Records

General Purpose

The resource may be accessed with a GET method to retrieve a bibliographic record. The record is retrieved in MARCXML format.

Product Version Compatibility

Versions 18, 20.2 and later

Interface Type

RESTful API

Hierarchy

Records

 

Input Parameters

REST Resource IDs:

Record ID: The Aleph BIB record identifier. The identifier is composed of the BIB library code + the system number. For example, USM01000030437

URL Parameters:

view: The format in which the BIB record will be displayed. Possible values are full. Optional.

Input URI

<Base URL>:/record/<record ID>

For example:

Using the link without a view parameter will retrieve only links to the Records resource sub-resources:

http://server.name:1892/rest-dlf/record/USM01000030437

To get the full record in MARCXML format, use the view attribute with the value full. For example:

http://server.name:1892/rest-dlf/record/USM01000030437?view=full

Output XML Format

The returned XML includes the full record in MARCXML format.

BIB record example:

<?xml version="1.0" encoding="UTF-8"?>
<get-record>
  <reply-text>ok</reply-text>
  <reply-code>0000</reply-code>
  <record>
    <info type="Items" href="http://server.name:1892/rest-dlf/record/USM01000030437/items"/>
    <info type="Holdings" href="http://server.name:1892/rest-dlf/record/USM01000030437/holdings"/>
    <info type="Filters" href="http://server.name:1892/rest-dlf/record/USM01000030437/filters"/>
    <leader>01212cam  2200289Ia 4500</leader>
    <controlfield tag="001">000030437-9</controlfield>
    <controlfield tag="005">20020418155342.1</controlfield>
    <controlfield tag="008">930129s1992    enk      b    001 1 eng d</controlfield>
    <datafield tag="020" ind1=" " ind2=" ">
      <subfield code="a">0701137681 (v. 1)</subfield>
    </datafield>
    <datafield tag="020" ind1=" " ind2=" ">
      <subfield code="a">0701139889 (v. 2)</subfield>
    </datafield>
    <datafield tag="035" ind1="0" ind2=" ">
      <subfield code="a">(OCoLC)27343498</subfield>
    </datafield>
    <datafield tag="040" ind1=" " ind2=" ">
      <subfield code="a">EUN</subfield>
      <subfield code="c">EUN</subfield>
      <subfield code="d">PIT</subfield>
      <subfield code="d">HLS</subfield>
    </datafield>
    <datafield tag="100" ind1="1" ind2=" ">
      <subfield code="a">Proust, Marcel,</subfield>
      <subfield code="d">1871-1922.</subfield>
    </datafield>
    <datafield tag="240" ind1="1" ind2="0">
      <subfield code="a">A la recherche du temps perdu.</subfield>
      <subfield code="l">English</subfield>
    </datafield>
    <datafield tag="245" ind1="1" ind2="0">
      <subfield code="a">In search of lost time /</subfield>
      <subfield code="c">Marcel Proust ; translated by C.K. Scott Moncrieff & Terence Kilmartin.</subfield>
    </datafield>
    <datafield tag="250" ind1=" " ind2=" ">
      <subfield code="a">Rev. /</subfield>
      <subfield code="b">by D.J. Enright.</subfield>
    </datafield>
    <datafield tag="260" ind1=" " ind2=" ">
      <subfield code="a">London :</subfield>
      <subfield code="b">Chatto & Windus,</subfield>
      <subfield code="c">1992.</subfield>
    </datafield>
    <datafield tag="300" ind1=" " ind2=" ">
      <subfield code="a">6 v. ;</subfield>
      <subfield code="c">23 cm.</subfield>
    </datafield>
    <datafield tag="500" ind1=" " ind2=" ">
      <subfield code="a">Translation of: ? la recherche du temps perdu.</subfield>
    </datafield>
    <datafield tag="504" ind1=" " ind2=" ">
      <subfield code="a">Includes bibliographical references and indexes.</subfield>
    </datafield>
    <datafield tag="505" ind1="0" ind2=" ">
      <subfield code="a">1. Swann's way -- 2. Within a budding grove -- 3. The Guermantes way -- 4. Sodom and Gomorrah -- 5. The captive, The fugitive -- 6. Time regained. A guide to Proust / compiled by Terence Kilmartin ; revised by Joanna Kilmartin.</subfield>
    </datafield>
    <datafield tag="700" ind1="1" ind2=" ">
      <subfield code="a">Scott-Moncrieff, C. K.</subfield>
      <subfield code="q">(Charles Kenneth),</subfield>
      <subfield code="d">1889-1930</subfield>
    </datafield>
    <datafield tag="700" ind1="1" ind2=" ">
      <subfield code="a">Kilmartin, Terence.</subfield>
    </datafield>
    <datafield tag="700" ind1="1" ind2=" ">
      <subfield code="a">Enright, D. J.</subfield>
      <subfield code="q">(Dennis Joseph),</subfield>
      <subfield code="d">1920-</subfield>
    </datafield>
  </record>
</get-record>

Possible Error Codes

19 : Record does not exist

Expand Routines

It is possible to use expand routines – by setting the “tab_expand” table of the bibliographic library (“XXX01”) tab directory, under the ‘ WEB-FULL-1’ expand menu (in COL 1).

For example:

WEB-FULL-1 expand_doc_bib_852_1
WEB-FULL-1 expand_doc_bib_852_title
WEB-FULL-1 expand_doc_isbn_13

  • Please note that it is possible to use expand routines that create fields with numeric field tag. In the example above – the expand routines create the “020”, and “852” fields which are numeric.