Importação e exportação programadas

Recurso do Adobe Commerce {width="20"} Recurso exclusivo somente no Adobe Commerce (Saiba mais)

Importações e exportações programadas podem ser executadas diariamente, semanalmente ou mensalmente. Os arquivos a serem importados ou exportados podem residir em servidores Adobe Commerce locais ou em servidores FTP remotos. A Importação/Exportação programada é implementada por padrão e não requer configuração adicional. Todas as importações e exportações programadas são gerenciadas pelo cron job scheduler.

Acessar importação/exportação programada

  1. Na barra lateral Admin, vá para System > Data Transfer>Scheduled Imports/Exports.

    Importação/exportação de dados agendada {width="700" modal="regular"}

  2. Para criar um novo trabalho agendado de importação ou exportação, clique no botão apropriado e siga as instruções para o tipo de trabalho agendado.

  3. Quando o registro é salvo, o trabalho aparece na grade Scheduled Import/Export.

    note note
    NOTE
    Ao criar ou atualizar uma importação/exportação programada, isso resulta em uma alteração na configuração do sistema. Depois de salvar, certifique-se de endereçar o aviso de invalidação de cache exibido na parte superior da página de Administração e liberar o cache para aplicar a programação nova ou atualizada.
  4. Após cada trabalho agendado, uma cópia do arquivo é colocada no diretório var/log/import_export no servidor local do Adobe Commerce.

    Os detalhes de cada operação não são gravados no log. Se ocorrer um erro, será enviada uma notificação do trabalho de importação/exportação que falhou, com uma descrição do erro.

Agendar uma importação

Para o formato de arquivo de importação disponível e os tipos de entidades de importação, o processo de importação programado é semelhante ao processo de importação manual:

  • O arquivo de importação deve estar no formato .CSV
  • Você pode importar dados de produtos e clientes

A vantagem de usar a importação agendada é que você pode importar automaticamente um arquivo de dados várias vezes depois de especificar os parâmetros de importação e agendar apenas uma vez.

Os detalhes de cada operação de importação não são gravados em um log, mas quando há uma falha, você recebe um email de Falha na importação com uma descrição do erro. O resultado do último trabalho de importação programado é mostrado na coluna Último resultado na página Importação/Exportação programada.

Após cada operação de importação, uma cópia do arquivo de importação é colocada no diretório var/log/import_export no servidor onde o Adobe Commerce ou o Magento Open Source está implantado. O carimbo de data e hora, o marcador da entidade importada (produtos ou clientes) e o tipo da operação (nesse caso, importação) são adicionados ao nome do arquivo de importação.

Após cada trabalho de importação programado, uma operação de reindexação é executada automaticamente. No front-end, as alterações nas descrições e outras informações de texto são refletidas depois que os dados atualizados são inseridos no banco de dados, e as alterações nos preços são refletidas somente após a operação de reindexação.

Etapa 1: concluir as configurações de importação

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

  2. No canto superior direito, clique em Add Scheduled Import.

  3. Defina as opções de agendamento e importação:

    • Name — Digite um nome para a importação agendada.

    • Description — Insira uma breve descrição que explique a finalidade da importação e como ela deve ser usada.

    • Entity Type — Defina como um dos seguintes:

      • Products
      • Advanced Pricing
      • Customers and Addresses (single file)
      • Customer Addresses
      • Customer Finances
      • Customers Main File
      • Stock Sources
    • Import Behavior — Defina como um dos seguintes:

      • Add/Update Complex Data — Adiciona ou atualiza novos dados complexos aos dados complexos existentes para entradas existentes no banco de dados. Este é o valor padrão.
      • Replace — Substitui entidades complexas existentes no banco de dados.
      • Delete Entities — Exclui entradas existentes no banco de dados.
      • Custom Action - Personaliza entidades existentes no banco de dados.
      note note
      NOTE
      Para os tipos de entidade Advanced Pricing,Products, Customers and Addresses (single file) ​e_Stock Sources_, esses comportamentos de importação são exibidos: Add/Update, Replace e Delete. Para os tipos de entidade Finanças do Cliente, Arquivo Principal do Cliente e Clientes e Endereços, esses comportamentos de importação são exibidos: Add/Update Complex Data, Delete Entities e Custom Action.
    • Start Time — Defina como a hora, os minutos e os segundos em que a importação está agendada para começar.

    • Frequency — Defina como um dos seguintes: Daily, Weekly ou Monthly

    • On Error - Defina como um dos seguintes: Stop Import ou Continue Processing

    • Status — Para ativar a importação agendada, defina como Enabled.

    • Field Separator — Insira o caractere usado para separar campos no arquivo de importação. O caractere padrão é uma vírgula.

    • Multiple Value Separator — Insira o caractere usado para separar vários valores em um campo.

    Importação de dados - configurações de importação agendadas {width="600" modal="regular"}

Etapa 2: completar as informações do arquivo de importação

  1. Defina Server Type como um dos seguintes:

    • Local Server - Importa os dados do mesmo servidor em que o Adobe Commerce está instalado.
    • Remote FTP - Importa os dados de um servidor remoto.

    Importação de dados - informações do arquivo de importação agendado {width="600" modal="regular"}

    note note
    NOTE
    Quando o módulo de armazenamento remoto está habilitado, o Local Server muda automaticamente para Remote Storage.
  2. Insira o File Directory de onde o arquivo de importação se origina.

    • Local Server - Insira um caminho relativo na instalação do Commerce. Por exemplo, var/import. Se o módulo de Armazenamento remoto estiver configurado, use import_export/import.
    • Remote FTP server - Digite a URL e o caminho completos para a pasta de importação no servidor remoto.
  3. Insira o File Name a ser importado.

  4. Para Images File Directory, insira o caminho para o diretório onde as imagens do produto são armazenadas.

    Em um servidor local, insira um caminho relativo como: var/import. Em um armazenamento remoto, insira um caminho relativo como: import_export/import ou import_export/import/some/dir.

Etapa 3: configurar os emails de importação com falha

Importação de dados - falha ao importar emails

  1. Defina Failed Email Receiver para o contato de armazenamento que receberá a notificação se ocorrer um erro durante a importação.

  2. Defina Failed Email Sender para o contato de armazenamento que aparece como remetente da notificação.

  3. Defina Failed Email Template para o modelo usado para a notificação.

  4. Para Send Failed Email Copy To, insira o endereço de email de qualquer pessoa que deverá receber uma cópia da notificação.

    Separe vários endereços de email com vírgula.

  5. Defina Failed Email Copy Method como um dos seguintes:

    • Bcc - Envia uma cópia de cortesia oculta da notificação de importação com falha. O nome e o endereço do recipient estão incluídos na distribuição de email original, mas ocultos da visualização.
    • Separate Email - Envia uma cópia da notificação de importação com falha como um email separado.
  6. Quando terminar, clique em Save.

    O novo trabalho de importação agendado é adicionado à lista na página Scheduled Import/Export. Nessa página, ele pode ser executado imediatamente para teste e edição. O arquivo de importação é validado antes da execução de cada trabalho de importação.

NOTE
Ao criar ou atualizar uma importação/exportação programada, isso resulta em uma alteração na configuração do sistema. Depois de salvar, certifique-se de endereçar o aviso de invalidação de cache exibido na parte superior da página de Administração e liberar o cache para aplicar a programação nova ou atualizada.

Descrições dos campos

Import Settings

Campo
Descrição
Name
O nome da importação. Ajuda a diferenciá-lo se muitas importações programadas diferentes forem criadas.
Description
(Opcional) Você pode inserir uma descrição.
Entity Type
Define os dados a serem importados.
Import Behavior
Define como os dados complexos são tratados se as entidades que estão sendo importadas existirem no banco de dados. Dados complexos para produtos incluem categorias, sites, opções personalizadas, preços de níveis, produtos relacionados, vendas adicionais, vendas cruzadas e dados de produtos associados. Dados complexos para clientes incluem endereços. Opções:
Add/Update Complex Data- Os novos dados complexos são adicionados ou atualizados para os dados complexos existentes de entradas existentes no banco de dados. Este é o valor padrão.
Add/Update - Novos dados são adicionados às entradas existentes no banco de dados. Todos os campos, exceto sku, podem ser atualizados para produtos. Quaisquer vários valores de campo que não estejam listados no arquivo CSV, como categorias ou sites, permanecem no banco de dados após a importação.
Replace- Os dados complexos existentes para as entidades existentes são substituídos.
Delete Entities - Se existirem entidades importadas no banco de dados, elas serão excluídas do banco de dados.
Custom Action- As entidades complexas existentes são personalizadas durante o processo de importação.
Start Time
Defina a hora de início, os minutos e os segundos da importação.
Frequency
Defina com que frequência a importação é executada. Opções: Daily / Weekly / Monthly
On Error
Defina o comportamento do sistema caso sejam encontrados erros durante a validação do arquivo. Opções:
Parar Importação — O arquivo não será importado se algum erro for encontrado durante a validação. Este é o valor padrão.
Continuar Processando - Caso sejam encontrados erros durante a validação, mas a importação for possível, o arquivo será importado.
Status
A importação é ativada por padrão. Você pode suspendê-lo definindo o Status como Disabled.
Field Separator
Determina o caractere usado para separar campos. Valor padrão: , (vírgula)
Multiple Value Separator
Determina o caractere usado para separar vários valores dentro de um campo. Valor padrão: , (vírgula)

Import File Information

Campo
Descrição
Server Type
Você pode importar de um arquivo no mesmo servidor em que o Commerce está implantado (selecione Local Server) ou do servidor FTP remoto (selecione Remote FTP). Se você selecionar Remote FTP, serão exibidas opções adicionais para credenciais e configurações de transferência de arquivos. Se o módulo de armazenamento remoto estiver habilitado, o tipo Local Server será alternado automaticamente para Remote Storage.
File Directory
Especifique o diretório onde o arquivo de importação está localizado. Se o Tipo de Servidor estiver definido como Local Server, especifique o caminho relativo para o diretório de instalação do Commerce. Por exemplo: var/import ou import_export/import para armazenamento remoto.
File Name
Especifique o nome do arquivo de importação.
Images File Directory
Insira o caminho para o diretório onde as imagens do produto são armazenadas. Para um servidor local, insira um caminho relativo. Por exemplo: var/import ou import_export/import para armazenamento remoto.

Import Failed Emails

Campo
Descrição
Failed Email Receiver
Especifique o endereço de email para o qual uma notificação por email (email de importação com falha) será enviada se a importação falhar.
Failed Email Sender
Especifique o endereço de email usado como remetente do email de falha na importação.
Failed Email Template
Selecione um modelo para o email de falha na importação. Por padrão, somente a opção Falha ao importar (Modelo padrão da localidade) está disponível. Modelos personalizados podem ser criados em System>Transactional Emails.
Send Failed Email Copy To
O endereço de email para o qual uma cópia do email de falha de importação é enviada.
Send Failed Email Copy Method
Selecione o método de envio de cópia para o email de falha na importação.

Agendar uma exportação

A Exportação Agendada é semelhante a uma Exportação manual no formato de arquivo de exportação disponível e nos tipos de entidades que podem ser exportadas:

  • É possível exportar para o formato CSV
  • É possível exportar dados do produto e do cliente

A vantagem de usar a Exportação agendada é que você pode exportar dados várias vezes automaticamente, depois de especificar os parâmetros de exportação, e agendar apenas uma vez.

Os detalhes de cada exportação não são gravados em um log, mas, se houver falha, você receberá um email Export Failed, que contém a descrição do erro. O resultado do último trabalho de exportação é exibido na coluna Último resultado na página Importação/Exportação programada.

Após cada exportação, o arquivo de exportação é colocado no local definido pelo usuário e uma cópia no diretório var/log/import_export no servidor onde o Adobe Commerce ou o Magento Open Source está implantado. O carimbo de data e hora e o marcador da entidade exportada (produtos ou clientes) e o tipo da operação (nesse caso, exportação) são adicionados ao nome do arquivo de exportação.

Etapa 1: concluir as configurações de exportação

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

  2. No canto superior direito, clique em Add Scheduled Export e faça o seguinte:

    • Insira um Name para a exportação agendada.

    • Insira um breve Description que explique a finalidade da exportação e como ela deve ser usada.

    • Defina Entity Type como um dos seguintes:

      • Advanced Pricing
      • Products
      • Customer Financing
      • Customers Main File
      • Customer Addresses
      • Stock Sources

      A seção Entity Attributes ​na parte inferior da página é atualizada para refletir o Tipo de Entidade selecionado.

    • Defina Start Time como a hora, os minutos e os segundos em que a exportação está agendada para começar.

    • Defina Frequency como um dos seguintes:

      • Daily
      • Weekly
      • Monthly
  3. Para ativar a exportação agendada, defina Status como Enabled.

  4. Aceitar CSV como o File Format padrão.

    Configurações de exportação agendadas {width="600" modal="regular"}

Etapa 2: completar as informações do arquivo de exportação

  1. Defina Server Type como um dos seguintes:

    • Local Server - Para salvar o arquivo de exportação no mesmo servidor em que o Commerce está instalado.
    • Remote FTP — Para salvar o arquivo de exportação em um servidor remoto.

    Informações do arquivo de exportação agendado {width="600" modal="regular"}

    note note
    NOTE
    Quando o módulo de armazenamento remoto está habilitado, o Local Server muda automaticamente para Remote Storage.
  2. Para File Directory, insira o diretório onde o arquivo de exportação deve ser salvo da seguinte maneira:

    • Para Local Server, insira um caminho relativo na instalação do Commerce, como var/export. Se o módulo de armazenamento remoto estiver configurado, use import_export/export.
    • Para Remote FTP server, insira a URL e o caminho completos para a pasta de destino no servidor de destino.
  3. Se o servidor Remote FTP ​estiver selecionado, insira as credenciais de conexão para o servidor e selecione as configurações adicionais:

    • Para FTP Host[:Port], insira o endereço do host FTP remoto.
    • Para User Name, digite o nome de usuário usado para acessar o servidor remoto.
    • Para Password, digite a senha da conta de nome de usuário fornecida.
    • Para File Mode, escolha Binary ou ASCII.
    • Para Passive Mode, escolha No ou Yes.

Etapa 3: configurar os emails de falha de exportação

  1. Defina Failed Email Receiver para o contato de armazenamento que receberá a notificação se ocorrer um erro durante a exportação.

  2. Defina Failed Email Sender para o contato de armazenamento que aparece como remetente da notificação.

  3. Defina Failed Email Template para o modelo usado para a notificação.

  4. Para Send Failed Email Copy To, insira o endereço de email de qualquer pessoa que deverá receber uma cópia da notificação.

    Para vários endereços de email, separe com vírgula.

  5. Defina Failed Email Copy Method como um dos seguintes:

    • Bcc - Envia uma cópia de cortesia oculta. O nome e o endereço do recipient estão incluídos na distribuição de email original, mas estão ocultos na visualização.
    • Separate Email — Envia a cópia como um email separado.

Etapa 4: Escolher os atributos de entidade

  1. Na seção Entity Attributes, escolha os atributos que deseja incluir nos dados de exportação.

    • Para filtrar os dados exportados por valor de atributos, insira o valor de atributo na coluna Filter.
    • Para excluir produtos ou clientes com determinados valores de atributo, insira os valores dos atributos que deseja excluir e marque a caixa de seleção na coluna Ignorar.
  2. Quando terminar, clique em Save.

    O novo trabalho de exportação agendado é adicionado à lista na página Scheduled Import/Export. Nessa página, ela pode ser executada imediatamente, para teste e editada.

NOTE
Ao criar ou atualizar uma importação/exportação programada, isso resulta em uma alteração na configuração do sistema. Depois de salvar, certifique-se de endereçar o aviso de invalidação de cache exibido na parte superior da página de Administração e liberar o cache para aplicar a programação nova ou atualizada.

Descrições dos campos

Export Settings

Campo
Descrição
Name
O nome da exportação. Ajuda a diferenciá-lo se muitas exportações programadas diferentes forem criadas.
Description
(Opcional) Uma descrição da exportação programada.
Entity Type
Identifica os dados a serem exportados. Depois que a seleção é feita, os Atributos da entidade aparecem abaixo. Opções: Advanced Pricing / Products / Customer Finances / Customers Main File / Customer Addresses / Stock Sources
Start Time
Defina a hora de início, os minutos e os segundos da exportação.
Frequency
Defina com que frequência o trabalho de exportação é executado. Opções: Daily / Weekly / Monthly
Status
Uma nova exportação agendada é ativada por padrão. Você pode suspendê-la definindo o Status como Desativado. Opções: Enabled / Disabled
File Format
Selecione o formato do arquivo de exportação. Atualmente, apenas a opção .CSV está disponível.

Export Settings Information

Campo
Descrição
Server Type
Determina o local do arquivo de exportação. Opções:
Servidor Local — Coloca o arquivo de exportação no mesmo servidor em que o Commerce está implantado. Se o módulo de armazenamento remoto estiver habilitado, Local Server será alternado para Remote Storage.
FTP remoto — Coloca o arquivo de exportação em um servidor remoto. Opções adicionais para credenciais e configurações de transferência de arquivos são exibidas.
File Directory
Especifique o diretório onde o arquivo de exportação é colocado. Caso Server Type ​esteja definido como Local Server, especifique o caminho relativo ao caminho de instalação do Commerce. Por exemplo, var/export ou import_export/export para armazenamento remoto.

Export Failed Emails

Campo
Descrição
Failed Email Receiver
Especifique o endereço de email para o qual uma notificação por email (email de falha na exportação) será enviada se a exportação falhar.
Failed Email Sender
Especifique o endereço de email usado como remetente de email com falha na exportação.
Failed Email Template
Selecione um modelo para o email de exportação com falha. Por padrão, somente a opção Export Failed (Default Template from Locale) está disponível.
Send Failed Email Copy To
O endereço de email para o qual uma cópia do email de exportação com falha é enviada.
Send Failed Email Copy Method
Especifique o método de envio de cópia para o email de falha na exportação.
recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1