breadcrumbDescription
Brug formler i Omnistudio-datatilknytninger
Hvis du vil føje data til outputtet af en datatilknytning, skal du definere formler. Flere typer af datatilknyttere (Udtræk, Transformer og Indlæs) understøtter formler. Når du definerer en formel, tilknytter du dens output til output-JSON (for udtrækninger og transformationer) eller Salesforce-objektfelt (for indlæsninger).
Hvis du ønsker oplysninger om operatorer og funktioner, du kan bruge i formler, kan du se Omnistudio Formler og funktioner.
Hvis et variabelnavn indeholder mellemrum eller ikke-alfanumeriske tegn, skal du omkranse variabelnavnet med dobbelte anførselstegn og forud for det med var: i formler. Hvis JSON-nodenavnet f.eks. er Primary Guardian, skal du angive det i formler som var:"Primary Guardian".
Hvis navnet på et tilpasset felt indeholder specialtegn, kan du nogle gange ikke referere til feltet i en formel.
I Omnistudio-standardkørsel returnerer angivelse af den ukorrekte forespørgselsformel for Datatilknytninger nul, men viser ikke fejllogfiler. Hvis du får et nul-svar fra en forespørgsel, skal du opdatere forespørgslen.
- På siden Data Mapper-grænseflade skal du gå til fanen Formler.
- Klik på Tilføj formel. Der føjes en tom formel til listen.
-
Angiv den ønskede logik i feltet Formel. Hvis du f.eks. vil bestemme den samlede pris for købselementer for en kunde, skal du angive en formel som f.eks.:
SUM(Products:Price)Du kan også bruge relationsnotation i formler til at henvise til felter i et overordnet objekt. Se Relationnotation kontra flere udtrækningstrin.
- I feltet Formelresultatsti skal du angive en JSON-node, som formelresultatet skal lagres i.
-
Tilknyt resultatet til det endelige output.
- For en Udtræk datatilknytning skal du på fanen Output tilknytte formelresultatet til outputstrukturen. Brug et kolon (:) til at adskille niveauer i input- og outputstier i tilknytninger.
- For en transformeringsdatatilknytning skal du på fanen Transformeringer tilknytte formelresultatet til outputstrukturen. Brug et kolon (:) til at adskille niveauer i input- og outputstier i tilknytninger.
- For en indlæs datatilknytning for hvert sObject, du vil opdatere, skal du på fanen Felter tilknytte formelresultatet til det felt, du vil opdatere.
- Indlæs: For hvert sObject, du vil opdatere, skal du gå til fanen Felter og knytte formelresultatet til det specifikke felt, du vil opdatere.
Opret et Omnistudio Data Mapper-eksempel med en formel
Følgende eksempel accepterer en liste over priser og bruger en formel til at beregne den samlede pris.
Hvis du vil oprette denne Data Mapper-transformation, skal du udføre disse trin:
- Gå til fanen Omnistudio Data Mapper Designer, og klik på Ny. Dialogboksen Opret vises.
-
Angiv et navn for Datatilknytning, og konfigurer dens indstillinger på følgende måde:
- Interface Type: Transformer
- Inputtype: JSON
- Outputtype: JSON
- Klik på Gem. Siden Data Mapper-grænseflade vises.
- Gå til fanen Formler, og klik på Tilføj formel.
- I feltet Formel skal du skrive SUM(Products:Price).
- I feltet Formelresultatsti skal du skrive TotalPrice.
-
På fanen Transforms skal du udvide ruden Input JSON og indsætte denne JSON-struktur i den:
{ "CustomerName": "Bob Smith", "Products": [ { "Name": "iPhone", "Price": 600 }, { "Name": "iPhone Case", "Price": 30 }, { "Name": "Ear Buds", "Price": 200 } ] } -
Udvid ruden Forventet JSON-output, og indsæt denne JSON-struktur i den:
{ "CustomerName": "Bob Smith", "TotalPrice": 830, "Products": [ { "Name": "iPhone", "Price": 600 }, { "Name": "iPhone Case", "Price": 30 }, { "Name": "Ear Buds", "Price": 200 } ] } - Klik på Fast match. I vinduet Hurtigt match skal du klikke på Automatisk match og derefter klikke på Gem.
-
Klik på fanen Eksempelvisning på Udfør.
Hvis du har bygget eksemplet korrekt, matcher JSON-strukturen i ruden Svar det forventede JSON-output, bortset fra rækkefølgen af noder på topniveau.
-
I ruden Input skal du ændre en eller flere af priserne og derefter klikke på Udfør igen.
Bemærk, hvordan
TotalPriceændres.
