Explorar importação e exportação do Business Manager

Linda Rosenberg é uma nova administradora na Cloud Kicks, uma empresa de tênis personalizados de alta qualidade. Sua principal responsabilidade é o gerenciamento de dados. Mais especificamente, ela precisa gerenciar a transferência de dados de loja entre sistemas externos e o B2C Commerce. Ela também precisa ajudar a mudar dados de configuração do site e definições de uma instância para outra a fim de ativar novas instâncias de desenvolvedor.

A Cloud Kicks desenvolve detalhes de catálogo, como números de SKU, descrições de produtos, tamanhos, imagens, preços e assim por diante, em um sistema de registro, e Linda precisa usar processos de importação para transferir esses dados para o B2C Commerce. Enquanto isso, sempre que os compradores de calçados criam pedidos, resgatam cupons e muito mais no B2C Commerce, Linda precisa garantir que os dados vão para um sistema externo de processamento. Para isso, ela usa processos de exportação.

Uma loja é seu site de comércio eletrônico online alimentado pelo B2C Commerce. Uma única instância pode incluir várias lojas.

Nesta unidade, Linda aprende alguns conceitos básicos sobre como o B2C Commerce lida com importação e exportação. Mais tarde, ela coloca os conceitos em prática enquanto experimenta processos acionados manualmente ou "em lote" e importação/exportação de sites com o B2C Commerce. Vamos acompanhar.

Antes que Linda possa experimentar os recursos de importação/exportação do site no B2C Commerce, ela precisa saber:

• Os tipos de dados que a Cloud Kicks importa e exporta.
• Os tipos de instância que os administradores e desenvolvedores da Cloud Kicks usam.
• Como os arquivos de esquema funcionam e com quais arquivos de esquema ela precisa estar familiarizada.
• Como o B2C Commerce lida com a validação de dados.

Linda descobre que a Cloud Kicks importa e exporta os tipos de dados de loja abaixo.

Os processos da Cloud Kicks são simples e seus sistemas externos suportam a estrutura de arquivos do B2C Commerce. Isso significa que Linda pode usar o processo manual de importação/exportação do Business Manager para a maioria das coisas. No entanto, a Cloud Kicks mantém catálogos de preços grandes e complexos em um sistema PIM (gerenciamento de informações de produto) de terceiros que ela atualiza com frequência. Assim, em vez de usar o processo de importação do Business Manager, a Cloud Kicks usa o recurso Catálogos de preços somente leitura para importar seus dados de preço. Esse recurso torna as transferências em massa muito mais eficientes.

O B2C Commerce oferece aos clientes quatro tipos de instâncias: sandbox, preparação, desenvolvimento e produção. As instâncias sandbox são onde os desenvolvedores trabalham, ou seja, Linda só usa uma instância de sandbox quando trabalha com um desenvolvedor para editar ou criar um novo processo de importação ou exportação. Depois de testar o novo processo, o desenvolvedor o move da sandbox para a instância de preparação para ela usar.

Linda usa as instâncias de preparação e desenvolvimento para importar e exportar dados da loja. A fase de preparação é onde ela se prepara para a transferência de dados. Depois de testar os dados e o código da loja na preparação, ela os replica primeiro na instância de desenvolvimento e, em seguida, na instância de produção. Ela usa a instância de desenvolvimento para verificar se a transferência foi bem-sucedida antes efetuar push para a produção.

O arquivamento e a limpeza de registros é um passo importante e final no processo de importação. Uma vez por semana, Linda usa processos manuais para arquivar os arquivos XML anteriores e eliminar arquivos antigos e dados desnecessários. Quando ela exclui o registro de uma importação que realizou no Business Manager, ela remove automaticamente o arquivo de registro relacionado.

Linda descobre que os esquemas do B2C Commerce são uma grande parte do que faz a importação e exportação acontecerem. Os esquemas são um conjunto de arquivos XSD específicos de objetos que definem como os arquivos de importação e exportação XML precisam ser estruturados. O B2C Commerce só aceita arquivos de importação XML formatados por esses esquemas. Quando a Linda importa um arquivo manualmente pelo Business Manager, o B2C Commerce valida-o automaticamente em relação ao seu respectivo esquema.

A Cloud Kicks trabalha com um parceiro para configurar os sistemas externos a fim de produzir os arquivos XML na estrutura exigida pelo esquema. Linda se familiariza com os trabalhos externos que produzem arquivos de importação para que ela possa acomodar mudanças. Por exemplo, às vezes os esquemas mudam e ela precisa saber como a mudança afeta seus processos de importação ou exportação.

O B2C Commerce exporta automaticamente arquivos no formato XML adequado, exceto para códigos de cupom, que ele exporta para o formato CSV.

Estes são os arquivos de esquema aos quais ela presta muita atenção:

• catalog.xsd
• coupon.xsd
• couponredemption.xsd
• customer.xsd
• customeractivedata.xsd
• order.xsd
• pricebook.xsd

Como mencionamos, quando Linda importa um arquivo manualmente pelo Business Manager, a validação de dados em relação ao esquema é automática. Se ela usa outra maneira de importar dados, por exemplo, programaticamente, ela precisa pedir a um desenvolvedor para ajudá-la a validar os dados programaticamente.

Às vezes, os usuários criam dados manualmente no Business Manager, por exemplo, quando Traude Beck, a comerciante, adiciona detalhes aos dados do produto. Se os detalhes do produto dela não seguirem o esquema, os dados serão inválidos e a exportação (e talvez até mesmo os backups noturnos) falhará. Para fazer a exportação funcionar, Linda precisa pedir a Traude para editar os dados a fim de poder tentar a exportação novamente.

A maioria dos esquemas do B2C Commerce especificam que os elementos de esquema são opcionais. Isso significa que Linda só precisa incluir os elementos que ela quer em cada arquivo XML que usa para importar. No entanto, ela também precisa garantir a inclusão de eventuais elementos dependentes. Por exemplo, se ela importa dados de produtos em "tênis de plataforma", ela precisa incluir todas as categorias às quais eles estão atribuídos. Se ela esquecer de incluir uma (por exemplo, a categoria "plataforma") na importação, o B2C Commerce ignorará essa atribuição da categoria e a informará no log de erros.

Vamos dar uma olhada mais de perto em alguns elementos agora, para que você possa ver do que estamos falando.

Aprendemos que os esquemas fornecem as regras e o arquivo XML resultante contém os dados, esperamos que no formato correto.

As regras do esquema levam em consideração a natureza de determinado objeto e seus atributos. Isso lhe dá controle granular sobre dados específicos de objetos e ajuda você a entender melhor seus dados. É aí que entram elementos e atributos. Elementos são objetos de dados e atributos descrevem esses objetos. Por exemplo, catalog.xsd — lembre-se, este é o esquema do catálogo — inclui elementos de categoria e produto.

Este é um exemplo de um elemento de categoria em um arquivo XML gerado de um esquema de catálogo.

<category category-id="womens-shoes-sandals">
    <display-name xml:lang="x-default">Sandals</display-name>
    <online-flag>true</online-flag>
    <parent>womens-shoes</parent>
    <template/>
    <page-attributes/>
</category>

O atributo de nome de exibição é o nome da categoria que é exibida na loja. O atributo de sinalizador online, definido como verdadeiro, significa que a categoria está visível na loja. O atributo pai nomeia a categoria pai da subcategoria womens-shoes-sandals.

Este é um exemplo de elemento de produto em um arquivo XML.

<product product-id="008884303989">
    <ean/>
    <upc>008884303989</upc>
    <unit/>
    <searchable-flag>true</searchable-flag>
    <tax-class-id>standard</tax-class-id>
    <page-attributes/>
    <custom-attributes>
         <custom-attribute attribute-id="color">navy</custom-attribute>
         <custom-attribute attribute-id="size">007</custom-attribute>
         <custom-attribute attribute-id="width">N</custom-attribute>
    </custom-attributes>
    <pinterest-enabled-flag>false</pinterest-enabled-flag>
    <facebook-enabled-flag>false</facebook-enabled-flag>
</product>

O atributo upc indica o código universal do produto (UPC). Outros atributos incluem searchable-flag e tax-class-id, nesse caso, definido como padrão.

Em seguida, Linda se familiariza com algumas regras importantes de importação/exportação para os três elementos mais comuns com os quais trabalha: categoria, produto e pedido.

Nesta unidade, Linda aprendeu sobre os tipos de dados com que lida em importação/exportação, os tipos de instâncias, os arquivos de esquema e como o B2C Commerce valida os dados. Em seguida, ela aprenderá a usar modos em processos globais e específicos de importação e exportação.

• Trailhead: Arquitetura do Salesforce B2C Commerce
• Trailhead: Documentação de projeto para arquitetos funcionais do Salesforce B2C Commerce
• Ajuda: Importação e exportação

Sempre que possível, alteramos termos não inclusivos para estarmos alinhados com o valor de Igualdade da nossa empresa. Mantivemos certos termos para evitar determinados efeitos nas implementações dos clientes.