Skip to main content
Bring your team and maximize your impact at Dreamforce. Register three or more to unlock $999 passes.

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 Agentforce Commerce for B2C foi elaborado para lidar com dados da loja (virtual).

Introdução

Você está quase pronto para usar o recurso de importação/exportação no Business Manager. Porém, antes de fazer isso, você precisa entender totalmente como os modos funcionam. Além dos esquemas, os modos são o aspecto mais importante da função de importação/exportação.

Comparar 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. Esta tabela lista cada modo e sua função.

Com este modo...

Isto acontece...

Merge (Mesclar)

Se os dados não existirem, o Business Manager adicionará novos dados.

Se os dados existirem, o Business Manager atualizará os dados existentes.

Atualização

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.

Excluir

O Business Manager remove os dados no arquivo XML do banco de dados. Você só precisa fornecer a ID do objeto no arquivo XML. O Business Manager ignora os outros atributos do objeto.

Para entender como os modos funcionam, considere este cenário: um anunciante sênior pede sua ajuda em alterações em produtos e atributos. O anunciante quer adicionar uma sinalização do Pinterest a alguns produtos como teste. Anteriormente, ele testou uma sinalização do Facebook e agora quer remover esse atributo.

Você cria uma tabela das mudanças e escolhe qual modo usar. As alterações envolvem os objetos T-123440 a T-123445. Na tabela, as letras A a F abreviam as alterações no banco de dados. Por exemplo, o produto T-1234440 já está no banco de dados e o anunciante 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

Atualização

A, B, C, E, F1

Replace (Substituir)

A1, B, C, D, E, F1

Excluir

E

Você verá que os modos por si só não oferecem suporte à alteração B1 - Delete attribute (B1 - Excluir atributo). É por isso que você ainda vê B, não B1, após a importação. Para remover o atributo de sinalização do Facebook, altere o valor do atributo no arquivo XML para nenhum ou em branco e, em seguida, importe com o modo de mesclagem ou atualização.

  • No modo de exclusão, o Business Manager exclui todos os objetos na importação, mesmo que não haja alterações.
  • No modo de atualização, o Business Manager não adiciona novos dados ao banco de dados.
  • Para que o Business Manager remova objetos, adicione-os ao arquivo XML.

Uma maneira de excluir objetos é criar um arquivo XML que contenha apenas os objetos que você deseja excluir e, em seguida, importá-los usando o modo de exclusão. A outra maneira é especificar o modo de importação de exclusão no nível do objeto no feed XML. Abordaremos essa opção a seguir.

Modos para elementos

Os anunciantes da loja (virtual) querem que você atualize o catálogo com três novos produtos e exclua dois produtos ao mesmo tempo. Para isso, você especifica modos para elementos individuais dentro de um arquivo XML. Um modo no nível do elemento substitui o modo de importação global.

Você 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"/>

Você lista novos produtos sem um modo individual e os produtos a serem excluídos com o modo de exclusão. Em seguida, você executa a importação com o modo de mesclagem. Você não usa o modo de atualização porque ele exclui os dois produtos, mas não adiciona os novos.

Gerenciar a importação e exportação de catálogos

Os recursos de importação/exportação do Commerce for B2C são projetados para lidar com complexidades de dados da loja (virtual), por exemplo, o tipo de catálogo. Isso é importante porque é uma melhor prática do Commerce for B2C para usar dois catálogos: loja (virtual) e produto. O catálogo da loja (virtual) é o que você exibe na sua loja; já o catálogo de produtos representa o que você importa do seu PIM externo.

Importação de catálogo

Anteriormente, você adicionou e excluiu produtos e atributos específicos. Você 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 (virtual) 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 e 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

Você exporta dados de produtos selecionados ou do catálogo inteiro a partir do Business Manager. Quando você usa a configuração Export Specific Products (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 Commerce for B2C 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 Commerce for B2C 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.

Atualização

  • Após a confirmação da transação, o Business Manager atualiza cada linha da tabela do catálogo de preços em uma única transação. A transação torna o novo preço visível na loja (virtual).
  • Você não pode mudar a moeda de um catálogo de preços.

Replace (Substituir)

  • Após a conclusão da transferência, o Business Manager carrega o catálogo de preços inteiro em uma única transação e exibe os novos preços na loja (virtual). 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.

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.

É 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, você aprendeu a usar modos para importação e exportação global e específica de elementos. Você também aprendeu que o Commerce for B2C lida com processos de importação e exportação em relação ao tipo de objeto. Em seguida, saiba como configurar e executar processos de importação e exportação.

Recursos

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