Opsæt en datakilde på et Flex Card

Opsæt en SOQL-forespørgselsdatakilde

Konfigurer en datakilde til at bruge en SOQL-forespørgsel (Salesforce Object Query Language) til at søge i en organisations data efter specifikke oplysninger. SOQL-forespørgsler krypteres, så Flexcards ikke viser forespørgselsoplysninger på klientsiden.

Bemærk

Når du tilknytter felter, er det kun felter i feltvælgeren, der har ikke-nul-værdier for den specifikke registrering i testforespørgslen, der er synlige. Brug en testregistrering, som du ved, har ikke-nul-værdier for alle felter, der skal tilknyttes. Eller brug tilpassede felter, hvis testregistreringen ikke har sådanne felter.

1. Hvis du vil håndhæve sikkerhed på feltniveau for en SOQL-forespørgsel:
   1. Fra Opsætning skal du vælge og åbne Omni Interaction Configuration.
   2. Klik på Ny Omni Interaction-konfiguration.
   3. For Navn og Betegnelse skal du skrive EnableQueryWithFLS. For Value (Værdi) skal du angive true.
   4. Gem dine ændringer.

   Når indstillingen EnableQueryWithFLS er aktiveret, viser Flexcards kun de felter, som brugeren har tilladelse til at se. Alle felter, som brugeren ikke har adgang til, er skjult.

   

   Vigtigt I ugen den 2. februar 2026 aktiverer Salesforce som standard indstillingen EnableQueryWithFLS for at forbedre organisationssikkerheden. Gennemse og forbered din konfiguration på en problemfri overgang og for at forhindre potentielle serviceafbrydelser. Se Sikkerhedskontrol for Omnistudio.
2. Angiv en SOQL-forespørgsel og andre indstillinger efter behov.
   Hent f.eks. op til 10 felter fra objektet Kontakt, når der er en eksisterende mailadresse ved brug af denne forespørgsel:

   SELECT Id, Name, Email, Phone, Title FROM Contact WHERE Email != Null LIMIT 10

Opsæt en SOSL-søgedatakilde

Konstruer tekstbaserede søgeforespørgsler op mod søgeindekset med Salesforce Object Search Language (SOSL). Ved at bruge en enkelt forespørgsel kan du søge i tekst-, mail- og telefonfelter efter flere objekter, som du har adgang til, herunder tilpassede objekter. SOSL-forespørgsler krypteres, så forespørgselsoplysningerne ikke er synlige på klientsiden. Hvis du vil håndhæve sikkerhed på feltniveau for en SOSL-forespørgsel, skal du navigere til Opsætning og tilføje EnableQueryWithFLS Omni Interaction-konfigurationen og indstille den til true: EnableQueryWithFLS=true

Vigtigt I ugen den 2. februar 2026 aktiverer Salesforce som standard indstillingen EnableQueryWithFLS for at forbedre organisationssikkerheden. Gennemse og forbered din konfiguration på en problemfri overgang og for at forhindre potentielle serviceafbrydelser. Se Sikkerhedskontrol for Omnistudio.

1. Angiv søgeudtrykket.
2. Vælg de felter, der skal søges fra.
3. Vælg mindst et sObject og et felt, der skal søges i.
4. Hvis der er behov for det, kan du angive en grænse for det maksimale antal rækker, der skal returneres.
5. Angiv andre søgeoplysninger efter behov.

Opsæt en Apex

Konfigurer en datakilde til at kalde en Apex og -metode, der henter data for at udfylde et FlexCard. Apex kan køre asynkront, hvilket øger CPU-tiden, men sikrer, at lange kørselstransaktioner ikke udløber. En Apex er en Apex, der implementerer VlocityOpenInterface.

1. Vælg en Apex og -metode.
   Se Vis Apex-klasser.
   Dette eksempel viser en Apex-klasse-RemoteActionClass med en getAccounts-metode:

   global class RemoteActionClass implements [Namespace].VlocityOpenInterface2 {
   
       public Boolean invokeMethod(String methodName, Map<String,Object> input, Map<String,Object> outMap, Map<String,Object> options) {
           if (methodName.equals('getAccounts')) {
               getAccounts(input, outMap, options);
           }
           return true;
       }
       public void getAccounts(Map<String,Object> input, Map<String,Object> outMap, Map<String,Object> options) {
           String accountName = String.valueOf(input.get('account'));
           List<Account> accounts = new List<Account>();
           
           if (String.isBlank(accountName)) {
               accounts = [SELECT Id, Name, Phone FROM Account];
           } else {
               accounts = [SELECT Id, Name, Phone FROM Account WHERE Name Like :('%' + accountName + '%')];
           }
           outMap.put('accounts', accounts);
       }
   }

2. Vælg, om opkaldet skal køres asynkront gennem Apex.
3. Hvis der er behov for det, kan du angive et interval i millisekunder for at kontrollere svarstatussen.
4. Hvis der er behov for det, kan du overføre værdier fra FlexCard til fjernklassemetoden:
   1. Tilføj et inputkort.
   2. I Nøgle skal du angive en kontekst-id-variabel.
   3. Angiv variabelværdien i Værdi.

   Angiv f.eks. AccountId-nøglen og en registrerings konto-id som værdien.

5. Hvis der er behov for det, kan du sende yderligere nøgleværdipar til inputkortet, der overføres til fjernmetoden:
   1. Tilføj et indstillingskort.
   2. Angiv værdierne.
      

      Bemærk

      Værdifelterne understøtter statiske værdier og flettefelter som f.eks. {recordId} eller {name}.

6. Angiv andre Apex efter behov.

Opsæt en Apex REST-datakilde

Konfigurer en datakilde til at bruge et Apex REST-kald til at hente data til at udfylde felter på et FlexCard med GET-metoden. Brug POST-metoden til at sende data tilbage til serveren.

Bemærk

Hvis du ønsker optimal fleksibilitet og nemmere implementering, skal du bruge en integrationsprocedure som en datakilde til at udføre flere handlinger i et enkelt serverkald. Se Opsæt en integrationsprocedure-datakilde.

1. Angiv slutpunkts-URL'en, f.eks. /services/apexrest/{namespace}/CardTestApexRestResource/{recordId}.
   Dette eksempel viser en REST-klasse:

   @RestResource(urlMapping='/v1/typeahead/*') 
   
   global with sharing class TypeaheadApexRest {
       @HttpGet
       global static void doGet()
       {
           RestResponse res = RestContext.response;
           res.responseBody =blob.valueOf('["amazon","airbnb","amazon prime","american airlines","american express","apple","aol mail","at\u0026t","apple store","adele"]');
       }
       
       @HttpPost
       global static void doPost()
       {
           RestRequest req = RestContext.request;
           RestResponse res = RestContext.response;
           
           res.responseBody = blob.valueOf(JSON.serialize(new Map<String, Object>{'someResponse' => 'Post is done'}));
       }
   }

2. Vælg en metodetype:
   • GET: Anmod om data baseret på parametrene for URL'en.
   • POST: Send JSON-data.
3. For POST-metoden skal du angive de JSON-data, der skal sendes i feltet JSON-data.
   Du kan bruge kontekstvariabler til at overføre overtagne værdier med begge metoder.
4. Angiv andre Apex REST-datakildeoplysninger efter behov.

Opsæt en Omnistudio Data Mapper-datakilde

Konfigurer en Data Mapper-datakilde til at hente data fra en Data Mapper-udtrækning. Sikkerhed på feltniveau understøttes fuldt ud.

1. Find og vælg den datatilknytning, der skal bruges.
2. Hvis der er behov for det, kan du overføre værdier fra FlexCard til Data Mapper's inputparametre:
   1. Tilføj et inputkort.
   2. I Nøgle skal du angive en kontekst-id-variabel.
   3. Angiv variabelværdien i Værdi.

   Angiv f.eks. AccountId-nøglen og en registrerings konto-id som værdien.

   

   Bemærk

   Feltet Værdi understøtter statiske værdier og flettefelter som f.eks. {recordId} eller {name}.

3. Angiv andre Data Mapper-datakildeoplysninger efter behov.

Opsæt en REST-datakilde

Konfigurer en REST-datakilde ved at hente eller sende data gennem en offentlig API, f.eks. vejrdata fra en vejr-API baseret på en polices postnummer. Du kan også bruge navngivne legitimationsoplysninger til at godkende Apex, der angiver URL'en for et udkaldsslutpunkt og dens påkrævede godkendelsesparametre i en definition.

1. Vælg REST-typen og derefter metodetypen:
   • GET: Anmod om data baseret på parametrene for URL'en.
   • POST: Send JSON-data.
2. For den navngivne legitimationsoplysningstype REST:
   1. Vælg en navngiven legitimationsoplysning.
   2. Angiv en relativ sti til hentning af data, f.eks. My_Payroll_System/paystubs?format=json.
3. For Web REST-type skal du angive REST-slutpunkts-URL'en, f.eks. http://api.weatherstack.com/current?access_key={Session.weatherAPIkey}&query={BillingCity}.
4. For POST-metoden skal du angive de JSON-data, der skal sendes i feltet JSON-data.

   Du kan bruge kontekstvariabler til at overføre overtagne værdier med begge metoder.

5. Tilføj om nødvendigt anmodningssidehoveder, f.eks. tokener, offentlige nøgler eller indholdstype:
   1. Tilføj et nøgle-værdi-par.
   2. I Nøgle skal du angive en kontekst-id-variabel.
   3. Angiv variabelværdien i Værdi.
6. Angiv andre REST-datakildeoplysninger efter behov.

Opsæt en integrationsprocedurdatakilde

Konfigurer en datakilde til at bruge en integrationsprocedure, der eksekverer flere handlinger i et enkelt serverkald. Du ønsker f.eks., at dine kundeservicerepræsentanter skal se vejrprognosen for policere, når de er i gang med et opkald. Dette gør du ved at bruge en integrationsprocedure med en Data Mapper-udtrækning, der returnerer en kontos postnummer. Brug derefter et REST API-kald, der henter den aktuelle prognose for kontoens område baseret på postnummeret.

1. Find og vælg den integrationsprocedure, der skal bruges.
2. Hvis der er behov for det, kan du overføre værdier fra FlexCard til integrationsproceduren:
   1. Tilføj et nøgle-værdi-par.
   2. I Nøgle skal du angive en kontekst-id-variabel.
   3. I Værdi skal du angive variabelværdien i {}, {}, ... format. Matriksformat understøttes ikke.
   

   Bemærk

   Værdifelterne understøtter statiske værdier og flettefelter som f.eks. {recordId} eller {name}.

   matrix, hvis objekter i form af [{},{}] vil bryde interpoleringslogik, da det kun accepterer data i formatet {}, Kan ikke overføre matrix af objekter som inputparametre til IP-datahandling fra et Flexcard til [Doc] Kan ikke overføre matrix af objekter som inputparametre til IP-datahandling fra et Flexcard

   Angiv f.eks. AccountId-nøglen og en registrerings konto-id som værdien.

3. Hvis du bruger Omnistudio Winter '23 eller nyere, skal du konfigurere din integrationsprocedure til at bruge klassen Fortsæt i Apex til at foretage en længerevarende anmodning til en ekstern webtjeneste:
   1. Tilføj et indstillingskort.
   2. Skriv useContinuation i Nøgle.
   3. Skriv true i Værdi.

   Se Fortsætningsklasse.

4. Føj om nødvendigt eksempeldata til integrationsproceduren.

   Se Reaktion for integrationsprocedurer.

5. Angiv andre integrationsprocedure-datakildeoplysninger efter behov.

Opsæt en streaming-API-datakilde

Streaming-API-metoden bruger push-teknologi, som er en udgivelses- og abonnementsmodel, der overfører oplysninger, der er initieret fra en server til klienten baseret på kriterier, som du definerer. Den har en vedvarende forbindelse, der kontinuerligt leverer nye data, efterhånden som de bliver tilgængelige, snarere end at bruge klientpolling. Ved at bruge streaming-API reducerer du antallet af API-kald og forbedrer dermed ydeevnen.

1. Vælg streaming-API-typen:

   • PushTopic: SOQL-forespørgsel, der returnerer et resultat, der adviserer lytterne om registreringsændringer i Salesforce ved brug af en API-streamingkanal. Brug f.eks. denne metode til at blive adviseret, når nogen opretter en sag for en type, en status eller begge.

   • Streaming Channel: Streaming-API, der sender adviseringer om generelle begivenheder, der ikke er relateret til Salesforce-dataændringer. Du kan bruge denne metode til enhver applikation, der sender tilpassede adviseringer, f.eks. en chatapplikation.

   • Platformsbegivenhed: Begivenhedsstyret meddelelsesarkitektur, der gør det muligt for apps at kommunikere i og uden for Salesforce. En platformsbegivenhed kombinerer PushTopic- og streamingkanaltyper. I stedet for at arbejde med et sObject, fungerer platformsbegivenheder med tilpassede objekter.

2. I Kanal skal du angive URL'en til streaming-API'en.
3. Vælg handlingstypen, uanset om de hentede data erstatter eller føjer til de eksisterende data.
4. Fra pluklisten Hent alle meddelelser skal du vælge en af disse indstillinger:
   • True: Hent alle data fra de sidste 24 timer.
   • Falsk: Få den seneste dataopdatering.
5. Angiv andre streaming API-datakildeoplysninger efter behov.

Opsæt en tilpasset datakilde

Integrer direkte tilpassede JSON-data i Flexcard uden at være afhængig af en ekstern datakilde. Konfigurer disse tilpassede data til at teste med midlertidige statiske data, f.eks. når du venter på API-adgang eller til hurtig koncepttest.

1. Angiv din tilpassede JSON-kode, f.eks.:

   [
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000TOF0eAAH"
   		},
   		"Name": "Perry",
   		"Id": "0033700000TOF0eAAH",
   		"Phone": "(734) 489-5851",
   		"AccountId": "0013700000NVVLvAAP",
   		"Email": "perry@vlocity.com",
   		"MailingAddress": {
   			"city": "Concord",
   			"country": "US",
   			"geocodeAccuracy": null,
   			"latitude": null,
   			"longitude": null,
   			"postalCode": "53813",
   			"state": "WI",
   			"street": "856 4th Avenue #76"
   		},
   		"CreatedDate": "2017-06-14T18:53:11.000+0000"
   	},
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000TOB6mAAH"
   		},
   		"Name": "Robert0 Taylor",
   		"Id": "0033700000TOB6mAAH",
   		"Phone": "(888) 888-8888",
   		"AccountId": "00137000007D63JAAS",
   		"MailingAddress": {
   			"city": "SF",
   			"country": "US",
   			"geocodeAccuracy": null,
   			"latitude": null,
   			"longitude": null,
   			"postalCode": "99999",
   			"state": "CA",
   			"street": "50 Santa Rita St"
   		},
   		"CreatedDate": "2017-06-13T21:08:25.000+0000"
   	},
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000TNvK0AAL"
   		},
   		"Name": "c1",
   		"Id": "0033700000TNvK0AAL",
   		"AccountId": "0013700000NVE4tAAH",
   		"MailingAddress": null,
   		"CreatedDate": "2017-06-08T20:13:41.000+0000"
   	},
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000TNvKKAA1"
   		},
   		"Name": "c2",
   		"Id": "0033700000TNvKKAA1",
   		"AccountId": "0013700000NVE4tAAH",
   		"MailingAddress": null,
   		"CreatedDate": "2017-06-08T20:13:50.000+0000"
   	},
   	{
   		"attributes": {
   			"type": "Contact",
   			"url": "/services/data/v49.0/sobjects/Contact/0033700000Vs6RzAAJ"
   		},
   		"Name": "Smith",
   		"Id": "0033700000Vs6RzAAJ",
   		"Phone": "(300) 333-3763",
   		"AccountId": "001370000098i8mAAA",
   		"MailingAddress": {
   			"city": "SF",
   			"country": "US",
   			"geocodeAccuracy": null,
   			"latitude": null,
   			"longitude": null,
   			"postalCode": "99999",
   			"state": "CA",
   			"street": "50 Fremont St"
   		},
   		"CreatedDate": "2017-08-16T20:26:07.000+0000"
   	}
   ]

2. Angiv andre tilpassede datakildeoplysninger efter behov.

Automatisk startede forløb i Flexcards

Tilslut et Flex Card direkte til et Salesforce-autostartet forløb. Det automatisk startede forløb kører i baggrunden uden en brugergrænseflade, så du kan genbruge eksisterende forretningslogik.

Et automatisk startet forløb er et forløb, der kører i baggrunden og ikke kræver brugerinteraktion. Denne type forløb understøtter ikke skærme og lokale handlinger. Et automatisk startet forløb giver dine brugere mulighed for at interagere med oplysninger på en skærm eller se oplysninger, der vises for dem. Se Forløbstyper for at få flere oplysninger.

Brug et automatisk startet forløb som en datakilde til at udfylde kortet med forløbets output, når kortet indlæses, eller brug det som en handling til at køre det automatisk startede forløb, når en bruger interagerer med kortet.

Bemærk Automatisk startede forløb understøttes kun i Omnistudio-standarddesignere.

• Tilføj automatisk startet forløb som Flexcard-datakilde
  Føj et automatisk startet forløb til et Flex Card, og brug det som en datakilde til at udfylde kortet med forløbets output.
• Tilføj automatisk startet forløb som Flexcard-handling
  Tilføj et automatisk startet forløb som en handling, så det kører, når en bruger interagerer med kortet.