Show Menu
TÓPICOS×

Mapear um arquivo CSV para um schema XDM

Para assimilar dados CSV, Adobe Experience Platformos dados devem ser mapeados para um schema Experience Data Model (XDM). Este tutorial aborda como mapear um arquivo CSV para um schema XDM usando a interface do Platform usuário.
Além disso, o apêndice deste tutorial fornece mais informações sobre o uso de funções de mapeamento.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes do Platform:
Este tutorial também requer que você já tenha criado um conjunto de dados para assimilar seus dados CSV. Para obter etapas sobre como criar um conjunto de dados na interface do usuário, consulte o tutorial de assimilação de dados.

Escolher um destino

Faça logon em Adobe Experience Platform e selecione Workflows na barra de navegação esquerda para acessar a área de trabalho de Workflows .
Na tela Workflows , selecione Mapear o schema CSV para XDM na seção de ingestão de dados e selecione Iniciar .
O fluxo de trabalho Mapear CSV para schema XDM é exibido, começando na etapa Destino . Escolha um conjunto de dados para os dados de entrada a serem ingeridos. Você pode usar um conjunto de dados existente ou criar um novo.
Usar um conjunto de dados existente
Para assimilar seus dados CSV em um conjunto de dados existente, selecione Usar conjunto de dados existente. Você pode recuperar um conjunto de dados existente usando a função de pesquisa ou percorrendo a lista de conjuntos de dados existentes no painel.
Para assimilar seus dados CSV em um novo conjunto de dados, selecione Criar novo conjunto de dados e insira um nome e uma descrição para o conjunto de dados nos campos fornecidos. Selecione um schema usando a função de pesquisa ou percorrendo a lista dos schemas fornecidos. Selecione Avançar para continuar.

Adicionar dados

A etapa Adicionar dados é exibida. Arraste e solte o arquivo CSV no espaço fornecido ou selecione Escolher arquivos para inserir manualmente o arquivo CSV.
A seção Dados de amostra é exibida assim que o arquivo é carregado, mostrando as primeiras dez linhas de dados. Depois de confirmar que os dados foram carregados como esperado, selecione Avançar .

Mapear campos CSV para campos de schema XDM

A etapa Mapeamento é exibida. As colunas do arquivo CSV são listadas em Campo de origem, com seus campos de schema XDM correspondentes listados em Campo de Público alvo. Os campos de público alvo não selecionados são contornados em vermelho. Você pode usar a opção de filtrar campos para restringir a lista dos campos de origem disponíveis.
Platform fornece recomendações inteligentes para campos mapeados automaticamente com base no schema ou conjunto de dados do público alvo selecionado. É possível ajustar manualmente as regras de mapeamento para atender aos casos de uso.
Para mapear uma coluna CSV para um campo XDM, selecione o ícone de schema ao lado do campo de público alvo correspondente da coluna.
A janela Selecionar campo schema é exibida. Aqui, você pode navegar pela estrutura do schema XDM e localizar o campo para o qual deseja mapear a coluna CSV. Clique em um campo XDM para selecioná-lo e, em seguida, clique em Selecionar .
Depois de concluir as etapas para os campos de origem não mapeados restantes, a tela Mapeamento será exibida novamente com o campo XDM selecionado que agora aparece em Campo de Público alvo.
Ao mapear campos, também é possível incluir funções para calcular valores com base nos campos de origem de entrada. Consulte a seção de funções de mapeamento no apêndice para obter mais informações.

Adicionar campo calculado

Campos calculados permitem que valores sejam criados com base nos atributos no schema de entrada. Esses valores podem ser atribuídos aos atributos no schema do público alvo e receber um nome e uma descrição para facilitar a referência.
Selecione o botão Adicionar campo calculado para continuar.
O painel Criar campo calculado é exibido. A caixa de diálogo esquerda contém os campos, as funções e os operadores suportados nos campos calculados. Selecione uma das guias para adicionar funções, campos ou operadores ao editor de expressões.
Tabulação
Descrição
Campos
A guia campos lista campos e atributos disponíveis no schema de origem.
Funções
A guia funções lista as funções disponíveis para transformar os dados.
Operadores
A guia operadores lista os operadores disponíveis para transformar os dados.
É possível adicionar manualmente campos, funções e operadores usando o editor de expressão no centro. Selecione o editor para criar uma expressão no start.
Selecione Salvar para continuar.
A tela de mapeamento reaparece com o campo de origem recém-criado. Aplique o campo de público alvo correspondente apropriado e selecione Concluir para concluir o mapeamento.

Monitore seu fluxo de dados

Depois que o arquivo CSV for mapeado e criado, você poderá monitorar os dados que estão sendo assimilados por meio dele. Para obter mais informações sobre como monitorar fluxos de dados, consulte o tutorial sobre como monitorar fluxos de dados de transmissão contínua.

Próximas etapas

Ao seguir este tutorial, você mapeou com êxito um arquivo CSV simples para um schema XDM e o assimilou Platform. Esses dados agora podem ser usados por Platform serviços de downstream, como Real-time Customer Profile. Consulte a visão geral do Real-time Customer Perfil para obter mais informações.

Apêndice

A seção a seguir fornece informações adicionais para mapear colunas CSV para campos XDM.

Funções de mapeamento

Determinadas funções de mapeamento podem ser usadas para calcular e calcular valores com base no que é inserido nos campos de origem. Para usar uma função, digite-a em Campo de origem com a sintaxe e as entradas apropriadas.
Por exemplo, para concatenar campos CSV de cidade e país e atribuí-los ao campo XDM de cidade , defina o campo de origem como concat(city, ", ", county) .
A tabela a seguir lista todas as funções de mapeamento suportadas, incluindo expressões de amostra e suas saídas resultantes.
Função
Descrição
Expressão de amostra
Exemplo de saída
concat
Concatena determinadas cordas.
concat("Oi, ", "lá", "!")
"Hi, there!"
explosão
Divide a string com base em um regex e retorna uma matriz de partes.
explode("Oi, aqui!", " ")
["Hi,", "there"]
instr
Retorna o local/índice de uma substring.
instr("adobe .com", "com")
6
substituta
Substitui a string de pesquisa, se presente na string original.
replace("This is a string re test", "re", "replace")
"Este é um teste de substituição de string"
substr
Retorna uma substring de um determinado comprimento.
SAA("This is a substring test", 7, 8)
" a subst"
lower /
lcase
Converte uma string em minúsculas.
lower("EleLLo")
lcase("EleLLo")
"hello"
superior /
ucase
Converte uma string em maiúsculas.
upper("HeLLo")
ucase("EleLLo")
"OLÁ"
split
Divide uma string de entrada em um separador.
split("Hello world", " ")
["Hello", "world"]
join
Une uma lista de objetos usando o separador.
join(" ", ["Hello", "world"] )
"Olá mundo"
coalescência
Retorna o primeiro objeto não nulo em uma determinada lista.
coalesce(null, null, null, "first", null, "second")
"first"
decodificação
Considerando uma chave e uma lista de pares de valores chave nivelados como uma matriz, a função retornará o valor se a chave for encontrada ou retornará um valor padrão se estiver presente na matriz.
decode("k2", "k1", "v1", "k2", "v2", "default")
"v2"
iif
Avalia uma determinada expressão booleana e retorna o valor especificado com base no resultado.
iif("s".equalsIgnoreCase("S"), "True", "False")
"Verdadeiro"
min
Retorna o mínimo dos argumentos fornecidos. Usa ordenação natural.
min(3, 1, 4)
1
max
Retorna o máximo dos argumentos fornecidos. Usa ordenação natural.
max(3, 1, 4)
4
first
Recupera o primeiro argumento fornecido.
first("1", "2", "3")
"1"
last
Recupera o último argumento fornecido.
last("1", "2", "3")
"3"
uid /
guid
Gera uma ID pseudo-aleatória.
uuid()
guid()
now
Recupera a hora atual.
now()
2019-10-23T10:10:24.556-07:00[America/Los_Angeles]
carimbo de data e hora
Recupera o tempo Unix atual.
carimbo de data e hora()
1571850624571
format
Formata a data de entrada de acordo com um formato especificado.
format(, "aaaa-MM-dd HH:mm:ss")
"2019-10-23 11:24:35"
dformat
Converte um carimbo de data e hora em uma string de data de acordo com um formato especificado.
dformat(1571829875, "dd-MMM-yyyy hh:mm")
"23-out-2019 11:24"
data
Converte uma string de data em um objeto ZondedDateTime (formato ISO 8601).
date("23-out-2019 11:24")
"2019-10-23T11:24:00+00:00"
date_part
Recupera as partes da data. Os seguintes valores de componente são suportados:
"ano"
"aaaa"
"yy"
"trimestre"
"qq"
"q"
"month"
"mm"
"m"
"dayofyear"
"dia""dia""dia""dia""d""semana""wvw"tv"semana"dia da semana""dw"hvw"hormlvlvr"bresskr"brlhr h""hh24""hh12""""""""""""""""ms"" h""h24""ms"
date_part(date("2019-10-17 11:55:12"), "MM")
10
set_date_part
Substitui um componente em uma determinada data. Os seguintes componentes são aceitos:
"year"
"yyyy"
"yy"
"month"
"mm"
"m"
"day"
"dd"
"d"
"d"
"hora"
"hh""minuto"""in""second""""s""s""
set_date_part("m", 4, date("2016-11-09T11:44:44.797")
"2016-04-09T11:44:44.797"
make_date_time /
make_timestamp
Cria uma data de partes.
make_date_time(2019, 10, 17, 11, 55, 12, 999, "América/Los_Angeles")
2019-10-17T11:55:12.0​00000999-07:00[America/Los_Angeles]
current_timestamp
Retorna o carimbo de data e hora atual.
current_timestamp()
1571850624571
current_date
Retorna a data atual sem um componente de hora.
current_date()
"18-nov-2019"