Importar do Confluence

É importante ter todos os seus dados em um único lugar. Este tutorial ensina você a importar seu espaço do Confluence para o Notion. Dependendo das suas necessidades, existem duas formas de fazer uma importação do Confluence para o Notion.

• Importador de arquivos ZIP: pode ser usado para importar apenas parte do seu espaço de trabalho. Só é possível importar espaços de trabalho menores de até 5 GB (ou 15 GB mediante solicitação).

• Importador de API: só pode importar todo o espaço de trabalho. Pode importar espaços de trabalho de até 30 GB. Mantém comentários e o mapeamento de usuários.

Importações de vários espaços: até 10 espaços do Confluence podem ser importados de uma só vez diretamente pela interface do usuário. Cada espaço do Confluence selecionado gera sua própria página de registro e é importado como uma página privada de nível superior separada (em diferentes espaços de equipe do Notion, conforme necessário). Este recurso está disponível apenas nos Planos Business e Enterprise.

• Site do Confluence → Organização do Notion

• Espaço do Confluence → Espaço de trabalho do Notion

• Página do Confluence → Página do Notion

• Macros → Conteúdo simplificado ou tipo de bloco do Notion mais próximo (por exemplo, Expandir no Confluence → Alternar no Notion)

• Importe até aproximadamente 50 mil páginas ou 30 GB de tamanho. Importações maiores podem falhar.

  • Dica: para espaços grandes, divida as exportações por subespaço ou seções e use o importador de ZIP. Se o tamanho do espaço de trabalho for superior a 100 GB, entre em contato com o administrador da sua conta.

• Após o início da importação, você poderá fechar o navegador com segurança. Enviaremos um e-mail quando o processo for concluído.

• Acompanhe o progresso da importação em Configurações → Importar. Você pode ver ali o status da importação e as importações concluídas.

Exportar seu espaço do Confluence para HTML

1. Do seu espaço de trabalho do Confluence, acesse Configurações do espaço na barra lateral à direita.

2. Selecione Ferramentas de conteúdo na barra de ferramentas superior e, em seguida, Exportar. Caso você não veja nenhuma dessas opções, pode ser necessário solicitar autorização para exportar a um administrador do espaço de trabalho.

3. Na lista de formatos, selecione HTML .

4. Selecione Exportação personalizada e desmarque a caixa Incluir comentários.

5. Selecione as páginas que você deseja exportar. Lembramos que as páginas que contêm anexos grandes podem aumentar significativamente o tamanho e a complexidade da exportação.

6. Aguarde até que a exportação seja processada. No caso de espaços de trabalho grandes, isso pode demorar um pouco.

7. Após a conclusão, clique em Baixar para salvá-la no seu computador. O arquivo terá um nome semelhante a Confluence-space-export-XXXXXX.html.zip.

Importar para o Notion

1. Acesse o espaço de trabalho do Notion para o qual você deseja importar seu conteúdo do Confluence.

2. Acesse Configurações na barra lateral → Importar → Importações de terceiros → Confluence.

3. Vá até o arquivo .zip exportado do Confluence e selecione-o para fazer o upload. Você não precisa descompactar o arquivo: basta carregar todo o arquivo.

4. Você verá uma mensagem "Carregando..." e, em seguida, uma mensagem de status avisando sobre o andamento da importação.

5. Quando a importação for concluída, você verá o conteúdo recém-importado.

Conectar o Confluence ao Notion

1. Acesse Configurações na barra lateral → Importar → Confluence.

2. Selecione Importar via API.

3. Selecione o tipo de instância do Confluence: nuvem ou servidor. Para identificar o tipo de instância, abra o Confluence e clique em Ajuda → ? ao lado do seu perfil → Sobre o Confluence. O Notion só oferece compatibilidade com instâncias de nuvem e servidor.

Autenticar com o Confluence Cloud

1. Informe seu e-mail e site do Confluence.

2. Crie um token de API em sua conta da Atlassian e insira-o no campo. Leia mais sobre como criar tokens no Confluence.

3. Clique em Autenticar.

Autenticação no Confluence Server

1. Localize e selecione a respectiva versão do Confluence.

2. Informe seu e-mail e site do Confluence.

3. Se a sua versão for Confluence 7.9 ou posterior, crie um Token de acesso pessoal e cole-o. Se estiver usando uma versão anterior, digite seu nome de usuário e sua senha do Confluence.

4. Clique em Autenticar.

Importação

1. Clique em Confluence no menu Importar.

2. Acompanhe o progresso da importação — essa etapa pode demorar algumas horas no caso de espaços grandes.

   • Após ver a mensagem Importando páginas…, você poderá fechar a janela do navegador com segurança. Enviaremos um e-mail quando a importação terminar.

3. Repita esses passos caso queira importar mais de um espaço do Confluence.

• O Notion importa tudo para um único espaço raiz/principal na seção particular ou para um espaço de equipe selecionado pela pessoa que está fazendo a importação.

• Espera-se que os usuários limpem e configurem a arquitetura do espaço de trabalho antes de convidar outras pessoas.

• As autorizações precisam ser aplicadas novamente no Notion — planeje uma etapa pós-importação para relacionar os grupos e as restrições do Confluence com os grupos, os espaços de equipe e as autorizações no âmbito da página do Notion.

• Tabelas do Confluence com arquivos ou anexos viram bases de dados do Notion; caso contrário, tornam-se tabelas simples.

• O estilo de tabelas, bem como as macros e os plug-ins, geralmente são prejudicados (por exemplo, ui-steps, frases de destaque, legendas de imagens).

• A maioria das macros não é suportada. O Notion tenta relacionar os dados com o bloco do Notion mais próximo.

• Falhas temporárias devido à falta de confiabilidade da API do Confluence podem fazer com que a importação geral ou determinadas páginas falhem. Talvez seja necessário repetir toda a importação.

• No caso de vários espaços, execute as importações sequencialmente (um espaço por vez), a menos que você use a importação de vários espaços (somente nos Planos Business/Enterprise).

• Podem ocorrer falhas de importação com dados complexos do Confluence (por exemplo, células mescladas, tabelas dentro de tabelas).

• O Notion é compatível apenas com tokens de API com escopo de usuário (não com tokens com escopo). Use a opção de token de API pessoal ao fazer a autenticação.

• Anexos e mídias não mencionados nas páginas não serão importados.

• Às vezes, a hierarquia não é totalmente preservada: faça uma validação com uma importação-piloto.

• Os blocos de matemática LaTeX são importados com erro

  • Motivo: o formato de macro em bloco do plugin LaTeX do Confluence é diferente do código de matemática in-line. O Notion é compatível com macros LaTeX in-line, mas não com a variante de macro em bloco.

  • Solução: converta as macros de bloco LaTeX em macros in-line no Confluence antes de importar novamente ou coloque o LaTeX em um bloco de código e converta manualmente em um bloco de matemática após a importação.

• Não foi possível importar o conteúdo do Gliffy

  • Motivo: o Notion não tem compatibilidade com imagens do Gliffy por meio do importador de arquivos.

  • Solução: antes de importar, modifique o HTML para substituir o bloco Gliffy por um bloco de imagem que faça referência ao arquivo correto.

• Falha na importação

  • Motivo: espaços muito grandes, exportações com formato incorreto, limites de taxa ou tempos limite atingido.

  • Solução: importe um espaço por vez, divida espaços grandes em seções, exporte novamente um arquivo ZIP limpo ou use o importador de API com execuções com escopo.

• Faltam imagens ou anexos na importação

  • Motivo: os ativos podem não ter sido incluídos no pacote de exportação ou podem não estar acessíveis pelo token de API.

  • Solução: verifique se a opção “Incluir anexos” está selecionada na exportação, mantenha os caminhos relativos intactos no arquivo ZIP ou carregue novamente os principais arquivos após a importação.

• As prévias de links do Jira não funcionam após a importação

  • Motivo: as prévias de links do Jira só funcionam se o usuário for autenticado antes de iniciar a migração.

  • Solução: autentique-se no Jira antes de executar a migração.

• A hierarquia de arquivos não é preservada conforme o esperado

  • Motivo: exceções na estrutura de exportação ou aninhamento profundo.

  • Solução: primeiro, teste com um subconjunto representativo; depois, reorganize no Notion após a importação.

• Macros do Confluence e/ou formatação especial são perdidos:

  • Motivo: macros ou conteúdo de aplicativos não aceitos.

  • Solução: relacione-os aos blocos nativos do Notion: Expandir → Alternar, Itens de ação → A fazer. Simplifique tabelas complexas ou exporte para CSV e importe para uma base de dados do Notion.

• As autorizações do Confluence não são replicadas no Notion:

  • Motivo: isso é esperado em importações feitas por conta própria.

  • Solução: planeje e execute um mapeamento de autorizações após a chegada do conteúdo ao Notion, usando os grupos, os espaços de equipe e as autorizações no âmbito da página do Notion.