InsScheduledAutomatedTransitionService:scheduleAutomatedTransition

Класс: InsScheduledAutomatedTransitionService

Метод: scheduleAutomatedTransition

Принцип работы

Этот переход для бизнес-процессов модели состояния Vlocity. Сложные схемы планирования (каждые два дня, каждый первый понедельник месяца и т. д.) не поддерживаются.

1. С помощью вводных данных objectName и fieldName (и дополнительных typeName и typeValue) определяется определенная версия модели состояния Vlocity, представляющая бизнес-правило.

2. С помощью вводных данных fromState и toState определяется конкретный переход состояния Vlocity в этом бизнес-правиле, то есть в версии модели состояния Vlocity с предыдущего этапа. Вводные данные расписания предоставляют сведения о частоте и времени выполнения запланированного задания Salesforce, которое будет выполнять автоматический переход из 'fromState' в 'State'. При каждом выполнении запланированного задания выполняется следующее:

   1. Извлеките не более 5 экземпляров типа, представленного 'objectName', где значение поля, представленного 'fieldName' = значение, представленное 'fromState'. Таким образом, для выполнения перехода выбираются только экземпляры объекта, которые в данный момент находятся в состоянии, представленном 'fromState'.

   2. Выполняются все настроенные правила перехода в состояние Vlocity для указанного перехода в состояние Vlocity (как определено в шаге 2 выше).

   3. Если общий результат выполнения правила (управляемый критериями завершения перехода, заданными в переходе состояния Vlocity) является истинным, например, выполнение правила передано, состояние экземпляра объекта обновляется до состояния и представлено 'toState'.

   4. Если общий результат выполнения правила является ложным, то есть выполнение правила не удалось, состояние экземпляра объекта обновляется до состояния «Альтернатива», настроенного в переходе состояния Vlocity, при его наличии.

   5. Если состояние экземпляра объекта обновляется до нового состояния (либо 'toState', либо «Альтернативное состояние» для указанного перехода), выполняются соответствующие действия Vlocity, настроенные для этого состояния (то есть поле 'To State' в действии Vlocity).

   6. Количество экземпляров объекта, состояние которого было обновлено на 'toState', возвращается в 'noOfUpdatedRecords'. Количество экземпляров объекта, состояние которого было обновлено до состояния «Альтернатива», возвращается в 'noOfUpdatedRecordsToAlternateStates'.

   7. Если переход не был выполнен, экземпляр объекта остается в 'fromState'.

Вводные данные

Ввод	Описание
objectName	Обязательно. API-имя объекта
fieldName	Обязательно. API-имя поля, содержащее значение области.
fromState	Обязательно. Значение поля «От состояния (источник)» перехода к состоянию.
toState	Обязательно. Значение поля «Состояние (цель)» перехода состояния.
typeName	Дополнительно. typeName представляет значение дляtypeFieldName_c поля из модели состояния Vlocity. Это имя поля из другого объекта, для которого настраивается данный экземпляр модели состояния Vlocity. Например, это может быть установлено как поле 'Type__c' для объекта 'Application__c'.
typeValue	Дополнительно. typeValueпредставляет значение дляtypeFieldValue_c поля из модели состояния Vlocity. Это определенное значение для поля, представленного вводом 'typeName'. Сочетание <typeName, typeValue> используется для выбора определенной модели состояния Vlocity. Примечание Например, при typeName = 'Type__c' и typeValue = 'Idvidual Provider' будет использована определенная модель состояния Vlocity, настроенная для объекта Application__c.
schedule	Соотнесите объект, содержащий ключи pattern, startTime и dayOfTheWeek (см. ниже) для планирования времени выполнения перехода.
schedule.pattern	Обязательно. Значение строки HOURLY, DAILY или WEEKLY.
schedule.startTime	Формат: ЧЧ:ММ, военное время. Не обязательно, если schedule.pattern = HOURLY.
schedule.dayOfTheWeek	Значение строки. Допустимые значения: SUN, MON,TUE WED, THU, FRI или SAT. Дни также могут быть представлены в числовом выражении, от 1 до 7, где воскресенье = 1, понедельник = 2 и т. д. Обязательно, если schedule.pattern = WEEKLY.

JSON ввода

Ниже указан пример ввода JSON, схема расписания которого еженедельно в 13:30 каждый понедельник:

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

Вывод JSON

Вывод JSON отображает количество обновленных записей (максимум пять) и содержит все исключения.

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