Toewijzingsbronnen 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.