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) |
|
Atualização |
|
Replace (Substituir) |
|
Excluir |
|
Todos |
|
É 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