Você está aqui:
Importação/exportação de objetos de slot de conteúdo no B2C Commerce
Usando Business Manager, importe as configurações de slots de conteúdo existentes para usar com uma nova instância e exporte-as para transferência entre instâncias. Os slots em si não são importados ou exportados, mas os modelos de página os definem (em UX Studio). As configurações de slot apenas fazem referência a esses slots (usando o ID do slot). Em Business Manager, os elementos no slot.xsd controlam a visibilidade de um slot.
Uma configuração de slot pode pertencer a zero ou um site. Uma configuração de slot que não pertence a um site é como uma parte reutilizável para o site usar. Você pode atribuir uma configuração de slot a nenhuma campanha ou promoção ou a uma campanha ou promoção. Os elementos de planificação, classificação e qualificador fazem parte das atribuições.
| Elementos ou atributos | Impacto |
|---|---|
| <slot-configuration> | Ao importar um elemento <slot-configuration> no modo MERGE, o sistema verifica se existe uma configuração de slot existente com o mesmo ID no domínio do site atual. Em caso afirmativo, o processo de importação atualiza o existente; Caso contrário, o processo de importação criará um. |
| <rank>, <schedule> ou <customer-groups> | Se o arquivo de importação incluir qualquer um dos elementos descontinuados <rank>, <schedule> ou <customer-groups>, o sistema poderá atualizá-los somente se houver um SlotConfigurationAssignment explícito entre a configuração de slot e o site. Se houver, o processo de importação atualizará esses atributos da atribuição. Se não houver, a lógica de importação registrará uma advertência. |
| <slot-configuration-assignment> | Ao importar um elemento <slot-configuration-assignment> no modo MERGE, o sistema verifica se existe uma atribuição existente. A verificação é feita entre a configuração de slot especificada (identificada por uma chave composta que consiste em slot-id, context, context-id e configuration-id) e o site atual (derivado do contexto de importação/exportação, não especificado no arquivo). Se uma atribuição existir, ela será atualizada; Caso contrário, o sistema criará um. |
| <slot-configuration-campaign-assignment> | Ao importar um elemento <slot-configuration-campaign-assignment> no modo MERGE, o sistema verifica se existe uma atribuição existente entre a configuração de slot especificada e a campanha (especificada por campaign-id). Se uma atribuição já existir, ela será atualizada; caso contrário, uma será criada. Se você executar a importação em um modo de importação diferente, a semântica modificada comum será aplicada. |
| <mode> | Existe um novo atributo mode no elemento <slot-configuration> existente. Esse atributo de modo é usado para excluir objetos individuais sem fazer uma importação completa do modo DELETE. O elemento <slot-configuration> oferece um comportamento especial de curinga para exclusão. Você pode omitir o context, context-id e configuration-id no modo de exclusão. Use essa técnica para excluir várias configurações de slot simultaneamente. |
| <slot-configuration-assignment> e <slot-configuration-campaign-assignment> | Os novos elementos <slot-configuration-assignment> e <slot-configuration-campaign-assignment> aceitam um modo de exclusão, mas não uma exclusão curinga, tal como descrito anteriormente. Com esse método, exclua somente uma atribuição por vez. Por conta disso, os atributos context, context-id e configuration-id são obrigatórios para esses elementos. |
Localização de importação no Business Manager
Pipelets
- ImportSlots
- ExportSlots
Importar configurações do slot de conteúdo
Importe as configurações do slot do B2C Commerce.
-
Clique em Iniciador de Aplicações
e, em seguida, selecione .
- Na seção Slot de conteúdo, clique em Importar.
- Selecione um arquivo de importação na lista e clique em Próximo>>.
-
O B2C Commerce valida o arquivo de esquema.
- Se a validação do arquivo de esquema não tiver êxito, examine o arquivo quanto a erros e comece novamente.
- Se a validação for bem-sucedida, clique em Próximo>>.
-
Selecione um modo de importação:
Mesclar Atualiza os objetos de bancos de dados existentes e cria objetos com base no arquivo XML de importação. Atualizar Atualiza apenas objetos de banco de dados existentes (não cria novos). Substituir Exclui e depois recria os objetos de banco de dados existentes; cria objetos com base no arquivo XML de importação. Excluir Exclui configurações de slot referenciadas no arquivo; os slots superiores não são excluídos. -
Clique em Importar.
A página Importação e exportação é exibida novamente, onde você pode monitorar o estado da tarefa de importação.
Modos de importação de slots de conteúdo no B2C Commerce
Saiba como os modos de importação DELETE, UPDATE, MERGE e REPLACE alteram as configurações de slot de conteúdo quando você importa um arquivo de slot de conteúdo e como diagnosticar resultados de importação inesperados.
- Exportação: insira um nome de arquivo válido (sem caracteres especiais). Se o nome do arquivo não terminar em ".xml", o sistema anexará a extensão.
- Importação: selecione um arquivo de importação na lista. O sistema executa uma validação. Após a validação, o usuário pode selecionar um modo de importação: DELETE, UPDATE, MERGE e REPLACE.
A tabela a seguir descreve o comportamento da importação:
| Modo | Elemento/situação | Comportamento |
|---|---|---|
| DELETE | Configurações de slot | Se referenciado no arquivo, o sistema o exclui do banco de dados. |
| Se você especificar apenas um slot-id | Todas as configurações de slot para o slot com esse ID são excluídas. | |
| Se você especificar um slot-id e contexto | Todas as configurações de slot para o slot com o mesmo contexto são excluídas. | |
| Se você especificar slot-id, context e context-id | O sistema exclui todas as configurações de slot para o slot nesse contexto, com esse context-id. | |
| Se um slot-id, context, context-id e configuration-id forem todos especificados | O sistema exclui a configuração de um slot para o slot nesse contexto, com esse nome, se existir. | |
| Se um context, context-id ou configuration-id forem especificados, mas não o slot-id | O sistema ignora o elemento ausente com um aviso. | |
| UPDATE | Modo UPDATE padrão | O sistema atualiza as configurações de slot existentes referenciadas no arquivo. |
| Se o slot-id, context, context-id e configuration-id corresponderem a uma configuração de slot | Somente os elementos especificados resultam em propriedades atualizadas dessa configuração. | |
| Se o slot-id, context, context-id e configuration-id não corresponderem a uma configuração de slot | O sistema ignora o elemento com um aviso. | |
| Se você especificar várias configurações de slot como padrão. | A última configuração de slot é definida como o padrão e um aviso é exibido no log. | |
| MERGE | Modo MERGE padrão | O sistema atualiza as configurações de slot existentes referenciadas no arquivo e insere todas as novas configurações de slot no arquivo. Os padrões para as propriedades MERGE opcionais são:
|
| Para o caso de atualização | O mesmo comportamento do modo UPDATE. As propriedades obrigatórias são: slot-id, context, context-id, configuration-id e template. |
|
| Para o caso de inserção | Forneça todas as propriedades necessárias ou o sistema ignorará a configuração do slot com um aviso. | |
| Se você especificar várias configurações padrão | A última configuração de slot é definida como o padrão e um aviso é exibido no log. | |
| REPLACE | Modo REPLACE padrão | O mesmo que para o modo MERGE, exceto que a atualização das configurações de slots existentes é como se elas fossem importadas primeiro no modo DELETE. Isso significa que o sistema exclui a configuração de slot existente e insere uma nova com os dados fornecidos. O sistema reutiliza o local onde a configuração do slot foi armazenada. |
| Se elementos de propriedades de elementos opcionais não forem especificados | Os padrões entram em vigor, mesmo que os valores padrão sejam diferentes dos valores na configuração de slot que está sendo substituída. | |
| Se você especificar várias configurações padrão | A última configuração de slot é definida como o padrão e um aviso é exibido no log. |
Solução de problemas na importação de slots
Se uma importação produzir resultados inesperados, verifique o arquivo em relação a estas condições:
- Você executou uma importação de configurações de slot com referências a slots que não estão no modelo? Talvez você obtenha uma advertência de dados, mas as configurações do slot ainda são importadas como marcadores de posição.
- Você tinha configurações de slot com referências a slots no modelo, mas os slots foram removidos dos modelos depois? Essas configurações de slot não aparecem no Business Manager.
Exportar configurações de slots de conteúdo
Exporte configurações de slots de conteúdo do B2C Commerce.
-
Clique em Iniciador de Aplicações
e, em seguida, selecione .
- Na seção slot de conteúdo, clique em Exportar.
- Insira um nome para o arquivo de exportação. Se você não inserir o sufixo .xml, ele será adicionado automaticamente.
-
Clique em Concluir para enviar a tarefa.
A página Marketing online > Importação e exportação é reexibida. O estado da tarefa é exibido na seção Estado da página.
-
Para exibir o arquivo de log da tarefa, clique no link Processar na seção
Estado. -
Na página que é aberta, clique no link Fazer download do arquivo de exportação na seção
Exportar arquivopara fazer download do arquivo de exportação para sua máquina local.
