5 Интеграция редактора структурированных данных цифрового документа
Редактор структурированных данных «Портала ГосЭДО» является локальным сервисом для формирования и редактирования структурированных данных цифровых документов (XML-файлов).
Для обеспечения возможности формирования файла структурированных данных цифрового документа (файла digital.xml) предлагается интегрировать редактор структурированных данных «Портала ГосЭДО» в СЭД так, чтобы пользователь создавал и изменял структурированные данные в карточке документа СЭД.
Данный способ интеграции позволит:
- формировать файл структурированных данных цифрового документа (XML-файла) в карточке документа СЭД;
- просматривать визуализацию XML-файла, изменять и дополнять его;
- дополнять контейнер документа сформированным XML-файлом в качестве вложения до его отправки в МЭДО;
- выполнять все действия по подготовке и отправке транспортного контейнера документа без необходимости дополнительного перехода в конвертер документов «Портала ГосЭДО».
При реализации такого способа интеграции необходимо реализовать средствами СЭД:
- вызов окна редактора с передачей контекста текущей задачи;
- сохранение результирующего XML-файла в привязке к карточке документа;
- просмотр HTML визуализации XML-файла и печатной формы в виде PDF-файла (при необходимости);
- размещение XML-файла с именем «digital.xml» среди вложений транспортного контейнера МЭДО 2.7.1;
- добавление события регистрации и ограничения доступа в XML-файл (при возникновении соответствующих событий);
- автоматическое создание PDF-файла основного документа из структурированных данных файла XML (при необходимости).
Редактор включается в веб-интерфейс СЭД посредством элемента <iframe>, с указанием src="http://server-url/#/constructor/selector", где «server-url» - URL-адрес доступа к используемому экземпляру «Портала ГосЭДО». Для выбора нужной темы оформления после адреса редактора дополняется строка «/?theme=[dark/light]», где указывается одно из значений: «dark» - для тёмной темы оформления, «light» - для светлой темы оформления.
Пример кода интеграции окна редактора структурированных данных со светлой темой оформления (Рисунок 2.2):
<iframe src="http://10.77.142.21:84/#/constructor/selector/?theme=light">
// где
// 10.77.142.21:84 – IP-адрес:порт, на котором доступен модуль «Портал ГосЭДО»
// theme=light – признак светлой темы оформления
Рисунок 2.2. Пример интеграции окна редактирования структурированных данных в веб-интерфейс СЭД со светлой темой оформления
В зависимости от концепции интерфейса СЭД редактор структурированных данных может быть размещен на отдельной вкладке карточки документа или открываться в модальном окне, например при нажатии на отдельную кнопку «Ввод цифрового документа (XML)».
В любом случае СЭД должна перехватывать события окна редактирования, предусматривать сигнализацию пользователю ошибки заполнения (при их наличии), а также сохранять результирующий XML-файл в карточке документа СЭД в качестве приложения к основному документу.