InsScheduledAutomatedTransitionService:scheduleAutomatedTransition

Classe: InsScheduledAutomatedTransitionService

Metodo: scheduleAutomatedTransition

Funzionamento

Questa transizione è per i flussi di lavoro del modello di stato Vlocity. Gli schemi di pianificazione complessi (ogni due giorni, ogni primo lunedì del mese, ecc.) non sono supportati.

1. Con gli input objectName e fieldName (e gli input typeName e typeValue facoltativi), viene determinata la versione specifica del modello di stato di Vlocity che rappresenta il flusso di lavoro.

2. Con gli input fromState e toState, viene determinata la transizione stato Vlocity specifica all'interno di quel flusso di lavoro, ovvero nella versione del modello stato Vlocity del passaggio precedente. Gli input della pianificazione forniscono informazioni sulla frequenza e la data di esecuzione di un processo pianificato Salesforce che eseguirebbe la transizione automatica dello stato, da 'fromState' a 'toState'. Ogni volta che il processo pianificato viene eseguito, esegue queste azioni:

   1. Recuperare fino a 5 istanze del tipo rappresentato da 'objectName', dove il valore del campo rappresentato da 'fieldName' = il valore rappresentato da 'fromState'. Ciò garantisce che solo le istanze oggetto che si trovano attualmente nello stato rappresentato da 'fromState' vengano selezionate per eseguire la transizione.

   2. Vengono eseguite tutte le regole di transizione stato Vlocity configurate per la transizione stato Vlocity specificata (come determinato nel passaggio 2 precedente).

   3. Se il risultato complessivo dell'esecuzione della regola (governata dai criteri di completamento della transizione impostati sulla transizione stato Vlocity) è true, ad esempio l'esecuzione della regola passata, lo stato dell'istanza dell'oggetto viene aggiornato allo stato e rappresentato da 'toState'.

   4. Se il risultato complessivo dell'esecuzione della regola è false, ovvero l'esecuzione della regola non è riuscita, lo stato dell'istanza dell'oggetto viene aggiornato allo stato Alternativo configurato nella transizione di stato di Vlocity, se esistente.

   5. Se lo stato dell'istanza dell'oggetto viene aggiornato a un nuovo stato ('toState' o lo stato alternativo per la transizione specificata), vengono eseguite le azioni Vlocity corrispondenti configurate per quello stato (ad esempio il campo 'To State' in Azione Vlocity).

   6. Il numero di istanze oggetto il cui stato è stato aggiornato a 'toState' viene restituito in 'noOfUpdatedRecords'. Il numero di istanze oggetto il cui stato è stato aggiornato allo stato Alternativo viene restituito in 'noOfUpdatedRecordsToAlternateStates'.

   7. Se non è stata eseguita alcuna transizione, l'istanza dell'oggetto rimane in 'fromState'.

Input

Input	Descrizione
objectName	Obbligatorio. Nome API oggetto
fieldName	Obbligatorio. Nome API del campo che ospita il valore dello stato.
fromState	Obbligatorio. Dal valore del campo Stato (origine) della transizione tra stati.
toState	Obbligatorio. Valore del campo A stato (target) della transizione tra stati.
typeName	Facoltativo. typeName rappresenta il valore deltypeFieldName_c campo del modello di stato Vlocity. Questo è il nome di un campo di un altro oggetto per cui è in corso la configurazione di una determinata istanza del modello di stato di Vlocity. Ad esempio, potrebbe essere impostato come campo 'Type__c' per l'oggetto 'Application__c'.
typeValue	Facoltativo. typeValuerappresenta il valore deltypeFieldValue_c campo del modello di stato Vlocity. Questo è un valore specifico per il campo rappresentato dall'input 'typeName'. La combinazione di <typeName, typeValue> viene utilizzata per selezionare un modello di stato Vlocity specifico. Nota Ad esempio, con typeName = 'Type__c' e typeValue = 'Individual Provider', verrà utilizzato uno specifico modello di stato Vlocity configurato per l'oggetto Application__c.
schedule	Oggetto mappa che contiene chiavi pattern, startTime e dayOfTheWeek (vedere sotto) per pianificare l'esecuzione della transizione.
schedule.pattern	Obbligatorio. Valore stringa HOURLY, DAILY, o WEEKLY.
schedule.startTime	Formato: HH:MM, ora militare. Non obbligatorio se schedule.pattern = HOURLY.
schedule.dayOfTheWeek	Valore stringa. Valori accettabili: SUN, MON,TUE, WED, THU, FRI o SAT. I giorni possono anche essere rappresentati numericamente, da 1 a 7, dove domenica = 1, lunedì = 2, ecc. Obbligatorio se schedule.pattern = WEEKLY.

Input JSON

Di seguito è riportato un esempio di JSON di input il cui schema di pianificazione è settimanale alle 13:30 ogni lunedì:

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

JSON di output

Il JSON di output mostra il numero di record aggiornati (massimo cinque) ed elenca le eventuali eccezioni.

{
"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.>
}