doc/sru_z3950.xml

   1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
   2     "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
   3  <!ENTITY copyright SYSTEM "copyright.xml">
   4  <!ENTITY % idcommon SYSTEM "common/common.ent">
   5      %idcommon;
   6 ]>
   7 <refentry id="ref-sru_z3950">
   8  <refentryinfo>
   9   <productname>Metaproxy</productname>
  10   <orgname>Index Data</orgname>
  11  </refentryinfo>
  12
  13  <refmeta>
  14   <refentrytitle>sru_z3950</refentrytitle>
  15   <manvolnum>3mp</manvolnum>
  16   <refmiscinfo class="manual">Metaproxy Module</refmiscinfo>
  17  </refmeta>
  18
  19  <refnamediv>
  20   <refname>sru_z3950</refname>
  21   <refpurpose>Metaproxy Module transforming SRU web service requests to
  22   Z39.50 Metaproxy packages</refpurpose>
  23  </refnamediv>
  24
  25  <refsect1><title>DESCRIPTION</title>
  26   <para>
  27    The <literal>sru_z3950</literal> Metaproxy filter transforms valid
  28    SRU GET/POST/SOAP requests to Z39.50 requests, and wraps the
  29    received hit counts and XML records into suitable SRU response messages.
  30   </para>
  31   <para>
  32    Multiple database elements defining the names of the accepted
  33    databases are allowed in the configuration file. Each
  34    of them must contain their own explain record, or must be empty.
  35    Notice that explain
  36    records come in SRU and Z39.50 flavors, and this filter requires
  37    the SRU version. See the
  38    <ulink url="&url.zeerex.explain;">ZeeReX Explain</ulink>
  39    standard pages and the
  40    <ulink url="&url.sru.explain;">SRU Explain</ulink> pages
  41    for more information.
  42   </para>
  43   <para>
  44    Optionally the default stylesheet may be specified. If the client
  45    do not specify a stylesheet, the CDATA of element
  46    <literal>stylesheet</literal> is used.
  47   </para>
  48   <para>
  49    All Z39.50 packages and all HTTP packages that do not resolve to
  50    one configured database name are passed unaltered to the next
  51    filters on the route.
  52    </para>
  53   <para>
  54    The SRU <literal>explain</literal> operation is supported,
  55    returning either the absolute minimum required by the standard, or
  56    a  full  pre-defined ZeeReX explain record.
  57   </para>
  58   <para>
  59    It supports the SRU <literal>searchRetrieve</literal> operation, which
  60    is transformed into successive Z39.50 <literal>init</literal>,
  61    <literal>search</literal> and <literal>present</literal> requests.
  62   </para>
  63   <para>
  64    The SRU <literal>scan</literal> operation is not supported.
  65    </para>
  66   <para>
  67    This filter does not handle CQL-to-PQF translations. In case that
  68    the backends do not understand CQL, you need to append the
  69    <literal>cql_pqf</literal> metaproxy filter.
  70   </para>
  71   <para>
  72     This module supports the following SRU extra parameters:
  73     <variablelist>
  74       <varlistentry>
  75         <term>x-target</term>
  76         <listitem>
  77           <para>
  78             Specifies backend Z39.50 target.
  79           </para>
  80         </listitem>
  81       </varlistentry>
  82       <varlistentry>
  83         <term>x-max-sockets</term>
  84         <listitem>
  85           <para>
  86             Specifies maximum number of sockets to use for a Z39.50 backend
  87             client (for one given target host/db).
  88           </para>
  89         </listitem>
  90       </varlistentry>
  91       <varlistentry>
  92         <term>x-session-id</term>
  93         <listitem>
  94           <para>
  95             Allow a user-defined session ID to be attached to filter
  96             log that follows sru_z3950. The ID is present in the
  97             log files and not available to the SRU webservice. In order
  98             to log material out via SRU, the x-log-enable may be used
  99             instead.
 100           </para>
 101         </listitem>
 102       </varlistentry>
 103       <varlistentry>
 104         <term>x-log-enable</term>
 105         <listitem>
 106           <para>
 107             Controls whether log is to be collected for filters that
 108             sru_z3950. Log data is extra response data's log element.
 109             A value of 1 enables logging; other value disables
 110             logging (default).
 111           </para>
 112         </listitem>
 113       </varlistentry>
 114     </variablelist>
 115   </para>
 116  </refsect1>
 117
 118  <refsect1><title>SCHEMA</title>
 119    <literallayout><xi:include
 120                      xi:href="../xml/schema/filter_sru_z3950.rnc"
 121                      xi:parse="text"
 122                      xmlns:xi="http://www.w3.org/2001/XInclude" />
 123    </literallayout>
 124  </refsect1>
 125
 126  <refsect1><title>EXAMPLES</title>
 127   <para>
 128    A typical configuration looks like this:
 129    <screen><![CDATA[
 130     <filter type="sru_z3950">
 131       <stylesheet>/my.xsl</stylesheet>
 132       <database name="Default">
 133         <explain xmlns="http://explain.z3950.org/dtd/2.0/">
 134           ...
 135         </explain>
 136       </database>
 137       <database name="Dummy">
 138     </filter>
 139
 140 ]]>
 141    </screen>
 142   </para>
 143  </refsect1>
 144
 145  <refsect1><title>SEE ALSO</title>
 146   <para>
 147    <citerefentry>
 148     <refentrytitle>metaproxy</refentrytitle>
 149     <manvolnum>1</manvolnum>
 150    </citerefentry>
 151   </para>
 152  </refsect1>
 153
 154  &copyright;
 155 </refentry>
 156
 157 <!-- Keep this comment at the end of the file
 158 Local variables:
 159 mode: nxml
 160 nxml-child-indent: 1
 161 End:
 162 -->