Get Bib Record Web Service

This is a web service used to retrieve data from the UIUC Voyager Library Catalog given a Bib Id, Call Number, or Barcode Number. It supports one action with three kinds of identifiers and four possible return formats. The URL format is as follows: /getmarc/one.aspx/identifier.ext[?v=true].

This will retrieve a Bibligraphic Record corresponding to the given identifier in the format corresponding to given ext value. The identifier can be one of the following:

Bib ID
Any value which is a valid integer is assumed to be a Bib Id. This is the most reliable way to retreive a MARC record since a Bib Id corresponds to one and only one MARC Record.
Barcode Number
Any value of exactly 14 digits is assumed to be a Barcode Number. There may be cases, such as when multiple bibliographic or intellectual volumes are bound in a single physical volume, when a barcode corresponds to multiple Bib Records. When this happens only one of the Bib Records will be returned, usually the one with largest Bib Id. For an alternate service that deals with Barcodes see the Barcode Web Service
Call Number
Any other value is assumed to be a Call Number. For the same reason given above for Barcode Numbers, this may result in multiple Bib Records; only one of which will be returned. Call Numbers can also be problematic because of inconsistent punctuation, spaces, and prefixes. Usually prefixes like Q or F or quarto or folio should be omitted. Where possible normalized spacing and punctuation should be used. Finally, because of web server restructions, any colon character contained in a Call Number must be spelled out as __COLON__. For example, this call number, 738 C817 v.12:75, would be converted to this, 738 C817 v.12__COLON__75, before used in a URL.

The format extension value can be one of the following:

marc
This extension will cause records formatted as MARC XML to be returned.
opac
This extension will cause records formatted as OPAC XML to be returned. These are similar to MARC XML except they include holdings and circulation data.
text
This extension will cause records formatted as plain text to be returned.
mods
This extension will cause records formatted as MODS XML to be returned. These are the MARC XML transformed into MODS using the standard XSLT from the Library of Congress.
dc
This extension will cause records formatted as OAI DC (Dublin Core) to be returned. These are the MARC XML transformed into DC using the standard XSLT from the Library of Congress.

If the extension is ommitted, marc is assumed.

The optional [?v=true] parameter indicates that the MARC XML returned from the Z39.50 target should be validated against the XML schema before further processing. Note that only the source MARC XML will be validated, even if the selected return type is MODS, DC, or some other XML schema.

Here are some examples:

Retreive records based on a Bib Id

Retreive records based on a Barcode Number

Retreive records based on a Call Number

This call number is actually "738 C817 v.12:75", but because of the colon is must be turned into "738 C817 v.12__COLON__75". Also, this is an example of a Call Number that corresponds to multiple Bib Records where only one of those records will be returned.

All of the formats which are returned will have one or more of the folloowing XML processing instructions (PIs) appended to the end:

<?barcode ____ ?>
If the identifier was a barcode, this PI will contain that barcode value.
<?bibcount ____ ?>
If the identifier was a barcode, this PI will contain the number of Bib Records correspodning to that barcode value.
<?query ____ ?>
This will contain the value of the actually Z39.50 query in PQF syntax.
<?count ____ ?>
This will contain the number of records found by the PQF query, even though only one of those results will be returned.