Du är här:
Omnistudio-datamappningar
Använd Omnistudio Data Mappers för att deklarativt hämta, skriva och ändra data mellan Salesforce och andra Omnistudio-komponenter. Du kan bearbeta data med egen kod (som Apex klasser), men Omnistudio Data Mappers är snabbare att bygga, enklare att uppdatera och enklare att hantera. De går även att återanvända, vilket hjälper dig att snabbt flytta lösningar från utveckling till produktion.
Typer av datamappningar
För varje uppgift att hämta, skriva och transformera data har Omnistudio en annan typ av Datamappning.
Extrahering av datamappning, Turboextraktion och Läs in kan hantera egna indata och utdata för Omnistudio Data Mappers i Omnistudio. Datamappare kan komma åt externa objekt, egna metadata och Salesforce-objekt. Ingen speciell syntax eller konfiguration krävs.
- Extrahering av datamappning — läser data från ett eller flera Salesforce-objekt och JSON-utdata, egna data eller XML med fältmappningar.
- Extrahering av datamappningsturbo — läser data från ett enskilt Salesforce-objekt tillsammans med fält från relaterade objekt. Turboextraktionen är snabbare vid körning och är användbar för enklare extraheringar som inte kräver sökfrågor eller mer komplex utdatamappning.
- Datamappningsbelastning — skapar och uppdaterar Salesforce-data från JSON, XML eller egen indata.
- Datamappningstransformation — transformerar indata till en ny struktur som utdata. Exempel på utdata inkluderar omdöpta fält, omstrukturerad XML eller JSON, ändringar med formler och funktioner och konverterade format (som från JSON till PDF). Eftersom det fungerar med data i minnet använder det inte en SOQL-fråga (Salesforce Object Query Language) eller andra sätt att läsa från Salesforce-objekt.
Datamappare i ett arbetsflöde
Datamappare tillhandahåller vanligtvis Salesforce-data till klasserna Omniscripts, Integreringsprocedurer, Flexcards och Apex och skriver relaterade uppdateringar till Salesforce.
Till exempel guidar ett Omniscript kunder genom ett arbetsflöde för att uppdatera sitt konto.
- Omniskriptet anropar ett Datamappningsextrakt för att läsa data från Salesforce, till exempel objektet Konto.
- En kund ändrar och lägger till nya data i Omniscript.
- En datamappningstransformation kontrollerar indata och ändrar dem till rätt format efter behov.
- Omniskriptet anropar Data Mapper Load för att skriva nya och ändrade data till Salesforce.
Extrahering av datamappning
Datamappningsextraheringar läser Salesforce-data och returnerar resultat i JSON, XML eller egna format. Du kan filtrera data och välja fälten att returnera. Du kan använda formler, standardvärden och översättningar av dina data. Extrahering av datamappning ger nödvändiga data till Omniscripts, integreringsprocesser och Flexcards.
Konfigurera extraheringen av datamappning, definiera den inledande extraheringen, lägg till formler, lägg till fält, skapa mappning och ange egenskaper. Se Konfigurera ett Omnistudio Data Mapper-extrakt.
Avgör om du behöver flera extraheringssteg eller relationsnotation. Se När man ska använda flera extraheringssteg och Relationsnotation jämfört med flera extraheringssteg.
Extrahering av datamappningsturbo
Extrahering av datamappningsturbo hämtar data från en enskild Salesforce-objekttyp och inkluderar fält från relaterade objekt. Du kan filtrera data och välja fälten att returnera genom att mappa de relaterade objekten. Det går inte att använda formler, egen JSON, standardvärden eller transformationer på ett Turboextrakt för Data Mapper.
Jämfört med ett Data Mapper Extract erbjuder ett Data Mapper Turbo Extract enklare konfiguration och bättre prestanda vid körning.
Datamappningsinläsning
Datamappningsbelastning accepterar indata i JSON, XML eller egna format och skriver data till Salesforce-objekt. Du kan använda formler och attribut för dina data. Anta till exempel att en användare kör ett Omniscript som hanterar kundcase, avslutar inmatningen av data och sparar. Skriptet anropar en datamappningsinläsning för att registrera de data som angetts.
En datamappningsinläsning kan hämta indata på tre sätt:
- Omniscript- eller integreringsprocess — under körning bygger ett Omniscript- eller integreringsförfarande JSON med de data som behövs för verksamhetsanvändningen. När skriptet åberopar Data Mapper Load skickas JSON som indata.
- Data Mapper API REST-anrop — om ett anrop åberopar en Data Mapper genom att använda en POST-åtgärd kan nyttolasten för anropet inkludera JSON.
- Apex code — specificera JSON som en parameter i Apex code till Data Mapper Load.
För att ändra indata kan du definiera formler, transformera värden och ändra utdatatypen. Se Använda formler i Omnistudio Data Mappers. För att specificera hur resulterande data skrivs till Salesforce-objekt mappar du fält från JSON för utdata till fält i Salesforce-objekt. Se Konfigurera en Omnistudio Data Mapper-inläsning. När Data Mapper Load åberopas tillämpar den sina mappningar och formler på indata för att skapa utdata. Sedan läser den in utdata i Salesforce-objekt enligt mappningarna.
Transformera datamappning
Datamappningstransformation utför transformation av mellanliggande data utan att läsa från eller skriva till Salesforce-objekt. Du kan lägga till formler till data.
Datamappningstransformation utför dessa uppgifter:
-
Konvertera en indata till en utdata och vice versa. Indata och utdata kan vara i JSON- eller XML-format.
-
Omstrukturera indata och byt namn på fält.
-
Ersätt värden i fält (alla datamappningar kan ersätta värden)
-
Konvertera data till PDF-, Docusign- eller dokumentmallformat.
Transformera datamappning är viktigt för Omniscripts som måste fylla i en dokumentmall. Se Skapa ett datamappningsgränssnitt för att mappa ett OmniScript till DocuSign . Det är även viktigt att fylla i fält i ett PDF-dokument. Se Skapa ett datamappningsgränssnitt för att mappa ett OmniScript till en PDF.
- Arbeta med Omnistudio Data Mappers
Använd Data Mapper Designer för att bygga och konfigurera processer på serversidan som deklarativt hämtar, skriver och ändrar data. Du kan skapa Datamappningar från appen Omnistudio eller Datamappningar. Eller så kan du skapa dem från Datamappningselement i integreringsprocesser och Omniscripts. - Bygg en Omnistudio Data Mapper
För att hämta, spara och ändra Salesforce-data, bygg Datamappningar med de grundläggande konfigurationerna: Indatakälla, sökfrågor, formler, mappningar av indata och utdata och utdatadestination. Vilka konfigurationer som är tillgängliga beror på vilken typ av Data Mapper du bygger. - Åberopa Omnistudio-datamappningar
Det är enkelt att bygga och återanvända och du kan anropa Datamappare från andra Omnistudio-verktyg, som integreringsprocesser, Omniscripts och Flexcards. Men Apex klasser, batchjobb eller REST API kan även anropa Datamappare. Med en datamappning kan du centralt hantera datatransaktioner för användning i flera program. - Säkerhet för Omnistudio Data Mappers och integreringsprocesser
Du kan styra åtkomst till datamappningar och integreringsprocesser med hjälp av inställningar som refererar till Delningsinställningar och delningsuppsättningar eller Profiler och behörighetsuppsättningar. - Förhandsgranska och testa datamappningar
Du kan förhandsgranska och testa indata och utdata för en Data Mapper i Data Mapper Designer. - Exempel på Omnistudio Data Mappers
För varje typ av Datamappning visar exempel hur de är konfigurerade för specifika, vanliga användningsområden. Varje exempel ger exempel på JSON för indata. Varje visar inställningarna för indata, utdata, mappning, sökfråga och formel, enligt vad som gäller för typen Datamappning och användningsfallet.
