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

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

Listar três objetos de dados que você pode transferir por meio do processo de importação/exportação.
Explicar o propósito dos arquivos XSD do Agentforce Commerce for B2C.
Explicar um benefício de usar o recurso Catálogos de preços somente leitura.
Explicar dois benefícios de arquivos de esquema específicos de objetos.
Explicar como você usa instâncias para implementar dados de loja.

O Commerce Cloud passou a se chamar Agentforce Commerce, e o B2C Commerce passou a se chamar Agentforce Commerce for B2C. Você pode ver referências ao Commerce Cloud e ao B2C Commerce em nossos aplicativos e documentação.

Você é administrador do Commerce for B2C. Sua principal responsabilidade é o gerenciamento de dados. Mais especificamente, você precisa gerenciar a transferência de dados da loja (virtual) entre sistemas externos e o Commerce for B2C. Você também precisa ajudar a mover dados de configuração do site e definições de uma instância para outra a fim de ativar novas instâncias de desenvolvedor.

Sua empresa desenvolve detalhes do catálogo, como SKUs, descrições de produtos, tamanhos, imagens e preços, em um sistema de registro. Você usa processos de importação para transferir esses dados para o Agentforce Commerce for B2C. Enquanto isso, sempre que os compradores criam pedidos, resgatam cupons e muito mais no Commerce for B2C, você garante que os dados vão para um sistema externo de processamento. Para essa transação, você usa processos de exportação.

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

Nesta unidade, você aprende alguns conceitos básicos sobre como o Commerce for B2C lida com importação e exportação. Posteriormente, você colocará os conceitos em prática enquanto experimenta processos acionados manualmente ou em lote e importação/exportação de sites com o Commerce for B2C.

Antes de experimentar os recursos de importação/exportação de sites no Commerce for B2C, é importante saber:

Os tipos de dados que sua empresa importa e exporta.
Os tipos de instâncias que os administradores e desenvolvedores do Commerce B2C usam.
Como os arquivos de esquema funcionam e com quais arquivos de esquema você precisa estar familiarizado.
Como o Commerce for B2C lida com a validação de dados.

Importação/exportação de dados de loja

Sua empresa importa e exporta esses tipos de dados de loja (virtual).

Importações	Exportações
Dados ativos	Resgates de cupons
Catálogo	Registros de cliente
Cupons	Pedidos
Novos pedidos O Commerce for B2C não importa dados que atualizam pedidos existentes. O processo de importação de pedidos ignora esses dados.
Catálogos de preços

Seus processos são simples e seus sistemas externos são compatíveis com a estrutura de arquivos do Agentforce Commerce for B2C. Isso significa que você usa o processo manual de importação/exportação do Business Manager para a maioria das coisas. No entanto, sua empresa mantém catálogos de preços grandes e complexos em um sistema PIM (gerenciamento de informações de produto) de terceiros que é atualizado com frequência. Assim, em vez de usar o processo de importação do Business Manager, você usa o recurso Read-Only Price Books (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.

Importação para preparação

O Commerce for B2C oferece aos clientes quatro tipos de instâncias: sandbox, preparação, desenvolvimento e produção. As instâncias de sandbox são onde os desenvolvedores trabalham. Use uma instância de sandbox ao trabalhar com um desenvolvedor para editar ou criar um processo de importação ou exportação. Após testar o novo processo na instância de sandbox, o desenvolvedor move-o dessa instância para a instância de preparação para você usá-lo.

Você usa as instâncias de preparação e desenvolvimento para importar e exportar dados da loja (virtual). A instância de preparação é onde você se prepara para a transferência de dados. Depois de testar os dados e o código da loja (virtual) na preparação, você os replica primeiro na instância de desenvolvimento e, em seguida, na instância de produção. Convém verificar se o ambiente de preparação reflete fielmente seu ambiente de produção. Você usa a instância de preparação 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, você 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, você remove automaticamente o arquivo de registro relacionado.

Explorar arquivos do esquema

Os esquemas do Commerce for B2C 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 Commerce for B2C só aceita arquivos XML de importação formatados de acordo com esses esquemas. Quando você importa um arquivo manualmente pelo Business Manager, o Commerce for B2C valida-o automaticamente em relação ao seu respectivo esquema.

Sua empresa trabalha com um parceiro para configurar os sistemas externos a fim de produzir os arquivos XML na estrutura exigida pelo esquema. Familiarize-se com os trabalhos externos que geram arquivos de importação para que você possa lidar com eventuais mudanças. Por exemplo, às vezes os esquemas mudam e você precisa saber como a mudança afeta seus processos de importação ou exportação.

O Commerce for B2C 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 se deve prestar muita atenção:

catalog.xsd
coupon.xsd
customer.xsd
order.xsd
pricebook.xsd

Validar e estruturar dados de importação

Como mencionamos, quando você importa um arquivo manualmente pelo Business Manager, a validação de dados em relação ao esquema é automática. Se você usa outra maneira de importar dados, por exemplo, programaticamente, peça a um desenvolvedor para ajudar você a validar os dados programaticamente.

Às vezes, os usuários criam dados manualmente no Business Manager, por exemplo, quando um anunciante adiciona detalhes aos dados do produto. Se os detalhes do produto 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, peça ao anunciante para editar os dados a fim de poder tentar a exportação novamente.

A maioria dos esquemas do Commerce for B2C especificam que os elementos de esquema são opcionais. Isso significa que você só inclui os elementos que quer em cada arquivo XML que usa para importar. Não se esqueça de incluir todos os elementos dependentes. Por exemplo, se você importa dados de produtos em "sapatos femininos", inclua todas as categorias às quais eles estão atribuídos. Se você esquecer de incluir uma (por exemplo, a categoria "corrida") na importação, o Commerce for B2C ignorará essa atribuição da categoria e a informará no log de erros.

A seguir, vamos dar uma olhada mais de perto nos elementos.

Analisar elementos e atributos

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

As regras do esquema levam em consideração a natureza de determinado objeto e seus atributos. Esse nível de detalhe dá a você controle granular sobre dados específicos de objetos e ajuda você a entender melhor seus dados. É aqui que entram elemento e atributos. Elementos são objetos de dados e atributos descrevem esses objetos. Por exemplo, catalog.xsd, 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 um elemento de um 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, conheça algumas regras importantes de importação/exportação para os três elementos mais comuns com os quais você trabalha: categoria, produto e pedido.

Elementos de categoria

Estas são algumas regras específicas de elementos a serem consideradas na importação de um elemento de categoria.

Os elementos de categoria podem aparecer em qualquer ordem no arquivo XML.
Use o modo de substituição para atualizar a categoria raiz de um catálogo. (Saiba mais sobre modos na próxima unidade.)
A exclusão de uma categoria exclui as atribuições da categoria (não os produtos dentro da categoria), os links da categoria (entrada e saída) e todas as subcategorias.
A importação define o nome de exibição e a descrição da categoria raiz para o nome de exibição e descrição do catálogo.

Elementos do produto

Estes são alguns detalhes específicos do elemento a serem considerados na importação de um elemento do produto.

Os elementos do produto podem aparecer em qualquer ordem no arquivo XML.
Os tipos de pacote, conjunto de produtos e produtos básicos são mutuamente exclusivos, de modo que os elementos de bundled-products, product-set-products e de variação também são mutuamente exclusivos.
Você não pode especificar variantes dos tipos de pacote, conjunto de produtos ou produtos básicos.
Um produto base tem seus produtos de variação e grupos de variação. Você pode alterar a propriedade de um produto base para outro em um único processo de importação.

Elementos de pedido

Você exporta pedidos da loja (virtual) e processa-os em um sistema de gerenciamento de pedidos. O Commerce for B2C lida automaticamente com detalhes específicos do pedido, como status do pedido, números mascarados de cartão de crédito, reversão e devolução.

Para enviar números completos de cartões de crédito a um sistema de processamento externo, um desenvolvedor usa o pipelet ExportOrders configurado com uma chave de criptografia para exportar dados criptografados de cartões de crédito. O sistema externo é responsável pelas implementações de descriptografia e processamento.

A seguir

Nesta unidade, você aprendeu sobre os tipos de dados com os quais você lida em importação/exportação, os tipos de instâncias, os arquivos de esquema e como o Commerce for B2C valida os dados. Em seguida, saiba como usar modos em processos globais e específicos de importação e exportação.

Tempo estimado

Tópicos

Procurando ajuda?