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.

recommendation-more-help