Exportar Importar Árvore de Categorias
Exportar cria uma captura instantânea da sua árvore de categorias em uma planilha. Importar valida o arquivo, mostra uma pré-visualização e aplica as alterações somente quando você pressiona Salvar.
Visão geral
Exportar Importar é um fluxo de trabalho controlado para atualizar sua árvore de categorias usando um arquivo de planilha. Exportar gera um arquivo a partir da sua árvore atual para que você tenha uma captura explícita. Importar lê esse arquivo, valida-o e produz uma pré-visualização para que você possa revisar o resultado antes que quaisquer alterações sejam aplicadas. Após confirmar a pré-visualização, você pressiona Salvar para aplicar as alterações. Essa abordagem é projetada para mudanças cuidadosas, backups e reutilização intencional de uma estrutura.
Quando usar
Faça backup da sua árvore de categorias atual antes de fazer uma grande alteração
Faça edições em massa em um editor de planilhas como Excel ou Google Sheets
Restaure ou volte para uma estrutura anterior importando um arquivo de exportação mais antigo
Reutilize uma estrutura para outra loja quando você exportar intencionalmente da loja A e importar na loja B
Como funciona
Exportar cria um arquivo de planilha baseado na sua árvore de categorias atual. Você pode editá-lo em um editor de planilhas e enviá-lo novamente usando Importar. Importar valida o arquivo e mostra uma pré-visualização da árvore resultante. Nada é aplicado durante a pré-visualização. O aplicativo aplica as alterações somente quando você pressiona Salvar.
Passo a passo
Exportar árvore atual
1. Abra a página Árvore de Categorias no aplicativo.
2. Confirme que você está na loja e espaço de trabalho corretos.
3. Clique em Exportar.
4. Baixe o arquivo da planilha para o seu computador.
5. Mantenha o arquivo exportado como backup antes de editar qualquer coisa.
6. Se planeja editar, faça uma cópia do arquivo exportado e trabalhe na cópia.
Editar na planilha com segurança
1. Mantenha os cabeçalhos das colunas originais inalterados.
2. Mantenha os valores de ID inalterados.
3. Edite apenas os campos que você entende, como NOME DE EXIBIÇÃO e CAMINHO NA ÁRVORE.
4. Use uma linha por coleção e não duplique linhas.
5. Ao editar CAMINHO NA ÁRVORE, use o formato baseado em ID descrito em Regras e validação.
6. Evite adicionar espaços extras antes ou depois dos IDs em CAMINHO NA ÁRVORE.
7. Se você reordenar os nós, mantenha as linhas dos pais presentes para que a validação possa resolver os pais.
8. Salve o arquivo em um formato de planilha suportado e não renomeie as abas.
Importar e pré-visualizar
1. Retorne à página Árvore de Categorias no aplicativo.
2. Clique em Importar.
3. Selecione o arquivo de planilha editado.
4. Aguarde o aplicativo validar o arquivo.
5. Revise a árvore da pré-visualização e confirme que a estrutura está correta.
6. Se aparecerem erros de validação, corrija o arquivo e importe novamente.
Aplicar alterações
1. Na pré-visualização, confirme que está satisfeito com o resultado.
2. Pressione Salvar para aplicar as alterações pré-visualizadas.
3. Aguarde o processo de salvamento ser concluído.
4. Atualize a página e confirme que a árvore atual corresponde à pré-visualização.
Regras e validação
Importar valida o arquivo de planilha antes que ele possa gerar uma pré-visualização. As regras abaixo descrevem os requisitos mínimos para CAMINHO NA ÁRVORE e as relações entre os nós.
CAMINHO NA ÁRVORE deve começar com /
Exemplo: /100 é válido. 100 não é válido.
O último ID no caminho deve ser o próprio ID da linha
Exemplo: Para uma linha com ID 200, CAMINHO NA ÁRVORE deve terminar com /200.
Todo ID pai no caminho deve existir neste arquivo
Exemplo: Se CAMINHO NA ÁRVORE é /100/200, então as linhas com ID 100 e 200 devem existir.
Uma coleção pode ter apenas um pai por vez
Exemplo: O ID 200 não pode aparecer como filho de dois pais diferentes no mesmo arquivo de importação.
Não crie loops (referência circular)
Exemplo: Se 100 é pai de 200, então 200 não pode se tornar pai de 100 em qualquer CAMINHO NA ÁRVORE.
Exemplos rápidos
Erros comuns e correções
Pai ausente
Sintoma: A validação falha e a pré-visualização não pode ser gerada.
Causa provável: Um ID pai no CAMINHO NA ÁRVORE não existe como uma linha no arquivo.
Como corrigir: Adicione a linha do pai ausente ou atualize o CAMINHO NA ÁRVORE para referenciar um pai existente.
Referência circular
Sintoma: A validação falha com uma mensagem de referência circular.
Causa provável: O CAMINHO NA ÁRVORE cria um loop onde um nó se torna um ancestral de si mesmo.
Como corrigir: Edite o CAMINHO NA ÁRVORE para que a hierarquia seja estritamente de pai para filho, sem loops.
ID duplicado
Sintoma: A validação falha e reporta IDs duplicados.
Causa provável: O mesmo ID aparece em mais de uma linha em diferentes planilhas.
Como corrigir: Mantenha uma única linha por ID e remova duplicatas antes de importar.
Formato de caminho inválido
Sintoma: A validação falha devido ao formato do CAMINHO NA ÁRVORE.
Causa provável: O CAMINHO NA ÁRVORE não começa com / ou contém segmentos não numéricos onde IDs são esperados.
Como corrigir: Use o formato baseado em ID e assegure que o CAMINHO NA ÁRVORE comece com /.
ID de coleção inexistente
Sintoma: A pré-visualização está faltando nós ou a validação reporta IDs desconhecidos.
Causa provável: O arquivo contém um ID que não existe como uma coleção na loja atual.
Como corrigir: Exporte novamente da loja atual e reaplique suas edições no novo arquivo de exportação.
Múltiplos pais
Sintoma: A validação falha ou a pré-visualização mostra uma estrutura inesperada.
Causa provável: O mesmo ID está colocado sob diferentes pais em linhas ou planilhas diferentes.
Como corrigir: Assegure que cada nó apareça em exatamente um lugar na árvore e mantenha um único CAMINHO NA ÁRVORE para esse ID.
Notas de segurança
A importação cria apenas uma pré-visualização até que você pressione Salvar.
Exporte um backup antes de começar a editar.
Você pode restaurar importando um arquivo de exportação anterior e então pressionando Salvar.
Perguntas frequentes
Sim. Exporte um backup antes de aplicar as alterações. Se precisar desfazer, importe o arquivo de backup, revise a pré-visualização e pressione Salvar.
Não. IDs são usados para associar linhas às coleções. Mantenha os IDs inalterados.
Não. Este arquivo é para a estrutura da árvore de categorias e campos relacionados usados pelo app. Ele não renomeia suas coleções Shopify.
O fluxo de importação não altera os dados subjacentes das coleções Shopify, como títulos ou identificadores. Ele atualiza como as coleções são organizadas como nós dentro da árvore de categorias do app.
Sim, quando você exporta intencionalmente da loja A e importa na loja B. A loja de destino deve conter as coleções referenciadas pelos IDs no arquivo.
Atualize o CAMINHO NA ÁRVORE para refletir a ordenação e relações de pai que deseja, depois importe, revise a pré-visualização e pressione Salvar.
O app não gerará uma pré-visualização. Corrija o arquivo da planilha com base nos detalhes do erro e importe novamente.
Microcópia da interface
Texto do diálogo de importação
Envie um arquivo de planilha para validar e gerar uma pré-visualização. Nenhuma alteração será aplicada até que você revise a pré-visualização e pressione Salvar.
Dica da tela de pré-visualização
Revise a pré-visualização cuidadosamente, depois pressione Salvar para aplicar essas alterações.