Настройка правил присвоения тега

Правила присвоения тега применяются к документу в момент отправки или получения. Результатом применения правила к документу может быть истина или ложь.

Для тега может быть определено несколько правил:

Tag-Rules-List

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

Примечание

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

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

Tags-List-Item
Далее в списке правил нужно нажать кнопку Добавить.
После этого откроется форма настроек правила:
Tag-Rule-Settings

У правила три основные настройки:

  • выражение;

  • оператор;

  • значения.

Примечание

Механизм тегов является расширяемой подсистемой интеграционного модуля Продукта. На проектной основе могут быть реализованы дополнительные типы выражений и операторы.

Выражение

Выражение применяется к данным документооборота.

Выражением могут быть как данные «шапки» документа (отправитель, получатель, тип документа, направление, и т.д.), так и данные, полученные из контента документа (XPath- и JSONPath-выражения).

В поле Аргумент задается опциональный аргумент выражения. Например, для выражения «Атрибут документа» аргументом будет идентификатор атрибута в коллекции атрибутов документа. Для XPath-выражения аргумент - это строка XPath-запроса. Если выражение не требует аргументов, то это поле не показывается на форме.

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

Оператор

Оператор проверяет результаты выражения относительно значений: равенство, сравнение, вхождение в множество и т.д. Задается в поле Оператор.

Значения

Значения - это константы, относительно которых проверяются результаты выражения.

Для правила может быть задано несколько значений одного типа. Тип значений задается в поле Тип значения. Далее определяется непосредственно список значений. Новое значение добавляется кнопкой +.

Примечание

Если тип значения изменить, список значений будет очищен.

Преобразование типов данных

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

Например, выражение «Метаданные документа» возвращает строку, но его при этом можно проверить относительно значений с типом «Целое число».

Перед проверкой будет выполнена попытка преобразовать строковый результат в целое число. Если преобразование будет успешным, оператор выполнит проверку и правило вернет результат проверки. Если преобразование будет неуспешным, правило сразу вернет ложный результат.

Как читать правила

Правило читается слева направо. Для примера на рисунке правило читается так:

XPath-выражение «Файл/@ИдФайл» содержит строковые значения «ON_NSCHFDOPPR» или «ON_SCHFDOPPR»

Сохранение изменений

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