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
134 <name>opac</name>
\r
135 <type>text/html</type>
\r
139 <name>htmlholdings</name>
\r
140 <type>text/html</type>
\r
144 <name>html</name>
\r
145 <type>text/html</type>
\r
149 <name>htmlholdings-full</name>
\r
150 <type>text/html</type>
\r
154 <name>html-full</name>
\r
155 <type>text/html</type>
\r
159 <name>marcxml</name>
\r
160 <type>application/xml</type>
\r
161 <namespace_uri>http://www.loc.gov/MARC21/slim</namespace_uri>
\r
162 <docs>http://www.loc.gov/marcxml/</docs>
\r
164 <schema_location>
\r
165 http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
\r
166 </schema_location>
\r
170 <name>marcxml-full</name>
\r
171 <type>application/xml</type>
\r
172 <namespace_uri>http://www.loc.gov/MARC21/slim</namespace_uri>
\r
173 <docs>http://www.loc.gov/marcxml/</docs>
\r
175 <schema_location>
\r
176 http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
\r
177 </schema_location>
\r
181 <name>rss2</name>
\r
182 <type>application/xml</type>
\r
186 <name>rss2-full</name>
\r
187 <type>application/xml</type>
\r
191 <name>rdf_dc</name>
\r
192 <type>application/xml</type>
\r
193 <namespace_uri>http://purl.org/dc/elements/1.1/</namespace_uri>
\r
194 <schema_location>http://purl.org/dc/elements/1.1/</schema_location>
\r
198 <name>oai_dc</name>
\r
199 <type>application/xml</type>
\r
200 <namespace_uri>http://www.openarchives.org/OAI/2.0/oai_dc/</namespace_uri>
\r
201 <schema_location>http://www.openarchives.org/OAI/2.0/oai_dc.xsd</schema_location>
\r
205 <name>srw_dc</name>
\r
206 <type>application/xml</type>
\r
207 <namespace_uri>info:srw/schema/1/dc-schema</namespace_uri>
\r
209 <schema_location>
\r
210 http://www.loc.gov/z3950/agency/zing/srw/dc-schema.xsd
\r
211 </schema_location>
\r
215 <name>mods32</name>
\r
216 <type>application/xml</type>
\r
217 <namespace_uri>http://www.loc.gov/mods/v3</namespace_uri>
\r
218 <docs>http://www.loc.gov/mods/</docs>
\r
219 <schema_location>http://www.loc.gov/standards/mods/v3/mods-3-2.xsd</schema_location>
\r
223 <name>mods3</name>
\r
224 <type>application/xml</type>
\r
225 <namespace_uri>http://www.loc.gov/mods/v3</namespace_uri>
\r
226 <docs>http://www.loc.gov/mods/</docs>
\r
227 <schema_location>http://www.loc.gov/standards/mods/v3/mods-3-1.xsd</schema_location>
\r
231 <name>mods3-full</name>
\r
232 <type>application/xml</type>
\r
233 <namespace_uri>http://www.loc.gov/mods/v3</namespace_uri>
\r
234 <docs>http://www.loc.gov/mods/</docs>
\r
235 <schema_location>http://www.loc.gov/standards/mods/v3/mods-3-1.xsd</schema_location>
\r
239 <name>mods</name>
\r
240 <type>application/xml</type>
\r
241 <namespace_uri>http://www.loc.gov/mods/</namespace_uri>
\r
242 <docs>http://www.loc.gov/mods/</docs>
\r
243 <schema_location>http://www.loc.gov/standards/mods/mods.xsd</schema_location>
\r
247 <name>mods-full</name>
\r
248 <type>application/xml</type>
\r
249 <namespace_uri>http://www.loc.gov/mods/</namespace_uri>
\r
250 <docs>http://www.loc.gov/mods/</docs>
\r
251 <schema_location>http://www.loc.gov/standards/mods/mods.xsd</schema_location>
\r
255 <name>atom</name>
\r
256 <type>application/xml</type>
\r
257 <namespace_uri>http://www.w3.org/2005/Atom</namespace_uri>
\r
258 <docs>http://www.ietf.org/rfc/rfc4287.txt</docs>
\r
262 <name>atom-full</name>
\r
263 <type>application/xml</type>
\r
264 <namespace_uri>http://www.w3.org/2005/Atom</namespace_uri>
\r
265 <docs>http://www.ietf.org/rfc/rfc4287.txt</docs>
\r
271 <section xml:id="addingsupercatformats">
\r
272 <title>Adding new SuperCat Formats</title>
\r
273 <indexterm><primary>SuperCat</primary><secondary>formats</secondary><tertiary>adding</tertiary></indexterm>
\r
274 <para>Adding SuperCat formats requires experience editing XSL files and familiarity with XML and Perl.</para>
\r
275 <para>SuperCat web services are based on the OpenSRF service, <systemitem class="service">>open-ils.supercat</systemitem>.</para>
\r
276 <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
277 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
278 required for the feed to be activated.</para>
\r
279 <tip><para>Use an existing xsl stylesheet and Perl module entry as a template for your new format.</para></tip>
\r
281 <section xml:id="editingsupercatformats">
\r
282 <title>Customizing SuperCat Formats</title>
\r
283 <indexterm><primary>SuperCat</primary><secondary>formats</secondary><tertiary>customizing</tertiary></indexterm>
\r
284 <para>Editing SuperCat formats requires experience editing XSL files and familiarity with XML..</para>
\r
285 <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
286 <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
287 <filename class="directory">/openils/var/xsl/</filename>. </para>
\r