Du er her:
InsScheduledAutomatedTransitionService:scheduleAutomatedTransition
Bruk denne tjenesten til å automatisere overgangen til en stat ved å planlegge en objekttilstandsovergang fra en opprinnelsesstat til en måltilstand (Vlocity States) ved å bruke mønstre per time, daglig eller ukentlig.
Klasse: InsScheduledAutomatedTransitionService
Metode: scheduleAutomatedTransition
Slik virker det
Denne overgangen gjelder for arbeidsflyter for Vlocity-tilstandsmodell. Komplekse planleggingsmønstre (hver annen dag, hver første mandag i måneden osv.) støttes ikke.
-
Med inndataene objectName og fieldName (og de valgfrie typeName og typeValue) bestemmes den spesifikke Vlocity State Model-versjonen som representerer arbeidsflyten.
-
Med fromState- og toState-inndataene bestemmes den spesifikke Vlocity State-overgangen i arbeidsflyten, det vil si i Vlocity State Model-versjonen fra forrige trinn. Tidsplaninndataene gir informasjon om hvor ofte og når en planlagt Salesforce-jobb som vil utføre den automatiske overgangen til en stat, skal kjøres fra "fromState" til "toState". Hver gang den planlagte jobben kjører, utfører den disse handlingene:
-
Hent opptil 5 forekomster av typen representert av "objectName", der verdien i feltet representert av "fieldName" = verdien representert av "fromState". Dette sikrer at bare de objektforekomstene som for øyeblikket er i tilstanden som representeres av "fromState", velges for å utføre overgangen.
-
Alle konfigurerte Vlocity State Overgang-regler for den angitte Vlocity State Overgangen (slik det er bestemt fra trinn 2 ovenfor) utføres.
-
Hvis det generelle resultatet fra regelutførelsen (som styres av overgangsfullføringskriteriene som er angitt for overgangen til Vlocity-tilstand) er sant, som regelutførelsen som er overført, oppdateres objektforekomstens status til statusen og representeres av "toState".
-
Hvis det generelle resultatet fra regelutførelsen er usann, det vil si at regelutførelsen mislyktes, oppdateres objektforekomstens status til alternativtilstanden som er konfigurert i Overgangen til Vlocity-status, hvis den finnes.
-
Hvis objektforekomstens status oppdateres til en ny tilstand (enten "toState" eller den alternative tilstanden for den angitte overgangen), utføres de tilsvarende Vlocity-handlingene som er konfigurert for denne tilstanden (dvs. Til-tilstand-feltet i Vlocity-handling).
-
Antall objektforekomster der statusen ble oppdatert til "toState", returneres i noOfUpdatedRecords. Antall objektforekomster der statusen ble oppdatert til alternativstatusen, returneres i noOfUpdatedRecordsToAlternateStates.
-
Hvis ingen overgang ble utført, beholdes objektforekomsten i "fromState".
-
Inndata
Inndata |
Beskrivelse |
|---|---|
|
Obligatorisk. API-navn for objekt |
|
Obligatorisk. API-navn for feltet som er vert for verdien for staten. |
|
Obligatorisk. Fra (opphav)-feltverdien for overgangen til stat. |
|
Obligatorisk. Til-feltverdien (mål) for overgangen til stat. |
|
Valgfritt.
|
|
Valgfritt.
Merk
Med typeName = 'Type__c' og typeValue = 'Enkeltleverandør' vil for eksempel en bestemt Vlocity-tilstandsmodell som er konfigurert for Application__c-objektet, bli brukt. |
|
Et kartobjekt som inneholder |
|
Obligatorisk. Strengverdi
|
|
Format: TT:MM, militærtid. Ikke nødvendig hvis |
|
Strengverdi. Godtatte verdier: Dager kan også representeres numerisk, fra 1 til 7, der søndag = Kreves hvis |
Inndata-JSON
Her er et eksempel på JSON-koden for inndata der tidsplanmønsteret er ukentlig 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"
}
}Utdata-JSON
Utdata-JSON-koden viser antall oppdaterte poster (maksimalt fem) og viser eventuelle unntak.
{
"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.>
}