ООО «ДИТ-М» (ДОКУМЕНТАЛЬНЫЕ ИНФОРМАЦИОННЫЕ ТЕХНОЛОГИИ) Генеральный директор

advertisement
ООО «ДИТ-М»
(ДОКУМЕНТАЛЬНЫЕ ИНФОРМАЦИОННЫЕ ТЕХНОЛОГИИ)
УТВЕРЖДАЮ
УТВЕРЖДАЮ
Генеральный директор
Генеральный директор
ЗАО «ЦентрТелекомСервис»
ООО «ДИТ-М»
______________В.А. Швечков
_____________И.Г. Климанова
«____»_____________2011 г.
«____»_______________2011 г.
РУКОВОДСТВО АДМИНИСТРАТОРА
ИНТЕГРАЦИОННОГО МОДУЛЯ
Дата: 2011-11-08
Версия:
Листов: 61
Руководство администратора интеграционного модуля АБИС
СОДЕРЖАНИЕ
ОБЩИЕ СВЕДЕНИЯ…..………………………………………………………………………….5
1.1 Руководящие документы .................................................................................................................. 5
1.2 Описание электронного сервиса ...................................................................................................... 5
1.3 Операции (методы) электронного сервиса ..................................................................................... 5
1.4 Сценарии использования .................................................................................................................. 7
1.5 Схема взаимодействия.................................................................................................................... 11
1.6 Связи с другими электронными сервисами .................................................................................. 12
2
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ……………………………………………………………...12
1
2.1 Операция «Поиск библиографических записей» ......................................................................... 12
2.1.1 Общие сведения ....................................................................................................................... 12
2.1.2 Описание входных параметров .............................................................................................. 13
2.1.3 Описание выходных параметров ............................................................................................ 13
2.1.4 Коды возвратов ........................................................................................................................ 13
2.1.5 Контрольные примеры ............................................................................................................ 13
2.2 Операция «Поиск электронных документов» .............................................................................. 19
2.2.1 Общие сведения ....................................................................................................................... 19
2.2.2 Описание входных параметров .............................................................................................. 20
2.2.3 Описание выходных параметров ............................................................................................ 20
2.2.4 Коды возвратов ........................................................................................................................ 20
2.2.5 Контрольные примеры ............................................................................................................ 21
2.3 Операция «Предоставление доступа к электронному документу» ............................................ 24
2.3.1 Общие сведения ....................................................................................................................... 24
2.3.2 Описание входных параметров .............................................................................................. 24
2.3.3 Описание выходных параметров ............................................................................................ 25
2.3.4 Коды возвратов ........................................................................................................................ 25
2.3.5 Контрольные примеры ............................................................................................................ 26
3
МЕТОДИКА ИСПЫТАНИЙ……………………………………………………………………...28
3.1 Общие условия ................................................................................................................................ 28
3.2 Параметры испытаний на тестовой среде .................................................................................... 28
3.3 Параметры испытаний на продуктивной среде ........................................................................... 28
4
ПРИЛОЖЕНИЯ……………………………………………………………………………………29
4.1 Описание сервиса (WSDL) ............................................................................................................. 29
4.2 Описание общих структур данных................................................................................................ 48
4.2.1 tns:EServiceHeader (Специализированный заголовок запроса) ........................................... 50
4.2.2 tns:EServiceResultBase (Cпециализированный заголовок возврата результата/статуса) .. 51
4.2.3 tns:EServiceResult (Cпециализированный заголовок возврата результата/статуса)
2
Руководство администратора интеграционного модуля АБИС
наследует tns:EServiceResultBase и также включает в себя: ......................................................... 52
4.2.4 tns:EServiceResultContent (Cпециализированный заголовок возврата результата/статуса)
наследует tns:EServiceResultBase и также включает в себя: ......................................................... 52
4.2.5 Параметр комплексного типа: tns:Find (Входные данные метода Find) ............................ 52
4.2.6 Параметр комплексного типа: tns:FindContent (Входные данные метода Find) ................ 53
4.2.7 tns:SearchData (Условия поиска)............................................................................................. 55
4.2.8 tns:SearchOperator (Содержимое логического оператора or или and) ................................. 55
4.2.9 tns:SearchElement (Условие поиска) ....................................................................................... 55
4.2.10 Параметр комплексного типа: tns:FindResponse (Выходные данные метода Find) ........ 55
4.2.11 Параметр комплексного типа: tns:FindContentResponse (Выходные данные метода
FindContent) ....................................................................................................................................... 56
4.2.12 Параметр комплексного типа: tns:GetFileResponse (Выходные данные метода GetFile) 56
4.2.13 tns:ResultLibrary (Список всех библиотек с результатами поиска, только те, где есть
хотя бы один результат поиска) ...................................................................................................... 57
4.2.14 tns:ResultLibraryContent (Список всех библиотек с результатами поиска, только те, где
есть хотя бы один результат поиска) .............................................................................................. 58
4.2.15 tns:LibraryBase (Список записей и атрибуты библиотеки) ................................................ 58
4.2.16 tns:Library (Список записей и атрибуты библиотеки). ....................................................... 58
4.2.17 tns:LibraryContent (Список записей, имеющих электронные документы и атрибуты
библиотеки). ...................................................................................................................................... 59
4.2.18 tns:RecordList (Список всех записей, найденных в этой библиотеке) .............................. 59
4.2.19 tns:RecordContentList (Список всех записей, имеющих электронные документы) ......... 59
4.2.20 tns:Record (Атрибуты записи) ............................................................................................... 59
4.2.21 Наследует tns:Record.............................................................................................................. 60
4.2.22 tns:File (Файл с информационным материалом). ................................................................ 60
4.3 Описания справочников ................................................................................................................. 60
4.4 Иные приложения ........................................................................................................................... 61
3
Руководство администратора интеграционного модуля АБИС
ТЕРМИНЫ/СОКРАЩЕНИЯ
Термин/сокращение
СМЭВ
Поставщик
WSDL
XSD
SOAP
XML
АБИС
ЕПГУ
Описание
Система межведомственного электронного взаимодействия
Организация-владелец электронного сервиса
Web Services Description Language — язык описания веб-сервисов.
XML Schema definition - язык описания структуры XML
документа.
Simple
Object
Access
Protocol
протокол
обмена
структурированными
сообщениями
в
распределённой
вычислительной среде.
eXtensible Markup Language — расширяемый язык разметки.
Автоматизированная библиотечно-информационная система
Единый портал государственных и муниципальных услуг
4
Руководство администратора интеграционного модуля АБИС
1 ОБЩИЕ СВЕДЕНИЯ
1.1 Руководящие документы
Основанием для разработки данного документа является требование п. 48 Приказа
Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. №
190 «Об утверждении технических требований к взаимодействию информационных систем в
единой системе межведомственного электронного взаимодействия» в соответствии с которым, для
подключения информационной системы к системе межведомственного электронного
взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы:

паспорт электронного сервиса, регистрируемого в системе взаимодействия;

методику испытаний электронного сервиса, регистрируемого в системе
взаимодействия, включая контрольный пример обращения к электронному сервису;

руководство пользователя
взаимодействия.
электронного
сервиса,
регистрируемого
в
системе
Основанием для создания и использования электронного сервиса являются перечисленные
ниже документы.
Нормативно-правовые документы:

Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 697 «О
единой системе межведомственного электронного взаимодействия»;

Приказ Министерства связи и массовых коммуникаций Российской Федерации от 27
декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию
информационных систем в единой системе межведомственного электронного
взаимодействия».
1.2 Описание электронного сервиса
Наименование:
Веб-сервис предоставления доступа к справочно-поисковому
библиотек и оцифрованным изданиям, хранящимся в библиотеках
Назначение:
Предоставление доступа к справочно-поисковому аппарату библиотек и
оцифрованным изданиям, хранящимся в библиотеках, в том числе к фонду
Поставщик:
Область
применения:
аппарату
редких книг, с учетом соблюдения требований законодательства Российской
Федерации об авторских и смежных правах
ООО «ДИТ-М» (Документальные информационные технологии)
Предоставление населению доступа к библиотечной информации
1.3 Операции (методы) электронного сервиса
Электронный сервис предоставления доступа к справочно-поисковому аппарату библиотек
и оцифрованным изданиям, хранящимся в библиотеках, обеспечивает обмен данными.
5
Руководство администратора интеграционного модуля АБИС
Электронный сервис включает методы, обеспечивающие:

предоставление доступа к справочно-поисковому аппарату библиотек, базам данных;

предоставление доступа к оцифрованным изданиям, хранящимся в библиотеках, в том
числе к фонду редких книг, с учетом соблюдения требований законодательства
Российской Федерации об авторских и смежных правах.
Метод
Назначение
Предоставление
доступа
к
справочно- 1) прием запроса на поиск от ЕПГУ в
поисковому аппарату библиотек, базам данных соответствии с требованиями к сервису Find
(см. «Требование к Веб-сервису»)
2) отправляет запрос на поиск в АБИС «OPACКод: Find
Global» и принимает от АБИС «OPAC-Global»
ответ - список найденных библиографических
записей со следующими атрибутами: Автор,
Заглавие, ISBN, Место издания, Год издания,
Издательство, Объем документа (в страницах
или байтах), Местонахождение документа
(наименование библиотеки-держателя)
3) возвращает список библиографических
записей соответствующих условию в ЕПГУ в
соответствии с требованиями к сервису Find
(см. «Требование к Веб-сервису»)
6
Руководство администратора интеграционного модуля АБИС
Предоставление доступа к оцифрованным
изданиям, хранящимся в библиотеках, в том
числе к фонду редких книг, с учетом
соблюдения требований
законодательства
Российской Федерации об авторских и смежных
правах
Код: FindContent
Код: GetFile
1) Прием запроса на поиск электронных
документов в соответствии с требованиями к
сервису FindContent
2) Отправка запроса на поиск электронных
документов в АБИС «OPAC-Global» и прием от
АБИС «OPAC-Global» ответа - списка
найденных библиографических записей со
следующими атрибутами: Автор, Заглавие,
ISBN,
Место
издания,
Год
издания,
Издательство, Объем документа (в страницах
или байтах), Местонахождение документа
(наименование
библиотеки-держателя),
идентификатор электронного докумета
3) Возврат списка библиографических записей
соответствующих условию в соответствии с
требованиями к сервису FindСontent
1)
Прием
запроса
на
предоставление
электронного документа по идентификатору,
полученному
в
методе
FindContent
в
соответствии с требованиями к сервису GetFile
2) Отправка запроса на предоставление
электронного документа в АБИС «OPACGlobal» и прием от АБИС «OPAC-Global»
ответа
3) Возврат электронного документа в
соответствии с требованиями к сервису GetFile
1.4 Сценарии использования
Все методы АБИС по предоставлению доступа к справочному аппарату библиотек, базам
данных и оцифрованным изданиям, хранящимся в библиотеках, в том числе к фонду редких книг,
с учетом соблюдения требований законодательства РФ об авторских и смежных правах работают в
синхронном режиме и включают в себя услуги: предоставление доступа к справочно-поисковому
аппарату библиотек, базам данных и предоставление доступа к оцифрованным изданиям,
хранящимся в библиотеках, в том числе к фонду редких книг, с учетом соблюдения требований
законодательства РФ об авторских и смежных правах.
Предоставление услуг выполняется по следующим сценариям:
7
Руководство администратора интеграционного модуля АБИС

Сценарий 1. Предоставление доступа к справочно-поисковому аппарату библиотек, базам
данных (Блок-схема на рисунке 1) включает в себя:
o
Обработка запроса от ЕПГУ
o
Транслирование запроса ЕПГУ во внутренний запрос АБИС
o
Получение записей, соответствующих данному поисковому запросу
o
Реструктуризация запроса в соответствии с требованиями ЕПГУ
o
Отправка ответа ЕПГУ
Рисунок 1.
8
Руководство администратора интеграционного модуля АБИС

Сценарий 2. Предоставление доступа к оцифрованным изданиям, хранящимся в
библиотеках, в том числе к фонду редких книг, с учетом соблюдения требований
законодательства РФ об авторских и смежных правах реализуется в 2 этапа:
o
Генерация списка записей, соответствующих поисковому запросу, для которых
доступен полнотекстовый просмотр (см. выше блок-схему на рисунке 1).

Обработка запроса от ЕПГУ

Транслирование запроса ЕПГУ во внутренний запрос АБИС, добавление
опции, отсекающей записи, для которых полнотекстовый просмотр
недоступен

Получение записей, соответствующих данному поисковому запросу

Реструктуризация запроса в соответствии с требованиями ЕПГУ (в том числе
добавление информации необходимой для получения полнотекстового
просмотра)

o
Отправка ответа ЕПГУ
Предоставление полнотекстовой информации для конкретной записи (Блок-схема на
рисунке 2).

Обработка запроса от ЕПГУ, в котором содержится идентификатор
требуемого файла

Поиск данного файла в АБИС

Определение типа содержимого файла

Приведение содержимого файла к base64-строке

Отправка ответа ЕПГУ
9
Руководство администратора интеграционного модуля АБИС

Рисунок 2.
10
Руководство администратора интеграционного модуля АБИС
1.5 Схема взаимодействия
В рамках взаимодействия возможно использование сервиса в двух видах услуг:
 предоставление доступа к справочно-поисковому аппарату библиотек, базам данных;
 предоставление доступа к оцифрованным изданиям, хранящимся в библиотеках, в том
числе к фонду редких книг, с учетом соблюдения требований законодательства Российской
Федерации об авторских и смежных правах.
При предоставлении доступа к справочно-поисковому аппарату библиотек, базам данных
выполняются следующие действия:
 Веб-сервис, используя метод Find, получает от информационной системы ЕПГУ
запрос на поиск;
 запрос на поиск отправляется в АБИС «OPAC-Global»;
 Веб-сервис получает от АБИС «OPAC-Global» ответ в форме списка найденных
библиографических записей;
 Веб-сервис осуществляет возврат списка библиографических записей в адрес
запрашивающей сведения ИС.
При предоставлении доступа к оцифрованным изданиям, хранящимся в библиотеках, в том
числе к фонду редких книг, с учетом соблюдения требований законодательства Российской
Федерации об авторских и смежных правах выполняются следующие действия: поиск записей,
содержащих электронные документы, и поиск электронных документов.
При поиске записей, содержащих электронные документы:
 Веб-сервис, используя метод FindContent, получает от информационной системы
ЕПГУ запрос на поиск записей с электронными документами;
 запрос на поиск записей с электронными документами отправляется в АБИС
«OPAC-Global»;
 Веб-сервис получает от АБИС «OPAC-Global» ответ в форме списка найденных
библиографических записей;
 Веб-сервис осуществляет возврат списка записей c id электронных документов в
адрес запрашивающей сведения ИС.
При поиске электронных документов:
11
Руководство администратора интеграционного модуля АБИС
 Веб-сервис, используя метод GetFile, получает от информационной системы ЕПГУ
запрос на поиск электронных документов;
 запрос на поиск электронных документов отправляется в АБИС «OPAC-Global»;
 Веб-сервис получает от АБИС «OPAC-Global» ответ в форме списка найденных
библиографических записей;
 Веб-сервис осуществляет возврат списка электронных документов в адрес
запрашивающей сведения ИС.
Схема взаимодействия представлена на рисунке 3.
Рисунок 3.
1.6 Связи с другими электронными сервисами
Данный сервис не имеет связей с другими сервисами.
2 РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
2.1 Операция «Поиск библиографических записей»
2.1.1 Общие сведения
Код операции:
Find
Наименование
операции:
Поиск библиографических записей
12
Руководство администратора интеграционного модуля АБИС
Предоставление
Назначение операции:
доступа
к
справочно-поисковому
аппарату
библиотек, базам данных
2.1.2 Описание входных параметров
Входные данные: Find
№
Описание
параметра
Код параметра
tns:RequestHeader
1
Способ
заполнения/
Обязательность
Комментарий
Тип
Унифицированный
tns:RequestHeader
заголовок запроса
tns:EServiceHeader
2
Специализированный
tns:EServiceHeader
заголовок запроса
tns:regData
Содержимое запроса
+
tns:regData
3
2.1.3 Описание выходных параметров
Выходные данные: FindResponse
№
1
Описание
параметра
Код параметра
tns:ResponseHeader
Способ
заполнения/
Обязательность
Комментарий
Тип
Унифицированный
tns:ResponseHeader
заголовок ответа
tns:EServiceResult
Cпециализированный
заголовок
2
tns:EServiceResult
возврата
результата
Параметры комплексного типа описаны в приложении «Описание общих структур данных».
2.1.4 Коды возвратов
№
Код возврата
Описание кода
возврата
Сервис
1
3
успешно
Работа
2
отработал
была
-1
сервиса
прекращена
из-за ошибки
Условия возникновения
Комментарий
Сервис отработал успешно.
Работа сервиса была прекращена
из-за ошибки.
Подробности
содержатся
ошибки
в
узле
RequestHeader.
2.1.5 Контрольные примеры
Запрос
13
Руководство администратора интеграционного модуля АБИС
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.gosuslugi.ru/informLibrary/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:Find>
<RequestHeader>
<authToken>libraryN</authToken>
<requestDate>2011-06-07T16:38:46+04:00</requestDate>
<requestId>12345</requestId>
<requestInitiatorCode>
<regionCode>77</regionCode>
</requestInitiatorCode>
</RequestHeader>
<EServiceHeader>
<userId>1234</userId>
<eServiceId>12345</eServiceId>
<stateOrgId>12345</stateOrgId>
<orderDate>2011-06-07T16:38:46+04:00</orderDate>
</EServiceHeader>
<regData>
<MaxResult>1000</MaxResult>
<ExtSearchData>
<Search>
<Comparer>Start</Comparer>
<Condition>Толстой</Condition>
<AttributeRecord>Автор</AttributeRecord>
</Search>
</ExtSearchData>
</regData>
</ns1:Find>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ на запрос в случае успешного исполнения
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
14
Руководство администратора интеграционного модуля АБИС
xmlns:ns1="http://www.gosuslugi.ru/informLibrary/">
<SOAP-ENV:Body>
<ns1:FindResponse>
<ResponseHeader>
<authToken>libraryN</authToken>
<responseDate>2012-01-27T13:40:49+03:00</responseDate>
<requestInitiatorCode>
<regionCode>77</regionCode>
</requestInitiatorCode>
</ResponseHeader>
<EServiceResult>
<orderStatusId>3</orderStatusId>
<XML>
<ResultLibrary>
<Library>
<LibraryName>Тульская ОУНБ</LibraryName>
<LibraryNote>Тульская областная научная библиотека</LibraryNote>
<RecordQuantityAll>27</RecordQuantityAll>
<RecordList>
<Record>
<ResultNumber>1</ResultNumber>
<Author>Рикот, Поль (1628-1700)</Author>
<Name>Монархия Турецкая</Name>
<Publisher>СПб.: [Тип. Акад. наук], 1741</Publisher>
</Record>
<Record>
<ResultNumber>2</ResultNumber>
<Author>Толстой, Лев Николаевич (1828-1910)</Author>
<Name>Анна Каренина : [Роман]</Name>
<ISBN>5-17-008319-X, 5-7390-0881-6</ISBN>
<Publisher>М.: АСТ: Олимп, 2002</Publisher>
</Record>
<Record>
<ResultNumber>3</ResultNumber>
<Author>Толстой, Лев Николаевич (1828-1910)</Author>
<Name>Повести и рассказы</Name>
<ISBN>5-7905-2056-1</ISBN>
<Publisher>М.: РИПОЛ КЛАССИК, 2003 (ГУП ИПК Ульян. Дом
печати)</Publisher>
</Record>
<Record>
<ResultNumber>4</ResultNumber>
<Author>Толстой, Иван Иванович</Author>
<Name>Мемуары графа И. И. Толстого</Name>
<ISBN>5-85759-198-8</ISBN>
<Publisher>М.: Индрик, 2002</Publisher>
</Record>
<Record>
<ResultNumber>5</ResultNumber>
<Name>Россия - Восток - Запад</Name>
<ISBN>5-201-13321-5</ISBN>
15
Руководство администратора интеграционного модуля АБИС
<Publisher>М.: Наследие, 1998</Publisher>
</Record>
<Record>
<ResultNumber>6</ResultNumber>
<Author>Зверев, Алексей Матвеевич (1939-2003)</Author>
<Name>Лев Толстой</Name>
<ISBN>978-5-235-03037-4</ISBN>
<Publisher>Москва: Молодая гвардия, 2007</Publisher>
</Record>
<Record>
<ResultNumber>7</ResultNumber>
<Author>Варламов, Алексей Николаевич</Author>
<Name>Алексей Толстой</Name>
<ISBN>978-5-235-03024-4</ISBN>
<Publisher>Москва: Молодая гвардия, 2008</Publisher>
</Record>
<Record>
<ResultNumber>8</ResultNumber>
<Author>Толстой, Лев Николаевич (1828-1910)</Author>
<Name>Анна Каренина : [Роман]</Name>
<ISBN>5-7905-2213-0</ISBN>
<Publisher>М.: РИПОЛ КЛАССИК, 2003</Publisher>
</Record>
<Record>
<ResultNumber>9</ResultNumber>
<Author>Комарова, Татьяна Васильевна</Author>
<Name>Одна из семисот Шамординских монахинь Мария Николаевна
Толстая [[Текст]]</Name>
<Publisher>Тула: Ясная Поляна, 2003</Publisher>
</Record>
<Record>
<ResultNumber>10</ResultNumber>
<Author>Толстой, Лев Николаевич (1828-1910)</Author>
<Name>Азбука Л. Н. Толстого : [пособие для обучения чтению</Name>
<ISBN>978-5-94298-017-7</ISBN>
<Publisher>Тула: Свамия, 2009</Publisher>
</Record>
<Record>
<ResultNumber>11</ResultNumber>
<Author>Толстой, Алексей Николаевич (1882-1945)</Author>
<Name>Петр Первый</Name>
<ISBN>5-17-015182-9, 5-8195-0856-4</ISBN>
<Publisher>М.: АСТ: Олимп, 2002</Publisher>
</Record>
<Record>
<ResultNumber>12</ResultNumber>
<Name>Провинция в контексте истории и литературы : материалы I
Крапивенской краеведческой конференции</Name>
<Publisher>Тула: Ясная поляна, 2005 (: Гриф и К)</Publisher>
</Record>
<Record>
16
Руководство администратора интеграционного модуля АБИС
<ResultNumber>13</ResultNumber>
<Author>Ким, Анатолий</Author>
<Name>Сбор грибов под музыку Баха : роман-мистерия</Name>
<ISBN>307730</ISBN>
<Publisher>Тула: Ясная Поляна, 2006</Publisher>
</Record>
<Record>
<ResultNumber>14</ResultNumber>
<Author>Яковлев, Александр</Author>
<Name>Жареные ананасы : рассказы</Name>
<ISBN>307729</ISBN>
<Publisher>Тула: Ясная Поляна, 2006</Publisher>
</Record>
<Record>
<ResultNumber>15</ResultNumber>
<Name>Русские мыслители о Льве Толстом : сб. статей</Name>
<ISBN>5-93322-012-4</ISBN>
<Publisher>Тула: Изд. дом "Ясная Поляна", 2002</Publisher>
</Record>
<Record>
<ResultNumber>16</ResultNumber>
<Author>Толстой, Лев Николаевич (1828-1910)</Author>
<Name>Анна Каренина : [Роман]</Name>
<ISBN>5-04-000055-3</ISBN>
<Publisher>М.: ЭКСМО-Пресс, 1997</Publisher>
</Record>
<Record>
<ResultNumber>17</ResultNumber>
<Name>Материалы I Международного семинара переводчиков
произведений Л. Н. Толстого</Name>
<ISBN>314614</ISBN>
<Publisher>Тула: Ясная Поляна, 2007</Publisher>
</Record>
<Record>
<ResultNumber>18</ResultNumber>
<Author>Малышев, Игорь</Author>
<Name>Дом</Name>
<ISBN>316162</ISBN>
<Publisher>Тула: Ясная Поляна, 2007</Publisher>
</Record>
<Record>
<ResultNumber>19</ResultNumber>
<Name>Провинция в контексте истории и литературы : материалы III
Крапив. конф.</Name>
<ISBN>316239</ISBN>
<Publisher>Тула: Ясная Поляна, 2007</Publisher>
</Record>
<Record>
<ResultNumber>20</ResultNumber>
<Author>Толстой, Лев Николаевич (1828-1910)</Author>
<Name>Мысли на каждый день : [избранные, собранные и
17
Руководство администратора интеграционного модуля АБИС
расположенные на каждый день Львом Толстым мысли многих писателей об истине,
жизни и поведении]</Name>
<ISBN>978-5-7905-4149-0</ISBN>
<Publisher>Москва: РИПОЛ классик, 2008</Publisher>
</Record>
<Record>
<ResultNumber>21</ResultNumber>
<Author>Бородин, Леонид Иванович</Author>
<Name>Год чуда и печали : повесть</Name>
<ISBN>978-5-93322-025-1</ISBN>
<Publisher>Тула: Ясная Поляна, 2008</Publisher>
</Record>
<Record>
<ResultNumber>22</ResultNumber>
<Name>Л.Н. Толстой : энциклопедия</Name>
<ISBN>978-5-09-017163-2</ISBN>
<Publisher>Москва: Просвещение, 2009</Publisher>
</Record>
<Record>
<ResultNumber>23</ResultNumber>
<Author>Никитина, Нина</Author>
<Name>Путешествие в компании с Гением : путеводитель</Name>
<ISBN>307938</ISBN>
<Publisher>Тула: Ясная Поляна, 2006</Publisher>
</Record>
<Record>
<ResultNumber>24</ResultNumber>
<Name>Художественная жизнь Советской России. 1917-1932 : события,
факты, комментарии : сборник материалов и документов</Name>
<ISBN>978-5-269-01101-1</ISBN>
<Publisher>Москва: ГАЛАРТ, 2010</Publisher>
</Record>
<Record>
<ResultNumber>25</ResultNumber>
<Author>Ореханов, Георгий (1962-), Ореханов, Георгий
Леонидович</Author>
<Name>Русская Православная Церковь и Л.Н. Толстой: конфликт глазами
современников : монография</Name>
<ISBN>978-5-7429-0597-4</ISBN>
<Publisher>Москва: Изд-во ПСТГУ, 2010</Publisher>
</Record>
<Record>
<ResultNumber>26</ResultNumber>
<Author>Жданов, Владимир Александрович (1898-1971)</Author>
<Name>Неизвестный Толстой : тайная жизнь гения</Name>
<ISBN>978-5-699-46072-4</ISBN>
<Publisher>Москва: Эксмо: Алгоритм, 2010</Publisher>
</Record>
<Record>
<ResultNumber>27</ResultNumber>
<Author>Левенфельд, Рафаэль (1854-1910)</Author>
18
Руководство администратора интеграционного модуля АБИС
<Name>Первая биография Льва Толстого</Name>
<ISBN>978-5-222-17712-9</ISBN>
<Publisher>Ростов-на-Дону: Феникс, 2011</Publisher>
</Record>
</RecordList>
</Library>
</ResultLibrary>
</XML>
</EServiceResult>
</ns1:FindResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ на запрос с кодом возврата -1
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.gosuslugi.ru/informLibrary/">
<SOAP-ENV:Body>
<ns1:FindResponse>
<ResponseHeader>
<authToken>libraryN</authToken>
<responseDate>2011-11-09T16:01:06+03:00</responseDate>
<error>
<errorCode>2</errorCode>
<errorMessage>Database pipe has triggered error. But error's format is illegal and can't be
parsed.</errorMessage>
</error>
</ResponseHeader>
<EServiceResult>
<orderStatusId>-1</orderStatusId>
</EServiceResult>
</ns1:FindResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
2.2 Операция «Поиск электронных документов»
2.2.1 Общие сведения
Код операции:
FindContent
Наименование
операции:
Назначение операции:
Поиск электронных документов
Предоставление доступа к оцифрованным изданиям, хранящимся в
19
Руководство администратора интеграционного модуля АБИС
библиотеках, в том числе к фонду редких книг, с учетом соблюдения
требований законодательства Российской Федерации об авторских и
смежных правах
2.2.2 Описание входных параметров
Входные данные: FindContent
№
1
Описание
параметра
Код параметра
tns:RequestHeader
Обязательность
Унифицированный
Способ
заполнения/Тип
Комментарий
tns:RequestHeader
заголовок запроса
tns:EServiceHeader
Специализированн
ый
2
tns:EServiceHeader
заголовок
запроса
tns:regData
Содержимое
+
tns:regData
запроса
3
2.2.3 Описание выходных параметров
Выходные данные: FindContentResponse
№
1
Описание
параметра
Код параметра
tns:ResponseHeader
Способ
заполнения/
Обязательность
Комментарий
Тип
Унифицированный
tns:ResponseHeader
заголовок ответа
tns:EServiceResult
Cпециализированный
заголовок
2
tns:EServiceResult
возврата
результата
Параметры комплексного типа описаны в приложении «Описание общих структур данных».
2.2.4 Коды возвратов
№
Код возврата
Описание кода
возврата
Сервис
1
3
успешно
Работа
2
-1
отработал
была
сервиса
прекращена
из-за ошибки
Условия возникновения
Комментарий
Сервис отработал успешно.
Работа сервиса была прекращена
из-за ошибки.
Подробности
содержатся
ошибки
в
узле
RequestHeader.
20
Руководство администратора интеграционного модуля АБИС
2.2.5 Контрольные примеры
Запрос
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.gosuslugi.ru/informLibrary/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:FindContent>
<RequestHeader>
<authToken>libraryN</authToken>
<requestDate>2011-06-07T16:38:46+04:00</requestDate>
<requestId>12345</requestId>
<requestInitiatorCode>
<regionCode>77</regionCode>
</requestInitiatorCode>
</RequestHeader>
<EServiceHeader>
<userId>1234</userId>
<eServiceId>12345</eServiceId>
<stateOrgId>12345</stateOrgId>
<orderDate>2011-06-07T16:38:46+04:00</orderDate>
</EServiceHeader>
<regData>
<MaxResult>1000</MaxResult>
<ExtSearchData>
<Search>
<Comparer>Start</Comparer>
<Condition>Рикот</Condition>
<AttributeRecord>Автор</AttributeRecord>
</Search>
</ExtSearchData>
</regData>
</ns1:FindContent>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ на запрос в случае успешного исполнения
21
Руководство администратора интеграционного модуля АБИС
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.gosuslugi.ru/informLibrary/">
<SOAP-ENV:Body>
<ns1:FindContentResponse>
<ResponseHeader>
<authToken>libraryN</authToken>
<responseDate>2012-01-27T13:41:23+03:00</responseDate>
<requestInitiatorCode>
<regionCode>77</regionCode>
</requestInitiatorCode>
</ResponseHeader>
<EServiceResult>
<orderStatusId>3</orderStatusId>
<XML>
<ResultLibrary>
<Library>
<LibraryName>Тульская ОУНБ</LibraryName>
<LibraryNote>Тульская областная научная библиотека</LibraryNote>
<RecordQuantityAll>1</RecordQuantityAll>
<RecordList>
<Record>
<ResultNumber>1</ResultNumber>
<Author>Рикот, Поль (1628-1700)</Author>
<Name>Монархия Турецкая</Name>
<Publisher>СПб.: [Тип. Акад. наук], 1741</Publisher>
<RecordID>RU\NLR\A1\22700</RecordID>
<FileList>
<File>
<FileID>RU%5CNLR%5CA1%5C22700</FileID>
<FileName>Ссылка</FileName>
</File>
</FileList>
</Record>
</RecordList>
</Library>
</ResultLibrary>
</XML>
</EServiceResult>
22
Руководство администратора интеграционного модуля АБИС
</ns1:FindContentResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
23
Руководство администратора интеграционного модуля АБИС
Ответ на запрос с кодом возврата -1
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.gosuslugi.ru/informLibrary/">
<SOAP-ENV:Body>
<ns1:FindResponse>
<ResponseHeader>
<authToken>libraryN</authToken>
<responseDate>2011-11-09T16:01:06+03:00</responseDate>
<error>
<errorCode>2</errorCode>
<errorMessage>Database pipe has triggered error. But error's format is illegal and can't be
parsed.</errorMessage>
</error>
</ResponseHeader>
<EServiceResult>
<orderStatusId>-1</orderStatusId>
</EServiceResult>
</ns1:FindResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
2.3 Операция «Предоставление доступа к электронному документу»
2.3.1 Общие сведения
Код операции:
GetFile
Наименование
операции:
Предоставления доступа к электронным документам
Назначение операции:
Предоставление доступа к оцифрованным изданиям, хранящимся в
библиотеках, в том числе к фонду редких книг, с учетом соблюдения
требований законодательства Российской Федерации об авторских и
смежных правах
2.3.2 Описание входных параметров
Входные данные: GetFile
№
1
Код параметра
tns:FileID
Описание
параметра
Идентификатор
Обязательность
Способ
заполнения/Тип
+
s:string
Комментарий
файла
24
Руководство администратора интеграционного модуля АБИС
2.3.3 Описание выходных параметров
Выходные данные: GetFileResponse
№
Описание
параметра
Код параметра
tns:Content
Содержимое файла
в
1
виде
Обязательность
Способ
заполнения/Тип
+
s:base64Binary
Комментарий
base64-
строки
tns:ContentType
Тип возвращаемого
s:string
файла.
2
tns:FileName
Название
s:string
возвращаемого
файла.
3
Тип возвращаемого
файла. Если данный
тег отсутствует, то
тип файла
определяется
расширением файла,
указанным в теге
FileName данного
метода.
Если отстутствует,
то название
определяется тегом
FileName из
результата метода
FindContent. Если
тип файла не
определен, и
отсутствует
расширение в
данном теге, то
определять тип
файла по
расширению из
имени файла,
возвращенного в
теге FileName в
результате метода
FindContent. В
случае, если и по
результатам метода
FindContent
невозможно
определить тип
файла, то он
принимается
равным
application/octetstream.
Параметры комплексного типа описаны в приложении «Описание общих структур данных».
2.3.4 Коды возвратов
25
Руководство администратора интеграционного модуля АБИС
№
Описание кода
возврата
Код возврата
Сервис
1
3
успешно
Работа
2
отработал
была
-1
сервиса
прекращена
из-за ошибки
Условия возникновения
Комментарий
Сервис отработал успешно.
Работа сервиса была прекращена
из-за ошибки.
Подробности
содержатся
ошибки
в
узле
RequestHeader.
2.3.5 Контрольные примеры
Запрос
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:inf="http://www.gosuslugi.ru/informLibrary/">
<soapenv:Header/>
<soapenv:Body>
<inf:GetFile>
<FileID>RU%5CNLR%5CA1%5C22700</FileID>
</inf:GetFile>
</soapenv:Body>
</soapenv:Envelope>
Ответ на запрос в случае успешного исполнения
Содержимое файла сокращено из-за того, что строка, представляющая файл размером 7Мб
займет более 50 страниц этого документа.
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.gosuslugi.ru/informLibrary/">
<SOAP-ENV:Body>
<ns1:GetFileResponse>
<Content>JVBERi0xLj...</Content>
<ContentType>application/pdf</ContentType>
</ns1:GetFileResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
26
Руководство администратора интеграционного модуля АБИС
Ответ на запрос с кодом возврата -1
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.gosuslugi.ru/informLibrary/">
<SOAP-ENV:Body>
<ns1:FindResponse>
<ResponseHeader>
<responseDate>2011-11-09T14:16:23+00:00</responseDate>
<error>
<errorCode>5</errorCode>
<errorMessage>Unable to find a file.</errorMessage>
</error>
</ResponseHeader>
<EServiceResult>
<orderStatusId>-1</orderStatusId>
</EServiceResult>
</ns1:FindResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
27
Руководство администратора интеграционного модуля АБИС
3 МЕТОДИКА ИСПЫТАНИЙ
3.1 Общие условия
Проведение контрольных испытаний при регистрации электронного сервиса
регламентировано Приказом Министерства связи и массовых коммуникаций Российской
Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к
взаимодействию информационных систем в единой системе межведомственного электронного
взаимодействия».
Порядок проведения типовых испытаний предполагает следующие этапы:

Проверка комплектности предоставленной документации;

Проверка сетевой связности между узлом СМЭВ и точкой размещения электронного
сервиса;

Регистрация сервиса и тестирование сервиса на контрольном примере.
3.2 Параметры испытаний на тестовой среде
Проведение испытаний на тестовой среде перед регистрацией электронного сервиса в
продуктивной среде СМЭВ является необходимым действием, обеспечивающим повышение
качества и эффективности процесса и позволяющим выявлять ошибки и несоответствия
разработанного сервиса заранее, а не в продуктивном контуре.

Контактное лицо: Лысенко Андрей Владимирович, e-mail:andrey@ditm.ru, тел: (499)
128-05-620

Адрес тестового экземпляра: http://194.226.24.32/opacg.soap/?gosuslugi:wsdl

Режим функционирования тестовой среды: 24/5 (круглосуточно по будням). Особых
условий доступности не определено.

Для того чтоб протестировать сервис, необходимо:


зарегистрировать сервис на тестовой среде во время ее доступности
согласно режиму функционирования,
протестировать все операции на основании контрольных примеров.
3.3 Параметры испытаний на продуктивной среде

Контактное лицо: Лысенко Андрей Владимирович, e-mail:andrey@ditm.ru, тел: (499)
128-05-620

Адрес тестового экземпляра: http://195.34.235.134:8080/opacg.soap/?wsdl

Для того чтоб протестировать сервис, необходимо:


зарегистрировать сервис на тестовой среде во время ее доступности
согласно режиму функционирования,
протестировать все операции на основании контрольных примеров.
28
Руководство администратора интеграционного модуля АБИС
4 ПРИЛОЖЕНИЯ
4.1 Описание сервиса (WSDL)
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://www.gosuslugi.ru/informLibrary/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:s="http://www.w3.org/2001/XMLSchema"
name="LibrarySOAP"
targetNamespace="http://www.gosuslugi.ru/informLibrary/">
<wsdl:types>
<s:schema targetNamespace="http://www.gosuslugi.ru/informLibrary/">
<s:complexType name="RequestHeader">
<s:annotation>
<s:documentation>Унифицированный заголовок запроса</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="authToken" type="s:string" >
<s:annotation>
<s:documentation>Ведомственная ИС должна получить токен безопасности в
СИА, чтобы можно было вернуть ответ, который будет обработан
(на текущий момент каждой ведомственной ИС будет выдан постоянный
код токен, который будет необходимо проставлять в теге)</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="requestId" type="s:string" >
<s:annotation>
<s:documentation>Код заявки в ЕЛК</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="requestInitiatorCode" type="tns:OrgExternal" >
<s:annotation>
<s:documentation>Данные
о
системе-инициаторе
взаимодействия</s:documentation>
</s:annotation>
29
Руководство администратора интеграционного модуля АБИС
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="orgRegistrator" type="tns:OrgExternal" >
<s:annotation>
<s:documentation>Данные
о
системе,
зарегистрировавшей
обращение</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="requestDate" type="s:dateTime" >
<s:annotation>
<s:documentation>Дата регистрации запроса</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="requestTypeCode" type="s:string" >
</s:element>
</s:sequence>
</s:complexType>
<s:complexType name="OrgExternal">
<s:annotation>
<s:documentation>Информация о системе инициаторе/получателе</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="regionCode" type="s:string" >
<s:annotation>
<s:documentation>Код региона</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="serviceOrgCode" type="s:string" >
<s:annotation>
<s:documentation>Код организации</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="employee" type="tns:Employee" >
<s:annotation>
<s:documentation>Информация о сотруднике</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
30
Руководство администратора интеграционного модуля АБИС
<s:complexType name="Employee">
<s:annotation>
<s:documentation>Информация о сотруднике</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="sname" type="s:string" >
<s:annotation>
<s:documentation>Фамилия</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="fname" type="s:string" >
<s:annotation>
<s:documentation>Имя</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="mname" type="s:string" >
<s:annotation>
<s:documentation>Отчество</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="position" type="s:string" >
<s:annotation>
<s:documentation>Должность</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
<s:complexType name="EServiceHeader">
<s:annotation>
<s:documentation>Специализированный заголовок запроса</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="userId" type="s:long" >
<s:annotation>
<s:documentation>Идентификатор пользователя портала</s:documentation>
</s:annotation>
</s:element>
31
Руководство администратора интеграционного модуля АБИС
<s:element minOccurs="1" maxOccurs="1" name="eserviceId" type="s:long" >
<s:annotation>
<s:documentation>Идентификатор услуги</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="reestrId" type="s:string" >
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="sirRequestId" type="s:string" >
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="stateOrgId" type="s:long" >
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="orderDate" type="s:dateTime" >
</s:element>
</s:sequence>
</s:complexType>
<s:complexType name="ResponseHeader">
<s:annotation>
<s:documentation>Унифицированный заголовок ответа</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="authToken" type="s:string" >
<s:annotation>
<s:documentation>Ведомственная ИС должна получить токен безопасности в
СИА, чтобы можно было вернуть ответ, который будет обработан
(на текущий момент каждой ведомственной ИС будет выдан постоянный код
токен, который будет необходимо проставлять в теге)</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="responseDate" type="s:dateTime" >
<s:annotation>
<s:documentation>Дата ответа со стороны ведомственной ИС</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="requestInitiatorCode" type="tns:OrgExternal" >
<s:annotation>
<s:documentation>Данные
о
системе-инициаторе
взаимодействия</s:documentation>
</s:annotation>
32
Руководство администратора интеграционного модуля АБИС
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="requestIDRef" type="s:string" >
<s:annotation>
<s:documentation>Указывается код исходного запроса, пришедший в запросе в теге
RequestHeader.requestId</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="error" type="tns:Error" >
<s:annotation>
<s:documentation>Контейнер сообщения об ошибке</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
<s:complexType name="Error">
<s:annotation>
<s:documentation>Контейнер сообщения об ошибке</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="errorCode" type="s:long" >
<s:annotation>
<s:documentation>Указывается
код
в
случае
возникновения
ошибки</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="errorMessage" type="s:string" >
<s:annotation>
<s:documentation>Указывается описание ошибки</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
<s:complexType name="EServiceResultBase">
<s:annotation>
<s:documentation>Cпециализированный
заголовок
возврата
результата/статуса</s:documentation>
</s:annotation>
33
Руководство администратора интеграционного модуля АБИС
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="orderStatusId" type="s:long" >
<s:annotation>
<s:documentation>Код статуса исполнения услуги</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="comment" type="s:string" >
<s:annotation>
<s:documentation>Произвольный комментарий к статусу исполнения услуги,
который будет выводиться в Личном кабинете пользователя (например, статус – «Отправлено
ведомству», комментарий – «Идет согласование в Министерстве …»)</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="extOrderNumber" type="s:long" >
<s:annotation>
<s:documentation>Уникальный
идентификатор
принятого
заявления
в
ведомственной ИС</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
<s:complexType name="EServiceResult">
<s:annotation>
<s:documentation>Cпециализированный
заголовок
возврата
результата/статуса</s:documentation>
</s:annotation>
<s:complexContent>
<s:extension base="tns:EServiceResultBase">
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="XML">
<s:annotation>
<s:documentation>Структурированное
описание
специфических
результатов ведомственных ИС по услуге</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element
minOccurs="1"
maxOccurs="1"
name="ResultLibrary" type="tns:ResultLibrary" />
34
Руководство администратора интеграционного модуля АБИС
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:extension>
</s:complexContent>
</s:complexType>
<s:complexType name="EServiceResultContent">
<s:annotation>
<s:documentation>Cпециализированный
заголовок
возврата
результата/статуса</s:documentation>
</s:annotation>
<s:complexContent>
<s:extension base="tns:EServiceResultBase">
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="XML">
<s:annotation>
<s:documentation>Структурированное
описание
специфических
результатов ведомственных ИС по услуге</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element
minOccurs="1"
maxOccurs="1"
name="ResultLibrary" type="tns:ResultLibraryContent" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:extension>
</s:complexContent>
</s:complexType>
<s:complexType name="Any">
<s:annotation>
<s:documentation>Любое содержимое</s:documentation>
</s:annotation>
<s:sequence>
35
Руководство администратора интеграционного модуля АБИС
<s:any minOccurs="0" maxOccurs="unbounded" />
</s:sequence>
</s:complexType>
<s:element name="Find">
<s:annotation>
<s:documentation>Входные данные метода Find</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="RequestHeader" type="tns:RequestHeader" />
<s:element minOccurs="0" maxOccurs="1" name="EServiceHeader" type="tns:EServiceHeader" />
<s:element minOccurs="1" maxOccurs="1" name="regData">
<s:complexType>
<s:sequence>
<s:element
minOccurs="1"
maxOccurs="1"
name="MaxResult"
type="s:long"
default="1000">
<s:annotation>
<s:documentation>Максимальное ограничение на
количество получаемых записей в результате поиска для этого веб-сервиса</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="ExtSearchData" type="tns:SearchData" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>
<s:element name="FindContent">
<s:annotation>
<s:documentation>Входные данные метода Find</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="RequestHeader" type="tns:RequestHeader" />
<s:element minOccurs="0" maxOccurs="1" name="EServiceHeader" type="tns:EServiceHeader" />
<s:element minOccurs="1" maxOccurs="1" name="regData">
36
Руководство администратора интеграционного модуля АБИС
<s:complexType>
<s:sequence>
<s:element
minOccurs="1"
maxOccurs="1"
name="MaxResult"
type="s:long"
default="1000">
<s:annotation>
<s:documentation>Максимальное ограничение на
количество получаемых записей в результате поиска для этого веб-сервиса</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="ExtSearchData" type="tns:SearchData" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetFile">
<s:annotation>
<s:documentation>Входные данные метода GetFile</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="FileID" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:complexType name="SearchData">
<s:annotation>
<s:documentation>Условия поиска</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="Search" type="tns:SearchElement" />
<s:element
minOccurs="0"
maxOccurs="unbounded"
name="or"
type="tns:SearchOperator"></s:element>
<s:element
minOccurs="0"
maxOccurs="unbounded"
name="and"
type="tns:SearchOperator"></s:element>
</s:sequence>
37
Руководство администратора интеграционного модуля АБИС
</s:complexType>
<s:complexType name="SearchOperator">
<s:annotation>
<s:documentation>Содержимое логического оператора (or или and)</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="Search" type="tns:SearchElement"/>
</s:sequence>
</s:complexType>
<s:complexType name="SearchElement">
<s:annotation>
<s:documentation>Условие поиска</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="Comparer" type="tns:Comparators" >
<s:annotation>
<s:documentation>Предикат, используемый для поиска</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="Condition" type="s:string" >
<s:annotation>
<s:documentation>Искомое значение</s:documentation>
</s:annotation>
</s:element>
<s:element
minOccurs="1"
maxOccurs="1"
name="AttributeRecord"
type="tns:AttributeRecords" >
<s:annotation>
<s:documentation>Атрибут,
к
которому
применяется
условие</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
<s:simpleType name="Comparators">
<s:annotation>
<s:documentation>Список возможных предикатов</s:documentation>
38
Руководство администратора интеграционного модуля АБИС
</s:annotation>
<s:restriction base="s:string">
<s:enumeration value="Start" >
<s:annotation>
<s:documentation>Предикат "начинается с"</s:documentation>
</s:annotation>
</s:enumeration>
<s:enumeration value="End" >
<s:annotation>
<s:documentation>Предикат "заканчивается на"</s:documentation>
</s:annotation>
</s:enumeration>
<s:enumeration value="Equal" >
<s:annotation>
<s:documentation>Предикат "равно"</s:documentation>
</s:annotation>
</s:enumeration>
<s:enumeration value="Contain" >
<s:annotation>
<s:documentation>Предикат "содержит"</s:documentation>
</s:annotation>
</s:enumeration>
</s:restriction>
</s:simpleType>
<s:simpleType name="AttributeRecords">
<s:annotation>
<s:documentation>Список возможных атрибутов для поиска</s:documentation>
</s:annotation>
<s:restriction base="s:string">
<s:enumeration value="Автор" />
<s:enumeration value="Заглавие" />
<s:enumeration value="Серия" />
<s:enumeration value="Тема" />
<s:enumeration value="Место издания" />
<s:enumeration value="Издательство" />
<s:enumeration value="Год издания" />
<s:enumeration value="ISBN" />
<s:enumeration value="Предметные рубрики" />
39
Руководство администратора интеграционного модуля АБИС
<s:enumeration value="Тип документа" />
</s:restriction>
</s:simpleType>
<s:element name="FindResponse">
<s:annotation>
<s:documentation>Выходные данные метода Find</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="ResponseHeader" type="tns:ResponseHeader"
/>
<s:element minOccurs="0" maxOccurs="1" name="EServiceResult" type="tns:EServiceResult" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="FindContentResponse">
<s:annotation>
<s:documentation>Выходные данные метода FindContent</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="ResponseHeader" type="tns:ResponseHeader"
/>
<s:element
minOccurs="0"
maxOccurs="1"
name="EServiceResult"
type="tns:EServiceResultContent" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetFileResponse">
<s:annotation>
<s:documentation>Выходные данные метода GetFile</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="Content" type="s:base64Binary" />
<s:element minOccurs="0" maxOccurs="1" name="ContentType" type="s:string">
40
Руководство администратора интеграционного модуля АБИС
<s:annotation>
<s:documentation>Тип
возвращаемого
файла.
Если
данный
тег
отсутствует, то тип файла определяется расширением файла, указанным в теге FileName данного
метода.</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="FileName" type="s:string">
<s:annotation>
<s:documentation>Название возвращаемого файла. Если отстутствует, то
название определяется тегом FileName из результата метода FindContent. Если тип файла не определен, и
отсутствует расширение в данном теге, то определять тип
файла по расширению из имени файла, возвращенного в теге FileName в результате метода FindContent. В
случае,
если
и
по
результатам
метода
FindContent
невозможно
определить тип файла, то он принимается равным application/octet-stream</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
</s:element>
<s:complexType name="ResultLibrary">
<s:annotation>
<s:documentation>Содержит список всех библиотек с результатами поиска (только те,
где есть хотя бы один результат поиска)</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="Library" type="tns:Library" />
</s:sequence>
</s:complexType>
<s:complexType name="ResultLibraryContent">
<s:annotation>
<s:documentation>Содержит список всех библиотек с результатами поиска (только те,
где есть хотя бы один результат поиска)</s:documentation>
</s:annotation>
<s:sequence>
<s:element
minOccurs="0"
maxOccurs="unbounded"
name="Library"
type="tns:LibraryContent" />
41
Руководство администратора интеграционного модуля АБИС
</s:sequence>
</s:complexType>
<s:complexType name="LibraryBase">
<s:annotation>
<s:documentation>Содержит
список
записей
и
атрибуты
библиотеки
(базовый
тег)</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="LibraryName" type="s:string" >
<s:annotation>
<s:documentation>название библиотеки</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="LibraryNote" type="s:string" >
<s:annotation>
<s:documentation>опциональный - предназначен для доп. информации о
работе и местонахождении библиотеки</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="RecordQuantityAll" type="s:long" >
<s:annotation>
<s:documentation>общее количество записей, найденных по запросу в этой
библиотеке</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
<s:complexType name="Library">
<s:annotation>
<s:documentation>Содержит список записей и атрибуты библиотеки</s:documentation>
</s:annotation>
<s:complexContent>
<s:extension base="tns:LibraryBase">
<s:sequence>
<s:element
minOccurs="1"
maxOccurs="1"
name="RecordList"
type="tns:RecordList" >
<s:annotation>
42
Руководство администратора интеграционного модуля АБИС
<s:documentation>Список записей</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:extension>
</s:complexContent>
</s:complexType>
<s:complexType name="LibraryContent">
<s:annotation>
<s:documentation>Содержит список записей с оцифрованным содержимым и атрибуты
библиотеки</s:documentation>
</s:annotation>
<s:complexContent>
<s:extension base="tns:LibraryBase">
<s:sequence>
<s:element
minOccurs="1"
maxOccurs="1"
name="RecordList"
type="tns:RecordContentList" >
<s:annotation>
<s:documentation>Список записей</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:extension>
</s:complexContent>
</s:complexType>
<s:complexType name="RecordList">
<s:annotation>
<s:documentation>содержит
список
всех
записей,
найденных
в
этой
библиотеке</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="unbounded" name="Record" type="tns:Record" />
</s:sequence>
</s:complexType>
<s:complexType name="RecordContentList">
<s:annotation>
43
Руководство администратора интеграционного модуля АБИС
<s:documentation>содержит список всех записей, найденных в этой библиотеке, вместе с
оцифрованным содержимым</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="unbounded" name="Record" type="tns:RecordContent"
/>
</s:sequence>
</s:complexType>
<s:complexType name="Record">
<s:annotation>
<s:documentation>Содержит атрибуты записи (только те, которые не были пустыми в
записи)</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="ResultNumber" type="s:long" >
<s:annotation>
<s:documentation>порядковый
номер
записи
в
результате</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="Author" type="s:string" >
<s:annotation>
<s:documentation>Автор</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="Name" type="s:string" >
<s:annotation>
<s:documentation>Заглавие</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="Year" type="s:string" >
<s:annotation>
<s:documentation>Год издания</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="Location" type="s:string" >
<s:annotation>
<s:documentation>Место издания</s:documentation>
44
Руководство администратора интеграционного модуля АБИС
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="ISBN" type="s:string" >
<s:annotation>
<s:documentation>Индекс ISBN</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="Publisher" type="s:string" >
<s:annotation>
<s:documentation>Издательство</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
<s:complexType name="RecordContent">
<s:annotation>
<s:documentation>Содержит атрибуты записи (только те, которые не были пустыми в
записи)</s:documentation>
</s:annotation>
<s:complexContent>
<s:extension base="tns:Record">
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="RecordID" type="s:string"
>
<s:annotation>
<s:documentation>Идентификатор
записи</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="FileList" >
<s:annotation>
<s:documentation>Список файлов</s:documentation>
</s:annotation>
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded"
name="File" type="tns:File"/>
</s:sequence>
45
Руководство администратора интеграционного модуля АБИС
</s:complexType>
</s:element>
</s:sequence>
</s:extension>
</s:complexContent>
</s:complexType>
<s:complexType name="File">
<s:annotation>
<s:documentation>Файл с информационным материалом</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="FileID" type="s:string" >
<s:annotation>
<s:documentation>Идентификатор файла</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="FileName" type="s:string" >
<s:annotation>
<s:documentation>Имя файла</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
</s:schema>
</wsdl:types>
<wsdl:message name="FindSoapIn">
<wsdl:part name="parameters" element="tns:Find" />
</wsdl:message>
<wsdl:message name="FindSoapOut">
<wsdl:part name="parameters" element="tns:FindResponse" />
</wsdl:message>
<wsdl:message name="FindContentSoapIn">
<wsdl:part name="parameters" element="tns:FindContent" />
</wsdl:message>
46
Руководство администратора интеграционного модуля АБИС
<wsdl:message name="FindContentSoapOut">
<wsdl:part name="parameters" element="tns:FindContentResponse" />
</wsdl:message>
<wsdl:message name="GetFileSoapIn">
<wsdl:part name="parameters" element="tns:GetFile" />
</wsdl:message>
<wsdl:message name="GetFileSoapOut">
<wsdl:part name="parameters" element="tns:GetFileResponse" />
</wsdl:message>
<wsdl:portType name="LibrarySOAP">
<wsdl:operation name="Find">
<wsdl:input message="tns:FindSoapIn" />
<wsdl:output message="tns:FindSoapOut" />
</wsdl:operation>
<wsdl:operation name="FindContent">
<wsdl:input message="tns:FindContentSoapIn" />
<wsdl:output message="tns:FindContentSoapOut" />
</wsdl:operation>
<wsdl:operation name="GetFile">
<wsdl:input message="tns:GetFileSoapIn" />
<wsdl:output message="tns:GetFileSoapOut" />
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="LibrarySOAP" type="tns:LibrarySOAP">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="Find">
<soap:operation soapAction="LibrarySOAPFind" style="document" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
47
Руководство администратора интеграционного модуля АБИС
</wsdl:operation>
<wsdl:operation name="FindContent">
<soap:operation soapAction="LibrarySOAPFindContent" style="document" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetFile">
<soap:operation soapAction="LibrarySOAPGetFile" style="document" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="LibrarySOAP">
<wsdl:port name="LibrarySOAP" binding="tns:LibrarySOAP">
<soap:address location="http://194.226.24.32/opacg.soap/?gosuslugi" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
4.2 Описание общих структур данных
tns:RequestHeader (Унифицированный заголовок запроса)
48
Руководство администратора интеграционного модуля АБИС
№
Код параметра
tns:authToken
Описание
параметра
Токен
Способ
заполнения/Тип
Комментарий
s:string
безопасности
1
Обязательность
в
СИА
2
3
tns:requestId
Код заявки в ЕЛК
s:string
tns:requestInitiatorCo
Данные о системе-
tns:OrgExternal
de
инициаторе
взаимодействия
tns:orgRegistrator
Данные о системе,
tns:OrgExternal
зарегистрировавше
4
й обращение
tns:requestDate
Дата
регистрации
+
s:dateTime
запроса
5
tns:requestTypeCode
s:string
Незаодокументиров
анный
параметр,
который
игнорируется.
Нужен
6
исключительно для
СМЭВ
(для
совместимости
с
другими
системами).
tns:OrgExternal (Информация о системе инициаторе/получателе)
№
Код параметра
Описание
параметра
Обязательность
Способ
заполнения/Тип
1
tns:regionCode
Код региона
s:string
2
tns:serviceOrgCode
Код организации
s:string
tns:employee
Информация
3
о
Комментарий
tns:Employee
сотруднике
tns:Employee (Информация о сотруднике)
49
Руководство администратора интеграционного модуля АБИС
№
Код параметра
Описание
параметра
Обязательность
Способ
заполнения/Тип
1
tns:sname
Фамилия
s:string
2
tns:fname
Имя
s:string
3
tns:mname
Отчество
s:string
4
tns:position
Должность
s:string
Комментарий
4.2.1 tns:EServiceHeader (Специализированный заголовок запроса)
№
Код параметра
tns:userId
Описание
параметра
Обязательность
Идентификатор
Способ
заполнения/Тип
Комментарий
s:long
пользователя
1
портала
2
tns:eserviceId
Идентификатор
s:long
услуги
tns:reestrId
3
Номер услуги по
s:string
Игнорируется.
внутреннему
Используется только
реестру СМЭВ
СМЭВ.
tns:sirRequestId
s:string
Незаодокументиров
анный
параметр,
который
игнорируется.
Нужен
4
исключительно для
СМЭВ
(для
совместимости
с
другими
системами).
5
6
tns:stateOrgId
Код ведомства
+
s:long
tns:orderDate
Дата
+
s:dateTime
регистрации
запроса
tns:ResponseHeader (Унифицированный заголовок ответа)
№
Код параметра
tns:authToken
1
Описание
параметра
Обязательность
Токен
безопасности
Способ
заполнения/Тип
Комментарий
s:string
в
50
Руководство администратора интеграционного модуля АБИС
СИА
tns:responseDate
Дата
ответа
со
+
s:dateTime
стороны
2
ведомственной ИС
3
tns:requestInitiatorCo
Данные о системе-
de
инициаторе
tns:OrgExternal
взаимодействия
tns:requestIDRef
Код
исходного
Указывается
s:string
запроса
исходного
код
запроса,
пришедший
4
запросе
в
в
теге
RequestHeader.reque
stId
tns:error
Контейнер
tns:Error
сообщения
5
об
ошибке
tns:Error (Контейнер сообщения об ошибке)
№
Код параметра
Описание
параметра
1
tns:errorCode
Код ошибки
2
tns:errorMessage
Описание ошибки
1
Код параметра
tns:orderStatusId
Способ
заполнения/Тип
+
s:long
Описание
параметра
Код
Комментарий
s:string
(Cпециализированный
4.2.2 tns:EServiceResultBase
результата/статуса)
№
Обязательность
Обязательность
статуса
заголовок
Способ
заполнения/Тип
возврата
Комментарий
s:long
исполнения услуги
tns:comment
Произвольный
комментарий
s:string
к
статусу
исполнения услуги,
2
который
будет
выводиться
Личном
в
кабинете
пользователя
3
tns:extOrderNumber
Уникальный
s:long
51
Руководство администратора интеграционного модуля АБИС
идентификатор
принятого
заявления
в
ведомственной ИС
4.2.3 tns:EServiceResult
(Cпециализированный
заголовок
возврата
результата/статуса) наследует tns:EServiceResultBase и также включает в себя:
№
Код параметра
tns:XML
Описание
параметра
Обязательность
Способ
заполнения/Тип
Структурированное
Параметр
описание
комплексного типа
специфических
1
Комментарий
Содержит
в
себе
единственный
необязательный узел
результатов
ResultLibrary
ведомственных ИС
типа
tns:ResultLibrary
по услуге
4.2.4 tns:EServiceResultContent
(Cпециализированный
заголовок
возврата
результата/статуса) наследует tns:EServiceResultBase и также включает в себя:
№
Код параметра
tns:XML
Описание
параметра
Обязательность
Способ
заполнения/Тип
Структурированное
Параметр
описание
комплексного типа
специфических
1
результатов
ведомственных
ИС
Комментарий
Содержит в себе
единственный
необязательный узел
ResultLibrary типа
tns:ResultLibraryCont
ent
по услуге
4.2.5 Параметр комплексного типа: tns:Find (Входные данные метода Find)
№
Код параметра
Обязательность
Способ
заполнения/Тип
tns:RequestHeader
Унифицированн
ый
заголовок
запроса
tns:RequestHeader
tns:EServiceHeader
Специализиров
анный
tns:EServiceHeader
1
2
Описание
параметра
Комментарий
52
Руководство администратора интеграционного модуля АБИС
заголовок
запроса
tns:regData
Содержимое
запроса
Параметр
комплексного
типа
Содержит
2
обязательных
параметра:
MaxResult
(s:long,
по
умолчанию
1000)
Максимальное
ограничение на
количество
получаемых
записей
в
результате
поиска
для
этого
вебсервиса,
3
ExtSearchData
— содержимое
запроса , тип
—
tns:SearchData.
4.2.6 Параметр комплексного типа: tns:FindContent (Входные данные метода
Find)
№
tns:RequestHeader
1
Унифицированный
Обязательность
Способ
заполнения/Тип
Комментарий
tns:RequestHeader
заголовок запроса
tns:EServiceHeader
2
Описание
параметра
Код параметра
Специализированн
ый
tns:EServiceHeader
заголовок
запроса
53
Руководство администратора интеграционного модуля АБИС
tns:regData
Содержимое
+
запроса
Параметр
Содержит
комплексного типа
обязательных
2
параметра:
MaxResult (s:long, по
умолчанию 1000) Максимальное
ограничение
на
количество
3
получаемых записей
в результате поиска
для
этого
веб-
сервиса,
ExtSearchData
—
содержимое запроса
,
тип
—
tns:SearchData.
Параметр комплексного типа: tns:GetFile (Входные данные метода GetFile)
№
Код параметра
tns:FileID
1
Описание
параметра
Обязательность
Идентификатор
файла
Способ
заполнения/Тип
Комментарий
s:string
tns:SearchData (Условия поиска)
№
1
Код параметра
Описание
параметра
tns:Search
Условия поиска
tns:or
Дополнительные
условия
2
Обязательность
Способ
заполнения/Тип
+
tns:SearchElement
Комментарий
tns:SearchOperator
поиска
(логическое
«ИЛИ»)
tns:and
3
Дополнительные
условия
tns:SearchOperator
поиска
(логическое «И»)
54
Руководство администратора интеграционного модуля АБИС
4.2.7 tns:SearchData (Условия поиска)
№
1
Код параметра
Описание
параметра
tns:Search
Условия поиска
tns:or
Дополнительные
условия
2
Обязательность
Способ
заполнения/Тип
+
tns:SearchElement
Комментарий
tns:SearchOperator
поиска
(логическое
«ИЛИ»)
tns:and
Дополнительные
условия
3
tns:SearchOperator
поиска
(логическое «И»)
4.2.8 tns:SearchOperator (Содержимое логического оператора or или and)
№
1
Код параметра
tns:Search
Описание
параметра
Условия поиска
Обязательность
Способ
заполнения/Тип
+
tns:SearchElement
Комментарий
4.2.9 tns:SearchElement (Условие поиска)
№
Код параметра
tns:Comparer
Описание
параметра
Предикат,
Обязательность
Способ
заполнения/Тип
+
tns:Comparators
+
s:string
+
s:string
Комментарий
используемый для
1
поиска
2
tns:Condition
Искомое значение
tns:AttributeRecord
Атрибут,
к
которому
3
применяется
условие
4.2.10 Параметр комплексного типа: tns:FindResponse (Выходные данные
метода Find)
№
1
Код параметра
tns:ResponseHeader
Описание
параметра
Унифицированный
Обязательность
Способ
заполнения/Тип
Комментарий
tns:ResponseHea
заголовок запроса
55
Руководство администратора интеграционного модуля АБИС
der
tns:EServiceResult
Cпециализированн
ый
2
tns:EServiceResul
t
заголовок
возврата
результата/статуса
4.2.11 Параметр комплексного
данные метода FindContent)
№
Описание
параметра
Код параметра
tns:ResponseHeader
1
типа:
tns:FindContentResponse
Обязательность
Унифицированный
Способ
заполнения/Тип
(Выходные
Комментарий
tns:ResponseHeader
заголовок запроса
tns:EServiceResult
2
Cпециализированн
tns:EServiceResultCo
ый
ntent
заголовок
возврата
результата/статуса
4.2.12 Параметр комплексного типа: tns:GetFileResponse (Выходные данные
метода GetFile)
№
Код параметра
tns:Content
Описание
параметра
Содержимое
Обязательность
Способ
заполнения/Тип
+
s:base64Binary
Комментарий
электронного
1
документа в виде
base64-строки
tns:ContentType
Тип возвращаемого
файла
s:string
Тип возвращаемого
файла. Если данный
тег отсутствует, то
2
тип
файла
определяется
расширением файла,
указанным
в
теге
FileName
данного
56
Руководство администратора интеграционного модуля АБИС
метода.
tns:FileName
Название
s:string
Если
отстутствует,
возвращаемого
то
название
файла
определяется тегом
FileName
из
результата
метода
FindContent.
тип
Если
файла
не
определен,
и
отсутствует
расширение
данном
в
теге,
определять
тип
файла
по
расширению
из
имени
3
то
файла,
возвращенного
в
теге
в
FileName
результате
метода
FindContent.
В
случае, если и по
результатам метода
FindContent
невозможно
определить
файла,
тип
то
он
принимается
равным
application/octetstream
4.2.13 tns:ResultLibrary (Список всех библиотек с результатами поиска, только
те, где есть хотя бы один результат поиска)
№
Код параметра
tns:Library
1
Описание
параметра
Список библиотек
Обязательность
Способ
заполнения/Тип
tns:Library
Комментарий
Содержит список
всех библиотек с
результатами поиска
(только те, где есть
хотя бы один
57
Руководство администратора интеграционного модуля АБИС
результат поиска)
4.2.14 tns:ResultLibraryContent (Список всех библиотек с результатами поиска,
только те, где есть хотя бы один результат поиска)
№
Описание
параметра
Код параметра
tns:Library
Обязательность
Список библиотек
Способ
заполнения/Тип
tns:LibraryContent
Комментарий
Содержит
всех
список
библиотек
с
результатами поиска
1
(только те, где есть
хотя
бы
один
результат поиска)
4.2.15 tns:LibraryBase (Список записей и атрибуты библиотеки)
№
Описание
параметра
Код параметра
tns:LibraryName
1
Название
Обязательность
Способ
заполнения/Тип
+
s:string
Комментарий
библиотеки
tns:LibraryNote
Доп. информации о
работе
2
s:string
и
местонахождении
библиотеки
RecordQuantityAll
Общее количество
s:long
записей,
найденных
3
запросу
в
по
этой
библиотеке
4.2.16 tns:Library (Список записей и атрибуты библиотеки).
Наследует tns:LibraryBase.
№
1
2
Код параметра
tns:LibraryName
Описание
параметра
Название
Обязательность
Способ
заполнения/Тип
+
s:string
Комментарий
библиотеки
tns:LibraryNote
Доп. информации о
работе
s:string
и
58
Руководство администратора интеграционного модуля АБИС
местонахождении
библиотеки
tns:RecordQuantityAll
Общее количество
s:long
записей,
найденных
3
запросу
в
по
этой
библиотеке
4.2.17 tns:LibraryContent (Список записей, имеющих электронные документы и
атрибуты библиотеки).
Наследует tns:LibraryBase.
№
1
Код параметра
tns:RecordList
Описание
параметра
Список записей
Обязательность
Способ
заполнения/Тип
+
tns:RecordContentLis
Комментарий
t
4.2.18 tns:RecordList (Список всех записей, найденных в этой библиотеке)
№
1
Код параметра
tns:Record
Описание
параметра
Обязательность
Массив записей
Способ
заполнения/Тип
Комментарий
tns:Record
4.2.19 tns:RecordContentList (Список всех записей, имеющих электронные
документы)
№
1
Код параметра
tns:Record
Описание
параметра
Обязательность
Массив записей
Способ
заполнения/Тип
Комментарий
tns:RecordContent
4.2.20 tns:Record (Атрибуты записи)
№
1
Код параметра
tns:ResultNumber
Описание
параметра
Порядковый номер
Обязательность
Способ
заполнения/Тип
+
s:long
Комментарий
записи в результате
2
tns:Author
Автор
s:string
3
tns:Name
Заглавие
s:string
4
tns:Year
Год издания
s:string
59
Руководство администратора интеграционного модуля АБИС
5
tns:Location
Место издания
s:string
6
tns:ISBN
Индекс ISBN
s:string
7
tns:Publisher
Издательство
s:string
tns:RecordContent (Атрибуты записи, имеющей электронную копию).
4.2.21 Наследует tns:Record.
№
Описание
параметра
Код параметра
RecordID
1
Идентификатор
Обязательность
Способ
заполнения/Тип
+
s:string
+
tns:File
Комментарий
записи
tns:FileList
Список
идентификаторов
2
файлов
4.2.22 tns:File (Файл с информационным материалом).
№
Описание
параметра
Код параметра
tns:FileID
1
Идентификатор
Обязательность
Способ
заполнения/Тип
+
s:string
+
s:string
Комментарий
записи
2
tns:FileName
Имя файла
4.3 Описания справочников
4.3.1. tns:Comparators. Возможные значения (все типа s:string):
Start
Предикат "начинается с"
End
Предикат "заканчивается на"
Equal
Предикат "равно"
Contain
Предикат "содержит"
4.3.2. tns:AttributeRecords. Список возможных атрибутов для поиска (все типа s:string):
 Автор

Заглавие

Серия

Тема

Место издания
60
Руководство администратора интеграционного модуля АБИС

Издательство

Год издания

ISBN

Предметные рубрики

Тип документа
4.4 Иные приложения
Возможные коды ошибок, возвращаемые сервисом (в узле error/errorCode):

«0» - ошибка инициализации веб-сервера,

«1» - система не настроена должным образом: отсутствуют конфигурационные файлы, или
в настройках имеются ошибки (например, отсутствуют обязательные параметры),

«2» - ошибка при работе веб-сервиса («баг»),

«3» - ошибка от библиотечных сервисов, работающих с базами данных,

«4» - ошибка при работе веб-сервиса («баг»), возникшая из-за некорректной работы
плагинов, подключенных к веб-сервису.

«5» - введены неправильные данные.
61
Download