5.1 Формирование тела документа
Для формирования примера цифрового документа для рассмотрения в курсе будет использован «Редактор документов», доступный на официальном сайте ГИС ГосЭДО по адресу https://gosedo.ru/редактор-документов. Данный редактор может быть использован в обучающих целях для подготовки и тестирования примеров цифровых документов.
Внимание! Версия НСИ в редакторе документов на сайте ГИС ГосЭДО может отличаться от версии НСИ, которая актуальна в текущих процессах информационного взаимодействия. Для подготовки корректных цифровых документов необходимо использовать актуальную версию НСИ, которая доступна на официальном сайте ГИС ГосЭДО (https://gosedo.ru/) в разделе «Форматы документов»→«Цифровые форматы и шаблоны», либо можно запросить актуальную версию НСИ в Центре поддержки ГИС ГосЭДО (support@gosedo.ru, +7 (800) 500-85-92).
Сформируем пример цифрового документа в редакторе и рассмотрим его наполнение.
На странице https://gosedo.ru/редактор-документов нажмите кнопку «Создать». Выберите вид информационного взаимодействия «Работа с поручением», вид события «Выдача поручения», вид документа «Резолюция» (Рисунок 5.1). Нажмите «Ввести документ».
Рисунок 5.1. Формирование примера цифрового документа в редакторе на сайте
В открывшейся форме заполните обязательные поля, отображающиеся красным цветом: «Исполнитель», «ТекстПоручения», «АвторПорчения», «СрокИсполнения» (Рисунок 5.2). Нажмите «Сохранить».
Рисунок 5.2. Формирование примера цифрового документа в редакторе на сайте
Под формой редактирования появится строка с названием цифрового документа «Резолюция от XXXX-XX-XX …..». Нажмите на пиктограмму загрузки в конце строки , чтобы скачать цифровой документ.
Файл с расширением .GOSX будет загружен на локальный компьютер. Откройте файл .GOSX программой для просмотра содержимого архивов. Откройте на просмотр файл digital.xml из состава архива. Пример файла можно загрузить по ссылке: digital.xml.
Файл основного документа имеет название digital.xml, оформляется в кодировке «UTF-8», первая строка цифрового документа содержит текст: «<?xml version-"1.0" encoding="UTF-8"?>».
Дальнейшее наполнение документа соответствует схеме этого вида документа. В данном случае это документ Doc01-005-00001 "Резолюция", схема которого находится в файле Doc01-005-00001_DocumentMeta_v1.0.0.xsd из состава ТК НСИ.
Первым элементом является элемент «Документ», в котором объявляются префиксы пространств имён, где определены элементы и типы данных, используемые в этом документе (Рисунок 5.3).
Рисунок 5.3. Базовая схема данных digital.xml
Далее следует основной элемент «ДанныеДокумента» (1), который ог раничивает зону подписываемого содержания документа.
Примечание: Здесь и далее в тексте и на иллюстрациях в скобках после наименования элемента указано допустимое количество элементов в документе:
- 1 — один обязательный элемент,
- 0..1 — элемент может отсутствовать или присутствовать один раз,
- 0..n — элемент может отсутствовать или присутствовать до n раз;
- 1..n — элемент должен присутствовать от 1 до n раз.
Первым дочерним для элемента «ДанныеДокумента» является элемент «ЗаголовокДокумента» (1) (см. Рисунок 5.3), в котором задаются идентификационные данные документа («карточка документа»):
- «ЗаголовокДокумента» (1) - вид документа согласно справочнику Cat01-002-00002 «Виды электронных документов»;
- «СсылкаДокумента» (1) - уникальный идентификатор документа, название документа;
- «СсылкаСоздателя» (1) - создатель документа согласно ГАС;
- «ВремяСоздания» (1) - время создания;
- «СодержитСведенияДСП» (1) - признак содержания сведений ДСП;
- «ТребуетПодписания» (1) - признак обязательного подписания документа;
- «ТребуетРегистрациии» (1) - признак обязательной регистрации документа;
- «ФиксированныйШаблон» (0..1) — файл xsl-шаблона, с помощью которого необходимо выполнять визуализацию этого документа. Если шаблон зафиксирован, то визуализацию данных можно получить только с его помощью.
Вторым дочерним для элемента «ДанныеДокумента» является элемент «СообщенияДокумента» (1), в котором приводится перечень событий по процессам, которые передаются с документом (см. Рисунок 5.3).
Третьим дочерним для элемента «ДанныеДокумента» является необязательный элемент «ПриложенияДокумента» (0..1) (см. Рисунок 5.3), в котором приводится перечень приложений к основному документу, если они есть. На каждый файл приложения должен быть приведён отдельный элемент «ПриложениеДокумента» (1..n), в котором заданы параметры приложения (имя файла, описание, хэш).
Дочерними элементами блока «СообщенияДокумента» являются элементы {НазваниеСобытия} с названиями событий, которые передаются с этим документом (Рисунок 5.4). Элементов {НазваниеСобытия} может быть несколько (0..n), поскольку один документ может начинать, координировать, завершать состояние нескольких процессов.
Рисунок 5.4 . Фрагмент структурированных данных с элементом «СообщенияДокумента»
В данном конкретном случае это одно событие «ВыдачаПоручения», поскольку документ «Резолюция» предназначен для инициации цифровых поручений, и в нём выдано только одно поручение. Если в документе будет выдано несколько поручений (по нескольким пунктам), то элемент «ВыдачаПоручения» будет приведен по количеству выданных поручений.
Перечень возможных событий по процессам определён в схеме конкретного процесса из ТК НСИ. Например, по процессу Exc01-005-00001 «Работа с поручением» виды событий и их структура определены в схеме Exc01-005-00001_ExchangeMeta_v1.0.0.xsd. В событии указываются данные согласно структуре, определенной в схеме процесса.
Согласно схеме, первым дочерним элементом события «ВыдачаПоручения» является «ИнформацияОПроцессе» (1) (Рисунок 5.5), где указывается код вида процесса и название процесса (согласно справочнику НСИ Cat01-002-00003 «Виды информационных взаимодействий»), по которому передается это событие. В дочерних элементах «ИнформацияОПроцессе» приводятся элементы:
- «СсылкаПроцесса» (1) - указывается GUID процесса и его представление, по которому передается это событие (для событий, начинающих новый процесс, как «ВыдачаПоручения», задается новый GUID процесса, поскольку событие инициирует новый процесс; для событий, которые продолжают работу по процессу, указывается GUID процесса, инициированного ранее, к которому привязано событие и документ);
- «СсылкаСоздателя» (1) - указывает данные организации-создателя процесса согласно ГАС;
- «ВремяСоздания» (1) - дата и время создания.
Рисунок 5.5. Структура события
После элемента «ИнформацияОПроцессе» следует элемент «ИнформацияОСобытии» (1) (см. Рисунок 5.5), в котором передается информация о событии, передаваемым с этим документом: код и название события (по данным события из схемы процесса). В дочерних элементах:
- «СсылкаСобытия» (1) - задается уникальный идентификатор события и его представление;
- «ВремяСобытия» (1) - дата и время события;
- «СтатусСобытия» (1) - статус события, который задает текущее состояние процесса (для события «ВыдачаПоручения»=«Инициация», что задано в xsd-схеме процесса Exc01-005-00001 «Работа с поручением»).
После «ИнформацияОСобытии» следует элемент «АгентыСобытия» (1) (Рисунок 5.6), в котором передаются роли агентов, которые занимают организации, участвующие в этом событии.
Рисунок 5.6. Содержание элемента «АгентыСобытия»
В составе элемента «АгентыСобытия» обязательно передается информация об элементе «АгентОтправитель» (1) - сведения об организации-отправителе документа.
Внутри элемента «АгентОтправитель» приводится элемент {НазваниеАгента} (1) (см. Рисунок 5.6), который указывает роль агента, которую занимает организация-отправитель в соответствии с правилами информационного взаимодействия по процессу. Обязательный вложенный элемент «СсылкаАгента» (1) передает информацию об организации, которая занимает роль этого агента (GUID и наименование организации согласно ГАС).
Далее следует элемент «АгентыПолучатели» (0..n) (если элемент необходим согласно схеме события), в котором задаются сведения об организациях-получателях документа (см. Рисунок 5.6). Внутри элемента «АгентыПолучатели» на каждую организацию-получателя указывается элемент {НазваниеАгента} (1), который указывает роль агента, которую занимает конкретная организация-получатель в соответствии с правилами информационного взаимодействия по процессу.
Обязательный вложенный элемент «СсылкаАгента» (1) передает информацию об организации, которая занимает роль этого агента (GUID и наименование организации согласно ГАС). Обязательность/необязательность указания агентов-получателей и их ролей задана в схеме события по процессу.
После элемента «АгентыСобытия» следует элемент «ПредметыСобытия» (0..1), который состоит из элементов {НазваниеПредмета} (1..n), в которых приводится информация о предметах, передающихся с этим событием (Рисунок 5.7).
Информация о предметах события описана в схеме события по процессу. В схеме процесса «Работа с поручением» Exc01-005-00001_ExchangeMeta_v1.0.0.xsd, определено, что в событии «Выдача поручения» должна быть передана информация о двух предметах: «Поручение» и «Доклад».
Рисунок 5.7. Содержание элемента «ПредметыСобытия»
В составе каждого элемента {НазваниеПредмета} приводятся элементы согласно схеме этого предмета и схеме события (Рисунок 5.8):
- «ВидВладельца» (1) — роль агента-владельца предмета;
- «СостояниеПредмета» (0..1) - фиксированное для вида события значение, определяет новое состояние предмета после наступления события в ходе процесса;
- «ДанныеДляВизуализации» (1) - произвольная структура данных, заданная схемой события, данные для вывода в визуализации документа;
- «ДанныеДляКоординации» (1) - произвольная структура данных, заданная схемой события, данные мониторинга и координации процесса.
Рисунок 5.8. Содержание элемента «{НазваниеПредмета}»
Описание базовых структурированных данных цифровых документов приведено в Приложение Б.