Руководство пользователя электронного сервиса ГАС «Управление» (стр. 3 )

Рисунок 1 – Схема взаимодействия при предоставлении информации, содержащейся в ИС Поставщика, в адрес ГАС «Управление»

Метод Query

Для обеспечения данного взаимодействия осуществляется следующая последовательность действий:

а)  ИС Потребитель осуществляет вызов метода query электронного сервиса. В качестве параметра вызова указанного метода передается ЭС, сформированное ИС Потребителем, которое содержит ЭД с запросом на получение необходимой ИС Потребителю информации. Формат данного ЭС соответствует элементу GasuQueryMessage, который определен в схеме сообщений, используемых при взаимодействии с ГАС «Управление» (файл gasu2.xsd);

б)  ГАС «Управление» обрабатывает вызов метода query электронного сервиса gasu2 и по результатам обработки формирует:

1)  ЭД, который содержит информацию, запрошенную ИС Потребителем, в случае успешной обработки запроса. Сформированный ЭД включается в ЭС, формат которого соответствует элементу GasuTicket, включающий элемент QueryResponse, который определен в схеме сообщений, используемых при взаимодействии с ГАС «Управление» (файл gasu2.xsd);

2)  Отказ в обработке запроса, поступившего от ИС Потребителя. Сведения об отказе включается в ЭС, формат которого соответствует элементу GasuTicket, который определен в схеме сообщений, используемых при взаимодействии с ГАС «Управление» (файл gasu2.xsd).

На рисунке 2 представлена схема взаимодействия при получении информации, содержащейся в ГАС «Управление» ИС Потребителем.

Рисунок 2 – Схема взаимодействия при получении информации, содержащейся в ГАС «Управление» ИС Потребителем

Метод Updates

Для обеспечения данного взаимодействия осуществляется следующая последовательность действий:

а)  ИС Потребитель осуществляет вызов метода updates электронного сервиса. В качестве параметра вызова указанного метода передается ЭС, сформированное ИС Потребителем, которое содержит ЭД с запросом на получение информации об изменениях данных по показателям. Формат данного ЭС соответствует элементу GasuUpdatesMessage, который определен в схеме сообщений, используемых при взаимодействии с ГАС «Управление» (файл gasu2.xsd);

б)  ГАС «Управление» обрабатывает вызов метода updates электронного сервиса gasu2 и по результатам обработки формирует:

1)  в случае успешной обработки запроса ЭД, который содержит информацию, запрошенную ИС Потребителем. Сформированный ЭД включается в ЭС, формат которого соответствует элементу GasuTicket, включающий элемент UpdatesResponse, который определен в схеме сообщений, используемых при взаимодействии с ГАС «Управление» (файл gasu2.xsd);

2)  Отказ в обработке запроса, поступившего от ИС Потребителя. Сведения об отказе включается в ЭС, формат которого соответствует элементу GasuTicket, который определен в схеме сообщений, используемых при взаимодействии с ГАС «Управление» (файл gasu2.xsd).

На рисунке 3 представлена схема взаимодействия при получении информации об обновлениях данных показателей, содержащихся в ГАС «Управление», ИС Потребителем.

Рисунок 3 – Схема взаимодействия при получении информации об обновлениях данных показателей, содержащихся в ГАС «Управление», ИС Потребителем

1.6  Связи с другими электронными сервисами

Данный сервис не имеет связей с другими сервисами.

2  Руководство пользователя

2.1  Операция «Публикация и обновление информации в ГАСУ»

2.1.1  Общие сведения

Таблица 3. Сведения об операции «Публикация и обновление информации в ГАСУ»

Код операции:	Publish
Наименование операции:	Публикация и обновление информации в ГАС «Управление».
Назначение операции:	Операция предназначена для публикации информации, поступающей от ИС Поставщиков, в ГАС «Управление»

2.1.2  Описание входных параметров

Единственным входящим параметром метода publish является сообщение типа GasuMessage, которое содержит информацию необходимую для публикации в ГАС «Управление». Структура типа GasuMessage реализована в соответствие с форматом, описанным в документе «Методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии (версия 2.5.6)». Детальная информация о составе блока структурированных сведений AppMessage типа AppMessageType представлена в таблице 4.

Таблица 4. Описание типа AppMessageType

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	AppHeader	Заголовок блока	+	smev:AppHeaderType	Более подробная информация представлена в разделе 4.2.3 Прикладной тип AppHeaderType
2	MessageType	Тип сообщения	+	smev:MessageTypeType (производный от xsd:string)	Тип взаимодействия. Допустимы следующие значения: ImportFull - Сохранить информацию о объекте/объектах целиком на основе информации из сообщения – используется в методе publish ImportDelta – Обновить информацию о объекте/объектах на основе информации из сообщения – используется в методе publish Delete – Удалить информацию об объекте/объектах – используется в методе publish
3	Body	Тело блока	+	Body	Более подробная информация представлена в разделе 4.2.39 Локальный прикладной тип данных Body [element AppMessage]

2.1.3  Описание выходных параметров

Единственным исходящим параметром метода publish является сообщение типа GasuTicket, которое содержит информацию о результатах выполнения операции публикации информации поступившей от ИС Поставщиков в ГАС «Управление». Структура типа GasuTicket реализована в соответствие с форматом, описанным в документе «Методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии (версия 2.5.6)». Детальная информация о составе блока структурированных сведений GasuResponse, входящего в состав GasuTicket (GasuTicket/MessageData/AppData/GasuResponse), типа GasuResponseType представлена в таблице 5.

Таблица 5. Описание типа GasuResponseType

№	Код параметра	Описание параметра	Обязательность	Способ заполнения/Тип	Комментарий
1	RequestID	Идентификатор сообщения, в ответ на которое сформирован данный ответ	+	UIDType	Соответствует RequestID входного сообщения сформированного поставщиком
2	GasuResponseCode	Код ответа, определяющий результаты обработки запроса в ГАС «Управление».	+	string	Возможные на данный момент коды возврата приведены в разделе 2.1.4 Коды возвратов
3	GasuResponseMessage	Текстовое сообщение, которое может содержать дополнительную информацию о результатах обработки сообщения		string
4	PublishResponse	Блок структурированных сведений. Может быть использован для передачи различных данных.		PublishResponseType	Более подробная информация представлена в разделе 4.2.26 Прикладной тип PublishResponseType

Параметры комплексного типа описаны в приложении «Описание общих структур данных».

2.1.4  Коды возвратов

Таблица 6. Коды возрвата

№	Код возврата	Описание кода возврата	Условия возникновения
1	200	Запрос выполнен успешно
2	210	Запрос выполнен успешно, имеются предупреждения	Возникает, когда в процессе обработки сообщение проходит форматно-логический котроль без ошибок, но с предупреждениями. Например: Переданные данные не соответствуют ТКМВ.
3	100	Ошибка форматно-логического контроля	Возникает при наличии ошибок во входящем XML запросе
4	110	Ошибка при проверке параметров входящего сообщения	Возникает, когда параметры входящего сообщения не соответствуют контракту веб-сервиса (но могут соответствовать схеме). Например, при вызове метода Query проставлен returtType="Organization", но в самом элементе Query запроса, нет элемента Organization, который определяет фильтр.
5	403	Отказ в доступе к сервисам ГАС «Управление»	Возникает при запросах от ИС, не имеющих прав на работу с сервисами ГАСУ.
6	404	Запрашиваемый ресурс не найден.	Возникает, когда в запросе присутствует ссылка на какой либо ресурс или объект, по которому публикуются/запрашиваются данные, который не определен в системе ГАСУ.
7	410	Нет доступа для публикации данных	Возникает при запросах от ИС, не имеющих прав на публикацию данных по определенным объектам. Например: Региональная ИС пытается опубликовать данные по показателю, и указывает не тот регион, к которому она принадлежит.
8	500	Внутренняя ошибка ГАС «Управление»	Возникает при наличии ошибок при обработке сообщений по внутренним причинам, в том числе, не относящимся непосредственно к посылаемому запросу.
9	510	Внутренняя ошибка при работе с данными	Возникает при обращении к базе данных в результате некорректно составленного запроса.

2.1.5  Контрольные примеры