3Приложения 3.1Описание сервиса (WSDL) В комплекте документации поставляются WSDL- и XSD-описания электронного сервиса СК МВД России в виде отдельных файлов, оформленных в соответствии с методическими рекомендациями СМЭВ версий 2.4.5. Структура вложения представлена на рисунке ниже.
Рисунок 1. Описание сервиса во вложении
3.2Описание общих структур данных Предложенные ниже текстовые описания актуальны для приложенного файла sxMessageTypes.xsd. Пространства имен в таблицах приняты следующими: 3.2.1tns:getTaskTypesMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| user
| Объект информации о вызывающем лице
| +
| tns:user
|
| 3.2.2tns:serviceRequestMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| user
| Пользователь (организация), представляющий запрашивающую сторону
| +
| tns:user
|
| 3
| serviceCode
| Код типа запроса
| +
| xs:string
|
| 4
| versionCode
| Версия типа запроса
| +
| xs:string
|
| 5
| parameters
| Параметры запроса
| -
| tns:taskParameter
| В случае множества параметров – заполняется множество объектов этого типа (см. пример)
| 6
| attachments
| Приложения
| -
| tns:attachment
| В случае множества параметров – заполняется множество объектов этого типа (см. пример)
| 3.2.3tns:user №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| organization
| Код запрашивающего ФОИВа – заполняется в соответствии с приложением 4.4.3
| +
| xs:string
| Строка не может быть пустой
| 2
| person
| Объект пользователя
| +
| tns:person
|
| 3.2.4tns:person №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| Id
| ID пользователя
| -
| xs:string
|
| 2
| firstName
| Имя пользователя
| +
| tns:personName
|
| 3
| secondName
| Отчество пользователя
| +
| tns:personName
|
| 4
| lastName
| Фамилия пользователя
| +
| tns:personName
|
| 3.2.5tns:personName Расширение типа xs:string с проверкой на соответствие следующему регулярному выражению:
[а-яА-ЯёЁ\-\s]+
3.2.6tns:getTaskTypesResponseMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| errorCode
| Числовой код ответа
| +
| xs:int
|
| 3
| errorDescription
| Текстовый комментарий к ответу
| -
| xs:string
|
| 4
| services
| Доступные пользователю типы запросов
| -
| tns:service
| В случае множества параметров – заполняется множество объектов этого типа (см. пример)
| 3.2.7tns:service №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| code
| Код возврата
| +
| xs:string
|
| 2
| incomingParameters
| Параметры запроса
| +
| tns:taskParameterDefinition
| В случае множества параметров – заполняется множество объектов этого типа (см. пример)
| 3
| outgoingParameters
| Параметры ответа
| +
| tns:taskParameterDefinition
| В случае множества параметров – заполняется множество объектов этого типа (см. пример)
| 3.2.8tns:taskParameterDefinition №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| name
| Наименование параметра
| -
| xs:string
|
| 2
| type
| Тип параметра
| -
| tns:taskParameterType
|
| 3
| mandatory
| Признак обязательности параметра
| +
| xs:boolean
|
| 4
| pattern
| Regexp-параметр для валидации
| -
| xs:string
| В случае формата типа «Дата» в этом поле указывается шаблон даты.
| 5
| length
| Максимальная длина значения параметра
| -
| xs:int
|
| 3.2.9tns:taskParameter №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| name
| Наименование параметра
| +
| xs:string
|
| 2
| value
| Значение параметра
| +
| xs:string
|
| 3.2.10tns:attachment №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| code
| Код вложения
| +
| xs:string
|
| 2
| fileName
| Имя файла-вложения
| -
| xs:string
|
| 3
| mimeType
| MIME-тип вложения
| +
| xs:string
|
| 4
| data
| Содержимое вложения
| +
| xs:base64Binary
|
| 3.2.11tns: getResultMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| user
| Пользователь (организация), представляющий запрашивающую сторону
| +
| tns:user
|
| 3
| taskId
| Номер задачи
| +
| xs:string
|
| 3.2.12tns:getResultResponseMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| errorCode
| Числовой код ответа
| +
| xs:int
|
| 3
| errorDescription
| Текстовый комментарий к ответу
| -
| xs:string
|
| 4
| taskResult
| Объект результата выполнения задачи
| -
| tns:taskResult
|
| 3.2.13tns:processTaskResponseMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| errorCode
| Числовой код ответа
| +
| xs:int
|
| 3
| errorDescription
| Текстовый комментарий к ответу
| -
| xs:string
|
| 4
| taskResult
| Объект результата выполнения задачи
| -
| tns:taskResult
|
| 3.2.14tns: sendErrorReportMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| user
| Пользователь (организация), представляющий запрашивающую сторону
| +
| tns:user
|
| 3
| taskId
| Уникальный идентификатор задачи
| +
| xs:string
|
| 4
| errorReport
| Сообщение об ошибке
| +
| xs:string
|
| 3.2.15tns: sendErrorReportResponseMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| errorCode
| Числовой код ответа
| +
| xs:int
|
| 3
| errorDescription
| Текстовый комментарий к ответу
| -
| xs:string
|
| 4
| errorReportId
| Уникальный идентификатор сообщения об ошибке
| +
| xs:string
|
| 3.2.16tns:taskResult №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| taskId
| Уникальный идентификатор задачи
| +
| xs:string
|
| 2
| state
| Текущее состояние запроса
| +
| tns:taskState
|
| 3
| parameters
| Результат выполнения запроса в виде набора параметров
| -
| tns:taskParameter
| В случае множества параметров – заполняется множество объектов этого типа (см. пример)
| 4
| attachments
| Приложение к результату
| -
| tns:attachment
| В случае множества параметров – заполняется множество объектов этого типа (см. пример)
| 3.2.17tns:bookRequestResponseMessageType №
| Код параметра
| Описание параметра
| Обяз.
| Способ заполнения/Тип
| Комментарий
| 1
| signature
| Подпись ЭП СП
| -
| ds:Signature
| Стандартный объект, соответствующий спецификации xmldsig
| 2
| errorCode
| Числовой код ответа
| +
| xs:int
|
| 3
| errorDescription
| Текстовый комментарий к ответу
| -
| xs:string
|
| 4
| taskId
| Уникальный идентификатор задачи
| -
| xs:string
|
| |