Importar do Confluence

É importante ter todos os seus dados em um só lugar. Aqui está um tutorial útil para importar seu espaço do Confluence para o Notion. Dependendo das suas necessidades, há duas maneiras de importar do Confluence para o Notion.

• Importador de arquivo .zip: Pode ser usado para importar apenas parte do seu espaço de trabalho. Pode importar apenas espaços de trabalho menores de até 5 GB (ou 15 GB mediante solicitação).

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

• URL/ID: Se você precisar apenas de algumas páginas, pode trazer páginas específicas do Confluence diretamente colando seus links ou IDs.

Importações de vários espaços: Até 10 espaços do Confluence podem ser importados de uma só vez diretamente pela interface. Cada espaço do Confluence selecionado gera sua própria página de registro e é importado como uma página Particular 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é ~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 ZIP. Se o tamanho do espaço de trabalho for >100 GB, entre em contato com seu administrador da 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 sua importação em Configurações → Importar. Lá você pode ver o status da sua 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 na barra de ferramentas abaixo. 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. Observação: páginas com anexos grandes podem aumentar significativamente o tamanho e a complexidade da exportação.

6. Aguarde até que a exportação seja processada. Isso pode demorar um pouco para espaços de trabalho grandes.

7. Assim que terminar, clique em Download para salvar a exportação no seu computador. O arquivo terá um nome parecido com 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. Procure o arquivo .zip exportado do Confluence e selecione-o para upload. Não é preciso descompactar o arquivo; faça o upload de 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. No Notion, acesse Configurações na barra lateral → Importações → Word.

2. Selecione Importar via API.

3. Selecione o tipo da sua instância do Confluence: cloud ou server. Para encontrar o tipo da sua instância, abra o Confluence, clique em Ajuda → ? ao lado do seu perfil → Sobre o Confluence. O Notion oferece suporte apenas a instâncias cloud e server.

Autenticar com o Confluence Cloud

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

2. Crie um token de API na 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 você estiver usando o Confluence 7.9 ou posterior, crie um Token de acesso pessoal e cole-o. Se você estiver usando uma versão anterior, digite seu nome de usuário e 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.

   • Quando vir a mensagem Importando páginas…, você pode fechar a janela do navegador em 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.

Conectar o Confluence ao Notion

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

2. Selecione Importar via API.

3. Conecte sua conta do Confluence.

Escolha como importar

1. Na tela Configurar importação, selecione Importar páginas individuais (a opção com o subtítulo Carregar um CSV de IDs de página ou hiperlinks). A opção Importar espaços acima dela é recomendada para importações de espaços completos — use-a se você estiver trazendo um espaço inteiro.

2. Selecione Continuar.

Adicione suas páginas

1. Na tela Personalizar sua importação, escolha uma guia:

   • Carregar CSV: Selecione Escolher arquivo e carregue um arquivo .csv de coluna única com um URL de página ou ID numérico de página por linha.

   • Inserir manualmente: Cole os links ou IDs das suas páginas do Confluence na caixa de texto (separados por vírgula ou quebra de linha).

2. Ative Incluir todas as subpáginas se você quiser que as subpáginas de cada página também sejam trazidas.

3. Em Localização de importação, escolha onde as páginas devem ser colocadas — sua seção particular, um Espaço de equipe ou (se disponível) uma página específica.

4. Selecione Continuar. O Notion validará e resolverá suas páginas antes de iniciar a importação.

• 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 mapear os dados para o bloco mais próximo do Notion.

• Erros temporários devido à falta de confiabilidade da API do Confluence podem fazer com que a importação geral ou determinadas páginas falhem. Pode ser necessário tentar realizar a importação novamente.

• Para múltiplos espaços, você pode realizar até três importações simultâneas de espaço único por espaço de trabalho, a menos que esteja usando a importação de múltiplos espaços (Business/Enterprise apenas).

• Se uma importação de múltiplos espaços já estiver em execução, todas as novas importações do Confluence serão bloqueadas (de espaço único ou múltiplo) até que ela termine.

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

• O Notion oferece suporte apenas a tokens de API com escopo de usuário (não tokens com escopo). Use a opção de token de API pessoal ao autenticar.

• 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

  • Por que isso acontece: O formato de macro de bloco do plugin LaTeX do Confluence difere da matemática em linha. O Notion oferece suporte a macros LaTeX em linha, mas não à variante de macro de 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.

  • Para corrigir: Mapeie para blocos nativos do Notion: Expandir → Alternante, Itens de ação → To-do. 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.