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:
- Gegevensprep: Data Prep staat gegevensingenieurs toe om gegevens in kaart te brengen, om te zetten en te bevestigen aan en van het Model van de Gegevens van de Ervaring (XDM).
- Gegevensstromen: Gegevensstromen zijn een weergave van gegevenstaken die gegevens verplaatsen over het hele platform. Dataflows worden gevormd over verschillende diensten, die gegevens van bronschakelaars aan doeldatasets helpen bewegen, aan Identity en Profile, en Destinations.
- Adobe Experience Platform Data Ingestion: De methoden waarmee gegevens kunnen worden verzonden naar Experience Platform.
- Experience Data Model (XDM) System: Het gestandaardiseerde kader waarbinnen Experience Platform organiseert de gegevens van de klantenervaring.
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, zijn sourceType kenmerk geeft het type bron aan dat moet worden toegewezen. Kan één van ATTRIBUTE, STATIC, of EXPRESSION:
ATTRIBUTEwordt gebruikt voor alle waarden die in het bronpad worden gevonden.STATICwordt gebruikt voor waarden die in het bestemmingspad 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 met beschikbare expressies vindt u in het dialoogvenster handleiding voor toewijzingsfuncties.
sourcesource Dit kenmerk geeft het veld aan dat u wilt toewijzen. Meer informatie over hoe te om uw bron te vormen kan in worden gevonden overzicht van bronnen.destinationdestination kenmerk geeft het veld aan, of het pad naar het veld, waar de waarde wordt geëxtraheerd uit het source wordt geplaatst. Meer informatie over hoe te om uw bestemmingen te vormen kan in worden gevonden doeloverzicht.mappings.namemappings.descriptionToewijzingsbronnen configureren
In een afbeelding worden de source Dit kan 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 de opdracht ATTRIBUTE brontype. Als het veld . binnen de naam ervan gebruiken \ om de waarde te verwijderen. Hieronder vindt u een voorbeeld van deze toewijzing:
CSV-bestand voorbeeld:
Full.Name, Email
John Smith, js@example.com
Voorbeeldtoewijzing
{
"source": "Full.Name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": {
"name": "John Smith"
}
}
Veld in geneste gegevens
Wanneer u een veld in geneste gegevens toewijst, zoals een JSON-bestand, gebruikt u de opdracht ATTRIBUTE brontype. Als het veld . binnen de naam ervan gebruiken \ om de waarde te verwijderen. Hieronder vindt u een voorbeeld van deze toewijzing:
Voorbeeld-JSON-bestand
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
Voorbeeldtoewijzing
{
"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. Om dit te doen, gebruik ATTRIBUTE Het brontype en de index van de waarde die u wilt toewijzen. Hieronder vindt u een voorbeeld van deze toewijzing:
Voorbeeld-JSON-bestand
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Voorbeeldtoewijzing
{
"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 de ATTRIBUTE brontype, kunt u een array ook rechtstreeks toewijzen aan een array of een object aan een object. Hieronder vindt u een voorbeeld van deze toewijzing:
Voorbeeld-JSON-bestand
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Voorbeeldtoewijzing
{
"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 de ATTRIBUTE brontype, kunt u door series herhaling en kaart hen aan een doelschema door een vervangingsindex te gebruiken ([*]). Hieronder vindt u een voorbeeld van deze toewijzing:
Voorbeeld-JSON-bestand
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Voorbeeldtoewijzing
{
"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 de opdracht STATIC brontype. Wanneer u de opdracht STATIC brontype, de source vertegenwoordigt de hard-gecodeerde waarde die u aan wilt toewijzen destination. Hieronder vindt u een voorbeeld van deze toewijzing:
Voorbeeld-JSON-bestand
{
"name": "John Smith",
"email": "js@example.com"
}
Voorbeeldtoewijzing
{
"source": "CUSTOMER",
"destination": "userType",
"sourceType": "STATIC"
}
Getransformeerde gegevens
{
"userType:": "CUSTOMER"
}
Expressies
Als u een expressie wilt toewijzen, gebruikt u de opdracht EXPRESSION brontype. Een lijst met geaccepteerde functies vindt u in het dialoogvenster handleiding voor toewijzingsfuncties. Wanneer u de opdracht EXPRESSION brontype, de source vertegenwoordigt de functie u wilt oplossen. Hieronder vindt u een voorbeeld van deze toewijzing:
Voorbeeld-JSON-bestand
{
"firstName": "John",
"lastName": "Smith",
"email": "js@example.com"
}
Voorbeeldtoewijzing
{
"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 afbeelding worden de destination is de locatie waar de waarde uit de source wordt ingevoegd.
Veld op hoofdniveau
Wanneer u de source de waarde tot het wortelniveau van uw getransformeerde gegevens, volgt het voorbeeld hieronder:
Voorbeeld-JSON-bestand
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
Voorbeeldtoewijzing
{
"source": "customerInfo.name",
"destination": "name",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"name": "John Smith"
}
Geneste veld
Wanneer u de source volgt u het onderstaande voorbeeld om een waarde toe te voegen aan een genest veld in uw getransformeerde gegevens:
Voorbeeld-JSON-bestand
{
"name": "John Smith",
"email": "js@example.com"
}
Voorbeeldtoewijzing
{
"source": "name",
"destination": "pi.name",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"pi": {
"name": "John Smith"
}
}
Veld bij een specifieke arrayindex
Wanneer u de source Volg het onderstaande voorbeeld voor een waarde van een specifieke index in een array in uw getransformeerde gegevens:
Voorbeeld-JSON-bestand
{
"customerInfo": {
"name": "John Smith",
"email": "js@example.com"
}
}
Voorbeeldtoewijzing
{
"source": "customerInfo.name",
"destination": "piList[0]",
"sourceType": "ATTRIBUTE"
}
Getransformeerde gegevens
{
"piList": ["John Smith"]
}
Iteratieve arraybewerking
Wanneer u arrays doorloopt en de waarden aan het doel wilt toewijzen, kunt u een jokertekenindex gebruiken ([*]). Hieronder ziet u een voorbeeld:
{
"customerInfo": {
"emails": [
{
"name": "John Smith",
"email": "js@example.com"
},
{
"name": "Jane Smith",
"email": "jane@example.com"
}
]
}
}
Voorbeeldtoewijzing
{
"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. Lees voor meer informatie over andere functies van Data Prep de Overzicht van Data Prep. Als u wilt weten hoe u toewijzingssets kunt gebruiken in de Data Prep API, leest u de Handleiding voor ontwikkelaars van Data Prep.