ELMA AI > Решение «Антифрод в договорном документообороте» / Подсветка документа по маске

Подсветка документа по маске

antifraud-mask-highlight-1 Элемент становится доступен в дизайнере бизнес-процессов после подключения Модуля антифрод. Он позволяет с помощью модели искусственного интеллекта выделить цветом области сгенерированного по шаблону документа, которые пользователь имеет право редактировать. Также подсвечиваются значения переменных, подставленные в документ при генерации. Подсветка осуществляется на основе подготовленной маски — файла, сформированного из шаблона документа, с указанием доступных для редактирования областей.

Блок можно использовать как для только что сформированных файлов, так и для отредактированных. Поэтому при его работе с помощью ИИ также выполняется проверка на неразрешённые изменения, которые мог внести сотрудник:

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

Результаты подсветки и проверки на неразрешённые изменения сохраняются в контекстные переменные, и вы сможете использовать их в ходе процесса.

начало внимание

Действие доступно только для документов в формате .docx.

конец внимание

Подсветка применяется к документу, сформированному на основе данных из элемента приложения. Допустим, сотрудник создаёт элемент приложения Договоры, вводя в систему данные: реквизиты компании, сроки поставки, сумму и т. д. Запускается бизнес-процесс, в ходе которого на основе этих сведений по шаблону генерируется файл договора. Затем в него вручную вносятся специальные условия и перечень услуг. Это делает менеджер, редактируя текст файла. Чтобы сотрудник сразу видел, какие области документа разрешено изменять, перед задачей редактирования можно использовать блок подсветки. Также подсветку можно применить после того, как пользователь внёс дополнения, чтобы проверить их корректность.

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

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

Добавить входные и выходные переменные

Для настройки блока нужно заранее создать определённый набор свойств. Они указываются в настройках блока в полях, которые подразделяются на:

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

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

Добавление входных переменных.

Добавьте в контекст бизнес-процесса переменные:

Отредактированный документ (тип Файлы) — файл, к которому применится подсветка, в формате .docx. Это может быть документ сразу после генерации по шаблону или отредактированный сотрудником;
Маска (тип Файлы) — файл маски, соответствующей шаблону, по которому сгенерирован документ. По ней на сервере ИИ выполняется подсветка документа;
Приложение (тип Приложение) — ссылка на приложение, в котором хранятся данные документа, например, Договоры. При работе блока файл документа проверяется на изменения в сведениях, подставленных из элемента приложения при генерации. Для этого на сервере ИИ сопоставляются значения из текста файла и из полей в карточке документа;
Переменные (тип Строка) — данные документа, сериализованные в JSON. Свойство используется на сервере ИИ, чтобы проверить данные в файле. Они сравниваются со сведениями из карточки документа, на основе которых сгенерирована исходная версия. Создание строки в ходе процесса описано в разделе «Сформировать JSON‑строку для проверки данных документа»;
Исходный документ (тип Файлы) — изначальный сгенерированный по шаблону документ, не изменённый пользователем, в формате .docx. Может совпадать с файлом для подсветки. Используется на сервере ИИ для уточнения позиций переменных в документе;
Разрешены ли изменения переменных (тип Выбор «да/нет») — при работе блока выполняется проверка данных, подставленных в документ при генерации. Они сопоставляются со сведениями из карточки документа. Это позволяет проверить, что при редактировании файла вручную пользователь не вносил изменения в значения переменных.

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

Обратите внимание, входные переменные нужно заполнить данными до того, как ход процесса дойдёт до шага Подсветка документа по маске. Это делается с помощью других графических элементов. Например, файл маски можно записать из карточки документа с помощью блока Присваивание, а разрешить или запретить изменения в переменных может сотрудник в рамках блока Задача.

Добавление выходных переменных.

Свойства для сопоставления с выходными атрибутами добавляются:

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

Создайте следующие переменные, в которые запишется информация:

Документ с подсветкой (тип Файлы) — файл обработанного документа, в котором зелёным выделены области, разрешённые для редактирования, жёлтым — значения переменных, подставленные в файл при генерации;
Ответ сервера AI (тип Строка) — текст ответа, полученного с сервера ИИ. Его может использовать администратор для анализа ошибок, возникших при обработке документа на сервере. Например, чтобы узнать, какая проблема возникла при распознавании значений в JSON-строке с данными документа;
Таблица изменённых переменных (тип Таблица) — таблица, в которой фиксируются изменённые значения переменных, найденные при сравнении данных файла с полями из карточки документа. Её можно вынести на форму задачи для сотрудника, чтобы он мог проверить и исправить данные. В настройках таблицы добавьте колонки:

№ (тип Число) — номера строк в таблице;
Название (тип Строка) — названия переменных;
Значение в карточке (тип Строка) — значения из карточки документа;
Значение в документе (тип Строка) — значения из файла, изменённые пользователем при редактировании.

Были ли неразрешённые изменения (тип Выбор «да/нет») — наличие неразрешённых правок в тексте документа;
Статус запроса на сервер (тип Число) — код состояния HTTP, полученный с сервера ИИ. Переменную можно использовать для определения следующего шага процесса в зависимости от успешности подсветки. Подробнее читайте в разделе «Настроить обработку ошибок». Также на основе кода администратор может анализировать возникшие ошибки;
Были ли изменения переменных (тип Выбор «да/нет») — наличие изменений в значениях переменных;
Отредактированный документ без подсветки (тип Файлы) — исходный документ, загруженный для подсветки — сгенерированный или изменённый пользователем файл. Его можно прикрепить к задаче сотрудника для дальнейшего редактирования.

Настроить обязательные шаги в процессе

Разместите блок Подсветка документа по маске в том месте на схеме процесса, где нужно сформировать файл с подсветкой.

Чтобы блок работал корректно, в ходе процесса нужно подготовить JSON-строку для проверки документа на сервере ИИ и настроить обработку ошибок. Рассмотрим, какие графические элементы для этого используются.

antifraud-mask-highlight-2

Сформировать JSON-строку для проверки данных документа

При выполнении подсветки на сервере ИИ сравниваются значения переменных в файле и данные элемента приложения, по которым он сгенерирован. Таким образом документ проверяется на изменения. Для этого используется JSON-строка со свойствами из карточки документа и их значениями. Она передаётся во входных переменных блока Подсветка документа по маске, поэтому её нужно сформировать до шага подсветки.

Для этого разместите на схеме графический элемент Скрипт, представьте свойства приложения в виде объекта Map и переведите их в JSON. Затем запишите результат в переменную процесса.

Пример скрипта для преобразования переменных приложения в JSON-строку

async function mapVariables(): Promise<void> {
// Получение свойств приложения, хранящегося в переменной процесса с кодом `application`
const applicationData = (await Context.data.application!.fetch()).data;

// Создание объекта `Map` из всех свойств приложения, кроме системных, так как их не нужно проверять
// Системные свойства фильтруются по '__' в начале названия
let variables = new Map(
Object.keys(applicationData)
.filter(key => !key.startsWith('__'))
.map(key => [key, applicationData[key]])
);

// Удаление ненужных свойств — маски и типа документа
variables.delete('mask');
variables.delete('contractType');

// Преобразование в строки тех значений переменных,
// для которых нужна особая логика,
// например, форматирование значений даты начала и окончания договора
variables.set('StartDate', applicationData.StartDate?.format('DD.MM.YYYY'));
variables.set('EndDate', applicationData.EndDate?.format('DD.MM.YYYY'));

// Преобразование объекта `Map` в объект со строковыми значениями
const variablesObject: { [key: string]: string } = {};
[...variables].sort((a, b) => a[0].localeCompare(b[0]))
.forEach(variable => {
variablesObject[variable[0]] = variable[1]?.toString();
});

// Преобразование объекта в JSON и запись строки в переменную `variables` из контекста процесса
Context.data.variables = JSON.stringify(variablesObject);
}

Настроить обработку ошибок

Ошибки в работе блока. Во время работы блока могут возникать критические ошибки, к примеру, если Модуль антифрод оказывается отключён. Такие случаи обрабатываются с помощью дополнительного исходящего перехода из блока Подсветка документа по маске. Например, при его активации процесс может завершаться. Добавьте переход на схему, чтобы позже при настройке блока указать его на вкладке Обработка ошибок.

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

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

antifraud-mask-highlight-3

В настройках шлюза в качестве варианта по умолчанию укажите переход для обработки ошибок сервера. Для другого перехода задайте условие. Чтобы определить успешность обработки документа, можно использовать код статуса HTTP, который при работе блока Подсветка документа по маске записывается в специальную переменную. Если статус ответа с сервера равен 200, продолжится основной ход процесса.

antifraud-mask-highlight-4

Настройка блока

После выполнения предварительных действий дважды нажмите на блок Подсветка документа по маске на схеме процесса и задайте настройки на трёх вкладках: Основное, Входные и выходные атрибуты, Обработка ошибок.

Вкладка «Основное»

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

antifraud-mask-highlight-5

Название — введите название блока, которое будет отображаться на схеме процесса;
Название задачи — блок Подсветка документа по маске выполняется автоматически без назначения задачи на пользователя. Поэтому настраивать формирование названия задачи не требуется, и поле можно оставить пустым;
Присвоить выходные атрибуты в — укажите, куда будет записываться результат исполнения блока:
- контекст процесса — отметьте эту опцию, если вы создали переменные, в которые запишется результат работы блока, в контексте процесса;
- приложение — выберите опцию, а затем в поле Переменная* укажите приложение, добавленное в контекст процесса, в поля которого будет записан результат работы блока.

Вкладка «Входные и выходные атрибуты»

На этой вкладке заранее созданные свойства связываются с настройками блока, которые делятся на:

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

Описание свойств и их типы приведены в разделе «Добавить входные и выходные переменные».

antifraud-mask-highlight-6

Вкладка «Обработка ошибок»

Определите, по какой ветке направится ход бизнес-процесса при возникновении ошибки в работе блока, например, если модуль отключён. Также вы можете настроить оповещение пользователей об ошибке.

antifraud-mask-highlight-8

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

После завершения настройки нажмите кнопку Сохранить.

antifraud-solution.html antifraud-fill-in-variables.html

Была ли статья полезной?