В случае ошибки, электронный сервис вернет код ошибки с описанием причины её возникновения.


Схема взаимодействия

В рамках взаимодействия информационная система потребителя направляет в адрес электронного сервиса один из двух вариантов сообщений (запрос):

учетные данные пользователя и регистрационный номер классификатора. учетные данные пользователя и полное наименование классификатора.

После получения и обработки запроса электронный сервис должен вернуть один из двух вариантов сообщений (ответ):

номер последней версии публикации классификатора и дату публикации в случае, если в запросе содержаться корректные данные. код и описание ошибки в случае, если в запросе содержаться некорректные данные (например, неверное имя пользователя или пароль).

Схема взаимодействия представлена на рисунке 1.

Рисунок 1 «Схема взаимодействия»

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

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


Руководство пользователя Операция «Версия последней публикации классификатора по его регистрационному номеру» Общие сведения

Код операции:

getLastVersionByClassifierNumber

Наименование операции:

Версия последней публикации классификатора по его регистрационному номеру

Назначение операции:

Получение номера последней опубликованной в системе классификаторов ИОГВ г. Санкт-Петербурга  версии классификатора и дату публикации по указанному регистрационному номеру классификатора
Описание входных параметров

Входные данные: getLastVersionByClassifierNumber

НЕ нашли? Не то? Что вы ищете?

№

Код параметра

Описание параметра

Обязательность

Способ заполнения/Тип

Комментарий

1

login

Имя пользователя

+

xs:string

2

pass

Пароль пользователя

+

xs:string

MD5 хэш пароля

3

RegNumber

Регистрационный номер классификатора

+

xs:int
Описание выходных параметров

Выходные данные: getLastVersionByClassifierNumberResponse

№

Код параметра

Описание параметра

Обязательность

Способ заполнения/Тип

Комментарий

1

RegNumber

Регистрационный номер классификатора

xs:int

2

Fullname

Полное наименование классификатора

Xs:string

3

CurrentVersionNumber

Номер последней опубликованной версии классификатора

Xs:int

4

CurDate

Дата публикации

Xs:datetime

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

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

№

Код возврата

Описание кода возврата

Условия возникновения

Комментарий

1

0

Нет ошибок

Данный код возврата соответствует ситуации, когда электронный сервис отработал без ошибок и вернул не пустой список классификаторов.

2

-1

Ошибка аутентификации (неверный логин/пароль)

Данный код возврата соответствует ситуации, когда были введены неверные учетные данные пользователя.

3

-4

Неверный регистрационный номер классификатора

В системе отсутствуют опубликованные классификаторы с  указанным регистрационным номером

4

-8

Системная ошибка

Данный код возврата соответствует ситуации, когда во время работы электронного сервиса возникла ошибка, не связанная с действиями пользователя.

Ошибка возникает в случае отсутствия сети, недоступности базы данных и т. д.
Контрольные примеры

Запрос

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:clas="http://ws. iac. spb. ru/ClassifierLastVersion">

  <soapenv:Header/>

  <soapenv:Body>

  <clas:getLastVersionByClassifierNumber>

  <login>имя пользователя</login>

  <pass>пароль</pass>

  <RegNumber>20</RegNumber>

  </clas:getLastVersionByClassifierNumber>

  </soapenv:Body>

</soapenv:Envelope>

Ответ на запрос в случае успешного исполнения (код возврата 0)

<S:Envelope xmlns:S="http://schemas. xmlsoap. org/soap/envelope/">

  <S:Body>

  <ns2:getLastVersionByClassifierNumberResponse xmlns:ns2="http://ws. iac. spb. ru/ClassifierLastVersion">

  <return>

  <MessageInfo>

  <FaultCode>0</FaultCode>

  <FaultMessage>Операция успешно завершена</FaultMessage>

  <ItemsInMessage>1</ItemsInMessage>

  <ItemsInResponse>1</ItemsInResponse>

  <ItemStructure>RegNumber, FullName, VersionNumber, CurDate</ItemStructure>

  </MessageInfo>

  <Item>

  <RegNumber>20</RegNumber>

  <Fullname>Классификатор состояния в браке (на основе ОКИН)</Fullname>

  <CurrentVersionNumber>0</CurrentVersionNumber>

  <CurDate>2010-09-20T00:00:00+04:00</CurDate>

  </Item>

  </return>

  </ns2:getLastVersionByClassifierNumberResponse>

  </S:Body>

</S:Envelope>

Запрос на получение ответа с кодом возврата -1

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:clas="http://ws. iac. spb. ru/ClassifierLastVersion">

  <soapenv:Header/>

  <soapenv:Body>

  <clas:getLastVersionByClassifierNumber>

  <login>имя пользователя</login>

  <pass>пароль</pass>

  <RegNumber>20</RegNumber>

  </clas:getLastVersionByClassifierNumber>

  </soapenv:Body>

</soapenv:Envelope>

Ответ на запрос с кодом возврата -1

<S:Envelope xmlns:S="http://schemas. xmlsoap. org/soap/envelope/">

  <S:Body>

  <ns2:getLastVersionByClassifierNumberResponse xmlns:ns2="http://ws. iac. spb. ru/ClassifierLastVersion">

  <return>

  <MessageInfo>

  <FaultCode>-1</FaultCode>

  <FaultMessage>Ошибка аутентификации</FaultMessage>

  </MessageInfo>

  </return>

  </ns2:getLastVersionByClassifierNumberResponse>

  </S:Body>

</S:Envelope>

Запрос на получение ответа с кодом возврата -4

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:clas="http://ws. iac. spb. ru/ClassifierLastVersion">

  <soapenv:Header/>

  <soapenv:Body>

  <clas:getLastVersionByClassifierNumber>

  <login>имя пользователя</login>

  <pass>пароль</pass>

  <RegNumber>920</RegNumber>

  </clas:getLastVersionByClassifierNumber>

  </soapenv:Body>

</soapenv:Envelope>

Ответ на запрос с кодом возврата -4

<S:Envelope xmlns:S="http://schemas. xmlsoap. org/soap/envelope/">

  <S:Body>

  <ns2:getLastVersionByClassifierNumberResponse xmlns:ns2="http://ws. iac. spb. ru/ClassifierLastVersion">

  <return>

  <MessageInfo>

  <FaultCode>-4</FaultCode>

  <FaultMessage>Неверный регистрационный номер классификатора</FaultMessage>

  </MessageInfo>

  </return>

  </ns2:getLastVersionByClassifierNumberResponse>

  </S:Body>

</S:Envelope>

Операция «Версия последней публикации классификатора по его наименованию» Общие сведения

Код операции:

getLastVersionByClassifierName

Наименование операции:

Версия последней публикации классификатора по его наименованию

Назначение операции:

Получение номера последней опубликованной в системе классификаторов ИОГВ г. Санкт-Петербурга  версии классификатора и дату публикации по указанному наименованию классификатора
Описание входных параметров

Входные данные: getLastVersionByClassifierName

Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4