3.1.1. Данные о происшествиях ("Служба 02") (в режиме реального времени)
Информация по одному событию передается однократно по мере создания карточек событий. Для передачи информации необходимо вызывать соответствующую хранимую процедуру в базе данных СЦ.
3.1.1.1. Информационная услуга "Предоставление сведений о происшествии"
Информационная услуга предоставляет подробные сведения о конкретном происшествии, зарегистрированном в дежурной части "02". Информация о происшествии включает в себя место и время происшествия, сведения о человеке, сообщившем о происшествии, протокол обработки происшествия, а также результат выезда наряда милиции.
Структура прикладных объектов взаимодействия:
Запрос на выполнение информационной услуги (элемент incidentlnfoRequest)
N | Элемент прикладного объекта | Тип [множественность] | Содержание |
1 | incidentld | Строка [1] | Идентификатор происшествия |
Результат выполнения информационной услуги (элемент incidentlnfoResult)
N | Элемент прикладного объекта | Тип [множественность] | Содержание |
1 | executionResult | - [1] | Сведения о результате выполнения информационной услуги |
1.1 | resultCode | Целое число [1] | Код результата выполнения. Значение "0" соответствует успешному выполнению. Любое другое значение соответствует неуспешному выполнению. Диапазон допустимых значений: от 0 до 255 |
1.2 | resultDescription | Строка [1] | Текстовое описание результата выполнения (например, сообщение об ошибке). При успешном выполнении этот элемент может отсутствовать в составе прикладного объекта |
2 | incidentlnfo | - [0..1] | Подробные сведения о происшествии |
2.1 | incidentld | Строка [1] | Идентификатор сообщения |
2.2 | incidentKind | Строка [1] | Наименование вида происшествия |
2.3 | incidentAddress | - [1] | Адрес происшествия |
2.3.1 | addressPrefixCode | - [1] | Код префикса адреса |
2.3.1.1 | value | Строка [1] | Значение кода префикса адреса (из классификатора адресной системы КЗРиЗ) |
2.3.1.2 | атрибут classifier | Строка [0..1] | Наименование классификатора: по умолчанию содержит значение "Адресная система КЗРиЗ". Этот атрибут в прикладном объекте можно не указывать |
2.3.2 | buildingNumber | Строка [0..1] | Номер дома |
2.3.3 | buldingSubnumber | Строка [0..1] | Корпус дома |
2.3.4 | buldingLetter | Строка [0..1] | Литера дома |
2.3.5 | appNumber | Строка [0..1] | Номер квартиры |
2.3.6 | appLetter | Строка [0..1] | Литера квартиры |
2.3.7 | additionallnfo | Строка [0..1] | Дополнительная информация по адресу в виде текстового описания |
2.4 | incidentLocation | - [0..1] | Описание места происшествия |
2.4.1 | хCoordinate | Строка [1] | Координата места происшествия по оси X |
2.4.2 | yCoordinate | Строка [1] | Координата места происшествия по оси Y |
2.4.3 | атрибут coordinateSystem | Строка [1] | Наименование используемой системы координат |
2.5 | incidentTime | Строка [1] | Дата и время происшествия. Формат строки: YYYY-MM-DDTHH:MM:SS |
2.6 | personNAME | Строка [0..1] | Ф.И.О. человека, с которым связано происшествие |
2.7 | declarantlnfo | Строка [0..1] | Сведения о человеке, заявившем о происшествии (*) |
2.8 | incidentProtocol | Строка [1] | Протокол сообщений, формируемых по данному происшествию. Протокол представляет собой список сообщений, каждое из которых является строкой, содержащей время сообщения, содержание сообщения и символ перевода строки. Эти строки в списке должны быть отсортированы по времени по убыванию (последние зарегистрированные сообщения находятся в начале списка) |
3.1.1.2. Информационная услуга "Предоставление списка происшествий за период"
Информационная услуга предоставляет список происшествий, зарегистрированных в дежурной части "02" за указанный период. Каждый элемент списка содержит информацию о месте и времени происшествия, виде происшествия, а также результате выезда наряда милиции.
Структура прикладных объектов взаимодействия:
Запрос на выполнение информационной услуги (элемент incidentsListRequest)
N | Элемент прикладного объекта | Тип [множественность] | Содержание |
1 | incidentКindCodeList | Строка [0..1] | Список кодов видов происшествий, которые необходимо поместить в результирующий список. Если этот элемент не присутствует в объекте, то список составляется для всех видов происшествий. Коды видов происшествий разделяются символом "|" |
2 | period | - [1] | Период времени, за который требуется получить список происшествий |
2.1 | from | Строка [1] | Начальный момент периода. Формат строки: YYY-MM-DDTHH:MM:SS |
2.2 | to | Строка [1] | Конечный момент периода. Формат строки: YYYY-MM-DDTHH:MM:SS |
Примечания: (1) В список должны попасть все происшествия, зарегистрированные в указанный период.
Результат выполнения информационной услуги (элемент incidentsListResult)
N | Элемент прикладного объекта | Тип [множественность] | Содержание |
1 | executionResult | - [1] | Сведения о результате выполнения информационной услуги |
1.1 | resultCode | Целое число [1] | Код результата выполнения. Значение "0" соответствует успешному выполнению. Любое другое значение соответствует неуспешному выполнению. Диапазон допустимых значений: от 0 до 255 |
1.2 | resultDescription | Строка [1] | Текстовое описание результата выполнения (например, сообщение об ошибке). При успешном выполнении этот элемент может отсутствовать в составе прикладного объекта |
2 | incidentList | - [0..1] | Список происшествий |
2.1 | incident | - [1..*] | Краткая информация о происшествии |
2.1.1 | incidentKindCode | Строка [1] | Код вида происшествия |
2.1.2 | incidentAddress | - [1] | Адрес происшествия |
2.1.2.1 | addressPrefixCode | - [1] | Код префикса адреса |
2.1.2.1.1 | value | Строка [1] | Значение кода префикса адреса (из классификатора адресной системы КЗP) |
2.1.2.1.2 | атрибут classifier | Строка [0..1] | Наименование классификатора: по умолчанию содержит значение "Адресная система КЗРиЗ". Этот атрибут [на] прикладном объекте можно не указывать |
2.1.2.2 | buildingNumber | Строка [0..1] | Номер дома |
2.1.2.3 | buldingSubnumber | Строка [0..1] | Корпус дома |
2.1.2.4 | buldingLetter | Строка [0..I] | Литера дома |
2.1.2.5 | appNumber | Строка [0..1] | Номер квартиры |
2.1.2.6 | appLetter | Строка [0..1] | Литера квартиры |
2.1.2.7 | additionallnfo | Строка [0..1] | Дополнительная информация по адресу в виде текстового описания |
2.1.3 | incidentLocation | - [0..1] | Описание места происшествия |
2.1.3.1 | xCoordinate | Строка [1] | Координата места происшествия по оси X |
2.1.3.2 | yCoordinate | Строка [1] | Координата места происшествия по оси Y |
2.1.3.3 | coordinateSystem | Строка [11 | Наименование используемой системы координат |
2.1.4 | incidentTime | Строка [1] | Дата и время происшествия. Формат строки: YYYY-MM-DDTHH:MM:SS |
2.1.5 | incidentHandlingResult | Строка [0..1] | Результат выезда на место происшествия |
2.1.6 | incidentld | Строка [1] | Идентификатор происшествия |
2.1.7 | incidentDescription | Строка [1] | Описание происшествия (*) |
Примечания: (*) - формат строки:
(1) для ДЧ-02: <описание события>, где описание события - атрибут журнала учета информации в АИС ДЧ-02;
(2) для ДЧ-01: <описание события>, этаж: <этаж пожара>/<число этажей>, ранг: <ранг пожара>, где описание события, этаж пожара, число этажей и ранг пожара - атрибуты таблицы "Происшествия" в АИС ДЧ-01.