Версия 24 - История - Руководство пользователя - Web-сервисы Руслан - Redmine

Руководство пользователя » История » Версия 24

Rustam Usmanov, 28.09.2015 16:40

-Rustam Usmanov
+h1. Руководство пользователя
 Rustam Usmanov
-Rustam Usmanov
+{{toc}}
-Rustam Usmanov
+h2. Получение списка баз данных, поддерживаемых сервером
-Rustam Usmanov
+Получение списка баз данных, поддерживаемых сервером, осуществляется по протоколу "WebDAV":http://tools.ietf.org/html/rfc4918. Запрос отправляется методом PROPFIND по адресу "/db" относительно корневого URL Web-сервисов. Поддерживаются выдача значений двух свойств БД:
-Rustam Usmanov
+* *displayname* - название БД
 * *resourcetype* - тип ресурса (постоянное значение "collection")
 Rustam Usmanov
-Rustam Usmanov
+h2. Получение метаданных базы данных
-Rustam Usmanov
+Получение метаданных базы данных, осуществляется по протоколу "SRU 2.0":http://www.loc.gov/standards/sru/sru-2-0.html (сервис Explain). Запрос отправляется методом GET по адресу "/db/name" относительно корневого URL Web-сервисов, где name - название БД, метаданные для которой требуется получить. В ответной записи Explain поддерживается выдача следующих элементов метаданных:
 * *indexInfo/set/@identifier* - идентификатор набора поисковых атрибутов
 * *recordInfo/recordSyntax/@identifier* - идентификатор основного формата записей
 Rustam Usmanov
-Rustam Usmanov
+h2. Поиск и извлечение записей
 Поиск и извлечение записей осуществляются по протоколу "SRU 2.0":http://www.loc.gov/standards/sru/sru-2-0.html. Поддерживаются:
-Rustam Usmanov
+* Язык запросов "PQF":http://www.indexdata.com/yaz/doc/tools.html#PQF (*queryType=pqf*) - для работы со всеми БД Руслан.
-Rustam Usmanov
+* Язык запросов "CQL":http://www.loc.gov/standards/sru/cql/spec.html - только в части работы с результирующим множеством (например, *query=cql.resultSetId=default*).
-Rustam Usmanov
+* Одновременное использование нескольких результирующих множеств. Создание и удаление результирующих множеств осуществляется сервисом автоматически. При отсутствии в запросе на поиск параметра *resultSetTTL* создается результирующее множество с именем ??default??. В противном случае создается результирующее множество с уникальным именем.
 * Значения ??string?? и ??xml?? параметра *recordXMLEscaping*.
 * Ответные сообщения в форматах XML и JSON. Запрос того или иного формата осуществляется при помощи заголовка HTTP *Accept* - соотв. поддерживаются значения ??application/xml??, ??application/json??.
 * Извлечение записей в схеме OPAC - для этого следует использовать заголовок HTTP *Accept* со значением ??application/opac+xml?? либо ??application/opac+json??.
-Rustam Usmanov
+* Извлечение метаданных БД (Explain).
 Rustam Usmanov
-Rustam Usmanov
+Запрос отправляется методом GET по адресу "/db/name" относительно корневого URL Web-сервисов, где name - название БД, в которой осуществляется поиск (например, http://testbed.ruslan.ru:8080/rrs-web/db/books). Одновременный поиск в нескольких БД возможен при помощи указания в качестве названия БД нескольких названий БД, соединённых знаком "+" (например, http://testbed.ruslan.ru:8080/rrs-web/db/books+serial).
 Rustam Usmanov
-Rustam Usmanov
+Для работы с внешними источниками данных в качестве названия БД можно использовать Z39.50 URL (например, http://testbed.ruslan.ru:8080/rrs-web/db/z39.50s://z3950.loc.gov:7090/voyager). При этом надо иметь в виду, что не все источники поддерживают кодировку UTF-8
  - в таких случаях кодировку требуется указывать явно при помощи параметра *x-z3950-target-charset* (например, *x-z3950-target-charset=Windows-1251*).
-Rustam Usmanov
+h2. Заказ документа (бронирование, заказ копии)
 Rustam Usmanov
-Rustam Usmanov
+Заказ документа осуществляется в соответствии с NISO Circulation Interchange Protocol (NCIP) v. 2.0.2. Запрос отправляется методом POST по адресу "ncip" относительно корневого URL Web-сервисов (например, http://testbed.ruslan.ru:8080/rrs-web/ncip).
 Rustam Usmanov
-Rustam Usmanov
+h3. Входные параметры (обязательные)
 Rustam Usmanov
-Rustam Usmanov
+* Идентификатор пользователя, от имени которого осуществляется заказ - *UserId/UserIdentifierValue*.
 * Идентификатор библиографической записи, описывающей объект заказа - *BibliographicId/BibliographicRecordId/BibliographicRecordIdentifier*.
 * Идентификатор заказываемой услуги - *RequestType*. Значения: ??Hold?? - бронирование, ??Non-returnable Copy?? - копия.
 * Область применения запроса - *RequestScopeType*. Значения: ??Bibliographic Item?? - любой экземпляр, ??Item?? - конкретный экземпляр.
 * Идентификатор места выдачи заказа - *PickupLocation*.
 * Идентификатор домашней организации пользователя - *UserId/AgencyId*.
 * Идентификатор организации-держателя заказываемого документа - *BibliographicId/BibliographicRecordId/AgencyId*.
 Rustam Usmanov
-Rustam Usmanov
+h3. Выходные параметры (обязательные)
-Rustam Usmanov
+* Идентификатор пользователя, от имени которого осуществляется заказ - *UserId/UserIdentifierValue*.
 * Идентификатор заказываемой услуги - *RequestType*. Значения: ??Hold?? - бронирование, ??Non-returnable Copy?? - копия.
 * Область применения запроса - *RequestScopeType*. Значения: ??Bibliographic Item?? - любой экземпляр, ??Item?? - конкретный экземпляр.
 * Идентификатор заказа - *RequestId/RequestIdentifierValue*. Является ключом записи на заказ в БД заказов.
 * Идентификатор домашней организации пользователя - *UserId/AgencyId*.
 * Сведения о проблемах возникших в процессе обработки запроса - *Problem*.
 Rustam Usmanov
-Rustam Usmanov
+Запрос XML:
-Rustam Usmanov
+<pre><code class="xml">
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip">
   <ns1:RequestItem>
     <ns1:UserId>
       <ns1:AgencyId>19013582</ns1:AgencyId>
       <ns1:UserIdentifierValue>sip</ns1:UserIdentifierValue>
     </ns1:UserId>
     <ns1:BibliographicId>
       <ns1:BibliographicRecordId>
         <ns1:BibliographicRecordIdentifier>RU\SPSTU\books\241</ns1:BibliographicRecordIdentifier>
         <ns1:AgencyId>19013582</ns1:AgencyId>
       </ns1:BibliographicRecordId>
     </ns1:BibliographicId>
     <ns1:RequestType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/requesttype/requesttype.scm">Hold</ns1:RequestType>
     <ns1:RequestScopeType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/requestscopetype/requestscopetype.scm">Bibliographic Item</ns1:RequestScopeType>
     <ns1:PickupLocation>СПбГПУ/ОНЛ/АбонОНЛ</ns1:PickupLocation>
   </ns1:RequestItem>
-Rustam Usmanov
+</ns1:NCIPMessage>
 </code></pre>
 Rustam Usmanov
-Rustam Usmanov
+Запрос JSON:
 <pre><code class="json">
+{
     "RequestItem": {
         "UserId": {
             "AgencyId": {
                 "value": "19013582"
             },
             "UserIdentifierValue": "002"
         },
         "BibliographicId": {
             "BibliographicRecordId": {
                 "BibliographicRecordIdentifier": "RU\\SPSTU\\books\\241",
                 "AgencyId": {
                     "value": "19013582"
+                }
+            }
         },
         "RequestType": {
             "value": "Hold",
             "Scheme": "http://www.niso.org/ncip/v1_0/imp1/schemes/requesttype/requesttype.scm"
         },
         "RequestScopeType": {
             "value": "Bibliographic Item",
             "Scheme": "http://www.niso.org/ncip/v1_0/imp1/schemes/requestscopetype/requestscopetype.scm"
         },
         "PickupLocation": {
             "value": "СПбГПУ/ОНЛ/АбонОНЛ"
+        }
+    }
+}
 </code></pre>
 Ответ XML (неуспешное завершение):
-Rustam Usmanov
+<pre><code class="xml">
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip">
   <ns1:RequestItemResponse>
     <ns1:Problem>
       <ns1:ProblemType>Diagnostic [220] Additional Info : </ns1:ProblemType>
-Rustam Usmanov
+      <ns1:ProblemDetail>220: </ns1:ProblemDetail>
-Rustam Usmanov
+    </ns1:Problem>
   </ns1:RequestItemResponse>
-Rustam Usmanov
+</ns1:NCIPMessage>
 </code></pre>
-Rustam Usmanov
+Ответ JSON (неуспешное завершение):
 <pre><code class="json">
+{
     "RequestItemResponse": {
         "Problem": {
             "ProblemType": {
                 "value": "Diagnostic [220] Additional Info : "
             },
             "ProblemDetail": "220: "
+        }
+    }
+}
 </code></pre>
-Rustam Usmanov
+Ответ XML (успешное завершение):
-Rustam Usmanov
+<pre><code class="xml">
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <ns1:NCIPMessage xmlns:ns1="http://www.niso.org/2008/ncip">
   <ns1:RequestItemResponse>
     <ns1:UserId>
       <ns1:AgencyId>19013582</ns1:AgencyId>
       <ns1:UserIdentifierValue>sip</ns1:UserIdentifierValue>
     </ns1:UserId>
     <ns1:RequestType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/requesttype/requesttype.scm">Hold</ns1:RequestType>
     <ns1:RequestScopeType ns1:Scheme="http://www.niso.org/ncip/v1_0/imp1/schemes/requestscopetype/requestscopetype.scm">Bibliographic Item</ns1:RequestScopeType>
     <ns1:RequestId>
       <ns1:RequestIdentifierValue>302</ns1:RequestIdentifierValue>
-Rustam Usmanov
+    </ns1:RequestId>
   </ns1:RequestItemResponse>
 </ns1:NCIPMessage>
-Rustam Usmanov
+</code></pre>
 Ответ JSON (успешное завершение):
 <pre><code class="json">
+{
     "RequestItemResponse": {
         "UserId": {
             "AgencyId": {
                 "value": "19013582"
             },
             "UserIdentifierValue": "002"
         },
         "RequestType": {
             "value": "Hold",
             "Scheme": "http://www.niso.org/ncip/v1_0/imp1/schemes/requesttype/requesttype.scm"
         },
         "RequestScopeType": {
             "value": "Bibliographic Item",
             "Scheme": "http://www.niso.org/ncip/v1_0/imp1/schemes/requestscopetype/requestscopetype.scm"
         },
         "RequestId": {
             "RequestIdentifierValue": "373"
+        }
+    }
+}
-Rustam Usmanov
+</code></pre>

Проект

Общее

Профиль

Руслан-Нео » Web-сервисы Руслан

Руководство пользователя » История » Версия 24