3.2 Получение и состав справочников НСИ
В ответ на запрос актуальных справочников НСИ с узла Организатора ГосЭДО будет автоматически направлено электронное сообщение формата 2.7.1 инициатору запроса, содержащее транспортный контейнер типа «Сведения НСИ» с актуальной версией справочников НСИ. Пример электронного сообщения с ответом на запрос актуальной версии НСИ можно загрузить по ссылке: msg_nsi_referenceResponse_v53.zip.
В составе ТК с актуальной версией справочников НСИ (ТК НСИ):
- файл паспорта ТК passport.xml, в котором совмещены элементы «описание транспортного контейнера» и «данные технологического сообщения», содержащий основные данные справочников;
- опционально, файл preview.html – файл с визуализацией справочников НСИ в html для просмотра в браузере человеком при отсутствии возможности машинной обработки (в версии html представлены только сведения справочников для визуального просмотра, полные сведения содержатся в файле passport.xml);
- файлы xsd-схем, описывающих структуру и типы данных справочников, электронных сообщений, контейнеров и цифровых документов;
- файлы xsl-шаблонов для визуализации. Пример содержания паспорта ТК приведен на Рисунок 3.3.
Рисунок 3.3. Пример фрагмента паспорта ТК с ответом на запрос актуальных сведений НСИ
Схема паспорта транспортного контейнера с актуальными сведениями НСИ находится в файле iedms004_references_v2.7.1.xsd из состава ТК НСИ (начало описания структуры ответа на запрос справочника обозначено комментарием <!--Структура ответа "Отправка нормативно-справочной информации"-->, начало описания структуры актуальных сведений справочников НСИ обозначено комментарием <!--Структура для публикации актуальных сведений НСИ-->) (Рисунок 3.4).
Рисунок 3.4. Структура публикации актуальных сведений НСИ в файле схемы из состава ТК НСИ
Описание элементов паспорта транспортного контейнера с версией справочников НСИ приведено в Таблица 2, а также указано в Приложении №4 проекта совместного приказа Минцифры России и ФСО России «Об утверждении Технических требований к порядку ведения нормативно-справочной информации при организации информационного взаимодействия».
Кратность элемента определяет его минимальное и максимальное допустимое число повторений в файле, а также обязательность его заполнения:
- 1 - элемент указывается один раз и заполняется обязательно;
- 1..n - элемент повторяется необходимое число раз и заполняется обязательно;
- 0..1 - элемент либо не указывается, либо указывается один раз и заполняется обязательно, если выполняются условия его обязательного заполнения, указанные в описании элемента;
- 0..n - элемент либо не указывается, либо повторяется необходимое число раз и заполняется обязательно, если выполняются условия его обязательного заполнения, указанные в описании элемента.
Таблица 2. Описание элементов схемы паспорта ТК со сведениями НСИ
| Пункт | Идентификатор | Тип | Кратность | Описание элемента |
| Описание корневых типов данных: | ||||
| 1 | container | Сложный | 1 | Паспорт транспортного контейнера НСИ |
| 1.1 | @version | Строка | 1 | Версия XML-схемы паспорта: «2.7.1» |
| 1.2 | header | Сложный | 1 | Описание транспортного контейнера |
| 1.2.1 | uid | Заданный | 1 | Уникальный идентификатор контейнера. Заданный тип: «globalUniqueIdentifier» (пункт 6 настоящей таблицы) |
| 1.2.2 | created | Заданный | 1 | Дата и время создания контейнера. Заданный тип: «dateTimeZone» (пункт 7 настоящей таблицы) |
| 1.2.3 | previewFile | Заданный | 0..1 | Название файла визуализации технологического сообщения. Заданный тип: «fileName» (пункт 5 настоящей таблицы) |
| 1.2.4 | signatureFile | Заданный | 0..1 | Название файла электронной подписи транспортного контейнера. Заданный тип: «fileName» (пункт 5 настоящей таблицы) |
| 1.3 | Данные технологического сообщения – одно из следующих значений: | |||
| referenceActual | Заданный | 1..n | Актуальная нормативно-справочная информация. Заданный тип: «referenceActual» (пункт 10 настоящей таблицы) |
|
| referenceResponse | Заданный | 1 | Отправка нормативно-справочной информации. Заданный тип: «referenceResponse» (пункт 13 настоящей таблицы). |
|
| Описание задаваемых типов данных: | ||||
| 2 | numberValue | Простой | -- | Базовый тип: число (от 1 до 109-1) |
| 3 | stringValue | Простой | -- | Базовый тип: строка (от 1 до 511 символов) |
| 4 | identityValue | Простой | -- | Идентификатор объекта (код) |
| 5 | fileName | Простой | -- | Имя файла внутри контейнера |
| 6 | globalUniqueIdentifier | Простой | -- | Универсальный уникальный идентификатор Вид: «iiiiiiii-iiii-iiii-iiii-iiiiiiiiiiii» i=[a-f0-9] |
| 7 | dateTimeZone | Простой | -- | Дата и время с указанием часового пояса Вид: «YYYY-MM-DDThh:mm:ss±hh:mm» |
| 8 | semverValue | Простой | -- | Семантический номер версии в формате Вид: «MM.mmm.ppp» (https://semver.org/) |
| 9 | referenceMeta | Сложный | -- | Общая информация о справочнике, входящем в состав НСИ. |
| 9.1 | referenceId | Строка | 1 | Код справочника по классификатору видов справочников |
| 9.2 | referenceName | Строка | 1 | Название справочника по классификатору видов справочников. |
| 9.3 | metaVersion | Заданный | 1 | Семантический номер версии метаданных в формате MM.mmm.nnn Заданный тип: «semverValue» (пункт 8 настоящей таблицы) |
| 9.4 | metaSchemaFile | Заданный | 0..1 | Название файла XML-схемы с описанием структуры справочника Заданный тип: «fileName» (пункт 5 настоящей таблицы) |
| 10 | referenceActual | Сложный | -- | Структура для публикации актуальных сведений НСИ. |
| 10.1 | referenceMeta | Заданный | 1 | Описание справочника по классификатору видов справочников. Заданный тип: «referenceMeta» (пункт 9 настоящей таблицы) |
| 10.2 | extractionDate | Заданный | 1 | Дата и время извлечения сведений НСИ (для указанной версии). Заданный тип: «dateTimeZone» (пункт 7 настоящей таблицы) |
| 10.3 | dataVersion | Число | 1 | Порядковый номер версии сведений НСИ, присвоенный организатором. |
| 10.4 | recordsActual | Заданный | 1..n | Записи данных по справочнику. |
| 10.4.1 | Актуальная версия записи справочника | Заданный | 1..n | Запись справочника. Схема данных задаётся видом справочника (referenceMeta) и по решению отправителя может также вкладываться в контейнер. |
| 12 | referenceRequest | Сложный | -- | Структура запроса «Запрос нормативно-справочной информации» |
| 12.1 | requestUid | Заданный | 1 | Уникальный идентификатор запроса. Заданный тип: «globalUniqueIdentifier» (пункт 6 настоящей таблицы). |
| 12.2 | sourceUid | Заданный | 1 | Идентификатор источника запроса (оператора, участника). Заданный тип: «globalUniqueIdentifier» (пункт 6 настоящей таблицы) |
| 12.3 | extractionKind | Строка | 1 | Вид запрашиваемых сведений. Допустимые значения:
|
| 13 | referenceResponse | Сложный | -- | Структура ответа «Отправка нормативно-справочной информации» |
| 13.1 | responseUid | Заданный | 1 | Уникальный идентификатор ответа. Заданный тип: «globalUniqueIdentifier» (пункт 6 настоящей таблицы) |
| 13.2 | requestUid | Заданный | 1 | Идентификатор запроса, на который подготовлен ответ. Заданный тип: «globalUniqueIdentifier» (пункт 6 настоящей таблицы) |
| 13.3 | Данные ответа на запрос – одно из следующих значений: | |||
| referenceMeta | Заданный | 0..n | Общая информация о справочнике, входящем в состав НСИ. Заданный тип: «referenceMeta» (пункт 9 настоящей таблицы) | |
| referenceActual | Заданный | 0..n | Структура для публикации актуальных сведений НСИ. Заданный тип: «referenceActual» (пункт 10 настоящей таблицы) | |