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. No Admin barra lateral, vá para System > Data Transfer>Scheduled Imports/Exports.

    Importação/exportação de dados programada {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 job é exibido no campo Scheduled Import/Export ​grade.

    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 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 Falha ao importar email 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 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. No Admin barra lateral, 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 — Grava sobre o complexo existente para entidades 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 o Advanced Pricing,Products, Customers and Addresses (single file), e​_Stock Sources_ tipos de entidade, esses comportamentos de importação são exibidos: Add/Update, Replace, e Delete. Para o Finanças do cliente, Arquivo principal do cliente, e Clientes e endereços tipos de entidade, 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 o segundo em que a importação está programada para começar.

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

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

    • Status — Para ativar a importação programada, 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 programadas {width="600" modal="regular"}

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

  1. Definir Server Type a 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 estiver habilitado, Local Server alterna 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 - Insira o URL completo e o caminho para a pasta de importação no servidor remoto.
  3. Insira o File Name a ser importado.

  4. Para Images File Directory, digite 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 na importação de emails

  1. Definir Failed Email Receiver ao contato da loja que receberá a notificação se ocorrer um erro durante a importação.

  2. Definir Failed Email Sender ao contato da loja que aparece como o remetente da notificação.

  3. Definir Failed Email Template ao template usado para a notificação.

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

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

  5. Definir Failed Email Copy Method a 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 no Scheduled Import/Export ​página. 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 nos dados complexos existentes para 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 pode ser atualizado 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 relativos às 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 é importado se quaisquer erros forem encontrados durante a validação. Este é o valor padrão.
Continuar processamento - 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ê-la 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, opções adicionais para credenciais e configurações de transferência de arquivos serão exibidas. Se o módulo de armazenamento remoto estiver habilitado, Local Server O tipo é 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 ao 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 um manual Exportar 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 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. No Admin barra lateral, 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 resumo Description isso explica a finalidade da exportação e como ela deve ser usada.

    • Definir Entity Type a um dos seguintes:

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

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

    • Definir Start Time à hora, aos minutos e ao segundo em que a exportação está programada para começar.

    • Definir Frequency a um dos seguintes:

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

  4. Aceitar CSV como padrão File Format.

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

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

  1. Definir Server Type a 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 estiver habilitado, a variável Local Server alterna automaticamente para Remote Storage.
  2. Para File Directory, informe 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 o URL completo e o caminho para a pasta de destino no servidor de destino.
  3. Se a variável Remote FTP ​for selecionado, insira as credenciais de conexão para o servidor e selecione 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. Definir Failed Email Receiver ao contato da loja que receberá a notificação se ocorrer um erro durante a exportação.

  2. Definir Failed Email Sender ao contato da loja que aparece como o remetente da notificação.

  3. Definir Failed Email Template ao template usado para a notificação.

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

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

  5. Definir Failed Email Copy Method a um dos seguintes:

    • Bcc - Envia uma cópia de cortesia às cegas. 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 e-mail separado.

Etapa 4: Escolher os atributos de entidade

  1. No Entity Attributes ​escolha os atributos que deseja incluir nos dados de exportação.

    • Para filtrar dados de exportação por valor de atributos, insira o valor de atributo na Filter ​coluna.
    • 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 no Scheduled Import/Export ​página. 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, somente 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 é 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. No caso Server Type ​está definida como Local Server, especifique o caminho relativo ao caminho de instalação do Commerce. Por exemplo, var/exportou 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 variável 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