Visão geral dos conjuntos de mapeamento
Um conjunto de mapeamento é um conjunto de mapeamentos que transforma os dados de um esquema para outro. Este documento fornece informações sobre como os conjuntos de mapeamento são compostos, incluindo o esquema de entrada, o esquema de saída e os mapeamentos.
Introdução
Esta visão geral requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
- Preparo de dados: o Preparo de dados permite que os engenheiros de dados mapeiem, transformem e validem dados de e para o Experience Data Model (XDM).
- Fluxos de dados: os fluxos de dados são uma representação de trabalhos de dados que movem dados pela Plataforma. Os fluxos de dados são configurados em diferentes serviços, ajudando a mover dados dos conectores de origem para conjuntos de dados de destino, para Identity e Profile e para Destinations.
- Adobe Experience Platform Data Ingestion: Os métodos pelos quais os dados podem ser enviados para Experience Platform.
- Experience Data Model (XDM) System: a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
Sintaxe do conjunto de mapeamento
Um conjunto de mapeamento é composto de uma ID, nome, esquema de entrada, esquema de saída e uma lista de mapeamentos associados.
O JSON a seguir é um exemplo de um conjunto de mapeamento típico:
{
"id": "cbb0da769faa48fcb29e026a924ba29d",
"name": "Demo Mapping Set",
"inputSchema": {
"id": "a167ff2947ff447ebd8bcf7ef6756232",
"version": 0
},
"outputSchema": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/6dd1768be928c36d58ad4897219bb52d491671f966084bc0",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"mappings": [
{
"sourceType": "ATTRIBUTE",
"source": "Id",
"destination": "_id",
"name": "Id",
"description": "Identifier field"
},
{
"sourceType": "ATTRIBUTE",
"source": "FirstName",
"destination": "person.name.firstName"
},
{
"sourceType": "ATTRIBUTE",
"source": "LastName",
"destination": "person.name.lastName"
}
]
}
idnameinputSchemaoutputSchemamappingssourceTypePara cada mapeamento listado, seu atributo sourceType indica o tipo de origem a ser mapeado. Pode ser um de ATTRIBUTE, STATIC ou EXPRESSION:
ATTRIBUTEé usado para qualquer valor encontrado no caminho de origem.STATICé usado para valores inseridos no caminho de destino. Esse valor permanece constante e não é afetado pelo esquema de origem.EXPRESSIONé usado para uma expressão, que será resolvida durante o tempo de execução. Uma lista de expressões disponíveis pode ser encontrada no guia de funções de mapeamento.
sourcesource indica o campo que você deseja mapear. Mais informações sobre como configurar sua origem podem ser encontradas na visão geral das origens.destinationdestination indica o campo ou o caminho para o campo, onde o valor extraído do campo source será colocado. Mais informações sobre como configurar os destinos podem ser encontradas na visão geral do destino.mappings.namemappings.descriptionConfiguração de origens de mapeamento
Em um mapeamento, o source pode ser um campo, expressão ou um valor estático. Com base no tipo de origem fornecido, o valor pode ser extraído de várias maneiras.
Campo em dados de colunas
Ao mapear um campo em dados de colunas, como um arquivo CSV, use o tipo de origem ATTRIBUTE. Se o campo contiver . em seu nome, use \ para escapar o valor. Um exemplo desse mapeamento pode ser encontrado abaixo:
Arquivo CSV de exemplo:
Full.Name, Email
John Smith, js@example.com
Mapeamento de exemplo
{
"source": "Full.Name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"pi": {
"name": "John Smith"
}
}
Campo em dados aninhados
Ao mapear um campo em dados aninhados, como um arquivo JSON, use o tipo de origem ATTRIBUTE. Se o campo contiver . em seu nome, use \ para escapar o valor. Um exemplo desse mapeamento pode ser encontrado abaixo:
Arquivo JSON de exemplo
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
Mapeamento de exemplo
{
"source": "customerInfo.name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"pi": {
"name": "John Smith"
}
}
Campo dentro de uma matriz
Ao mapear um campo em uma matriz, você pode recuperar um valor específico usando um índice. Para fazer isso, use o tipo de origem ATTRIBUTE e o índice do valor que você deseja mapear. Um exemplo desse mapeamento pode ser encontrado abaixo:
Arquivo JSON de exemplo
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Mapeamento de exemplo
{
"source": "customerInfo.emails[0].email",
"destination": "pi.email",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"pi": {
"email": "js@example.com"
}
}
Matriz para matriz ou objeto para objeto
Usando o tipo de origem ATTRIBUTE, você também pode mapear diretamente uma matriz para uma matriz ou um objeto para um objeto. Um exemplo desse mapeamento pode ser encontrado abaixo:
Arquivo JSON de exemplo
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Mapeamento de exemplo
{
"source": "customerInfo.emails",
"destination": "pi.emailList",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"pi": {
"emailList": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Operações iterativas em arrays
Usando o tipo de origem ATTRIBUTE, você pode executar um loop iterativo pelas matrizes e mapeá-las para um esquema de destino usando um índice curinga ([*]). Um exemplo desse mapeamento pode ser encontrado abaixo:
Arquivo JSON de exemplo
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Mapeamento de exemplo
{
"source": "customerInfo.emails[*].name",
"destination": "pi[*].names",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"pi": [
{
"names": {
"name": "John Smith"
}
},
{
"names": {
"name": "Jane Smith"
}
}
]
}
Valor constante
Se você deseja mapear um valor estático ou constante, use o tipo de origem STATIC. Ao usar o tipo de origem STATIC, source representa o valor embutido em código que você deseja atribuir a destination. Um exemplo desse mapeamento pode ser encontrado abaixo:
Arquivo JSON de exemplo
{
"name": "John Smith",
"email": "js@example.com"
}
Mapeamento de exemplo
{
"source": "CUSTOMER",
"destination": "userType",
"sourceType": "STATIC"
}
Dados transformados
{
"userType:": "CUSTOMER"
}
Expressões
Se quiser mapear uma expressão, use o tipo de origem EXPRESSION. Uma lista de funções aceitas pode ser encontrada no guia de funções de mapeamento. Ao usar o tipo de origem EXPRESSION, source representa a função que você deseja resolver. Um exemplo desse mapeamento pode ser encontrado abaixo:
Arquivo JSON de exemplo
{
"firstName": "John",
"lastName": "Smith",
"email": "js@example.com"
}
Mapeamento de exemplo
{
"source": "concat(upper(lastName), upper(firstName), now())",
"destination": "pi.created",
"sourceType": "EXPRESSION"
}
Dados transformados
{
"pi": {
"created": "SMITHJOHNFri Sep 25 15:17:31 PDT 2020"
}
}
Configuração de destinos de mapeamento
Em um mapeamento, o destination é o local onde o valor extraído do source será inserido.
Campo no nível raiz
Quando quiser mapear o valor source para o nível raiz dos dados transformados, siga o exemplo abaixo:
Arquivo JSON de exemplo
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
Mapeamento de exemplo
{
"source": "customerInfo.name",
"destination": "name",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"name": "John Smith"
}
Campo aninhado
Quando quiser mapear o valor source para um campo aninhado em seus dados transformados, siga o exemplo abaixo:
Arquivo JSON de exemplo
{
"name": "John Smith",
"email": "js@example.com"
}
Mapeamento de exemplo
{
"source": "name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"pi": {
"name": "John Smith"
}
}
Campo em um índice de matriz específico
Quando quiser mapear o valor source para um índice específico em uma matriz nos dados transformados, siga o exemplo abaixo:
Arquivo JSON de exemplo
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
Mapeamento de exemplo
{
"source": "customerInfo.name",
"destination": "piList[0]",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"piList": ["John Smith"]
}
Operação de matriz iterativa
Quando quiser executar um loop iterativo pelas matrizes e mapear os valores para o destino, você poderá usar um índice curinga ([*]). Um exemplo disso pode ser visto abaixo:
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Mapeamento de exemplo
{
"source": "customerInfo.emails[*].name",
"destination": "pi[*].names",
"sourceType": "ATTRIBUTE"
}
Dados transformados
{
"pi": [
{
"names": {
"name": "John Smith"
}
},
{
"names": {
"name": "Jane Smith"
}
}
]
}
Próximas etapas
Após a leitura deste documento, você deve entender como os conjuntos de mapeamento são construídos, incluindo como configurar mapeamentos individuais em um conjunto de mapeamento. Para obter mais informações sobre outros recursos do Preparo de dados, leia a visão geral do Preparo de dados. Para saber como usar conjuntos de mapeamento na API de Preparo de Dados, leia o guia do desenvolvedor de Preparo de Dados.