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.
Este tutorial requer uma compreensão funcional dos seguintes componentes da Platform:
Você pode acessar os detalhes do fluxo de dados selecionando qualquer origem no catálogo de origens. Para obter mais informações, consulte visão geral das origens.
Antes de mapear os dados CSV para um esquema XDM, primeiro estabeleça os detalhes do fluxo de dados.
A variável 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.
Para assimilar dados CSV em um conjunto de dados existente, selecione Conjunto de dados existente. É possível recuperar um conjunto de dados existente usando 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 ativar Diagnóstico de erro e Assimilação parcial. Diagnóstico de erro permite a geração de mensagens de erro detalhadas para qualquer registro incorreto que ocorra em seu fluxo de dados, enquanto Assimilação parcial O 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.
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 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 a Diagnóstico de erro e Assimilação parcial as configurações desejadas para o seu fluxo de dados. Quando terminar, selecione Próxima.
A variável Selecionar dados é exibida, fornecendo uma interface para fazer upload dos arquivos locais e visualizar sua estrutura e conteúdo. Selecionar Escolher arquivos para carregar um arquivo CSV do seu sistema local. Como alternativa, você pode arrastar e soltar o arquivo CSV que deseja fazer upload na Arrastar e soltar arquivos painel.
No momento, somente arquivos CSV são compatíveis com o upload de arquivo local. O tamanho máximo para cada arquivo é de 1 GB.
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 o Delimitador e selecione o delimitador apropriado no menu.
Quando terminar, selecione Próxima.
A variável mapeamento A interface do fornece uma ferramenta abrangente para mapear campos de origem do esquema de origem para os campos XDM de destino apropriados no esquema de destino.
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:
Propriedade | Descrição |
---|---|
Campos mapeados | Exibe o número total de campos de origem que foram mapeados para um campo XDM de destino, independentemente de erros. |
Campos obrigatórios | Exibe o número de campos de mapeamento necessários. |
Campos de identidade | Exibe o número total de campos de mapeamento definidos como identidade. Esses campos de mapeamento são representados por um ícone de impressão digital. |
Erros | Exibe o número de campos de mapeamento incorretos. |
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 pesquisar um conjunto de mapeamento específico, selecione Pesquisar campos de origem e digite o nome dos dados de origem que deseja isolar.
Selecionar Todos os campos de origem para ver um menu suspenso de opções de filtragem para restringir melhor sua visualização da interface de mapeamento.
As opções de filtro são:
Campos de origem | Descrição |
---|---|
Todos os campos de origem | Essa opção exibe todos os campos de origem do esquema de origem. Essa opção é exibida por padrão. |
Campos obrigatórios | Essa opção filtra o esquema de origem para exibir apenas os campos necessários para concluir o mapeamento. |
Campos de identidade | Essa opção filtra o esquema de origem para exibir apenas os campos marcados para Identidade. |
Campos mapeados | Essa opção filtra o esquema de origem para exibir apenas os campos que já foram mapeados. |
Campos não mapeados | Essa opção filtra o esquema de origem para exibir apenas os campos que ainda não foram mapeados. |
Campos com recomendação | Essa opção filtra o esquema de origem para exibir apenas os campos que contêm recomendações de mapeamento. |
Selecionar 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.
É possível adicionar um novo campo de mapeamento ou um campo calculado selecionando Novo tipo de campo.
Para adicionar um novo campo de mapeamento, selecione Novo tipo de campo e selecione 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. Selecionar 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.
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 selecione Adicionar campo calculado
A variável 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.
Tabulação | Descrição |
---|---|
Função | A guia functions lista as funções disponíveis para transformar os dados. Para saber mais sobre as funções que você pode usar em campos calculados, leia o guia em uso das funções de Preparo de dados (Mapeador). |
Campo | A guia fields lista campos e atributos disponíveis no schema de origem. |
Operador | A guia operators lista os operadores disponíveis para transformar os dados. |
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. Quando terminar, selecione Salvar para continuar.
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. Selecionar Importar mapeamento para reutilizar um mapeamento existente.
A variável 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, é possível selecionar Voltar para retornar à lista de fluxos de dados e inspecionar outro conjunto de mapeamento, ou você 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.
Todos os conjuntos de mapeamento existentes que você estabelecer ou as recomendações de mapeamento de ML serão substituídos pelo mapeamento que você importou de um fluxo de dados existente.
Selecionar Visualizar dados para ver resultados de 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.
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.
A variável Recomendações de mapeamento pop-up será 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 schema 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.
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: