Перейти к основному содержимому
Версия: 1.20.1

SimpleWorkflow

Этот класс содержит методы, которые позволяют управлять рабочими процессами и их компонентами, такими как действия, переходы и другие.

Чтобы создать экземпляр класса SimpleWorkflow, передайте в конструктор ID рабочего процесса, как в примере ниже:

SimpleWorkflow()
const simpleWorkflow = new SimpleWorkflow('159491114038814558');

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
workflowIdStringНетnull

cancel(current)


Используйте этот метод, чтобы отменить все активные контексты текущей записи.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
currentSimpleRecord objectДаНет

Возвращаемое значение:

ТипОписание
VoidМетод не возвращает значение.

Пример:

cancel()
const simpleWorkflow = new SimpleWorkflow('159491114038814558');
if (simpleWorkflow.hasActiveContexts(current)) {
simpleWorkflow.cancel(current);
}

Если для рабочего процесса были созданы подпроцессы, используйте следующий скрипт, чтобы отменить все контексты рабочего процесса и все связанные с ним подпроцессы:

Пример
const currentDocId = ss.getDocIdByIds(current.sys_db_table_id, current.sys_id);

const wfContext = new SimpleRecord('wf_context');
wfContext.addQuery('related_record_id', currentDocId);
wfContext.addQuery('active', true);
wfContext.orderBy('sys_id');
wfContext.selectAttributes(['workflow_version_id']);
wfContext.query();
const doesActiveWfExist = wfContext.getRowCount() > 0;

while (wfContext.next()) {
const simpleWorkflow = new SimpleWorkflow(wfContext.workflow_version_id.getValue('workflow_id'));
if (simpleWorkflow.hasActiveContexts(current)) {
simpleWorkflow.cancel(current);
}
}

if (doesActiveWfExist) {
ss.addInfoMessage('Все контексты отменены');
ss.setRedirect();
}

copy(current)


Используйте этот метод, чтобы скопировать рабочий процесс. При этом создается версия процесса в статусе Заблокировано, после чего метод возвращает скопированный рабочий процесс.

Возвращаемое значение:

ТипОписание
SimpleRecord objectМетод возвращает null, если объект SimpleWorkflow был создан без указания параметра workflowId. Метод возвращает объект SimpleRecord таблицы Рабочий процесс (wf_workflow).

Пример:

copy()
const workflow = new SimpleWorkflow('159491114038814558');
const copiedWorkflow = workflow.copy();
const simpleWorkflow = new SimpleWorkflow(copiedWorkflow.sys_id);

delete()


Используйте этот метод, чтобы удалить рабочий процесс и все его элементы.

Возвращаемое значение:

ТипОписание
BooleanПри успешном удалении процесса метод возвращает true. В случае неудачи метод возвращает false.

Пример:

delete()
const simpleWorkflow = new SimpleWorkflow('159491114038814558');
const copiedWorkflow = simpleWorkflow.copy();
const simpleWorkflow = new SimpleWorkflow(copiedWorkflow.sys_id);
if (simpleWorkflow.delete()) {
ss.info('Рабочий процесс удален!');
}

hasActiveContexts(current)


Используйте данный метод, чтобы проверить текущую запись на наличие активных контекстов рабочего процесса.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
currentSimpleRecord objectДаНет

Возвращаемое значение:

ТипОписание
BooleanЕсли контекст активного рабочего процесса найден, метод возвращает значение true. Если такой контекст отсутствует, метод возвращает false.

Пример:

hasActiveContext()
const simpleWorkflow = new SimpleWorkflow('159491114038814558');
if (simpleWorkflow.hasActiveContexts(current)) {
simpleWorkflow.cancel(current);
}

revival(executingActivity, current)


Используйте этот метод, чтобы перезапустить рабочий процесс для указанной записи.

примечание

Метод работает только если контекст рабочего процесса и выполняющееся действие не находятся в статусе Завершен. Добавляйте это условие к вашим скриптам, когда используете этот метод.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
executingActivitySimpleRecord objectДаНет
currentSimpleRecord objectДаНет

Возвращаемое значение:

ТипОписание
SimpleRecord objectМетод возвращает объект SimpleRecord таблицы Контекста рабочего процесса (wf_context).

Пример:

revival()
const current = new SimpleRecord('task');
current.get('164579976616724057');
const approval = new SimpleRecord('sys_approval');
approval.get('164625329711023536');
const executingActivity = new SimpleRecord('wf_executing_activity');
executingActivity.get(approval.getValue('wf_executing_activity_id'));
const context = new SimpleRecord('wf_context');
context.get(executingActivity.getValue('context_id'));
if (context.getValue('state') == 'finished' || executingActivity.getValue('state') == 'finished') {
ss.info(`Перезапуск выполняющегося действия ${executingActivity.sys_id} и текущего контекста рабочего процесса ${current.getTableName()}:${current.sys_id} невозможен из-за того, что выполняющееся действие или контекст рабочего процесса уже завершены`);
} else {
const workflow = new SimpleWorkflow();
workflow.revival(executingActivity, current);
}

start(current)


Используйте метод, чтобы запустить рабочий процесс. При помощи этого метода можно запустить только рабочие процессы, в которых Тип условия указан как Ручной.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
currentSimpleRecord objectДаНет

Возвращаемое значение:

ТипОписание
SimpleRecord objectВ случае успеха метод возвращает объект SimpleRecord таблицы Контекст рабочего процесса (wf_context).
Метод возвращает null в следующих случаях:
  • новый объект SimpleWorkflow был создан без указания параметра workflowId.
  • нет версий рабочего процесса, созданных текущим пользователем.

Пример:

start()
const simpleWorkflow = new SimpleWorkflow('159491114038814558');
const context = simpleWorkflow.start(current);
if (context.state === 'finished') {
ss.info('Рабочий процесс завершен!');
}

startSubflow(executingActivity, current, workflowId)


Используйте этот метод, чтобы запустить подпроцесс путем выполнения действия.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
executingActivitySimpleRecord objectДаНет
currentSimpleRecord objectДаНет
workflowIdStringДаНет

Возвращаемое значение:

ТипОписание
SimpleRecord objectМетод возвращает объект SimpleRecord таблицы Контекст рабочего процесса (wf_context).
Метод возвращает значение null, если нет версий рабочего процесса, созданных текущим пользователем.

Пример:

startSubflow()
;
(
(current, activity) => {
const wfActivitySubflow = new SimpleRecord('wf_activity_subflow');
wfActivitySubflow.get(activity.getValue('activity_id'));

const workflowManager = new SimpleWorkflow();
const subflowContext = workflowManager.startSubflow(activity, current, wfActivitySubflow.getValue('workflow_id'));
ss.info(subflowContext.state);
// Info: executing
}
)(current, activity);