InsScheduledAutomatedTransitionService:scheduleAutomatedTransition

Klasse: InsScheduledAutomatedTransitionService

Methode: scheduleAutomatedTransition

De manier waarop het werkt...

Deze overgang is voor Vlocity-statusmodelwerkstromen. Complexe planningspatronen (elke twee dagen, elke eerste maandag van de maand, enz.) worden niet ondersteund.

1. Met de invoer objectName en fieldName (en de optionele invoer typeName en typeValue) wordt de specifieke Vlocity-statusmodelversie bepaald die de werkstroom vertegenwoordigt.

2. Met de invoer fromState en toState wordt de specifieke Vlocity-statustransitie binnen die werkstroom bepaald, d.w.z. binnen de Vlocity-statusmodelversie uit de vorige stap. De planningsinvoer geeft informatie over hoe vaak en wanneer een geplande Salesforce-taak moet worden uitgevoerd die de geautomatiseerde statusovergang zou uitvoeren, van 'fromState' naar 'toState'. Telkens wanneer de geplande taak wordt uitgevoerd, voert deze de volgende acties uit:

   1. Haal maximaal 5 exemplaren op van het type vertegenwoordigd door 'objectName', waarbij de waarde van het veld vertegenwoordigd door 'fieldName' = de waarde vertegenwoordigd door 'fromState'. Dit zorgt ervoor dat alleen die objectexemplaren die momenteel de status 'fromState' hebben, worden gekozen voor het uitvoeren van de overgang.

   2. Alle geconfigureerde Vlocity-statustransitieregels voor de opgegeven Vlocity-statustransitie (zoals bepaald in stap 2 hierboven) worden uitgevoerd.

   3. Als het algemene resultaat van de uitvoering van de regel (die wordt bepaald door de Voltooiingscriteria voor transitie die zijn ingesteld voor de Vlocity-statustransitie) true (waar) is, zoals de uitvoering van de regel die is doorgegeven, wordt de status van het objectexemplaar bijgewerkt naar de status en weergegeven door de 'toState'.

   4. Als het algemene resultaat van de uitvoering van de regel false (onwaar) is, d.w.z. als de uitvoering van de regel is mislukt, wordt de status van het objectexemplaar bijgewerkt naar de status Alternate (Alternatieve) die is geconfigureerd in de Vlocity-statustransitie, indien aanwezig.

   5. Als de status van het objectexemplaar wordt bijgewerkt naar een nieuwe status ('toState' of de alternatieve status voor de opgegeven Transitie), worden de overeenkomende Vlocity-acties uitgevoerd die voor die status zijn geconfigureerd (d.w.z. het veld 'To State' in Vlocity-actie).

   6. Het aantal objectexemplaren waarvan de status is bijgewerkt naar 'toState', wordt geretourneerd in 'noOfUpdatedRecords'. Het aantal objectexemplaren waarvan de status is bijgewerkt naar de alternatieve status, wordt geretourneerd in 'noOfUpdatedRecordsToAlternateStates'.

   7. Als er geen overgang is uitgevoerd, blijft het objectexemplaar in de 'fromState'.

Invoer

Invoer	Beschrijving
objectName	Verplicht. API-naam van object
fieldName	Verplicht. Veld-API-naam die de waarde state host.
fromState	Verplicht. Waarde van het veld From State (origin) van de overgang naar state.
toState	Verplicht. Veldwaarde voor Staat/provincie (doel) van de overgang naar staat/provincie.
typeName	Optioneel. typeName vertegenwoordigt de waarde voor hettypeFieldName_c veld uit het Vlocity-statusmodel. Dit is de naam van een veld uit een ander object waarvoor een bepaald exemplaar van het Vlocity-statusmodel wordt geconfigureerd. Dit kan bijvoorbeeld worden ingesteld als veld 'Type__c' voor het object 'Application__c'.
typeValue	Optioneel. typeValuevertegenwoordigt de waarde voor hettypeFieldValue_c veld uit het Vlocity-statusmodel. Dit is een specifieke waarde voor het veld dat wordt vertegenwoordigd door de invoer 'typeName'. De combinatie van <typeName, typeValue> wordt gebruikt om een specifiek Vlocity-statusmodel te selecteren. Opmerking Met typeName = 'Type__c' en typeValue = 'Individual Provider' wordt bijvoorbeeld een specifiek Vlocity-statusmodel gebruikt dat is geconfigureerd voor het object Application__c.
schedule	Een toewijzingsobject dat pattern, startTime en dayOfTheWeek bevat (zie hieronder) om te plannen wanneer de overgang wordt uitgevoerd.
schedule.pattern	Verplicht. Tekenreekswaarde HOURLY, DAILY, of WEEKLY.
schedule.startTime	Notatie: UU:MM, militaire tijd. Niet verplicht als schedule.pattern = HOURLY.
schedule.dayOfTheWeek	Tekenreekswaarde. Aanvaardbare waarden: SUN, MON,TUE, WED, THU, FRI of SAT. Dagen kunnen ook numeriek worden weergegeven, van 1 tot 7, waarbij zondag = 1, maandag = 2, enz. Verplicht als schedule.pattern = WEEKLY.

Invoer-JSON

Hier is een voorbeeld van de invoer-JSON waarvan het planningspatroon elke maandag om 13:30 uur wekelijks is:

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

Uitvoer-JSON

De uitvoer-JSON toont het aantal bijgewerkte records (maximaal vijf) en vermeldt eventuele uitzonderingen.

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