======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. 
<del>In github: http://github.com/rsoulliere/Evergreen-DocBook/blob/master/1.6/development/supercat.xml.</del>(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:<code xml><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>
</code>


=====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:<code>
<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>
</code>

=====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:<code xml><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>
</code>



=====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:<code xml>
<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>
</code>