Overzicht van toewijzingssets
Een toewijzingsset is een set toewijzingen waarmee gegevens van het ene schema naar het andere worden getransformeerd. Dit document bevat informatie over de samenstelling van toewijzingssets, zoals invoerschema, uitvoerschema en toewijzingen.
Aan de slag
Voor dit overzicht is een goed begrip van de volgende Adobe Experience Platform-componenten vereist:
- Prep van Gegevens: De Prep van Gegevens staat gegevensingenieurs toe om, gegevens in kaart te brengen om te transformeren en te bevestigen aan en van het Model van Gegevens van de Ervaring (XDM).
- Dataflows: Dataflows zijn een vertegenwoordiging van gegevensbanen die gegevens over Platform bewegen. Dataflows worden geconfigureerd op verschillende services, waardoor gegevens van bronconnectors naar doelgegevenssets worden verplaatst, naar Identity en Profile en naar Destinations .
- Adobe Experience Platform Data Ingestion: de methoden waarmee gegevens naar Experience Platform kunnen worden verzonden.
- Experience Data Model (XDM) System: Het gestandaardiseerde framework waarmee Experience Platform gegevens voor de klantervaring indeelt.
Syntaxis toewijzingsset
Een toewijzingsset bestaat uit een id, naam, invoerschema, uitvoerschema en een lijst met gekoppelde toewijzingen.
De volgende JSON is een voorbeeld van een typische toewijzingenset:
{
"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"
}
]
}
idnameinputSchemaoutputSchemamappingssourceTypeVoor elke vermelde afbeelding geeft het kenmerk sourceType het type bron aan dat moet worden toegewezen. Kan een van ATTRIBUTE , STATIC of EXPRESSION zijn:
ATTRIBUTEwordt gebruikt voor alle waarden die in het bronpad worden gevonden.STATICwordt gebruikt voor waarden die in het doelpad worden geïnjecteerd. Deze waarde blijft constant en wordt niet beïnvloed door het bronschema.EXPRESSIONwordt gebruikt voor een expressie die tijdens runtime wordt opgelost. Een lijst van beschikbare uitdrukkingen kan in de handleiding van toewijzingsfunctiesworden gevonden.
sourcesource het veld aan dat u wilt toewijzen. Meer informatie over hoe te om uw bron te vormen kan in het overzicht van bronnenworden gevonden.destinationdestination het veld aan of het pad naar het veld, waar de waarde die uit het veld source is geëxtraheerd, wordt geplaatst. Meer informatie over hoe te om uw bestemmingen te vormen kan in het bestemmingsoverzichtworden gevonden.mappings.namemappings.descriptionToewijzingsbronnen configureren
In een afbeelding kan de source een veld, expressie of statische waarde zijn. Op basis van het opgegeven brontype kan de waarde op verschillende manieren worden geëxtraheerd.
Veld in kolomgegevens
Wanneer u een veld toewijst aan kolomgegevens, zoals een CSV-bestand, gebruikt u het brontype ATTRIBUTE . Als het veld . in de naam bevat, gebruikt u \ om de waarde te laten ontsnappen. Hieronder vindt u een voorbeeld van deze toewijzing:
Csv- dossier van de Steekproef:
Full.Name, Email
John Smith, js@example.com
de afbeelding van de Steekproef
{
"source": "Full.Name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": {
"name": "John Smith"
}
}
Veld in geneste gegevens
Wanneer u een veld toewijst aan geneste gegevens, zoals een JSON-bestand, gebruikt u het brontype ATTRIBUTE . Als het veld . in de naam bevat, gebruikt u \ om de waarde te laten ontsnappen. Hieronder vindt u een voorbeeld van deze toewijzing:
Steekproef JSON- dossier
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
de afbeelding van de Steekproef
{
"source": "customerInfo.name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": {
"name": "John Smith"
}
}
Veld binnen een array
Wanneer u een veld in een array toewijst, kunt u een specifieke waarde ophalen met een index. Hiervoor gebruikt u het brontype ATTRIBUTE en de index van de waarde die u wilt toewijzen. Hieronder vindt u een voorbeeld van deze toewijzing:
Steekproef JSON- dossier
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
de afbeelding van de Steekproef
{
"source": "customerInfo.emails[0].email",
"destination": "pi.email",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": {
"email": "js@example.com"
}
}
Array naar array of object naar object
Met behulp van het brontype ATTRIBUTE kunt u een array ook rechtstreeks toewijzen aan een array of een object aan een object. Hieronder vindt u een voorbeeld van deze toewijzing:
Steekproef JSON- dossier
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
de afbeelding van de Steekproef
{
"source": "customerInfo.emails",
"destination": "pi.emailList",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": {
"emailList": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Interactieve bewerkingen op arrays
Met behulp van het brontype ATTRIBUTE kunt u arrays doorlopen en toewijzen aan een doelschema met behulp van een jokertekenindex ([*] ). Hieronder vindt u een voorbeeld van deze toewijzing:
Steekproef JSON- dossier
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
de afbeelding van de Steekproef
{
"source": "customerInfo.emails[*].name",
"destination": "pi[*].names",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": [
{
"names": {
"name": "John Smith"
}
},
{
"names": {
"name": "Jane Smith"
}
}
]
}
Constante waarde
Als u een constante of een statische waarde wilt toewijzen, gebruikt u het brontype STATIC . Wanneer u het brontype STATIC gebruikt, vertegenwoordigt source de hard-gecodeerde waarde die u aan destination wilt toewijzen. Hieronder vindt u een voorbeeld van deze toewijzing:
Steekproef JSON- dossier
{
"name": "John Smith",
"email": "js@example.com"
}
de afbeelding van de Steekproef
{
"source": "CUSTOMER",
"destination": "userType",
"sourceType": "STATIC"
}
Getransformeerde gegevens
{
"userType:": "CUSTOMER"
}
Expressies
Als u een expressie wilt toewijzen, gebruikt u het brontype EXPRESSION . Een lijst van toegelaten functies kan in de handleiding van toewijzingsfunctiesworden gevonden. Wanneer u het brontype EXPRESSION gebruikt, vertegenwoordigt source de functie die u wilt omzetten. Hieronder vindt u een voorbeeld van deze toewijzing:
Steekproef JSON- dossier
{
"firstName": "John",
"lastName": "Smith",
"email": "js@example.com"
}
de afbeelding van de Steekproef
{
"source": "concat(upper(lastName), upper(firstName), now())",
"destination": "pi.created",
"sourceType": "EXPRESSION"
}
Getransformeerde gegevens
{
"pi": {
"created": "SMITHJOHNFri Sep 25 15:17:31 PDT 2020"
}
}
Toewijzingsdoelen configureren
In een toewijzing is destination de locatie waar de waarde die uit source wordt geëxtraheerd, wordt ingevoegd.
Veld op hoofdniveau
Wanneer u de source -waarde wilt toewijzen aan het hoofdniveau van de getransformeerde gegevens, volgt u het onderstaande voorbeeld:
Steekproef JSON- dossier
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
de afbeelding van de Steekproef
{
"source": "customerInfo.name",
"destination": "name",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"name": "John Smith"
}
Geneste veld
Wanneer u de waarde source wilt toewijzen aan een genest veld in uw getransformeerde gegevens, volgt u het onderstaande voorbeeld:
Steekproef JSON- dossier
{
"name": "John Smith",
"email": "js@example.com"
}
de afbeelding van de Steekproef
{
"source": "name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": {
"name": "John Smith"
}
}
Veld bij een specifieke arrayindex
Wanneer u de source -waarde wilt toewijzen aan een specifieke index in een array in uw getransformeerde gegevens, volgt u het onderstaande voorbeeld:
Steekproef JSON- dossier
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
de afbeelding van de Steekproef
{
"source": "customerInfo.name",
"destination": "piList[0]",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"piList": ["John Smith"]
}
Iteratieve arraybewerking
Wanneer u door series wilt herhalen en de waarden aan het doel in kaart brengen, kunt u een vervangingsindex ([*]) gebruiken. Hieronder ziet u een voorbeeld:
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
de afbeelding van de Steekproef
{
"source": "customerInfo.emails[*].name",
"destination": "pi[*].names",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": [
{
"names": {
"name": "John Smith"
}
},
{
"names": {
"name": "Jane Smith"
}
}
]
}
Volgende stappen
Door dit document te lezen, zou u nu moeten begrijpen hoe de kaartreeksen worden geconstrueerd, met inbegrip van hoe te om individuele afbeeldingen binnen een mappenset te vormen. Voor meer informatie over andere eigenschappen van de Prep van Gegevens, te lezen gelieve het overzicht van de Prep van Gegevens. Leren hoe te om kaartreeksen binnen de Prep API van Gegevens te gebruiken, gelieve de ontwikkelaarsgids van de Prep van Gegevenste lezen.