Hent data med en integrationsprocedure i et Omniscript

Fra et Omniscript skal du kalde en integrationsprocedure for at hente Salesforce-data og eksterne data. Du kan køre flere handlinger som en headless-tjeneste (uden brugergrænseflade) gennem JavaScript eller Apex Service.

Før du går i gang, skal du oprette en integrationsprocedure til håndtering af Omniscript-data.

Bemærk Når du føjer den samme integrationsprocedurehandling til to eller flere Omniscripts, der har en overordnet-underordnet-relation, skal du angive værdierne i det overordnede Omniscript, selvom værdien er beregnet til brug i det underordnede Omniscript.

1. Når du har tilføjet et integrationsprocedureelement, skal du i fjernegenskaberne aktivere integrationsprocedurens indstillinger for kæde, der kan sættes i kø:

   Egenskab	Værdi
   Future Method Brug Future (i designeren for en administreret pakke)	Angiver, at integrationsproceduren kører asynkront som en fremtidig Salesforce-metode, som ikke kan returnere nogen data til den kaldende Omniscript.
   Kæledyr	Aktiverer indstillingerne for Kan kædes for den underordnede integrationsprocedure.
   Brug fortsættelse	Aktiverer en underordnet integrationsprocedure, der kalder langsigtede handlinger til at bruge Apex.
   Købar	Aktiverer trin, der kan kædes, i den underordnede integrationsprocedure for at starte job, der kan sættes i kø.
   Kæledrevet kæde	Aktiverer indstillinger for Kædebeskyttet i integrationsproceduren.

2. I Fjernindstillinger skal du tilføje dette nøgle-værdi-par:

   Nøgle	Værdi
   useQueueableApexRemoting	true

3. Brug egenskaben Ekstra data for at sende yderligere nøgle-værdi-par til integrationsproceduren som inputdata.
4. Angiv eventuelle yderligere egenskaber for integrationsprocedurehandlinger, du har brug for.
5. Brug egenskaberne Send/svar-transformationer til at angive inputtet og til at beskære eller omdøbe output-JSON.

   • Send JSON-sti – Angiver den JSON-node, der indeholder inputtet for integrationsproceduren. Dette er typisk navnet på et tidligere element i Omniscript.

   • Send JSON-node – Omdøb den JSON-node, der indeholder inputtet for integrationsproceduren. Dette er typisk navnet på en af integrationsprocedurens inputparametre.

   • Svar JSON-sti – Angiver den JSON-node, der indeholder outputtet, der skal returneres til Omniscript. Alle integrationsproceduredata returneres som standard.

   • Svar-JSON-node – Omdøb den JSON-node, der indeholder outputtet for at vende tilbage til Omniscript. Dette er typisk navnet på et efterfølgende element i Omniscript.

   Se Manipuler JSON med Egenskaber for Send/svar-transformationer.

6. Vælg svaradfærden for handlingen ved at vælge en Kaldetilstand.

   • Standard – Blokerer brugergrænsefladen med en indlæsningsspinner.

   • Ikke-blokerende – Kører asynkront, og svaret anvendes på brugergrænsefladen. Før og efter Omnistudio Data Mapper-transformationer, og store vedhæftede filer understøttes ikke. Når Kaldtilstand er indstillet til ikke-blokering, vil elementer, der bruger standardværdier, ikke modtage svaret, da elementet indlæses, før svaret returneres. Hvis du vil tilknytte svaret til et element, skal du indstille Svar-JSON-noden til VlocityNoRootNode og Svar-JSON-sti til navnet på elementet.

   • Fire og Glem – Kører asynkront uden tilbagekald til brugergrænsefladen. Før- og Send datatilknytning-transformationer og store vedhæftninger understøttes ikke. Et svar vises stadig på fejlretningskonsollen, men det vil ikke blive anvendt på Data JSON.

7. Når Kaldtilstand er indstillet til ikke-blokering, modtager elementer, der bruger standardværdier, ikke svaret, da elementet indlæses, før svaret returneres. Du skal konfigurere disse egenskaber for at tilknytte svaret til et element:

   Egenskab	Værdi
   Svar-JSON-node	VlocityNoRootNode
   Svar JSON-sti	Navnet på det Omniscript-element, der modtager værdien.

   Se Manipuler JSON med Egenskaber for Send/svar-transformationer.

Bemærk Når et Omniscript kalder en integrationsprocedure asynkront, fortsætter integrationsproceduren med at køre, hvis brugeren går til næste trin, men ikke, hvis brugeren navigerer væk fra Omniscript.