Мониторинг DocsVision

Данная функция позволяет обнаружить объект DocsVision, обладающий определенными свойствами (аналогично поиску объектов, соответствующих критериям фильтрации), или отслеживать вносимые в карточку изменения (добавление/удаление строк, изменение значения поля), а также находить версии карточек файлов. В настройках функции мониторинга указывается переменная процесса, в которую будет возвращена ссылка на найденный объект (или объекты: для этого следует указать переменную-коллекцию).

Рис. 4.3. Функция мониторинга DocsVision, вкладка Параметры

Окно описания функции содержит вкладку Общие, включающую такие же поля, как и аналогичная вкладка всех остальных функций, а также вкладку Параметры (рис. 4.3), на которой указываются параметры мониторинга карточек DocsVision.

Первое поле на этой вкладке — Очищать историю мониторинга: в нем выбирается значение (или переменная бизнес-процесса) типа да/нет, которое определяет, будет ли удаляться (да) или сохраняться (нет) история мониторинга при повторном выполнении функции. При удалении истории каждый повторный запуск функции мониторинга обеспечивает поиск всех удовлетворяющих условию объектов DocsVision без учета результатов предыдущего мониторинга. Например, после добавления нового документа повторный мониторинг DocsVision приведет к обработке всех документов папки, если в данном поле указано Да, и к обработке только вновь появившегося документа, если в данном поле указано Нет.

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

Примечание

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

Далее следуют два переключателя, позволяющие выбрать, над чем будет производиться мониторинг: над объектами (Мониторинг карточек DocsVision) или над событиями, происходящими с каким-либо объектом (Мониторинг карточки). Естественно, что возможен выбор только одного из переключателей; после выбора переключателя становится доступной для описания соответствующая группа параметров.

• Переключатель Мониторинг карточек DocsVision позволяет обнаруживать уже имеющиеся и вновь появляющиеся карточки DocsVision, соответствующие указанным критериям. Параметры мониторинга указываются в следующих полях:
• • в поле Параметр процесса — карточка указывается переменная бизнес-процесса типа карточка DV, в которую будет возвращена ссылка на найденную карточку (карточки);
  • в раскрывающихся списках поля Сортировать результаты выбираются параметры сортировки, предназначенные для упорядочения результатов мониторинга; при этом в первом списке выбирается тип сортировки (Не сортировать, По дате создания, По дате изменения, По дайджесту), а во втором — способ сортировки (По возрастанию или По убыванию);
  • в поле Папка поиска и при помощи следующего флажка Искать в подпапках следует указать область поиска; если область поиска не задана, поиск осуществляется по всем папкам системы;
  • Фильтр карточек позволяет установить параметры поиска карточек с помощью кнопки Настроить фильтр; действие производится аналогично заданию условий расширенного поиска, описанного в руководстве пользователя по платформе DocsVision;
  • Параметры — имеет смысл только при указанных параметрах фильтра; с ее помощью осуществляется сопоставление параметров фильтра и переменных бизнес-процесса. Для этого необходимо: с помощью кнопки Настроить фильтр определить параметры атрибутивного поиска фильтра, затем с помощью кнопки Параметры открыть окно Параметры фильтра (рис. 4.4). В колонке Переменная процесса следует выбрать объявленную переменную бизнес-процесса, значение которой будет присвоено параметру фильтра.

Рис. 4.4. Окно параметров фильтра

• Переключатель Мониторинг карточки позволяет осуществлять мониторинг изменения данных в отдельной карточке; параметры мониторинга определяются в следующих полях:
• • Карточка: указывается карточка или переменная бизнес-процесса типа карточка DV, которая будет проверяться на предмет обнаружения внесенных изменений;
  • если в поле Карточка (см. выше) не указана карточка, то в поле Тип карточки из раскрывающегося списка выбирается тип карточки (например, Входящий документ или Карточка файла с версиями), мониторинг которой будет производиться (список составляют все типы карточек, определенные в системе, включая карточки справочников и Навигатора); если в поле Карточка указана карточка, тип карточки определяется автоматически;
  • в поле Выходная строка указывается переменная процесса типа строка секции карточки DV, в которую будет возвращен результат мониторинга.

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

• переключатель Мониторинг секции карточки на появление новых строк позволяет осуществлять мониторинг секции выбранной карточки на появление новых строк:
• • в поле Секция карточки указывается секция карточки, мониторинг которой будет производиться (например, секция внутреннего документа Ссылки на карточки);
• переключатель Мониторинг изменения поля строки позволяет осуществлять мониторинг поля секции выбранной карточки в указанной строке:
• • в поле Строка укажите переменную бизнес-процесса типа строка секции карточки DV, значение поля которой будет проверяться на изменение. Если строка не указана, а указана карточка (напрямую или через переменную) будет осуществляться мониторинг первой строки указанной секции карточки;
  • в поле Поле секции укажите поле карточки, мониторинг которой будет осуществляться (например, отследить изменение поля Название указанной карточки входящего документа);
• переключатель Атрибутивный мониторинг секции карточки позволяет осуществлять атрибутивный мониторинг поля секции карточки, условия которого указываются в соответствии со схемой <Название поля><Логическая операция><Значение поля>:
• • в поле Поле секции указывается поле секции карточки, мониторинг которого будет производиться;
  • в поле Операция указывается логическая операция, по которой осуществляется атрибутивный мониторинг поля секции карточки (равно, не равно, содержит, не содержит, больше чем, больше или равно, меньше чем, меньше или равно, строки равны, строки не равны, начинается с, кончается на, пустое значение, непустое значение);
  • в поле Значение указывается значение поля секции, с которым осуществляется сравнение по логической операции в процессе мониторинга.