Configurar importação e exportação
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Listar três tipos de autorizações de que um administrador do Commerce B2C precisa para realizar importação/exportação.
- Listar três etapas básicas do processo de importação.
- Listar três etapas básicas do processo de exportação.
- Explicar o propósito da importação/exportação local de site.
- Descrever duas maneiras de lidar com limitações de transferência.
Nesta unidade, saiba como configurar e executar um processo de importação e exportação. Embora os Administradores do Commerce B2C sejam responsáveis por vários processos de importação e exportação, esta unidade se concentra na importação de catálogos e na exportação de pedidos.
Para configurar a importação e exportação, você precisa de autorizações de acesso a:
- Importação/exportação do site, que inclui todas as informações do site
- Importação/exportação de informações da loja, por exemplo, produtos e conteúdo
- Acesso WebDAV a arquivos de registro e diretórios de importação/exportação no servidor
Você também precisa solicitar acesso a uma porta FTP ao Suporte do Agentforce Commerce for B2C para poder usar os scripts FTPClient fornecidos por um desenvolvedor.
Importar um catálogo
Você começa executando processos manuais de importação e exportação no Business Manager. Mais tarde, você planeja trabalhar com um desenvolvedor para criar processos que usem pipelets padrão. Esses pipelets lidam facilmente com grandes conjuntos de dados, são rápidos e confiáveis e usam os recursos do sistema de forma eficiente. Para melhorar sua eficiência, você também planeja criar trabalhos em lote tanto para transferência de arquivos quanto para importação/exportação. Por enquanto, os processos manuais estão ótimos.
Para importar um catálogo contendo dados do produto, você cria e compacta um arquivo do catálogo no sistema PIM usando o formato catalog.xsd, conforme descrito na primeira unidade deste módulo.
Veja as próximas etapas a seguir.
- No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Merchant Tools (Ferramentas do comerciante) | Products and Catalogs (Produtos e catálogos) | Import & Export (Importação e exportação).
- Na seção Importar e exportar arquivos, clique em Upload.

- Clique em Escolher arquivo.
- Selecione seu arquivo.
- Clique em Upload (Fazer upload).

- O Business Manager descompacta o arquivo.
- Clique em Voltar.
- Na seção Catalogs (Catálogos), clique em Import (Importar).

- Na seção Importação do catálogo, selecionar arquivo a ser importado e clique em Next (Avançar).
- O Business Manager valida o arquivo e exibe uma análise do arquivo. Verifique a análise para ver se o Business Manager reconheceu as informações esperadas antes de continuar a importação.
- Clique em Avançar.
- Selecione o modo de importação de mesclagem.
Exportar pedidos
Você deseja exportar pedidos de processamento pelo seu sistema de gerenciamento de pedidos (Order Management System - OMS) externo. Seu arquivo de exportação usa a mesma definição de esquema da importação. O Business Manager constrói automaticamente o arquivo XML.
Para exportar pedidos, siga estas etapas.
- No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Merchant Tools (Ferramentas do comerciante) | Ordering (Pedidos) | Import & Export (Importar e exportar).
- Clique em Exportar.
- Selecione os pedidos que você deseja exportar e clique em Next (Avançar).
- Selecione Exportar pedidos selecionados.
- Insira o nome do arquivo.
- Selecione Atualizar o status da exportação do pedido e o inventário.
- Clique em Exportar.
- Na seção Importar e exportar arquivos, clique em Download.
- Selecione o nome do arquivo e clique em Compress (Compactar).
- Clique no nome do arquivo zip, que baixa o arquivo para o sistema local.
Transfira o arquivo XML para o OMS usando o WebDAV e importe o arquivo no OMS. Opcionalmente, você pode usar FTP ou HTTPS, mas a empresa desenvolveu a implementação com uso de WebDAV. Seu processo de transferência usa uma conexão segura devido aos requisitos PCI-DSS para transferência de dados e aos requisitos do sistema OMS.
Exibir arquivos de importação/exportação via WebDAV
Para garantir que tudo está pronto, você analisa os arquivos. Veja o procedimento.
- No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Administration (Administração) | Site Development (Desenvolvimento do site) | Development Setup (Configuração de desenvolvimento.).
- Clique em Import/Export (Importar/Exportar).
- Analise os arquivos do registro para garantir que eles estejam corretos.
O Commerce for B2C limita os carregamentos de arquivos de exportação a 500 MB. Isso significa que várias exportações de sites ou exportações com imagens gigantes geram taxas de excedentes de dados. Você executa exportações somente quando necessário, por exemplo, uma vez por dia e apenas com os dados necessários.
Importação/exportação de sites
Outro tipo de importação/exportação que você faz é de dados do site. Sua empresa está implementando um novo site, com várias equipes de desenvolvimento trabalhando em paralelo em várias instâncias de desenvolvimento. O arquiteto funcional pede que você copie uma configuração de instância de desenvolvimento e compartilhe-a com outra instância de desenvolvimento.
Para essa tarefa, você usa o módulo de importação/exportação do site. Você pode salvar um instantâneo (configuração e dados) de uma instância e restaurá-lo na mesma instância ou em outra.
Para exportar dados do site, você segue estas etapas.
- No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Administration (Administração) | Site Development (Desenvolvimento do site) | Site Import & Export (Importação e exportação de sites).

- Na seção Exportação, digite um nome para o arquivo.
- Selecione os dados que você quer exportar.

- Clique em Exportar.
- Quando a exportação terminar, clique no link de arquivo de exportação na parte inferior da página.
- Na próxima página, role até a parte inferior da página e clique no link de download do arquivo. O sistema cria um arquivo zip no sistema local.
Para importar dados do site:
- No Business Manager na instância receptora, clique em App Launcher (Iniciador de aplicativos) e selecione Administration (Administração) | Site Development (Desenvolvimento de sites) | Site Import & Export (Importação e exportação de sites).
- Na seção Importação, com Local selecionado, clique em Escolher arquivo.
- Procure o arquivo e clique em Abrir.
- Selecione o arquivo na seção Importação e clique em Importar.
Limites de transação
Embora as importações padrão tenham sido projetadas para lidar com arquivos XML de tamanhos arbitrários, um único processo é limitado a 1.000 objetos comerciais. À medida que sua empresa cresce, você presta atenção a esse limite e a outros.
Limite |
Descrição |
|---|---|
Upload |
Um push WebDAV para uma instância do Commerce for B2C tem um limite de carregamento de 500 MB. Se demorar muito para transferir o arquivo, você poderá tentar novamente com os arquivos compactados. |
Download |
Para baixar em arquivo, o limite de tamanho é de 200 MB por FTP ou WebDAV. Os tamanhos dos arquivos para download em uma sequência de caracteres são menores. |
Tamanho do FTPClient |
Buscas de arquivo programáticas usam limites de arquivos impostos. Você pode passar os limites em um argumento ou padrão. |
Tamanho do HTTPClient |
O cliente HTTP não tem uma limitação de tamanho de arquivo. |
Arquivos XML compactados
Você reduz os tamanhos dos arquivos XML meio de compactação. Ao usar arquivos compactados, você fica dentro dos limites de tamanho de carregamento e acelera os tempos de carregamento e download em links de rede lentos.
-
gzip: o Business Manager compacta automaticamente arquivos de importação padrão com o algoritmo gzip para que você não precise executar
.gunzipna instância. Você insere um nome de arquivo, como catalog.xml.gz, no pipelet de importação ou seleciona um arquivo gzipado (a extensão deve ser .gz) no Business Manager.
-
zip: compacte ou descompacte arquivos XML (compactação zip, não gzip) em uma única base de arquivos dentro de Import/Export (Importação/exportação) no Business Manager. O Business Manager descompacta automaticamente arquivos .zip durante um upload.
Feeds delta
Para outras importações além de dados de catálogo, você cria arquivos XML que contêm apenas as diferenças entre os arquivos XML atuais e anteriores. Eles são chamados de feeds delta. Esses arquivos geralmente são menores e mais rápidos de importar e menos vulneráveis a interrupções de rede.
Embora você possa criar um feed de catálogo delta, você exclui elementos que substituem o modo de importação global por um modo de importação específico do elemento. Não é possível, por exemplo, criar um feed delta para um produto empacotado, pois o campo bundled-products usa automaticamente o modo de substituição.
Arquivos estáticos
Os objetos persistentes no catálogo e na biblioteca de conteúdo (categoria, produtos e dados de conteúdo) têm arquivos estáticos suplementares, como imagens de produtos. O Commerce for B2C armazena esses arquivos no sistema de arquivos da instância. Seus arquivos XML só podem conter objetos de banco de dados persistentes e referências aos objetos estáticos. Para exportar/importar ou baixar/carregar arquivos estáticos, Linda precisará usar a interface WebDAV.
Por que arquivamento?
Como o Commerce for B2C não reverte arquivos XML, sempre arquive o arquivo XML anterior antes de realizar uma importação. Se o novo arquivo XML não for validado, você poderá importar a versão anterior. A melhor prática é excluir arquivos antigos (exceto o último) uma vez por semana para que eles não se acumulem.
Resumo
Nesta unidade, você aprendeu a importar catálogos, exportar pedidos e visualizar os registros no WebDAV. Com a importação/exportação de sites, você copiou os dados do site de uma instância de desenvolvimento para outra. Você viu como lidar com limitações de tamanho de arquivo e transação e a importância dos arquivos.
Recursos
- Trailhead: Funções e autorizações do Salesforce B2C Commerce
- Ajuda do Salesforce: Importação e exportação
