Configurar importação e exportação

Linda Rosenberg, administradora da Cloud Kicks, aprendeu muito sobre esquemas e modos de importação e exportação. Agora ela está pronta para configurar e executar seu primeiro processo de importação e exportação. Embora Linda seja responsável por uma variedade de processos de importação e exportação, hoje ela se concentrará na importação de catálogos e exportação de pedidos. Ela aprenderá as etapas para completar esses processos e os limites de tamanho de transferência de dados.

Mas, primeiro, ela precisa garantir que ela e seu administrador de backup, Peter Wong, tenham as autorizações corretas do Business Manager e de transferência de arquivos.

Ela e Peter precisam de autorizações de acesso para:

• 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

Ela também solicita acesso a uma porta FTP ao Suporte do Salesforce B2C Commerce para poder usar os scripts FTPClient fornecidos por um desenvolvedor.

Para acessar o Business Manager, você tem de ter uma implementação do B2C Commerce. Neste módulo, pressupomos que você seja um administrador do B2C Commerce com as devidas autorizações para executar essas tarefas. Se você não for um administrador do B2C Commerce, tudo bem. Continue lendo para saber como seu administrador executaria essas etapas em uma instância de preparação. Não tente seguir nossas etapas em seu Trailhead Playground. O B2C Commerce não está disponível no Trailhead Playground. Se você tem uma instância de preparação do B2C Commerce, pode experimentar essas etapas em sua instância. Se você não tem uma instância de preparação, pergunte ao seu gerente se existe alguma que possa usar.

Linda começa executando processos manuais de importação e exportação no Business Manager. Mais tarde, ela 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, ela 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, ela cria um arquivo no sistema PIM da Cloud Kicks usando o formato catalog.xsd, conforme descrito na primeira unidade deste módulo.

Veja as próximas etapas que ela vai seguir.

1. Abra o Business Manager.
2. Selecione cloudkicks > Ferramentas de comerciante > Produtos e catálogos > Importar e exportar.
3. Na seção Importar e exportar arquivos, clique em Upload.
4. Clique em Escolher arquivo. 
5. Clique em Upload.
6. Selecione o arquivo e clique em Compactar. 
7. O Business Manager cria um arquivo zip.
8. Clique em <<Voltar.
9. Na seção Catálogos, clique em Importar. 
10. Na seção Importação de catálogo - Selecionar arquivo, selecione o arquivo a ser importado e clique em Avançar>>.
11. O Business Manager valida o arquivo e exibe uma análise do arquivo. Linda verifica a análise para ver se o Business Manager reconheceu as informações esperadas antes de continuar a importação.
12. Clique em Próximo.
13. Selecione o modo de importação de mesclagem.

Linda quer exportar pedidos para que possam ser processados pelo sistema de gerenciamento de pedidos externos (OMS) da Cloud Kicks. 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, ela segue estas etapas.

1. Abra o Business Manager.
2. Selecione cloudkicks > Ferramentas de comerciante > Pedidos > Importar e exportar.
3. Clique em Exportar.
4. Selecione os pedidos a serem exportados e clique em Avançar. 
5. Selecione Exportar pedidos selecionados.
6. Digite o nome do arquivo: orders-01-19-2019.
7. Selecione Atualizar o status da exportação do pedido e o inventário.
8. Clique em Exportar.
9. Na seção Importar e exportar arquivos, clique em Download.
10. Selecione o nome do arquivo (Linda seleciona orders-01-19-2019) e clique em Compactar.
11. Clique no nome do arquivo zip, que baixa o arquivo para o sistema local.

Linda transfere o arquivo XML para o OMS usando o WebDAV e importa o arquivo no OMS. Ela também pode usar FTP ou HTTPS, mas a Cloud Kicks 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. Essa é uma prática recomendada!

Linda quer ter certeza de que está tudo perfeito, ou seja, ela dá uma olhada nos arquivos. Veja como.

1. Abra o Business Manager.
2. Selecione Administração > Desenvolvimento do site > Configuração de desenvolvimento. 
3. Clique no link Importação/Exportação. 
4. Examine os arquivos de log para garantir que eles estejam corretos.

O B2C Commerce limita os uploads de arquivos de exportação a 500 MB. Isso significa que várias exportações de sites ou exportações com imagens gigantes podem gerar taxas de excedentes de dados. Assim, Linda só executa as exportações conforme a necessidade, por exemplo, uma vez por dia, e apenas com os dados necessários.

Outro tipo de importação/exportação que Linda faz é de dados do site. A Cloud Kicks 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 ela copie uma configuração de instância de desenvolvimento e compartilhe-a com outra instância de desenvolvimento.

A importação/exportação do site permite que ela salve um instantâneo (configuração e dados) de uma instância e restaure-o na mesma ou em outra instância.

Para exportar dados do site, Linda segue estas etapas.

1. Abra o Business Manager.
2. Selecione Administração > Desenvolvimento do site > Importação e exportação do sites. 
3. Na seção Exportação, digite um nome para o arquivo.
4. Selecione os dados que você deseja exportar. 
5. Clique em Exportar.
6. Quando a exportação terminar, clique no link de arquivo de exportação na parte inferior da página.
7. Na próxima página, role até a parte inferior da página e clique no link de download do arquivo. Um arquivo zip é criado no sistema local.

Para importar dados do site:

1. Abra o Business Manager na instância de recebimento.
2. Selecione Administração > Desenvolvimento do site > Importação e exportação do sites.
3. Na seção Importação, com Local selecionado, clique em Escolher arquivo.
4. Procure o arquivo e clique em Abrir.
5. Selecione o arquivo na seção Importação e clique em Importar.

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 a Cloud Kicks cresce, Linda precisará prestar atenção a esse limite e a outros.

Linda reduziu os tamanhos dos arquivos XML por meio de compactação. Isso ajuda a Linda a ficar dentro dos limites de tamanho de upload e acelera os tempos de upload/download em links de rede lentos.

• gzip: o Business Manager compacta automaticamente arquivos de importação padrão com o algoritmo gzip, para que ela não precise executar .gunzip na instância. Ela apenas digita um nome de arquivo, como catalog.xml.gz, para o pipelet de importação ou seleciona um arquivo gzip (a extensão deve ser .gz) no Business Manager.
• zip: os arquivos XML podem ser compactados e descompactados (compactação zip, não gzip) em uma única base de arquivos dentro de Importação/Exportação no Business Manager. O Business Manager descompacta automaticamente arquivos .zip durante um upload.

Para outras importações além de dados de catálogo, Linda cria arquivos XML que contêm apenas as diferenças entre os arquivos XML atuais e anteriores. Eles são chamados de feeds delta. Eles geralmente são menores e mais rápidos de importar e menos vulneráveis a interrupções de rede.

Embora ela possa criar um feed de catálogo delta, ela não pode incluir elementos que substituem o modo de importação global por um modo de importação específico de elementos. 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.

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 B2C Commerce armazena-os no sistema de arquivos de 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.

Como os arquivos XML não podem ser revertidos, Linda sempre arquiva o arquivo XML anterior antes de uma importação, o que é uma prática recomendada. Ela pode importar a versão anterior se o novo arquivo XML não for validado. Uma vez por semana, ela exclui arquivos antigos (exceto o último arquivo) para que eles não se acumulem.

Hoje, Linda aprendeu a importar catálogos, exportar pedidos e visualizar os registros no WebDAV. Com a importação/exportação de sites, ela copiou os dados do site de uma instância de desenvolvimento para outra. Ela aprendeu a lidar com limitações de tamanho de arquivo e transação e a importância dos arquivos.

Neste módulo você acompanhou enquanto Linda aprendia sobre esquemas, modos e etapas necessárias para executar processos de importação/exportação. É hora de testar seu conhecimento e ganhar um novo emblema!

• Trailhead: Funções e autorizações do Salesforce B2C Commerce
• Ajuda: Importação e exportação