SuperCat and Feed Examples

NOTE: This documentation is also available in the Evergreen documentation at https://docs.evergreen-ils.org/2.0/draft/html/supercat.html. ~~In github: http://github.com/rsoulliere/Evergreen-DocBook/blob/master/1.6/development/supercat.xml.~~(no longer available)

Record types

SuperCat supports the following record types (substituting for <record-type> in the following sections):

isbn
metarecord
record

Return a list of ISBNs for related records

Similar to the OCLC xISBN service, Evergreen can return a list of related records based on its oISBN algorithm:

http://<hostname>/opac/extras/oisbn/<ISBN>

For example, http://gapines.org/opac/extras/oisbn/0439136350 returns:

<idlist metarecord="302670">
  <isbn record="250060">0790783525</isbn>
  <isbn record="20717">0736691316</isbn>
  <isbn record="250045">0790783517</isbn>
  <isbn record="199060">9500421151</isbn>
  <isbn record="250061">0790783495</isbn>
  <isbn record="154477">0807286028</isbn>
  <isbn record="227297">1594130027</isbn>
  <isbn record="26682">0786222743</isbn>
  <isbn record="17179">0807282316</isbn>
  <isbn record="34885">0807282316</isbn>
  <isbn record="118019">8478885196</isbn>
  <isbn record="1231">0738301477</isbn>
</idlist>

Return records

SuperCat can return records and metarecords in many different formats (see Supported Formats below):

http://<hostname>/opac/extras/supercat/retrieve/<format>/<record-type>/<bib-ID>

For example, http://gapines.org/opac/extras/supercat/retrieve/mods/record/555 returns:

<mods:modsCollection version="3.0">
  <mods:mods xsi:schemaLocation="http://www.loc.gov/mods/ http://www.loc.gov/standards/mods/mods.xsd">
    <titleInfo>
      <title>More Brer Rabbit stories /</title>
    </titleInfo>
    <typeOfResource>text</typeOfResource>
    <originInfo>
      <place>
        <code authority="marc">xx</c0de>
      </place>
      <publisher>Award Publications</publisher>
      <dateIssued>c1982, 1983</dateIssued>
      <dateIssued encoding="marc" point="start">1983</dateIssued>
      <dateIssued encoding="marc" point="end">1982</dateIssued>
      <issuance>monographic</issuance>
    </originInfo>
    <language authority="iso639-2b">eng</language>
    <physicalDescription>
      <form authority="marcform">print</form>
      <extent>unp. : col. ill.</extent>
    </physicalDescription>
    <note type="statement of responsibility">ill. by Rene Cloke.</note>
    <subject authority="lcsh">
      <topic>Animals</topic>
      <topic>Fiction</topic>
    </subject>
    <subject authority="lcsh">
      <topic>Fables</topic>
    </subject>
    <recordInfo>
      <recordContentSource>(BRO)</recordContentSource>
      <recordCreationDate encoding="marc">930903</recordCreationDate>
      <recordChangeDate encoding="iso8601">19990703024637.0</recordChangeDate>
      <recordIdentifier>PIN60000007 </recordIdentifier>
    </recordInfo>
  </mods:mods>
</mods:modsCollection>

Return a feed of recently edited or created records

SuperCat can return feeds of recently edited or created authority and bibliographic records:

http://<hostname>/opac/extras/feed/freshmeat/<feed-type>/[authority|biblio]/[import|edit]/<limit>/<date>

The limit records imported or edited following the supplied date will be returned. If you do not supply a date, then the most recent limit records will be returned.

If you do not supply a limit, then up to 10 records will be returned.

feed-type can be one of atom, html, htmlholdings, marcxml, mods, mods3, or rss2.

Example: http://gapines.org/opac/extras/feed/freshmeat/atom/biblio/import/10/2008-01-01

Return a feed or page of recently created items

You can generate a similar list, with the added ability to limit by Org Unit, using the item-age browse axis.

To produce an RSS feed by item date rather than bib date, and to restrict it to a particular system within a consortium:

Example: http://gapines.org/opac/extras/browse/atom/item-age/ARL-BOG/1/10

ARL-BOG should be the short name of the org unit you're interested in
1 is the page (since you are browsing through pages of results)
10 is the number of results to return per page

Modifying the 'atom' portion of the URL to 'atom-full' will include catalog links in the results:

Example: http://gapines.org/opac/extras/browse/atom-full/item-age/ARL-BOG/1/10

Modifying the 'atom' portion of the URL to 'html-full' will produce an HTML page that is minimally formatted:

Example: http://gapines.org/opac/extras/browse/html-full/item-age/ARL-BOG/1/10

Browse records

SuperCat can browse records in HTML and XML formats:

http://<hostname>/opac/extras/supercat/browse/<format>/call_number/<org_unit>/<call_number>

For example, http://gapines.org/opac/extras/browse/xml/call_number/-/GV returns:

<hold:volumes xmlns:hold='http://open-ils.org/spec/holdings/v1'>
  <hold:volume id="tag:open-ils.org,2008:asset-call_number/130607" lib="FRRLS-FA" label="GUTCHEON BETH">
    <act:owning_lib id="tag:open-ils.org,2008:actor-org_unit/111" name="Fayette County Public Library"/>
    <record xsi:schemaLocation="http://www.loc.gov/MARC21/slim http://www.loc.gov/ 
      standards/marcxml/schema/MARC21slim.xsd"
      id="tag:open-ils.org,2008:biblio-record_entry/21669/FRRLS-FA">
      <leader>09319pam a2200961 a 4500</leader>
      <controlfield tag="001"/>
      <controlfield tag="005">20000302124754.0</controlfield>
      <controlfield tag="008">990817s2000    nyu           000 1 eng  </controlfield>
      <datafield tag="010" ind1=" " ind2=" ">
        <subfield code="a">   99045936</subfield>
      </datafield>
      ..
    </record>
    <record>
    ..
    </record>
  </hold:volume>
</hold:volumes>

Supported formats

SuperCat maintains a list of supported formats for records and metarecords:

http://<hostname>/opac/extras/supercat/formats/<record-type>

For example, http://gapines.org/opac/extras/supercat/formats/record returns:

<formats>
 
  <format>
    <name>opac</name>
    <type>text/html</type>
  </format>
 
  <format>
    <name>htmlholdings</name>
    <type>text/html</type>
  </format>
 
  <format>
    <name>html</name>
    <type>text/html</type>
  </format>
 
  <format>
    <name>htmlholdings-full</name>
    <type>text/html</type>
  </format>
 
  <format>
    <name>html-full</name>
    <type>text/html</type>
  </format>
 
  <format>
    <name>marcxml</name>
    <type>application/xml</type>
    <namespace_uri>http://www.loc.gov/MARC21/slim</namespace_uri>
    <docs>http://www.loc.gov/marcxml/</docs>
 
    <schema_location>
    http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
    </schema_location>
  </format>
 
  <format>
    <name>marcxml-full</name>
    <type>application/xml</type>
    <namespace_uri>http://www.loc.gov/MARC21/slim</namespace_uri>
    <docs>http://www.loc.gov/marcxml/</docs>
 
    <schema_location>
    http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
    </schema_location>
  </format>
 
  <format>
    <name>rss2</name>
    <type>application/xml</type>
  </format>
 
  <format>
    <name>rss2-full</name>
    <type>application/xml</type>
  </format>
 
  <format>
    <name>rdf_dc</name>
    <type>application/xml</type>
    <namespace_uri>http://purl.org/dc/elements/1.1/</namespace_uri>
    <schema_location>http://purl.org/dc/elements/1.1/</schema_location>
  </format>
 
  <format>
    <name>oai_dc</name>
    <type>application/xml</type>
    <namespace_uri>http://www.openarchives.org/OAI/2.0/oai_dc/</namespace_uri>
    <schema_location>http://www.openarchives.org/OAI/2.0/oai_dc.xsd</schema_location>
  </format>
 
  <format>
    <name>srw_dc</name>
    <type>application/xml</type>
    <namespace_uri>info:srw/schema/1/dc-schema</namespace_uri>
 
    <schema_location>
    http://www.loc.gov/z3950/agency/zing/srw/dc-schema.xsd
    </schema_location>
  </format>
 
  <format>
    <name>mods32</name>
    <type>application/xml</type>
    <namespace_uri>http://www.loc.gov/mods/v3</namespace_uri>
    <docs>http://www.loc.gov/mods/</docs>
    <schema_location>http://www.loc.gov/standards/mods/v3/mods-3-2.xsd</schema_location>
  </format>
 
  <format>
    <name>mods3</name>
    <type>application/xml</type>
    <namespace_uri>http://www.loc.gov/mods/v3</namespace_uri>
    <docs>http://www.loc.gov/mods/</docs>
    <schema_location>http://www.loc.gov/standards/mods/v3/mods-3-1.xsd</schema_location>
  </format>
 
  <format>
    <name>mods3-full</name>
    <type>application/xml</type>
    <namespace_uri>http://www.loc.gov/mods/v3</namespace_uri>
    <docs>http://www.loc.gov/mods/</docs>
    <schema_location>http://www.loc.gov/standards/mods/v3/mods-3-1.xsd</schema_location>
  </format>
 
  <format>
    <name>mods</name>
    <type>application/xml</type>
    <namespace_uri>http://www.loc.gov/mods/</namespace_uri>
    <docs>http://www.loc.gov/mods/</docs>
    <schema_location>http://www.loc.gov/standards/mods/mods.xsd</schema_location>
  </format>
 
  <format>
    <name>mods-full</name>
    <type>application/xml</type>
    <namespace_uri>http://www.loc.gov/mods/</namespace_uri>
    <docs>http://www.loc.gov/mods/</docs>
    <schema_location>http://www.loc.gov/standards/mods/mods.xsd</schema_location>
  </format>
 
  <format>
    <name>atom</name>
    <type>application/xml</type>
    <namespace_uri>http://www.w3.org/2005/Atom</namespace_uri>
    <docs>http://www.ietf.org/rfc/rfc4287.txt</docs>
  </format>
 
  <format>
    <name>atom-full</name>
    <type>application/xml</type>
    <namespace_uri>http://www.w3.org/2005/Atom</namespace_uri>
    <docs>http://www.ietf.org/rfc/rfc4287.txt</docs>
  </format>
</formats>

Evergreen DokuWiki

Table of Contents