Konfigurera en inläsning av Omnistudio Data Mapper

Konfigurera en datamappningsinläsning genom att specificera objekttyp och filter. För att förbättra prestandan för Data Mapper Load kan du definiera formler, lägga till fält att skriva data till och konfigurera ytterligare egenskaper.

1. Sök fram och öppna Datamappningar i Appstartaren.
2. Välj den Datamappningsinläsning som du vill konfigurera.
3. Klicka på Objekt och lägg till ett laddningsobjekt för Datamappning:
   • För att lägga till ett objekt, klicka på +. Om du använder designern i ett hanterat paket, klicka på Lägg till objekt.
   • Sök efter och välj ett objekt i listan Ladda objekt.
4. Klicka på Formel, lägg till en formel och definiera den för Datamappningsinläsning. Se Använda formler i Omnistudio Data Mappers.
   1. För att lägga till ett formelblock, klicka på +. Om du använder designern i ett hanterat paket, klicka på Lägg till formel.
   2. I fältet Formel, ange önskad logik.
   3. I fältet Formelresultatsökväg, specificera en JSON-nod som du vill lagra formelresultatet i.
   4. Om du använder denna Datamappning i testsyfte, inaktivera formeln. Klicka på och sedan på Inaktivera. Om du använder designern i ett hanterat paket, markera kryssrutan Inaktiverad.
5. Klicka på Mappning och klicka sedan på Skapa mappning. Om du använder designern i ett hanterat paket, klicka på Fält och klicka sedan på +.

   Du kan även använda alternativet Snabbmatchning för att snabbt matcha ett inmatningsfält till ett utmatningsobjektfält. Du kan matcha fält antingen manuellt med alternativet Par eller automatiskt med alternativet Automatisk matchning.

   1. Konfigurera dessa inställningar för mappning:
      • Indata-JSON-sökväg: Nyckeln för JSON-noden som innehåller de data du vill skriva till Salesforce.
      • Domänobjekt: Det Salesforce-objekt som du vill mappa till.
      • Domänobjektfält: Fältet i Salesforce-objektet som du vill uppdatera. I fält som innehåller JSON-data går det inte att mappa JSON-noder individuellt. Stränga alla JSON-noder som har värden för att säkerställa att inga JSON-data förloras. Till exempel:

        "JsonField": "{\"JsonNode1\":\"Text\", \"JsonNode2\":100, \"JsonNode3\":true}"

        Om du uppdaterar flera Salesforce-objekt visar designern en separat flik för mappningarna av varje målobjekt. Se Flera relaterade objektinläsningar (länkmappningar).

      • Lägg till nyckelvärdepar: Dessa mappningsinställningar kopierar värdet till en JSON-nod på högsta nivå som specificerats som en nyckel.
   2. För att styra hur mappningen utförs kan du konfigurera dessa valfria inställningar. Om du använder designern i ett hanterat paket, klicka på Alla och konfigurera dessa inställningar:
      • Utdatatyp: Måste vara kompatibel med datatypen för målfältet. Inställningen Utdatatyp måste vara kompatibel med målfältet i Salesforce. Om du konfigurerar inkompatibla typer kan inläsningen misslyckas. En lista över giltiga utdatatyper finns i Datatyper för Omnistudio Data Mapper-utdata.
      • Standardvärde: Värde som ska läsas in om fältet i JSON för datamappningsutdata är null. För att specificera en tom sträng för strängfält som är null, ange ett par dubbla citattecken (""). Utelämna om infoga krävs har aktiverats.
      • Inaktiverad: Förhindrar att fältet läses in.
      • Infoga nyckel: Anger att fältet är en nyckel för Salesforce-objektet som läses in. Datamappningen använder värdet för att avgöra om den uppdaterar en befintlig post eller infogar en ny. Om egenskapen Uppåtinfoga är aktiverad för flera fältmappningar blir resultatet en nyckel för flerfältsinfoga. Datamappningen använder denna nyckel för att kontrollera objektet efter unika värden för att avgöra om ett objekt ska skapas eller uppdateras. Använd inte ett ID som uppåtinfoga nyckel. Om indata innehåller ett ID uppdaterar Datamappningen posten. Om inmatningen inte innehåller ett ID skapar Data Mapper en post.
      • Krävs för Infoga/uppdatera: Om detta fält är null förhindrar det att en objektpost uppdateras.
      • Sökning: Använder fältvärdet för att fråga efter specificerade Salesforce-data och skriver resultatet till utdatafältet.
   3. Spara dina ändringar. Om du vill lägga till fler mappningar, klicka på Spara och ny. Om du använder designern i ett hanterat paket, klicka på +.
6. För att konfigurera ytterligare egenskaper, klicka på Alternativ och konfigurera dessa egenskaper:
   • Ignorera fel: Kör datamappningen även om fel uppstår och hoppa endast över de steg som har fel. Detta alternativ är användbart när du vet att en post kommer att misslyckas med begränsade data och framtida steg inte förlitar sig på tidigare steg.
   • Återkalla vid fel: Skapa eller uppdatera inte sObjects om fel uppstår. Mer information finns i Apex transaktioner och transaktionskontroll.
   • Använd tilldelningsregler: Använd tilldelningsregler för sObjects, till exempel Kundcase som har användartilldelningsfält. Mer information finns i Konfigurera tilldelningsregler. Ej inloggade gästanvändare kan inte utlösa tilldelningsregler. Om e-postmeddelanden har konfigurerats i tilldelningsregler för kundcase skickas automatiskt e-postmeddelanden till användare när kundcase tilldelas.
   • Inkludera nullvärden i svaret: Inkludera fält med nullvärden i svarsutmatningen för Datamappning.
   • Ta bort vid framgång: När indatatypen är sObject, använd detta alternativ för att automatiskt ta bort massposter efter att data har massinlästs.
   • Är standard för gränssnitt: När indatatypen är sObject, specificera denna datamappning som standardpaketet för det specificerade gränssnittobjektet.

• Skapa gränssnittobjekt för en datamappningsinläsning
  Tillhandahåll externa data, till exempel en CSV-fil, som en indata till en datamappningsinläsning. De externa data kan importeras till ett gränssnittsobjekt, som är ett eget Salesforce-objekt med hjälp av ett dataimportverktyg. Mappa sedan fälten från det egna objektet till målposterna i Salesforce med hjälp av en datamappningsinläsning. När du läser in data till ett eget Salesforce-objekt utlöses en Apex som anropar en Data Mapper Load. Datamappningen tar data från gränssnittsobjektet och skriver resulterande data till andra Salesforce-postobjekt.
• Flera relaterade objektinläsningar (länkmappningar)
  När du läser in data i en sekvens av objekt kan du propagera data direkt från ett objekt till ett annat relaterat objekt. Du kan till exempel använda en Omnistudio Data Mapper Load för att stödja ett Omniscript som skapar ett konto och en kontakt för kontot.