Действия этапа¶

Справочник содержит параметры системных действий маршрутов. Примеры необходимо проверять на тестовом контуре перед применением.

Отозвать документ с маршрута¶

Чтобы отозвать документ с маршрута, выберите действие с аналогичным названием:

Отправка уведомлений на Email¶

Для Отправки уведомления по Email, выберите действие этапа Отправка Email.

Введите команду в поле Параметры:

Пример

{"TemplateId":"NotificationAuthorSigned","Fields":"AuthorSN"}

Где:

• TemplateId –шаблон письма для уведомления;

• OrdersReview – Идентификатор шаблона уведомления;

• Fields – список пользовательских полей для отправки;

• NotifyEmployees – внутреннее имя столбца, в котором указаны получатели. Возможно указывать несколько значений через точку с запятой «;».

Возможные параметры получателей:

{"Recipients":"000000000000000000000001;#ExampleGroup"}

{"TemplateId":"NotificationTemplate","Fields":"Recipients"}

Отправка уведомлений с вложениями на Email¶

К отправке доступны файлы в формате pdf, размещенные на вкладке/в секции Вложения РКК. Для отправки уведомлений с вложениями по Email, выберите действие этапа Отправка Email.

Введите команду в поле Параметры :

Пример :

{"TemplateId":"Invitation","AttachmentTypes":"Договор","Emails":"user@example.invalid"}

Где:

• TemplateId – шаблон письма для уведомления.

• Invitation – Идентификатор шаблона уведомления.

• AttachmentTypes – Название типа вложения файла. Все файлы с таким типом вложения будут приложены к уведомлению. Доступна отправка файлов нескольких типов вложения, для этого между названиями типов вложения необходимо точку с запятой «;».

• Emails – электронный адрес для отправки уведомления. Возможно указывать несколько значений через точку с запятой «;».

Команды для указания получателей:

• "SendToInitiator":"true/false"- отправить инициатору процесса.

• "Emails":"электронный адрес" - список email для отправки.

• "Fields":"внутреннее имя поля" - список пользовательских полей для отправки.

• "SendToPerformers":"true/false" - отправить участникам процесса.

  Эти команды могут быть или использованы все сразу, одна или несколько.

В результате данного действия этапа указанному пользователю придет уведомление с вложенными файлами из РКК, по которой запущен маршрут с данным действием этапа.

Отмена отправки стандартного уведомления о назначении задачи или замена шаблона¶

Для отключения уведомления о назначении задачи необходимо указать команду в поле Параметры в настройках этапа назначения задачи:

{"DisableTaskNotification":"true/false"}

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

Для замены стандартного уведомления о назначении задачи необходимо указать команду в поле Параметры в настройках этапа назначения задачи:

{"TaskNotificationTemplate":"Invitation"}

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

Установить значения полей¶

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

Для полей с типом «Пользователь или группа» возможно заполнение конкретным пользователем или пользователями.

Для полей с типом «Однострочный текст»/«Многострочный текст»/«Число» возможно заполнение конкретным текстом:

Пример

{"Subject":"Договор подразделения «Портальных решений»"}

Может заполняться пустым значением:

{Subject=}

Для полей с типом «Выбор» возможно заполнение конкретным значением.

Укажите внутреннее имя поля, задайте значение, которое должно установиться:

Пример

{"SecrecyStamp":"Конфиденциально"}

Может заполняться пустым значением:

Пример

{SecrecyStamp:}

Для полей с типом "Да/Нет" может заполняться конкретным значением. Укажите внутреннее имя поля, задайте значение, которое должно установиться:

Пример

{"OutcomingLetter": "True"}

Может заполняться пустым значением:

Пример

{OutcomingLetter=}

Для полей с типом «Дата и время» может заполняться конкретным значением.

Пример

{"Date":"01.02.2023"}

Может заполняться переменной Today:

Пример

{"Date":"Today"}

Для переменных Yesterday, Tomorrow, можно использовать параметр:

Пример

{"Date":"Today.AddDays:-1"}

Может заполняться переменной с добавлением параметра:

Пример

{"Date":"Today.AddDays:365"}

Может заполняться пустым значением:

Пример

{"Date":null}

Где "Date": – внутреннее имя столбца с типом дата и время

Возможные команды для настройки «Установить значения полей»:

Установить значения полей по шаблону¶

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

Чтобы в названии задачи выводился пользователь и определенный текст:

Пример

{"Title":"[$Item:Title] [$Item:testUser] текст"}

Чтобы в названии задачи выводился регистрационный номер:

Пример

{"Title":"[$Item:Title] [$Item:RegNumber]"}

Где:

• Title – внутреннее имя поля

• Item:Title – значение поля, из которого мы получаем данные

• Item:testUser – значение поля, из которого мы получаем данные

• текст – текст, который всегда будет выводиться

• Item:RegNumber – значение поля, из которого мы получаем данные

Назначение уникальных разрешений¶

Для назначения уникальных разрешений выберите действие Назначение уникальных разрешений.

Эта настройка позволяет прекратить наследование прав Списка/Библиотеки документов/Справочника и назначить уникальные права пользователям/группе пользователей.

Права назначаются по процессу накопительно – можно и добавлять, и отбирать права на одном или нескольких этапах маршрута.

Выдача уникальных прав группе пользователей:

Пример

{"CopyPermission":"false","Permissions":"[{\"UserIds\":[\"000000000000000000000001\"],\"PermissionLevelId\":\"000000000000000000000100\"}]"}

Выдача уникальных прав пользователю в поле Manager:

Пример

{"CopyPermission":"false","Permissions":"[{\"UserIds\":[],\"FieldNames\":[\"Manager\"],\"PermissionLevelId\":\"000000000000000000000100\"}]"}

Выдача уникальных прав пользователю/группе пользователей из внешнего списка:

Пример

{"CopyPermission":"false","Permissions":"[{\"UserIds\":[],\"FieldNames\":[\"Department.Manager\"],\"PermissionLevelId\":\"000000000000000000000100\"}]"}

Где:

• "CopyPermission":"false" – прекращение наследования от Списка/Библиотеки/Справочника, удаляются все исходные разрешения.

• "CopyPermission":"true" – все исходные разрешения от Списка/Библиотеки/Справочника сохраняются.

  Warning

  "CopyPermission":"false"/ "CopyPermission":"true" необходимо указывать в каждом этапе, где есть назначение уникальных разрешений, но действует оно только 1 раз при отработке самого первого назначения уникального разрешения. Например, если в первый раз указать "CopyPermission":"false", а потом во всех остальных "CopyPermission":"true", то наследование не восстановится.

• Permissions – предоставление прав из поля

• UserIds – пользователь/группа пользователей

• 000000000000000000000001 — пример ID группы;

• PermissionLevelId – уровень разрешений

• 000000000000000000000100 — пример ID уровня разрешений;

• FieldNames – указание на поле или поля, из которых можно выбрать пользователей;

• Manager – внутреннее имя поля;

• Department.Manager – в данном случае Department – это поле с подстановкой из справочника департаментов. А Manager – это руководитель департамента из справочника.

Регистрация документа¶

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

Запуск дочерних документов по маршруту¶

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

Задайте следующие Параметры :

Пример

{"ChildListIds":"AuditProcedures","ContentTypeIds":"000000000000000000000010","ChildStatuses":"Черновик","RouteId":"000000000000000000000020"}

Где:

• "ChildListIds": – команда для запуска маршрутов

• "AuditProcedures" – Название списка дочернего документа

• "ContentTypeIds" — ID типа контента дочернего документа;

• "Childstatuses" – статус, в который необходимо перевести дочерний документ

• "RouteId" – Ид маршрута

Синхронизация полей из внешнего источника¶

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

Задайте следующие Параметры :

Пример

{ 
  "externalListName": "Accounts",
  "filter": "{\"ClosureOperator\":1,\"NestedConditions\":[{\"ClosureOperator\":0,\"NestedConditions\":null,\"FieldCondition\":{\"ConditionOperator\":0,\"Field\":\"externalTest\",\"Value\":\"1\",\"TypeAsString\":\"Text\"}}],\"FieldCondition\":null}",
  "copyFields": "[{\"from\":\"externalTest\",\"to\":\"Text\"}]",
  "onNotFound": "Skip"
}

Где:

• externalListName – команда для определения внешнего списка;

• Accounts – внутреннее название внешнего списка;

• "filter" — строка JSON с фильтром поиска элемента во внешнем списке;

• copyFields – команда для копирования значений полей;

• from – указатель на внешнее поле;

• externalTest – внутреннее имя поля из внешнего списка;

• to – указатель на внутреннее поле;

• Text – внутреннее имя поля текущего списка;

• onNotFound – действие при отсутствии элемента;

• Skip / SetNull / Notify – Пропустить / Установить значение Null / Отправить уведомление.

Если для поиска в другом списке используется значение из поля с типом "Подстановка", то необходимо указывать id и тип текст.

Пример:

{
  "externalListName": "ClientBase",
  "filter": "{\"FieldCondition\":{\"ConditionOperator\":0,\"Field\":\"Id\",\"Value\":\"$Item:TIN\",\"TypeAsString\":\"Text\"}}",
  "copyFields": "[{\"from\":\"PartnerCode\",\"to\":\"PartnerCode\"},{\"from\":\"Manager\",\"to\":\"Manager\"}]",
  "onNotFound": "Skip"
}

Формирование документа по шаблону¶

Для формирования документа по шаблону, настроенного для типа контента, выберите Действие Формирование документа по шаблону.

Задайте следующие параметры:

Пример:

{"TemplateStaticName": "00000000000000000000000000000011"}

Где:

• "TemplateStaticName" – команда для формирования печатной формы

• "00000000000000000000000000000011" – пример внутреннего имени печатной формы

Чтобы получить код StaticName для ввода выполните следующие действия:

• Откройте консоль администратора, нажмите F12 на клавиатуре;

• Откройте запрос с названием DocumentTemplates/get, вкладка Preview;

• В раскрывшемся списке скопируйте код staticName.