1 <?xml version="1.0" encoding="utf-8"?>
\r
2 <chapter xml:id="supercat" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="EN"
\r
3 xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink">
\r
5 <title>SuperCat</title>
\r
7 <section xml:id="usingsupercat">>
\r
8 <title>Using SuperCat</title>
\r
9 <indexterm><primary>SuperCat</primary></indexterm>
\r
10 <para>SuperCat allows Evergreen record and information retrieval from a web browser using a based on a number of open web standards and formats. The following record types are
\r
13 <listitem>isbn</listitem>
\r
14 <listitem>metarecord</listitem>
\r
15 <listitem>record</listitem>
\r
18 <title>Return a list of ISBNs for related records</title>
\r
19 <indexterm><primary>SuperCat</primary><secondary>ISBNs</secondary></indexterm>
\r
20 <para>Similar to the OCLC xISBN service, Evergreen can return a list of related records based on its oISBN algorithm:</para>
\r
21 <para><uri>http://<hostname>/opac/extras/osibn/<ISBN></uri></para>
\r
22 <para>For example, <uri>http://dev.gapines.org/opac/extras/oisbn/0439136350</uri> returns:</para>
\r
24 <idlist metarecord="302670">
\r
25 <isbn record="250060">0790783525</isbn>
\r
26 <isbn record="20717">0736691316</isbn>
\r
27 <isbn record="250045">0790783517</isbn>
\r
28 <isbn record="199060">9500421151</isbn>
\r
29 <isbn record="250061">0790783495</isbn>
\r
30 <isbn record="154477">0807286028</isbn>
\r
31 <isbn record="227297">1594130027</isbn>
\r
32 <isbn record="26682">0786222743</isbn>
\r
33 <isbn record="17179">0807282316</isbn>
\r
34 <isbn record="34885">0807282316</isbn>
\r
35 <isbn record="118019">8478885196</isbn>
\r
36 <isbn record="1231">0738301477</isbn>
\r
41 <title>Return records</title>
\r
42 <indexterm><primary>SuperCat</primary><secondary>records</secondary></indexterm>
\r
43 <para>SuperCat can return records and metarecords in many different formats (see <xref linkend='supportedsupercatformats' /></para>
\r
44 <para><uri>http://<hostname>/opac/extras/supercat/retrieve/<format>/<record-type>/<bib-ID></uri></para>
\r
45 <para>For example, <uri>http://dev.gapines.org/opac/extras/supercat/retrieve/mods/record/555</uri> returns:</para>
\r
47 <mods:modsCollection version="3.0">
\r
48 <mods:mods xsi:schemaLocation="http://www.loc.gov/mods/ http://www.loc.gov/standards/mods/mods.xsd">
\r
50 <title>More Brer Rabbit stories /</title>
\r
52 <typeOfResource>text</typeOfResource>
\r
55 <code authority="marc">xx</c0de>
\r
57 <publisher>Award Publications</publisher>
\r
58 <dateIssued>c1982, 1983</dateIssued>
\r
59 <dateIssued encoding="marc" point="start">1983</dateIssued>
\r
60 <dateIssued encoding="marc" point="end">1982</dateIssued>
\r
61 <issuance>monographic</issuance>
\r
63 <language authority="iso639-2b">eng</language>
\r
64 <physicalDescription>
\r
65 <form authority="marcform">print</form>
\r
66 <extent>unp. : col. ill.</extent>
\r
67 </physicalDescription>
\r
68 <note type="statement of responsibility">ill. by Rene Cloke.</note>
\r
69 <subject authority="lcsh">
\r
70 <topic>Animals</topic>
\r
71 <topic>Fiction</topic>
\r
73 <subject authority="lcsh">
\r
74 <topic>Fables</topic>
\r
77 <recordContentSource>(BRO)</recordContentSource>
\r
78 <recordCreationDate encoding="marc">930903</recordCreationDate>
\r
79 <recordChangeDate encoding="iso8601">19990703024637.0</recordChangeDate>
\r
80 <recordIdentifier>PIN60000007 </recordIdentifier>
\r
83 </mods:modsCollection>
\r
87 <title>Return a feed of recently edited or created records</title>
\r
88 <indexterm><primary>SuperCat</primary><secondary>recent records</secondary></indexterm>
\r
89 <para>SuperCat can return feeds of recently edited or created authority and bibliographic records:</para>
\r
90 <para><uri>http://<hostname>/opac/extras/feed/freshmeat/<feed-type>/[authority|biblio]/[import|edit]/<limit>/<date></uri></para>
\r
91 <para>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.</para>
\r
92 <para>If you do not supply a limit, then up to 10 records will be returned.</para>
\r
93 <para>Feed-type can be one of atom, html, htmlholdings, marcxml, mods, mods3, or rss2.</para>
\r
94 <para><uri>For example, http://dev.gapines.org/opac/extras/feed/freshmeat/atom/biblio/import/10/2008-01-01</uri></para>
\r
97 <title>Browse records</title>
\r
98 <para>SuperCat can browse records in HTML and XML formats:</para>
\r
99 <para><uri>http://<hostname>/opac/extras/supercat/browse/<format>/call_number/<org_unit>/<call_number></uri></para>
\r
100 <para>For example, <uri>http://dev.gapines.org/opac/extras/browse/xml/call_number/-/GV</uri> returns:</para>
\r
102 <hold:volumes xmlns:hold='http://open-ils.org/spec/holdings/v1'>
\r
103 <hold:volume id="tag:open-ils.org,2008:asset-call_number/130607" lib="FRRLS-FA" label="GUTCHEON BETH">
\r
104 <act:owning_lib id="tag:open-ils.org,2008:actor-org_unit/111" name="Fayette County Public Library"/>
\r
105 <record xsi:schemaLocation="http://www.loc.gov/MARC21/slim http://www.loc.gov/
\r
106 standards/marcxml/schema/MARC21slim.xsd"
\r
107 id="tag:open-ils.org,2008:biblio-record_entry/21669/FRRLS-FA">
\r
108 <leader>09319pam a2200961 a 4500</leader>
\r
109 <controlfield tag="001"/>
\r
110 <controlfield tag="005">20000302124754.0</controlfield>
\r
111 <controlfield tag="008">990817s2000 nyu 000 1 eng </controlfield>
\r
112 <datafield tag="010" ind1=" " ind2=" ">
\r
113 <subfield code="a"> 99045936</subfield>
\r
120 </hold:volume>
\r
121 </hold:volumes>
\r
124 <simplesect xml:id="supportedsupercatformats">
\r
125 <title>Supported formats</title>
\r
126 <indexterm><primary>SuperCat</primary><secondary>formats</secondary></indexterm>
\r
127 <para>SuperCat maintains a list of supported formats for records and metarecords:</para>
\r
128 <para><uri>http://<hostname>/opac/extras/supercat/formats/<record-type></uri></para>
\r
129 <para>For example, <uri>http://dev.gapines.org/opac/extras/supercat/formats/record</uri> returns:</para>
\r
133 <name>opac</name>
\r
134 <type>text/html</type>
\r
137 <name>htmlholdings</name>
\r
138 <type>text/html</type>
\r
144 <section xml:id="addingsupercatformats">
\r
145 <title>Adding new SuperCat Formats</title>
\r
146 <indexterm><primary>SuperCat</primary><secondary>formats</secondary><tertiary>adding</tertiary></indexterm>
\r
147 <para>Adding SuperCat formats requires experience editing XSL files and familiarity with XML and Perl.</para>
\r
148 <para>SuperCat web services are based on the OpenSRF service, <systemitem class="service">>open-ils.supercat</systemitem>.</para>
\r
149 <para>Developers are able to add new formats by adding the <emphasis>xsl</emphasis> stylesheet for the format. By default, the location of the stylesheets is <filename class="directory">/openils/var/xsl/</filename>. You must also add the feed to the perl
\r
150 modules <filename>openils/lib/perl5/OpenILS/WWW/SuperCat/feed.pm</filename> and <filename>openils/lib/perl5/OpenILS/WWW/SuperCat.pm</filename>. An Evergreen restart is
\r
151 required for the feed to be activated.</para>
\r
152 <tip><para>Use an existing xsl stylesheet and Perl module entry as a template for your new format.</para></tip>
\r
154 <section xml:id="editingsupercatformats">
\r
155 <title>Customizing SuperCat Formats</title>
\r
156 <indexterm><primary>SuperCat</primary><secondary>formats</secondary><tertiary>customizing</tertiary></indexterm>
\r
157 <para>Editing SuperCat formats requires experience editing XSL files and familiarity with XML..</para>
\r
158 <para>It is possible to customize existing supercat formats using XSL stylesheets. You are able to change the content to be displayed and the design of the pages.</para>
\r
159 <para>In order to change the display of a specific format, edit the corresponding XSL file(s) for the particular format. The default location for the XSL stylesheets is
\r
160 <filename class="directory">/openils/var/xsl/</filename>. </para>
\r