4.1 Запрос актуальной версии ГАС
Любой участник информационного взаимодействия может получить пакет с актуальным справочником ГАС, отправив технологическое сообщение МЭДО вида «Запрос глобального адресного справочника».
Запрос на получение актуальной версии ГАС отправляется в сообщении формата МЭДО 2.7.1 в адрес оператора информационного взаимодействия, к которому подключен участник (предпочтительно) или в некоторых случаях в адрес Организатора ГосЭДО. Операторы информационного взаимодействия направляют запрос на получение актуальной версии ГАС своему организатору (организатору МЭДО или ГосЭДО в зависимости от организатора, к которому подключена их транспортная шина).
Файл транспортного контейнера должен иметь название «addressees.edc.zip». Тип транспортного контейнера, указываемый в файле описания электронного сообщения, должен иметь значение «Сведения ГАС» (обязательно для заполнения). Файл паспорта ТК должен иметь название «passport.xml», оформляется в кодировке «UTF-8», первая строка содержит текст: «<?xml version-"1.0" encoding="UTF-8"?>». Номер версии формата файла описания ТК — 2.7.1.
Пример электронного сообщения вида «Запрос глобального адресного справочника» можно загрузить по ссылке: msg_zapros_aktualnogo_gas.zip.
Пример содержания паспорта ТК приведен на Рисунок 4.1.
Рисунок 4.1. Пример паспорта сообщения для запроса актуальной версии ГАС
Схема паспорта транспортного контейнера запроса на получение ГАС находится в файле iedms003_addressees_v2.7.1.xsd из состава справочников НСИ (начало описания запроса обозначено комментарием <!--Структура запроса "Запрос глобального адресного справочника"-->) (Рисунок 4.2).
Рисунок 4.2. Структура запроса на получение версии ГАС в файле схемы из состава НСИ
Описание элементов паспорта транспортного контейнера запроса на получение актуальной версии ГАС приведен в Таблица 4, а также указан в Приложении N2 «Формат транспортного контейнера для глобального адресного справочника» совместного приказа Минцифры России и ФСО России №500/82 от 29.06.2022.
Кратность элемента в таблице определяет его минимальное и максимальное допустимое число повторений в файле, а также обязательность его заполнения:
- 1 - элемент указывается один раз и заполняется обязательно;
- 1..n - элемент повторяется необходимое число раз и заполняется обязательно;
- 0..1 - элемент либо не указывается, либо указывается один раз и заполняется обязательно, если выполняются условия его обязательного заполнения, указанные в описании элемента;
- 0..n - элемент либо не указывается, либо повторяется необходимое число раз и заполняется обязательно, если выполняются условия его обязательного заполнения, указанные в описании элемента.
Таблица 4. Описание элементов схемы «Запрос глобального адресного справочника»
| Пункт | Идентификатор | Тип | Крат-ность | Описание элемента | ||||
| Описание корневых типов данных | ||||||||
| 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.3 | referenceRequest | Заданный | 1 | Запрос глобального адресного справочника Заданный тип: "referenceRequest" (пункт 22 настоящей таблицы) | ||||
| Описание задаваемых типов данных: | ||||||||
| 6 | globalUniqueIdentifier | Простой | -- | Простой Универсальный уникальный идентификатор Вид:"iiiiiiii-iiii-iiii-iiii-iiiiiiiiiiii"
i=[a-f0-9] |
||||
| 7 | dateTimeZone | Простой | -- | Дата и время с указанием часового пояса Вид: "YYYY-MM-DDThh:mm:ss+/-hh:mm" | ||||
| Описание элементов | ||||||||
| 22 | referenceRequest | Сложный | -- | Структура запроса "Запрос глобального адресного справочника" | ||||
| 22.1 | @requestUid | Заданный | 1 | Уникальный идентификатор запроса (сгенерированный программой, формирующей запрос) Заданный тип: "globalUniqueIdentifier" (пункт 6 настоящей таблицы) | ||||
| 22.2 | abonentUid | Заданный | 1 | Идентификатор источника запроса (GUID организации-автора запроса согласно ГАС) Заданный тип: "globalUniqueIdentifier" (пункт 6 настоящей таблицы) | ||||
| 22.3 | extractionKind | Строка | 1 | Вид запрашиваемых сведений: "Актуальные сведения" или "Исторические сведения" | ||||