Importar dados

Os dados de todos os tipos de produtos podem ser importados para a loja. Além disso, você pode importar produtos, dados de preços avançados, dados do cliente, dados de endereço do cliente e imagens do produto. A importação suporta as seguintes operações:

  • Adicionar/Atualizar
  • Substituir
  • Excluir

Diretrizes de importação

Novas entidades

  • As entidades são adicionadas com os valores de atributo especificados no arquivo CSV.
  • Para um atributo obrigatório sem valor padrão definido, a entidade (a linha ou linhas correspondentes) não poderá ser importada se não houver um valor ou um valor inválido.
  • Para um atributo obrigatório com um conjunto de valores padrão, a entidade (a linha ou linhas correspondentes) é importada e o valor padrão é definido para o atributo se não houver um valor ou um valor inválido.
  • Se os dados complexos não forem válidos, a entidade (a linha ou linhas correspondentes) não poderá ser importada.

Entidades existentes

  • Para atributos que não são dados complexos, os valores do arquivo de importação, incluindo os valores vazios para os atributos não obrigatórios, substituem os valores existentes.
  • Se não houver valor ou se houver um valor inválido para um atributo obrigatório, o valor existente não será substituído.
  • Se os dados complexos da entidade forem inválidos, a entidade (a linha ou linhas correspondentes) não poderá ser importada, exceto se isso ocorrer quando Excluir entidades tiver sido selecionado no menu suspenso Importar comportamento.

Dados complexos

Se existir um atributo especificado no arquivo de importação e seu valor for derivado de um conjunto definido de valores, o seguinte se aplica:

  • Se o valor ainda não estiver incluído no conjunto definido de valores, a linha poderá ser importada e um valor padrão, se definido, será definido para o atributo.
  • Se o valor já estiver incluído no conjunto definido, a linha correspondente não poderá ser importada.
  • Se o arquivo de importação especificar um nome de atributo que ainda não está definido no sistema, ele não será criado e seus valores não serão importados.

Arquivos inválidos

  • Um arquivo não pode ser importado se todas as linhas forem inválidas.
  • Um nome de dados complexo ou de serviço não existente foi especificado no arquivo de importação, como uma coluna com um cabeçalho _<non-existing name>.

O processo de importação do Adobe Commerce pode não reconhecer corretamente os arquivos codificados em UTF-8 que usam uma BOM (marca de ordem de byte). Os arquivos que contêm uma BOM podem causar problemas ou falhas durante o processo de importação.

Importar operações

Operação
Descrição
Adicionar/Atualizar
Os novos dados de produtos são adicionados aos dados de produtos existentes para as entradas existentes no banco de dados. Todos os campos, exceto sku, podem ser atualizados.

As novas classes de imposto especificadas nos dados de importação são criadas automaticamente.

Novas categorias de produtos especificadas no arquivo de importação são criadas automaticamente.

As novas SKUs especificadas no arquivo de importação são criadas automaticamente

Observação: ​para produtos, você pode atualizar todos os campos, exceto a SKU, por meio da importação.

Importante: vários valores de campo, como sites ou categorias, não podem ser removidos usando o comportamento de importação Adicionar/Atualizar. Esses campos permanecerão no banco de dados após a importação se não estiverem listados no arquivo CSV.
Substituir
Os dados existentes do produto são substituídos por novos dados.

Importante: ​tenha cuidado ao substituir dados, pois os dados existentes do produto são apagados e todas as referências do sistema são perdidas.

Se uma SKU nos dados de importação corresponder à SKU de uma entidade existente, todos os campos, incluindo a SKU, serão excluídos e um novo registro será criado usando os dados CSV. Ocorre um erro se o arquivo CSV referenciar uma SKU que não existe no banco de dados. Você pode Verificar dados para exibir um erro.
Excluir
Todas as entidades nos dados de importação existentes no banco de dados são excluídas do banco de dados.

Excluir ignora todas as colunas nos dados de importação, exceto o SKU. É possível ignorar todos os outros atributos nos dados.

Ocorre um erro se o arquivo CSV referenciar uma SKU que não existe no banco de dados. Você pode Verificar dados para exibir um erro.

Processo de importação

O tamanho do arquivo de importação é determinado pelas configurações no arquivo php.ini no servidor. A mensagem do sistema na página Importar indica o limite de tamanho atual. O tamanho padrão é 2 MB.

Caracteres especiais (como o sinal de igual, símbolos maiores e menores que, aspas simples e duplas, barra invertida, barra vertical e símbolos de E comercial) podem causar problemas durante a transferência de dados. Para garantir que esses caracteres especiais sejam interpretados corretamente, eles podem ser marcados como uma sequência de escape. Por exemplo, se os dados incluírem uma cadeia de caracteres de texto como code="str", code="str2", escolher colocar o texto entre aspas duplas garante que as aspas duplas originais sejam compreendidas como parte dos dados. Quando o sistema encontra um conjunto duplo de aspas duplas, ele entende que o conjunto externo de aspas duplas está delimitando os dados reais.

Ao importar dados de produtos, novos dados de produtos são adicionados às entradas de dados de produtos existentes no banco de dados. Todos os campos, exceto o SKU, podem ser atualizados por meio da importação. Todos os dados existentes do produto são substituídos pelos novos dados importados. Tenha cuidado ao substituir dados. Todos os dados existentes do produto são apagados e todas as referências no sistema são perdidas.

Importação de dados

Etapa 1: Preparar os dados

  1. Na barra lateral Admin, vá para System > Data Transfer>Import.

  2. Em Importar Configurações, defina Entity Type como um dos seguintes:

    • Advanced Pricing
    • Products
    • Customer Finances
    • Customers and Addresses
    • Customers Main File
    • Customer Addresses
    • Stock Sources
  3. Clique em Download Sample File.

  4. Localize o arquivo de exportação no local de downloads do seu navegador da Web e abra o arquivo.

    O arquivo de amostra inclui títulos de coluna com dados de espaço reservado para os tipos de produto.

    Importar arquivo de amostra de dados {width="600" modal="regular"}

  5. Examine a estrutura do arquivo de amostra e use-a para preparar seu arquivo de importação de CSV, certificando-se de que os cabeçalhos das colunas estejam escritos corretamente.

  6. Verifique se o tamanho do arquivo de importação não excede o limite mostrado na mensagem.

    Notificação de tamanho de importação de dados {width="600"}

  7. Se os dados de importação incluírem caminhos para imagens de produtos, verifique se os arquivos de imagem foram carregados no local apropriado.

    O local padrão no servidor Commerce é: pub/media/import.

    Se as imagens residirem em um servidor externo, verifique se você tem o URL completo para o diretório que contém as imagens.

Etapa 2: Escolher o comportamento de importação

Comportamento de importação de dados

  1. Defina Import Behavior como um dos seguintes:

    • Add/Update (Para produtos, você pode atualizar todos os campos, exceto o SKU por meio da importação.)
    • Replace
    • Delete
  2. Para determinar o que acontece quando um erro é encontrado ao importar dados, escolha uma das seguintes opções:

    • Stop on Error
    • Skip error entries
  3. Para Allowed Errors Count, insira o número de erros que podem ocorrer antes do cancelamento da importação.

    O valor padrão é 10.

  4. Aceite o valor padrão de vírgula (,) para Field separator.

  5. Aceite o valor padrão de vírgula (,) para Multiple value separator.

    Em um arquivo CSV, uma vírgula é o separador padrão. Para usar um caractere diferente, verifique se os dados no arquivo CSV correspondem ao caractere especificado.

  6. Aceite o valor padrão _EMPTY_VALUE_ para Empty attribute value constant.

  7. Para colocar qualquer caractere especial que possa ser encontrado nos dados como uma sequência de escape, marque a caixa de seleção Fields Enclosure.

Etapa 3: identificar o arquivo de importação

Arquivo de importação de dados

  1. Clique em Choose File para selecionar o arquivo a ser importado.

  2. Encontre o arquivo CSV que você preparou para importar e clique em Open.

  3. Para Images File Directory, insira o caminho relativo para o local no servidor do Commerce onde as imagens carregadas são armazenadas.

    Por exemplo: product_images.

    note note
    NOTE
    Começando com a versão Adobe Commerce e Magento Open Source 2.3.2, o caminho especificado em Images File Directory ​concatena para importação no diretório base de imagens: <Magento-root-folder>/var/import/images. Por exemplo, coloque os arquivos product_images na pasta <Magento-root-directory>/var/import/images/product_images. O diretório base de imagens de importação pode ser configurado no arquivo \Magento\ImportExport\etc\config.xml. Se o módulo de Armazenamento remoto estiver habilitado, importe os arquivos para a pasta <remote-storage-root-directory>/var/import/images/product_images.

    Para saber mais sobre como importar imagens de produtos, consulte Importar imagens de produtos.

Etapa 4: verificar os dados de importação

  1. No canto superior direito, clique em Check Data.

  2. Aguarde alguns momentos para que o processo de validação seja concluído.

    Se os dados de importação forem válidos, a seguinte mensagem será exibida:

    Mensagem de êxito - o arquivo é válido {width="600"}

  3. Se o arquivo for válido, clique em Import.

    Caso contrário, corrija cada problema com os dados listados na mensagem e tente importar o arquivo novamente.

  4. O processo de importação continua até o final dos dados, a menos que seja encontrado um erro.

    Se uma mensagem de erro for exibida nos Resultados da validação, corrija o problema nos dados e importe o arquivo novamente.

    Mensagem de erro - a chave de URL já existe {width="600"}

    Uma mensagem é exibida quando a importação é concluída.

Importar histórico

O Commerce mantém um registro dos dados que foram importados para seu armazenamento, incluindo a data e a hora de início, o usuário, o tempo de execução e um link para o arquivo importado. O Tempo de Execução é a duração do processo de importação.

Para exibir o histórico de importação:

Na barra lateral Admin, vá para System > Data Transfer>Import History.

Histórico de importação de dados

NOTE
Por padrão, os arquivos do histórico de importação estão na pasta <Magento-root-directory>/var/import_history. Se o módulo de Armazenamento remoto estiver habilitado, os arquivos de histórico de importação estarão na pasta <remote-storage-root-directory>/import_export/import_history.
Campo
Descrição
ID
Um número interno usado para designar uma transferência.
Start Date & Time
Uma data e hora específicas em que a transferência ocorreu.
User
O cliente que fez a transferência.
Imported file
Link para baixar o arquivo importado.
Error file
O arquivo de erro correspondente.
Execution Time
Intervalo de tempo do processo de importação.
Summary
O número de itens criados, atualizados e excluídos ou a mensagem de erro.

Para baixar o arquivo Importado/Erro, clique em Download.

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1