Guia da interface de preparação de dados

Este documento fornece instruções sobre como usar as funções de preparação de dados na interface do usuário do Adobe Experience Platform para mapear arquivos CSV para um esquema XDM.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes da Platform:

Detalhes do fluxo de dados

Antes de mapear os dados CSV para um esquema XDM, primeiro estabeleça os detalhes do fluxo de dados.

A página Detalhes do fluxo de dados permite selecionar se você deseja assimilar os dados CSV em um conjunto de dados de destino existente ou em um novo conjunto de dados de destino. Um conjunto de dados existente vem com um esquema de destino pré-criado para mapear seus dados, enquanto um novo conjunto de dados exige que você selecione um esquema existente ou crie um novo esquema para mapear seus dados.

Usar um conjunto de dados de destino existente

Para assimilar seus dados CSV em um conjunto de dados existente, selecione Conjunto de dados existente. Você pode recuperar um conjunto de dados existente usando a opção Pesquisa avançada ou rolando pela lista de conjuntos de dados existentes no menu suspenso.

Com um conjunto de dados selecionado, forneça um nome para o fluxo de dados e uma descrição opcional.

Durante esse processo, você também pode habilitar o Diagnóstico de erro e a Assimilação parcial. O Diagnóstico de erro habilita a geração de mensagens de erro detalhadas para todos os registros incorretos que ocorrem no fluxo de dados, enquanto a Assimilação parcial permite assimilar dados que contêm erros, até um determinado limite definido manualmente. Consulte a visão geral da assimilação parcial de lotes para obter mais informações.

Usar um novo conjunto de dados de destino

Para assimilar seus dados CSV em um novo conjunto de dados, selecione Novo conjunto de dados e forneça um nome de conjunto de dados de saída e uma descrição opcional. Em seguida, selecione um esquema para mapear usando a opção Pesquisa avançada ou rolando pela lista de esquemas existentes no menu suspenso.

Com um esquema selecionado, forneça um nome para o fluxo de dados e uma descrição opcional e aplique as configurações de diagnóstico de erro e assimilação parcial desejadas para o fluxo de dados. Quando terminar, selecione Próximo.

Selecionar dados

A etapa Selecionar dados é exibida, fornecendo uma interface para carregar seus arquivos locais e pré-visualizar sua estrutura e conteúdo. Selecione Escolher arquivos para carregar um arquivo CSV do seu sistema local. Como alternativa, você pode arrastar e soltar o arquivo CSV que deseja carregar no painel Arrastar e soltar arquivos.

Depois que o arquivo for carregado, a interface de visualização será atualizada para exibir o conteúdo e a estrutura do arquivo.

Dependendo do arquivo, você pode selecionar um delimitador de coluna, como guias, vírgulas, barras verticais ou um delimitador de coluna personalizado para seus dados de origem. Selecione a seta suspensa Delimitador e selecione o delimitador apropriado no menu.

Quando terminar, selecione Próximo.

Mapeamento

A interface mapping fornece uma ferramenta abrangente para mapear campos de origem do esquema de origem para os campos XDM de destino apropriados no esquema de destino.

Noções básicas sobre a interface de mapeamento mapping-interface

A interface de mapeamento inclui um painel que fornece informações sobre a integridade dos campos de mapeamento no contexto do fluxo de trabalho de assimilação. O painel exibe os seguintes detalhes em relação aos campos de mapeamento:

A interface de mapeamento também fornece um painel de opções que você pode escolher para interagir ou filtrar melhor pelos campos de mapeamento.

Para procurar um conjunto de mapeamento específico, selecione Pesquisar campos de origem e insira o nome dos dados de origem que deseja isolar.

Selecione Todos os campos de origem para ver um menu suspenso de opções de filtragem para restringir melhor sua exibição da interface de mapeamento.

As opções de filtro são:

Selecione Campos com erros para ver todos os campos de mapeamento com erros.

Uma exibição isolada de campos de mapeamento incorretos é exibida, permitindo que você solucione erros por meio de recomendações de mapeamento inteligentes ou pela árvore de mapeamento manual.

Adicionar um novo tipo de campo

Você pode adicionar um novo campo de mapeamento ou um campo calculado selecionando Novo tipo de campo.

Novo campo de mapeamento

Para adicionar um novo campo de mapeamento, selecione Novo tipo de campo e Adicionar novo campo no menu suspenso exibido.

Em seguida, selecione o campo de origem que deseja adicionar da árvore de esquema de origem exibida e selecione Selecionar.

A interface de mapeamento é atualizada com o campo de origem selecionado e um campo de destino vazio. Selecione Mapear campo de destino para começar a mapear o novo campo de origem para seu campo XDM de destino apropriado.

Uma árvore de esquema de destino interativa é exibida, permitindo navegar manualmente pelo esquema de destino e localizar o campo XDM de destino apropriado para o campo de origem.

Quando terminar, selecione o ícone do esquema para fechar a interface do esquema de destino.

Campos calculados calculated-fields

Os campos calculados permitem que valores sejam criados com base nos atributos no esquema de entrada. Esses valores podem ser atribuídos a atributos no esquema de destino e receber um nome e uma descrição para facilitar a referência. Os campos calculados têm um comprimento máximo de 4096 caracteres.

Para criar um campo calculado, selecione Novo tipo de campo e Adicionar campo calculado

O painel Criar campo calculado é exibido. A caixa de diálogo à esquerda contém os campos, funções e operadores compatíveis com os campos calculados. Selecione uma das guias para começar a adicionar funções, campos ou operadores ao editor de expressão.

Você pode adicionar campos, funções e operadores manualmente usando o editor de expressão no centro. Selecione o editor para começar a criar uma expressão. Depois de concluir, selecione Salvar para continuar.

Importar mapeamento import

Você pode reutilizar o mapeamento de um fluxo de dados existente para reduzir o tempo de configuração manual de sua assimilação de dados e limitar erros. Selecione Importar mapeamento para reutilizar um mapeamento existente.

A janela Importar mapeamento é exibida, fornecendo uma lista de fluxos de dados para escolher.

Selecione o ícone de visualização para visualizar o mapeamento do fluxo de dados selecionado.

A janela de visualização permite inspecionar o mapeamento existente antes de importar para o fluxo de dados. Depois de verificar o mapeamento, você pode selecionar Voltar para retornar à lista de fluxos de dados e inspecionar outro conjunto de mapeamentos, ou pode selecionar Selecionar para continuar.

Como alternativa, você pode selecionar o mapeamento que deseja importar na janela da lista de fluxos de dados. Selecione o fluxo de dados que contém o mapeamento que você deseja importar e selecione Selecionar para continuar.

A interface é atualizada com o mapeamento importado.

Selecione Visualizar dados para ver os resultados do mapeamento de até 100 linhas de dados de amostra do conjunto de dados selecionado.

Durante a visualização, a coluna de identidade é priorizada como o primeiro campo, pois são as informações principais necessárias ao validar os resultados do mapeamento. Quando terminar, selecione Fechar.

Para remover todos os campos de mapeamento, selecione Limpar todos os mapeamentos.

Uso da interface de mapeamento

A Platform fornece recomendações inteligentes automaticamente para campos mapeados automaticamente com base no esquema ou conjunto de dados de destino selecionado. Você pode ajustar manualmente as regras de mapeamento para atender aos seus casos de uso ou corrigir campos de mapeamento duplicados para eliminar erros.

Selecione o ícone de lâmpada no campo de destino que você deseja ajustar.

O painel pop-up Recomendações de mapeamento é exibido, exibindo uma lista de campos de destino recomendados que podem ser mapeados para um campo de origem específico. Por padrão, a primeira recomendação é aplicada automaticamente.

Às vezes, mais de uma recomendação está disponível para o esquema de origem. Quando isso acontece, o cartão de mapeamento exibe a recomendação mais proeminente, seguida por um ícone que contém o número de recomendações adicionais disponíveis. Selecionar o ícone de lâmpada mostrará uma lista das recomendações adicionais. Você pode escolher uma das recomendações alternativas marcando a caixa de seleção ao lado da recomendação para a qual deseja mapear.

Aqui, você pode alterar o campo de destino selecionado para corrigir um erro ou corresponder ao seu caso de uso.

Como alternativa, você pode selecionar Selecionar manualmente para usar manualmente a árvore de mapeamento do esquema de destino interativo.

A interface de mapeamento do esquema de destino aparece na mesma exibição dos campos de mapeamento, permitindo modificar pares de mapeamento na mesma tela. Selecione o campo de destino que se ajusta ao seu caso de uso ou que corrige seus erros.

Quando terminar, selecione Concluir para continuar.

Próximas etapas

Ao ler este documento, você mapeou com êxito um arquivo CSV para um esquema XDM de destino usando a interface de mapeamento na interface da Platform. Consulte os seguintes documentos para obter mais informações: