Entender os modos de importação
Objetivos de aprendizagem
- Explicar o propósito dos modos de importação.
- Listar dois modos que adicionam novos objetos por meio da importação.
- Descrever como você pode excluir dados usando importação.
- Explicar as duas maneiras gerais para você importar ou exportar dados.
- Descrever como o Salesforce B2C Commerce foi elaborado para lidar com dados da loja.
Introdução
Linda Rosenberg, a nova administradora da Cloud Kicks, está quase pronta para usar a funcionalidade de importação/exportação no Business Manager. Seu gerente pede que ela espere até entender completamente como os modos funcionam. Além dos esquemas, os modos são o aspecto mais importante da função de importação/exportação.
Modos
Enquanto os esquemas definem as regras de estrutura de arquivos de dados, os modos definem o que acontece com os dados na importação. Estes são os modos.
Veja o que cada um faz.
Com este modo... | Isto acontece... |
---|---|
Merge (Mesclar) | O Business Manager adiciona novos dados se eles não existirem e atualiza os dados existentes. |
Update (Atualizar) | O Business Manager atualiza os dados existentes, mas não adiciona novos dados. Ele atualiza apenas os atributos que estão no arquivo XML. |
Replace (Substituir) | O Business Manager recria os dados existentes ou adiciona novos dados conforme os dados no arquivo XML. O Business Manager remove atributos existentes que não estão no arquivo XML. Este modo é o mesmo que uma exclusão seguida de uma mesclagem. |
Delete (Excluir) | O Business Manager remove os dados no arquivo XML do banco de dados. Você só precisa fornecer o ID do objeto no arquivo XML. O Business Manager ignora os outros atributos do objeto. |
A comerciante sênior Traude Beck pede a Linda para ajudá-la com as mudanças de produto e atribuição. Traude quer adicionar uma sinalização do Pinterest a alguns produtos como teste. Anteriormente, ela testou uma sinalização do Facebook e agora quer remover esse atributo.
Linda cria uma tabela das mudanças que Traude quer para que ela possa escolher qual modo usar. As alterações de Traude envolvem os objetos T-123440 a T-123445. Na tabela, as letras A a F são uma forma de abreviar as alterações no banco de dados. Por exemplo, o produto T-1234440 já está no banco de dados, e Traude quer adicionar o atributo pinterest-enabled-flag true a ele.
A representa o produto no banco de dados:
<product product-id="T-123440">
A1 representa o produto mais a alteração de atributo:
<product product-id="T-123440"> <pinterest-enabled-flag>true</pinterest-enabled-flag>
Mudar | Já no banco de dados | Produto (objeto) | Atributo |
---|---|---|---|
A1 - Adicionar atributo | Sim | <product product-id="T-123440"> | <pinterest-enabled-flag>true</pinterest-enabled-flag> |
B1 - Excluir atributo | Sim | <product product-id="T-123441"> | <facebook-enabled-flag>true</facebook-enabled-flag> |
C - Sem mudança | Sim | <product product-id="T-123442"> | |
D - Novo produto | Não | <product product-id="T-123443"> | |
E - Não está no arquivo XML | Sim | <product product-id="T-123444"> | |
F1 - Alterar atributo | Sim | <product product-id="T-123445"> |
Change: <pinterest-enabled-flag>false</pinterest-enabled-flag> To: <pinterest-enabled-flag>true</pinterest-enabled-flag> |
Para cada modo, isso é o que acabaria no banco de dados.
Pré-importação | No arquivo XML | Modo de importação | Pós-Importação |
---|---|---|---|
A, B, C, E, F | A1, B1, C, D, F1 | Merge (Mesclar) | A1, B, C, D, E, F1 |
Update (Atualizar) | A, B, C, E, F1 | ||
Replace (Substituir) | A1, B, C, D, E, F1 | ||
Delete (Excluir) | E |
Linda vê que os modos sozinhos não permitem que ela faça a alteração de atributo B1 - Excluir listada em sua tabela. É por isso que ela ainda vê B, não B1, após a importação. Para remover o atributo de sinalização do Facebook, ela precisa alterar o valor do atributo no arquivo XML para nenhum ou em branco e, em seguida, importar com o modo de mesclagem ou atualização.
Para o modo de exclusão, todos os objetos na importação são excluídos, mesmo que, como em C, não haja alteração.
Para o modo de atualização, o Business Manager não adiciona D ao banco de dados. Por quê? Porque o modo de atualização não adiciona novos dados.
O Business Manager não remove E em nenhum desses cenários porque nada acontece com objetos que não estão no arquivo XML.
Uma maneira de Linda excluir objetos é criar um arquivo XML que contenha apenas os objetos que ela deseja excluir e, em seguida, importá-los usando o modo de exclusão. A outra maneira de excluir objetos é especificar o modo de importação de exclusão no nível do objeto no feed XML. Falaremos sobre isso a seguir.
Modos para elementos
Traude pede ajuda a Linda mais uma vez. Dessa vez, ela quer que Linda atualize o catálogo com três novos produtos e exclua dois produtos ao mesmo tempo. Para isso, Linda especifica modos para elementos individuais dentro de um arquivo XML. Um modo no nível do elemento substitui o modo de importação global.
Linda cria um arquivo XML que contém ambos os tipos de produtos.
<product product-id="T-555361"/> <product product-id="T-367822"/> <product product-id="T-622977"/> <product product-id="T-536378" mode="delete"/> <product product-id="T-638353" mode="delete"/>
Ela lista novos produtos sem um modo individual e os produtos a serem excluídos com o modo de exclusão. Em seguida, ela executa a importação com o modo de mesclagem. Ela não usa o modo de atualização porque ele excluiria os dois produtos, mas não adicionaria os novos.
Importação/exportação de catálogo
Linda percebe rapidamente que os recursos de importação/exportação do B2C Commerce são projetados para lidar com complexidades de dados da loja, por exemplo, o tipo de catálogo. Isso é importante porque é uma prática recomendada do B2C Commerce usar dois catálogos: loja e produto. É exatamente assim que a Cloud Kicks estrutura seus catálogos! O catálogo de loja é o que eles exibem em sua loja; já o catálogo de produto representa o que eles importam de seu PIM externo.
Importação de catálogo
Anteriormente, Linda adicionou e excluiu produtos e atributos específicos. Ela também pode importar um catálogo inteiro de uma vez. Isso inclui o catálogo e eventuais categorias e dados de produtos dentro dele.
Com importação de catálogo:
- Você pode importar um catálogo de loja independentemente do catálogo de produto.
- Uma categoria de catálogo de loja pode referenciar os produtos nessa categoria.
- As importações de outros catálogos de loja não afetam as atribuições existentes de produtos/categorias.
- As importações de atualização de produtos do catálogo de produto não afetam as atribuições de categoria nos catálogos de loja.
- A semântica da importação de catálogos considera os catálogos de produto e loja como unidades de dados independentes, isoladas umas das outras, para que você possa importar uma sem excluir a estrutura de dados da outra.
- O Business Manager atualiza o status online/offline com base em um produto ser novo ou existente e no modo que é usado. Por exemplo, ele define automaticamente novos produtos importados nos modos mesclar e substituir como offline se você não especifica o status no arquivo de importação.
Exportação de catálogo
Linda pode exportar dados sobre produtos selecionados do Business Manager ou de todo o catálogo. Quando Linda usa a configuração Exportar produtos específicos, o arquivo resultante contém apenas uma lista de produtos selecionados e as atribuições de categoria para esses produtos.
Durante a exportação, o B2C Commerce apara automaticamente os espaços em branco anteriores e posteriores e remove eventuais caracteres de nova linha salvos anteriormente em um caminho de imagem do produto.
Processamento específico do objeto
O B2C Commerce usa regras específicas de objetos particulares ao processar importações e exportações para tipos de objetos, por exemplo, cupons, clientes, pedidos e catálogos de preços. Vejamos, por exemplo, como ele lida com as importações de catálogos de preços.
Modo | Processamento de especificidades de catálogos de preços |
---|---|
Merge (Mesclar) |
|
Update (Atualizar) |
|
Replace (Substituir) |
|
Delete (Excluir) |
|
Todos |
|
Linda aprendeu rápido que é importante considerar tanto o modo quanto o tipo de objeto na criação de arquivos XML de importação e exportação.
Próximas etapas
Nesta unidade, Linda aprendeu a usar modos para importação e exportação global e específica de elementos. Ela também aprendeu que o B2C Commerce lida com processos de importação e exportação em relação ao tipo de objeto. Em seguida, ela aprenderá a configurar e executar processos de importação e exportação.