Руководство пользователя¶

Заказ документа (бронирование, заказ копии)¶

Заказ документа осуществляется в соответствии с NISO Circulation Interchange Protocol (NCIP) v. 2.0.2. Запрос отправляется методом POST по адресу "ncip" относительно корневого URL Web-сервисов (например, http://testbed.ruslan.ru:8080/rrs-web/ncip).

Входные параметры (обязательные)

• Идентификатор пользователя, от имени которого осуществляется заказ - UserId/UserIdentifierValue.
• Идентификатор библиографической записи, описывающей объект заказа - BibliographicId/BibliographicRecordId/BibliographicRecordIdentifier.
• Идентификатор заказываемой услуги - RequestType. Значения: Hold - бронирование, Non-returnable Copy - копия.
• Область применения запроса - RequestScopeType. Значения - Bibliographic Item - любой экземпляр, Item - конкретный экземпляр.
• Идентификатор места выдачи заказа - PickupLocation.
• Идентификатор домашней организации пользователя - UserId/AgencyId.
• Идентификатор организации-держателя заказываемого документа - BibliographicId/BibliographicRecordId/AgencyId

Запрос:

<?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>

Ответ (неуспешное завершение):

<?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>

Ответ (успешное завершение):

<?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>