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 NYPLInstitution, the title identifier is sent as part of the create request endpoint of NYPLInstitution.
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 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 |
---|
language | js |
---|
title | Request - Create Bib Record |
---|
linenumbers | true |
---|
|
{
"itemBarcodes": [
"123456789" // Item Barcode. Common across GFA LASStorage Location IMS System, ILS and SCSB.
],
"itemOwningInstitution": "PULInstitution", // Item owning Institution. Possible values are PUL and CUL.
"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 |
---|
language | js |
---|
title | Response - Create Bib Record |
---|
linenumbers | true |
---|
|
{
"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": ""
} |
...