Document 988682

Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
Министерство Российской Федерации по делам гражданской обороны,
чрезвычайным ситуациям и ликвидации последствий стихийных бедствий
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
ЭЛЕКТРОННОГО СЕРВИСА СМЭВ
Акт о пожаре
Дата: 01.08.2012
Версия: 1.3
Листов: 17
1
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
СОДЕРЖАНИЕ
ОБЩИЕ СВЕДЕНИЯ ......................................................................................................................4
1.1 Описание электронного сервиса ...................................................................................................... 4
1.2 Операции (методы) электронного сервиса ..................................................................................... 4
1.3 Схема взаимодействия...................................................................................................................... 4
2
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ.............................................................................................5
2.1 Операция « Запрос на получение акта о пожаре» .......................................................................... 5
2.1.1 Общие сведения ......................................................................................................................... 5
2.1.2 Описание входных параметров ................................................................................................ 5
2.1.3 Описание выходных параметров .............................................................................................. 6
1
2.1.4 Коды возвратов .......................................................................................................................... 6
2.2 Операция «Получение акта о пожаре»............................................................................................ 7
2.2.1 Общие сведения ......................................................................................................................... 7
2.2.2 Описание входных параметров ................................................................................................ 7
2.2.3 Описание выходных параметров .............................................................................................. 7
2.2.4 Коды возвратов .......................................................................................................................... 8
2.2.5 Контрольные примеры .............................................................................................................. 9
3
МЕТОДИКА ИСПЫТАНИЙ .........................................................................................................9
3.1 Общие условия .................................................................................................................................. 9
3.2 Параметры испытаний на тестовой среде .................................................................................... 10
3.3 Параметры испытаний на продуктивной среде ........................................................................... 10
3.4 Особые условия ............................................................................................................................... 10
4
ПРИЛОЖЕНИЯ.............................................................................................................................10
4.1 Описание сервиса (WSDL) ............................................................................................................. 10
4.2 Описание общих структур данных................................................................................................ 11
4.2.1 Параметр комплексного типа: FIO ......................................................................................... 11
4.2.2 комплексного типа: incidentDate ............................................................................................ 11
2
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
ИЗМЕНЕНИЯ
Версия
Дата
1.0
15.12.2011
1.1
01.02.2012
1.2
1.3
1.4
08.02.2012
01.08.2012
19.11.2012
1.5
21.02.2013
Автор
Лагутенко
Е.П.
Вялов И.С.
Вялов И.С.
Султанова
Д.Н.
Султанова
Д.Н.
Изменения
Исходный документ
Добавлен атрибут OriginRequestIdRef. Изменены
статусы первичного и вторичного запросов. Все
изменения на основе МР 2.4.3
Добавлено описание сервиса (WSDL)
Адреса, wsdl, КП
Обновлены КП
Обновлены КП
ТЕРМИНЫ/СОКРАЩЕНИЯ
Термин/сокращение
ИС
МЧС
СМЭВ
Поставщик
РОИВ
WSDL
Описание
Информационная система
Министерство чрезвычайных ситуаций
Система межведомственного электронного взаимодействия
Организация-владелец электронного сервиса
Региональный орган исполнительной власти.
Web Services Description Language — язык описания веб-сервисов.
3
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
1 ОБЩИЕ СВЕДЕНИЯ
1.1 Описание электронного сервиса
Наименование:
Назначение:
Электронный сервис «Акт о пожаре».
Электронный сервис предназначен для обеспечения возможности
взаимодействия органов исполнительной власти с электронным сервисом МЧС
России в части запроса актов о пожаре в рамках единой системы
межведомственного электронного взаимодействия (СМЭВ)
Поставщик:
Министерство чрезвычайных ситуаций
Область
Межведомственное взаимодействие
применения:
1.2 Операции (методы) электронного сервиса
Электронный сервис « Акт о пожаре» обеспечивает обмен данными между системамипотребителями (ИС РОИВ) и системой провайдером (ИС МЧС России).
Электронный сервис включает методы, обеспечивающие:

формирование запроса на получение акта о пожаре;

получение ответа с результатом обработки запроса на получение акта о пожаре.
Метод
Назначение
Код: queryFireAct
Наименование: Направление
получения акта о пожаре
Принимает
запроса
параметры
запроса,
возвращает
на идентификатор запроса/код обработки запроса
Принимает идентификатор ранее направленного
запроса, возвращает сведения акт о пожаре/код
обработки запроса
Код: getFireAct
Наименование: Получение акта о пожаре
1.3 Схема взаимодействия
В рамках взаимодействия между участниками для реализации сервиса в асинхронном
режиме предполагаются следующие типы сообщений:

запрос на получение акта о пожаре;

ответ на запрос получения акта о пожаре, содержащий идентификатор запроса
(requestIdRef), присвоенный запросу на стороне системы-провайдера, и код обработки
запроса;

повторный запрос на получение акта о пожаре по полученному ранее идентификатору
запроса;

ответ на повторный запрос на получение акта о пожаре, содержащий запрашиваемые
сведения либо код обработки запроса.
Схема взаимодействия системы-потребителя и системы-провайдера при получении акта о
пожаре представлена на рисунке 1.
4
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
Система-потребитель
Система-провайдер
Формирование
первичного запроса
Вызов сервиса
Приём данных,
формирование ответа
Передача ответа (requestIdRef)
Формирование
повтороного запроса
Вызов сервиса
Приём данных,
формирование ответа
Передача ответа
(Запрашиваемые сведения / Код обработки)
Рисунок 1 Схема взаимодействия при запросе на получение акта о пожаре
2 РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
2.1 Операция « Запрос на получение акта о пожаре»
2.1.1 Общие сведения
Код операции:
queryFireAct
Наименование
операции:
Запрос на получение акта о пожаре
Назначение операции:
Принимает параметры запроса,
запроса/код обработки запроса
возвращает
идентификатор
2.1.2 Описание входных параметров
Входные данные: queryFireAct
№
Код параметра
FIO
Описание
параметра
Фамилия,
отчество
Обязательность
имя,
+
1
Способ
заполнения/Тип
xs:string)
2
birthdate
Дата рождения
+
xs:date
3
placeBirth
Место рождения
+
xs:string
passport
Серия,
+
xs:string
+
xs:date
4
номер
паспорта
incidentDate
5
Дата происшествия
5
См. п. 3.1.1
tns:FIOType
(производный
Комментарий
от
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
incidentPlace
Место
+
tns:IncidentPlaceTyp
происшествия
(район,
6
См. п. 3.1.2
e
город,
населенный пункт,
улица, дом, корпус,
строение,
квартира)
2.1.3 Описание выходных параметров
Выходные данные: queryFireAct
№
Описание
параметра
Код параметра
requestIdRef
Идентификатор
Обязательность
Способ
заполнения/Тип
+
xs:string
+
xs:string
+
tns:StatusType
Комментарий
запроса,
1
инициировавшего
взаимодействие
originRequestIdRef
Идентификатор
запроса,
инициировавшего
2
цепочку
из
нескольких
запросов-ответов
Status
2
Код
обработки
запроса
(производный
от
xs:string)
2.1.4 Коды возвратов
При ответе сервис возвращает код обработки запроса Status, который принимает одно из
следующих значений:
№
Код возврата
Описание кода
возврата
Условия возникновения
Служебное
Сообщение-квиток
1
ACCEPT
о приеме
свидетельствует
электронного
Комментарий
сообщение,
о
приеме
сообщения
на
стороне поставщика электронного
сервиса.
2
REJECT
3
FAILURE
Мотивированный
Бизнес-отрицательный
отказ
запрос
Технический сбой
Обработанное
ответ
прерывание
на
на
стороне поставщика электронного
6
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
сервиса,
свидетельствующее
об
ошибке обработки электронного
сообщения запроса.
Ошибка,
4
INVALID
Ошибка при ФЛК
возникающая
выполнении
при
формально-
логического контроля входящего
сообщения
2.2 Операция «Получение акта о пожаре»
2.2.1 Общие сведения
Код операции:
getFireAct
Наименование
операции:
Получение акта о пожаре
Назначение операции:
Принимает идентификатор ранее направленного запроса, возвращает
акт о пожаре
2.2.2 Описание входных параметров
Входные данные: getFireAct
№
Код параметра
requestIdRef
Описание
параметра
Идентификатор
Обязательность
Способ
заполнения/Тип
+
xs:string
+
xs:string
Комментарий
запроса,
1
инициировавшего
взаимодействие
originRequestIdRef
Идентификатор
запроса,
инициировавшего
2
цепочку
из
нескольких
запросов-ответов
2.2.3 Описание выходных параметров
Выходные данные: getFireAct
№
1
2
3
Код параметра
Описание
параметра
Обязательность
Формат
параметра,
размерность
informationDate
Дата справки
+
xs:date
numberDate
Номер справки
+
xs:int
FIO
Данные о
заявителе
(Фамилия, Имя,
+
tns:FIOType
(производный от
xs:string)
7
Комментарий
См. п. 3.1.1
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
Отчество)
4
incidentDate
Дата происшествия
description
Описание событий,
которые привели к
факту
имущественных
потерь
Наименование
ведомства,
в
котором
зарегистрирован
данный факт
Адрес
происшествия
Наименование
утраченного
имущества
Территориальное
подразделение
МЧС, составившее
акт
5
DepartmentName
6
incidentAddress
7
propertyName
8
subdivisionMHS
9
10
rejectReason
Комментарий
+
+
xs:date
xs:string
+
xs:string
+
xs:string
+
xs:string
+
xs:string
-
xs:string
2.2.4 Коды возвратов
При ответе сервис возвращает код обработки запроса Status, который принимает одно из
следующих значений:
№
Код возврата
Описание кода
возврата
Условия возникновения
Ответ
на
Комментарий
запрос
данных/результатов, отправляемый
1
PROCESS
В обработке
поставщиком сервиса в случае,
если результат еще может быть
предоставлен по причине того, что
обработка не завершена.
Обработанное
прерывание
на
стороне поставщика электронного
2
FAILURE
Технический сбой
сервиса,
свидетельствующее
об
ошибке обработки электронного
сообщения запроса.
Ответ на запрос, который содержит
3
RESULT
Результат
сведения,
ради
которых
инициировался обмен данными.
4
REJECT
Мотивированный
Бизнес-отрицательный
отказ
запрос
Ошибка,
5
INVALID
Ошибка при ФЛК
выполнении
ответ
возникающая
на
при
формально-
логического контроля входящего
8
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
сообщения
Ответ на запрос, который содержит
6
STATE
Возврат состояния
сведения о состоянии обработки
электронного заявления.
2.2.5 Контрольные примеры
Запрос (сообщение со статусом REQUEST)
Ответ (сообщение со статусом ACCEPT)
Запрос (сообщение со статусом PING)
Ответ (сообщение со статусом RESULT)
3 МЕТОДИКА ИСПЫТАНИЙ
3.1 Общие условия
Проведение контрольных испытаний при регистрации электронного сервиса
регламентировано Приказом Министерства связи и массовых коммуникаций Российской
Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к
взаимодействию информационных систем в единой системе межведомственного электронного
взаимодействия».
Порядок проведения типовых испытаний предполагает следующие этапы:

Проверка комплектности предоставленной документации;

Проверка сетевой связности между узлом СМЭВ и точкой размещения электронного
сервиса;

Регистрация сервиса и тестирование сервиса на контрольном примере.
9
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
3.2 Параметры испытаний на тестовой среде
Проведение испытаний на тестовой среде перед регистрацией электронного сервиса в
продуктивной среде СМЭВ является необходимым действием, обеспечивающим повышение
качества и эффективности процесса и позволяющим выявлять ошибки и несоответствия
разработанного сервиса заранее, а не в продуктивном контуре.

Контактное лицо: Вялов Илья Сергеевич, e-mail: vyalov.ilya@otr.ru, тел: +7(495)223-0799 доб.446

Адрес тестового экземпляра:

http://188.254.16.92:7777/gateway/services/SID0003317?wsdl

Режим функционирования тестовой среды: 8/5. Особых условий доступности не
определено.

Для того чтоб протестировать сервис, необходимо:

протестировать все операции на основании контрольных примеров.
3.3 Параметры испытаний на продуктивной среде

Контактное лицо: Вялов Илья Сергеевич, e-mail: vyalov.ilya@otr.ru, тел: +7(495)223-0799 доб.446

Адрес продуктивного экземпляра:

http://oraas.rt.ru:7777/gateway/services/SID0003392?wsdl

Режим функционирования тестовой среды: 8/5. Особых условий доступности не
определено.

Для того чтоб протестировать сервис, необходимо:

протестировать все операции на основании контрольных примеров.
3.4 Особые условия
Особые условия и правила проведения контрольных испытаний не предусмотрены.
4 ПРИЛОЖЕНИЯ
4.1 Описание сервиса (WSDL)
10
Описание формата электронного сервиса «Обмен данными в рамках СМЭВ с РОИВ для получения акта о пожаре»
4.2 Описание общих структур данных
4.2.1 Параметр комплексного типа: FIO
№
Код параметра
Описание
параметра
1
lastName
фамилия
2
firstName
имя
middleName
отчество
Обязательность
Способ
заполнения/Тип
+
xs:string
+
xs:string
+
xs:string
Комментарий
3
4.2.2 комплексного типа: incidentDate
№
Код параметра
Описание
параметра
1
Region
район
2
City
город
3
Locality
населенный пункт
4
Street
улица
5
home
дом
6
corps
корпус
7
building
строение
8
apartment
квартира
Обязательность
Способ
заполнения/Тип
+
xs:string
-
xs:string
-
xs:string
+
xs:string
+
xs:string
-
xs:string
-
xs:string
-
xs:int
11
Комментарий