Skip to main content
Join the Agentforce Hackathon on Nov. 18-19 to compete for a $20,000 Grand Prize. Sign up now. Terms apply.

Entender os modos de importação

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:
  • 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.

Modos de mesclagem: mesclar, atualizar, substituir e excluir

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)
  • Você não pode mudar a moeda de um catálogo de preços.
Update (Atualizar)
  • O Business Manager atualiza cada linha na tabela do catálogo de preços em uma transação e deixa o novo preço visível na vitrine assim que a transação é confirmada.
  • Você não pode mudar a moeda de um catálogo de preços.
Replace (Substituir)
  • O Business Manager carrega todo o catálogo de preços em uma transação e exibe os novos preços na loja assim que a transferência é concluída. Se o preço de um item de linha mudar após o carregamento do catálogo de preços, o novo preço também ficará visível no carrinho.
  • Você pode alterar a moeda de um catálogo de preços.
Delete (Excluir)
  • Quando você importa um catálogo de preços, o Business Manager exclui todo o catálogo de preços em vez de apenas as atribuições de preço de SKUs listadas no XML.
Todos
  • A importação de catálogos de preços ignora os catálogos de preços que contêm um valor negativo de montante ou quantidade. O problema é relatado no log de importação.
  • A importação de catálogos de preços rejeita catálogos de preços com moedas desconhecidas. O sistema informa um aviso de dados.

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.

Compartilhe seu feedback do Trailhead usando a Ajuda do Salesforce.

Queremos saber sobre sua experiência com o Trailhead. Agora você pode acessar o novo formulário de feedback, a qualquer momento, no site Ajuda do Salesforce.

Saiba mais Continue compartilhando feedback