InsScheduledAutomatedTransitionService:scheduleAutomatedTransition

Kategori: InsScheduledAutomatedTransitionService

Metode: scheduleAutomatedTransition

Sådan fungerer det

Denne overgang er for arbejdsflows for Vlocity-tilstandsmodel. Komplekse planlægningsmønstre (hver anden dag, hver første mandag i måneden osv.) understøttes ikke.

1. Med inputene objectName og fieldName (og de valgfri typeName og typeValue) bestemmes den specifikke Vlocity-tilstandsmodelversion, der repræsenterer arbejdsflowet.

2. Med inputene fromState og toState bestemmes den specifikke Vlocity-tilstandsovergang i dette arbejdsflow, dvs. i Vlocity-tilstandsmodelversionen fra det forrige trin. Planlægningsinputs giver oplysninger om, hvor ofte og hvornår der skal køres et Salesforce-planlagt job, der ville udføre den automatiserede tilstandsovergang, fra "fromState" til "toState". Hver gang det planlagte job kører, udfører det disse handlinger:

   1. Hent op til 5 forekomster af den type, der repræsenteres af "objectName", hvor værdien af det felt, der repræsenteres af "fieldName" = den værdi, der repræsenteres af "fromState". Dette sikrer, at kun de objektforekomster, der aktuelt er i den tilstand, der repræsenteres af "fromState", vælges til at udføre overgangen.

   2. Alle de konfigurerede Vlocity-tilstandsovergangsregler for den angivne Vlocity-tilstandsovergang (som bestemt fra trin 2 ovenfor) udføres.

   3. Hvis det generelle resultat fra regelkørslen (som er styret af overgangsfuldførelseskriterier, der er angivet på Vlocity-tilstandsovergangen) er sandt, f.eks. den overførte regelkørsel, opdateres objektforekomstens tilstand til tilstanden og repræsenteres af "toState".

   4. Hvis det generelle resultat fra regelkørslen er falsk, dvs. regelkørslen mislykkedes, så opdateres objektforekomstens tilstand til den alternative tilstand, der er konfigureret i Vlocity-tilstandsovergang, hvis den findes.

   5. Hvis objektforekomstens tilstand opdateres til en ny tilstand (enten "toState" eller den alternative tilstand for den angivne overgang), udføres de tilsvarende Vlocity-handlinger, der er konfigureret for denne tilstand (dvs. feltet "Til-tilstand" i Vlocity-handling).

   6. Antallet af objektforekomster, hvis tilstand blev opdateret til "toState", returneres i "noOfUpdatedRecords". Antallet af objektforekomster, hvis tilstand blev opdateret til tilstanden Alternativ, returneres i "noOfUpdatedRecordsToAlternateStates".

   7. Hvis der ikke er foretaget nogen overgang, forbliver objektforekomsten i "fromState".

Input

Input	Beskrivelse
objectName	Påkrævet. Objekt-API-navn
fieldName	Påkrævet. Felt-API-navn, der er vært for statsværdien.
fromState	Påkrævet. Fra feltværdien Stat (oprindelse) for tilstandsovergangen.
toState	Påkrævet. Til-state-feltværdien (mål) for tilstandsovergangen.
typeName	Valgfrit. typeName repræsenterer værdien fortypeFieldName_c feltet fra Vlocity-tilstandsmodel. Dette er navnet på et felt fra et andet objekt, som en given Vlocity-tilstandsmodelforekomst konfigureres for. Dette kunne f.eks. være angivet som feltet "Type__c" for objektet "Application__c".
typeValue	Valgfrit. typeValuerepræsenterer værdien fortypeFieldValue_c feltet fra Vlocity-tilstandsmodel. Dette er en specifik værdi for det felt, der repræsenteres af "typeName"-inputtet. Kombinationen af <typeName, typeValue> bruges til at vælge en specifik Vlocity-tilstandsmodel. Bemærk F.eks. vil en specifik Vlocity-tilstandsmodel, der er konfigureret for Application__c-objektet, blive brugt med typeName = 'Type__c' og typeValue = 'Individual Provider'.
schedule	Et kortobjekt, der indeholder pattern-, startTime- og dayOfTheWeek-nøgler (se nedenfor) til at planlægge, hvornår overgangen udføres.
schedule.pattern	Påkrævet. Strengværdi HOURLY DAILY, eller WEEKLY.
schedule.startTime	Format: TT:MM, militærtid. Ikke påkrævet, hvis schedule.pattern = HOURLY.
schedule.dayOfTheWeek	Strengværdi. Acceptable værdier: SUN, MON,TUE, WED, THU, FRI eller SAT. Dage kan også repræsenteres numerisk, fra 1 til 7, hvor søndag = 1, mandag = 2 osv. Krævet, hvis schedule.pattern = WEEKLY.

Input JSON

Her er et eksempel på input-JSON, hvis tidsplansmønster er ugentligt kl. 13:30 hver mandag:

{ 
   	"objectName":"prefix__Application__c",
  	"fieldName":"prefix__Status__c",
	"fromState":"New",
	"toState":"Submitted",
	"schedule":{
		"pattern":"WEEKLY",
		"startTime":"13:30",
		"dayOfTheWeek":"MON"
	}
}

Output JSON

Output-JSON viser antallet af opdaterede registreringer (maksimalt fem) og angiver eventuelle undtagelser.

{
"noOfRecordsForProcessing": <Number of records for processing from a search, max=5>,
"noOfUpdatedRecords": <Number of records that have successful 'from state' to 'to state' transition>,
"noOfUpdatedRecordsToAlternateStates": <Number of records that have successful 'from state' to 'alternate state' transition>,
"errors":<Consolidated error mapping between record ID and error detail. This is null when there's no error.>
}