Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Create Bibliographic record API is an internal call made by SCSB to partner ILS as part of the request API for cross partner borrowings. In case of cross partner borrowings, the requesting institution is unlikely to have the metadata of the item that is being requested and hence cannot be placed on hold for the patron. The Create Bib record API addresses this by creating a temporary record against which a hold can be placed and subsequent charge and discharge processes can be done. For Institution, the title identifier is sent as part of the create request endpoint of Institution.

The created items are given a title with the use restriction mentioned in square brackets followed by the title data from 245 $a & $b which is followed  by RECAP by Storage Location in square brackets. (e.g. In Library Use] AFGHANISTAN RECAPStorage Location] All diacritical marks are stripped from the title before the record in created in the partner database. The short records allows the hold to be placed against it and gives the circulation staff and the patron information in the local ILS about use restrictions and the fact that the item belongs to a ReCAP Storage Location's partner.

Code Block
languagejs
titleRequest - Create Bib Record
linenumberstrue
{
  "itemBarcodes": [
    "123456789" // Item Barcode. Common across Storage Location GFAIMS LASSystem, ILS and SCSB.
  ],
  "itemOwningInstitution": "PULInstitution", // Item owning Institution. Possible values are PUL, CUL and NYPLCUL. 
  "patronIdentifier": "45678912", // The patron barcode issued by the partner ILS.
  "titleIdentifier": "[No Restriction] TITLE IN CAPS [RECAPStorage Location]" // The title of the created record. It follows the [<Use restriction>] <Title> [RECAPStorage Location] format.
}


Code Block
languagejs
titleResponse - Create Bib Record
linenumberstrue
{
  "itemBarcode": "",
  "itemOwningInstitution": "",
  "screenMessage": "Create Bib successful.", // Successful creation of bibliographic record
  "success": true,
  "esipDataIn": "81N20170112    062300|AO|AA45678912AP|AB123456789|AC|AJ[No Restriction] TITLE IN CAPS [RECAPStorage Location]|\r",
  "esipDataOut": "821MJ|MA9959123|AFCreate Bib successful.|",
  "bibId": "9959123",
  "itemId": ""
}

...