Importar arquivo ZIP do projeto

O recurso Importar projeto no Document360 permite que você traga um arquivo ZIP previamente exportado para qualquer projeto, restaurando ou migrando seus artigos, páginas de categoria e arquivos de mídia em uma única etapa. Isso é útil ao mover conteúdo entre projetos ou recuperar de um backup. O processo de importação valida o arquivo ZIP antes de aplicar qualquer alteração, então você pode revisar o que será adicionado antes de fazer o commit.

Quando usar o recurso de importação de projeto

Use esse recurso quando precisar:

• Migre conteúdo — transfira artigos e categorias de um projeto Document360 para outro.
• Restaure a partir de um backup — reimporte um arquivo ZIP previamente exportado para recuperar o conteúdo que foi perdido ou sobrescrevido.
• Consolide espaços de trabalho — mesture conteúdo de um projeto exportado em um espaço de trabalho existente que compartilhe o mesmo slug.

Antes de começar

• Você deve ter a função de conteúdo Editor para importar um projeto.
• Para funções de conteúdo personalizadas, sua conta deve ter acesso Atualizar e Publicar ao recurso de Importação & Exportação do Projeto .
• O arquivo ZIP deve ser uma exportação de projeto Document360. Arquivos ZIP de outras plataformas não são suportados.
• O tamanho máximo suportado de arquivo ZIP é de 1 GB.
• Se o arquivo ZIP contiver idiomas que não estejam presentes no workspace de destino, adicione esses idiomas ao workspace de destino antes de importar.

Como importar um arquivo ZIP de projeto

1. Passe o mouse sobre as ferramentas de conteúdo na barra de navegação da esquerda.
2. No submenu, navegue até Importar e exportar > Importar e exportar projeto.
3. Clique no botão Importar .
   O painel de Importar projeto se abre.
4. Arraste e solte o arquivo ZIP do seu projeto no painel, ou clique em Upload para selecionar o arquivo do seu armazenamento local.
   O Document360 faz upload e valida o arquivo ZIP automaticamente.
5. Se precisar usar outro arquivo, clique em Substituir.
6. Após validação bem-sucedida, revise a mensagem de confirmação, que exibe:
   • Idiomas incluídos no arquivo ZIP
   • Número de categorias
   • Número de artigos
7. Selecione a opção Definir status de artigo para publicar se quiser que todos os artigos importados sejam publicados imediatamente. Se não for selecionado, todos os artigos importados ficam configurados como Rascunho.
8. Clique em Importar para finalizar o processo.

Todos os artigos e arquivos de mídia do arquivo ZIP agora estão disponíveis no projeto de destino.

Importando projetos com o mesmo slug de workspace

Quando o slug do workspace no arquivo ZIP corresponde ao slug do workspace do projeto de destino, os artigos e categorias importados se fundem com o conteúdo existente naquele workspace.

Importando para um projeto com um slug de workspace diferente

Quando o slug do workspace no arquivo ZIP difere do slug do projeto de destino, o Document360 cria um novo workspace usando o nome e o slug do projeto importado. Todo o conteúdo importado é adicionado a esse novo espaço de trabalho.

Importar um arquivo ZIP para um espaço de trabalho específico sem sobrescrever conteúdo existente

Para importar conteúdo em um espaço de trabalho específico evitando conflitos com artigos existentes ou incompatibilidades entre slugs, edite manualmente o arquivo ZIP antes de importá-lo.

1. Exporte as categorias desejadas do seu projeto Document360 de origem como um arquivo ZIP.
2. Extraia o arquivo ZIP da sua máquina local.
   A pasta extraída contém dois diretórios:
   • Mídia — todos os arquivos de mídia do projeto.
   • workspace_slug — contém uma pasta Artigos , uma pasta Categorias e um workspace_slug_category_articles arquivo JSON.
3. Abra o workspace_slug_category_articles arquivo em um editor de código.
4. Atualize o nome do workspace e o slug para corresponder ao workspace de destino.
5. Salve o arquivo e renomeie usando o formato de slug do workspace de destino: workspace_slug_category_articles.
   Exemplo: v2_category_articles
6. Se necessário, atualize os slugs de artigos ou categorias individuais e ajuste o código do idioma nas pastas extraídas.
7. Comprima todos os arquivos modificados em um novo arquivo ZIP nomeado em referência ao slug do workspace de destino.
8. Retorne ao seu projeto Document360 e importe o arquivo ZIP recém-criado seguindo as etapas padrão de importação.

A gravação de tela acima demonstra como mudar o slug e o nome do workspace de v1 para v2 nos arquivos extraídos, recomprimi-los e importar o ZIP atualizado para o projeto v2 .

Razões comuns de falência de importação

Se sua importação falhar, verifique o seguinte:

Melhores práticas

• Valide slugs de workspace antes de fazer upload — slugs descompatíveis criam silenciosamente um novo workspace em vez de mesclar conteúdo. Confirme que os slugs de origem e destino coincidem antes de começar.
• Recrie conteúdo e reutilize elementos imediatamente após a importação — modelos, variáveis, trechos e termos do glossário são excluídos do ZIP. Recrie-os imediatamente no projeto de destino para evitar referências quebradas em artigos recém-importados.
• Teste com uma única categoria primeiro — para projetos grandes, exporte e importe uma categoria antes de executar a importação completa. Isso confirma que a configuração do slug e o mapeamento do espaço de trabalho estão corretos antes de se comprometer com uma operação em massa.

FAQ