Skip to main content
The Trailblazer Community will undergo maintenance on Saturday, November 15, 2025 and Sunday, November 16, 2025. Please plan your activities accordingly.

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