Omnistudio-datatilknyttere

Typer af datatilknytninger

For hver opgave med at hente, skrive og transformere data har Omnistudio en forskellig type af Datatilknytning.

Data Mapper Extract, Turbo Extract og Load kan håndtere tilpasset input og output for Omnistudio Data Mappers i Omnistudio. Datatilknyttere kan få adgang til eksterne objekter, tilpassede metadata og Salesforce-objekter. Der kræves ingen særlig syntaks eller konfiguration.

• Data Mapper-udtrækning – læser data fra et eller flere Salesforce-objekter og JSON-output, tilpassede data eller XML med felttilknytninger.
• Data Mapper Turbo Extract – læser data fra et enkelt Salesforce-objekt sammen med felter fra relaterede objekter. Turboudtrækningen er hurtigere på kørselstidspunktet og er nyttig til enklere udtrækninger, der ikke kræver forespørgsler eller mere kompleks outputtilknytning.
• Data Mapper Load – opretter og opdaterer Salesforce-data fra JSON, XML eller tilpasset input.
• Data Mapper-transformation – transformerer inputdata til en ny struktur som output. Outputeksempler inkluderer omdøbte felter, omstruktureret XML eller JSON, ændringer med formler og funktioner og konverterede formater (f.eks. fra JSON til PDF). Da det fungerer med data i hukommelsen, bruger det ikke en SOQL-forespørgsel (Salesforce Object Query Language) eller andre midler til at læse fra Salesforce-objekter.

Datatilknyttere i et arbejdsflow

Datatilknyttere leverer typisk Salesforce-data til Omniscripts, Integration Procedures, Flexcards og Apex og skriver de relaterede opdateringer til Salesforce.

Et Omniscript guider f.eks. kunder gennem et arbejdsflow for at opdatere deres konto.

1. Omniscript kalder en Data Mapper-udtrækning for at læse data fra Salesforce, f.eks. objektet Konto.
2. En kunde redigerer og tilføjer nye data i Omniscript.
3. En Data Mapper-transformation kontrollerer inputdataene og ændrer dem til de rigtige formater efter behov.
4. Omniscript kalder Data Mapper Load for at skrive de nye og ændrede data til Salesforce.

Data Mapper-udtrækning

Data Mapper-udtrækninger læser Salesforce-data og returnerer resultater i JSON-, XML- eller tilpassede formater. Du kan filtrere dataene og vælge de felter, der skal returneres. Du kan bruge formler, standardværdier og oversættelser på dine data. Data Mapper-udtrækning leverer påkrævede data til Omniscripts, Integration Procedures og Flexcards.

Konfigurer Data Mapper-udtrækningen, definer den indledende udtrækning, tilføj formler, tilføj felter, opret tilknytning og angiv egenskaber. Se Konfigurer et Omnistudio Data Mapper-udtræk.

Bestem, om du har brug for flere udtrækningstrin eller relationsnotation. Se når du skal bruge flere udtrækningstrin og relationsnotation kontra flere udtrækningstrin.

Data Mapper Turbo-udtrækning

Data Mapper Turbo-udtrækning henter data fra en enkelt Salesforce-objekttype og inkluderer felter fra relaterede objekter. Du kan filtrere dataene og vælge de felter, der skal returneres, ved at tilknytte de relaterede objekter. Du kan ikke bruge formler, tilpasset JSON, standardværdier og transformationer på en Data Mapper Turbo-udtrækning.

Sammenlignet med en Data Mapper-udtrækning tilbyder en Data Mapper Turbo-udtrækning en enklere konfiguration og bedre ydeevne på kørselstidspunktet.

Data Mapper-indlæsning

Data Mapper Load accepterer inputdata i JSON-, XML- eller tilpassede formater og skriver dataene til Salesforce-objekter. Du kan bruge formler og attributter på dine data. En bruger kører f.eks. et Omniscript-sagshåndtering, afslutter angivelse af data og gemmer. Scriptet kalder en Data Mapper-indlæsning for at registrere de angivne data.

En Data Mapper-indlæsning kan hente inputdata på tre måder:

• Omniscript- eller integrationsprocedure – under kørsel opbygger en Omniscript- eller integrationsprocedure JSON med de data, der er påkrævet for forretningsanvendelsessituationen. Når scriptet kalder Data Mapper-indlæsning, sendes JSON som input.
• Data Mapper API REST-kald – hvis et kald kalder en Data Mapper ved brug af en POST-handling, kan opkaldets dataindlæsning inkludere JSON.
• Apex – angiv JSON som en parameter i Apex til Data Mapper-indlæsning.

Hvis du vil redigere inputdataene, kan du definere formler, transformere værdier og ændre outputdatatypen. Se Brug formler i Omnistudio Data Mappers. Hvis du vil angive, hvordan de resulterende data skrives til Salesforce-objekter, skal du tilknytte felter fra output-JSON til felter i Salesforce-objekter. Se Konfigurer en Omnistudio Data Mapper-indlæsning. Når den kaldes, anvender Data Mapper-indlæsningen dens tilknytninger og formler på inputdataene for at oprette outputdataene. Derefter indlæses outputdata i Salesforce-objekter i henhold til tilknytningerne.

Data Mapper-transformation

Data Mapper-transformation udfører transformation af mellemliggende data uden at læse fra eller skrive til Salesforce-objekter. Du kan føje formler til dataene.

Data Mapper-transformation udfører disse opgaver:

• Konverter en input til en outputdata og omvendt. Input- og outputdata kan være i JSON- eller XML-format.

• Omstrukturer inputdata, og omdøb felter.

• Erstat værdier i felter (alle datatilknyttere kan erstatte værdier)

• Konverter data til PDF-, Docusign- eller dokumentskabelonformat.

Data Mapper-transformation er vigtig for Omniscripts, der skal udfylde en Docusign-skabelon. Se Oprettelse af en datatilknytningsgrænseflade for at tilknytte et OmniScript til DocuSign . Det er også vigtigt at udfylde felter i et PDF-dokument. Se Oprettelse af en datatilknytningsgrænseflade for at tilknytte et OmniScript til en PDF.