Руководство пользователя » История » Редакция 8
Редакция 7 (Rustam Usmanov, 09.04.2015 16:36) → Редакция 8/27 (Rustam Usmanov, 09.04.2015 16:41)
h1. Руководство пользователя
h2. Заказ документа (бронирование, заказ копии)
Заказ документа осуществляется в соответствии с NISO Circulation Interchange Protocol (NCIP) v. 2.0.2. Запрос отправляется методом POST по адресу "ncip" относительно корневого URL Web-сервисов (например, http://testbed.ruslan.ru:8080/rrs-web/ncip).
h3. Входные параметры (обязательные)
* Идентификатор пользователя, от имени которого осуществляется заказ - UserId/UserIdentifierValue.
* Идентификатор библиографической записи, описывающей объект заказа - BibliographicId/BibliographicRecordId/BibliographicRecordIdentifier.
* Идентификатор заказываемой услуги - RequestType. Значения: ??Hold?? - бронирование, ??Non-returnable Copy?? - копия.
* Область применения запроса - RequestScopeType. Значения: ??Bibliographic Item?? - любой экземпляр, ??Item?? - конкретный экземпляр.
* Идентификатор места выдачи заказа - PickupLocation.
* Идентификатор домашней организации пользователя - UserId/AgencyId.
* Идентификатор организации-держателя заказываемого документа - BibliographicId/BibliographicRecordId/AgencyId
h3. Выходные параметры (обязательные)
* Идентификатор пользователя, от имени которого осуществляется заказ - UserId/UserIdentifierValue.
* Идентификатор заказываемой услуги - RequestType. Значения: ??Hold?? - бронирование, ??Non-returnable Copy?? - копия.
* Область применения запроса - RequestScopeType. Значения: ??Bibliographic Item?? - любой экземпляр, ??Item?? - конкретный экземпляр.
* Идентификатор заказа - RequestId/RequestIdentifierValue. Является ключом записи на заказ в БД заказов.
* Идентификатор домашней организации пользователя - UserId/AgencyId.
* Сведения о проблемах возникших в процессе обработки запроса - Problem.
Запрос:
<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>
</ns1:NCIPMessage>
</code></pre>
Ответ (неуспешное завершение):
<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>
<ns1:ProblemDetail>220: </ns1:ProblemDetail>
</ns1:Problem>
</ns1:RequestItemResponse>
</ns1:NCIPMessage>
</code></pre>
Ответ (успешное завершение):
<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>
</ns1:RequestId>
</ns1:RequestItemResponse>
</ns1:NCIPMessage>
</code></pre>