Действия рабочих процессов

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

Подробнее о механизме читайте в статье Редактор рабочих процессов.

Доступные действия:

• Действие Run Script
• Действие Join
• Действие Set Values
• Действие Record Generator
• Действие Create Event
• Действие Wait Condition
• Действие If
• Действие Switch
• Действие User-approval
• Действие Subflow
• Действие Timer

Статусы действий

Статус действия сообщает механизму рабочих процессов, что нужно делать с действием. Перечисленные ниже статусы стандартны для всех типов действий, реализованных в SimpleOne.

В навигаторе перейдите в Рабочие процессы → Выполняемые действия, чтобы увидеть статусы действий в опубликованных рабочих процессах.

Статусы действий

Базовые действия

Утилиты

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

Действие Run Script

Действие Run Script выполняет определенный скрипт.

Поля действия

Действие Join

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

В примере ниже, действие Join ожидает результатов обработки действий If, Subflow и Wait. Если все три перехода из этих действий ведут к действию Join, выбирается выход Complete (с переходом к действию с названием Insert). Если одно из действий обходит действие Join (в данном случае это выход No из действия If), выбирается выход Incomplete.

Как использовать действие Join

1. В левом боковом меню откройте вкладку Utilities и перетащите действие Join в рабочую область.
2. Соедините необходимые выходы действий с действием Join.
3. Создайте переходы от выходов действия Join (Complete и Incomplete) к следующим действиям.

Поля действия

Выходы действия

Действие Set Values

Действие Set Values задает определенные значения текущей записи. Эти значения определяют поведение действия при остановке или завершении рабочего процесса.

Поля действия

Действие Record Generator

Действие Record Generator создает записи в любой таблице, наследующей от таблицы Задачи.

Поля действия

new_task.parent_id = current.sys_id;
new_task.caller = current.getValue('caller');

Действие Create Event

Действие Create Event ставит событие из таблицы Реестр событий (sys_event_register) в очередь. Позднее это событие может выполнить определенные скрипты или отправить уведомления. При запуске действия Create Event, в таблице Событие (sys_event) создается новая запись события.

Подробнее читайте в статье Системные события.

Поля действия

Условные операторы

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

Действие Wait Condition

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

Поля действия

const isUserManager =
  ss.hasRole('process_manager'); // true or false
return isUserManager;

Действие If

Данное действие проверяет условие, чтобы определить, из какого выхода будет совершен переход, Yes или No.

Поля действия

const uc = new SimpleUserCriteria();
const isUserLocal =
  uc.userAcceptanceByCriteria(ss.getUserID(), '165470191717512124'); // true or false
return isUserLocal; 

Действие Switch

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

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

Поля действия

Чтобы создать дополнительные выходы, выполните следующие действия:

1. Нажмите правой кнопкой мыши на действие Switch и выберите Добавить выход.
2. Двойным щелчком нажмите на выход, чтобы открыть поля формы выхода.
3. Заполните поля.
4. Нажмите Сохранить.
5. При необходимости повторите процесс, чтобы добавить еще поля.

Поля выхода из действия

Согласования

Действие User Approval настраивает обработку согласований: оно создает согласования, устанавливает правила и условия согласований.

Действие User-approval

Действие оценивает результат в зависимости от следующих факторов:

• решение, принятое согласующими.
• условия, указанные в поле Согласовано при условии или в полях Условия согласования и Условия отклонения.
• (опционально) условия, указанные в скриптах.

Действие может быть завершено с одним из двух результатов: Согласовано или Отклонено.

Поля действия

const caller = current.getValue('caller');
const callerGroup = new SimpleRecord('sys_user_group');
callerGroup.addQuery('user_id', сaller);
callerGroup.selectAttributes('group_id');
callerGroup.query();
while (callerGroup.next()) {
  if (callerGroups.group_id.getValue('responsible')) {
    answer = callerGroups.group_id.getValue('responsible');
  }
}

(() => {
  let isFirstGroupApprove = false;
  let isSecondGroupApprove = false;

  const docID = ss.getDocIdByIds(current.sys_db_table_id, current.sys_id);

  const rejectedApp = new SimpleRecord('sys_approval');
  rejectedApp.addQuery('item', docID);
  rejectedApp.addQuery('state', 'rejected');
  rejectedApp.setLimit(1);
  rejectedApp.selectAttributes(['sys_id']);
  rejectedApp.query();
  if (rejectedApp.next()) {  // Одна из заявок отклонена
    answer = 'rejected';
  }

  const approvedApp = new SimpleRecord('sys_approval');
  approvedApp.addQuery('item', docID);
  approvedApp.addQuery('state', 'approved');
  approvedApp.selectAttributes(['approver_id']);
  approvedApp.query();

  const uc = new SimpleUserCriteria();
  while (approvedApp.next()) {
    let approver = approvedApp.getValue('approver_id');

    if (!isFirstGroupApprove) {
      isFirstGroupApprove = uc.userAcceptanceByCriteria(approver, '167416106197358457'); // Участник первой группы
    }
    if (!isSecondGroupApprove) {
      isSecondGroupApprove = uc.userAcceptanceByCriteria(approver, '167416108994075219'); // Участник второй группы
    }
  }

  if (isFirstGroupApprove && isSecondGroupApprove) {
    return 'approved';
  } else {
    return 'waiting';
  }
}
)()

Подпроцессы

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

Действие Subflow

Действие Subflow выполняет существующий рабочий процесс в рамках текущего рабочего процесса.

Поля действия

При запуске блока рабочего процесса Subflow, для текущей записи создается контекст рабочего процесса. До тех пор, пока контекст рабочего процесса не будет завершен, запустить еще один блок Subflow с тем же рабочим процессом будет невозможно т.к. в один момент времени для текущей записи может существовать только один контекст рабочего процесса.

Например, в основном рабочем процессе определен блок Subflow со ссылкой на рабочий процесс "Request 2nd phase". После запуска основного рабочего процесса запускается подпроцесс "Request 2nd phase". Контекст выполнения подпроцесса приостанавливается. Если в рамках основного процесса произойдет попытка еще одного запуска подпроцесса "Request 2nd phase", подпроцесс будет создан в отмененном состоянии.

Таймеры

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

Действие Timer

Действие Timer определяет период времени, в течение которого текущий процесс не выполняется. Оно следует приведенной ниже логике:

• Если контекст рабочего процесса не завершен и блок, следующий за блоком Timer, находится в статусе Завершена – обработка блока запускается повторно.
• Если контекст рабочего процесса не завершен, но блок, следующий за блоком Timer, находится в статусе В ожидании – повторная обработка блока не запускается.
• Если контекст рабочего процесса на момент выполнения блока Timer завершен – обработка следующего за ним блока не запускается.

Поля действия