-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY copyright SYSTEM "copyright.xml">
<!ENTITY % idcommon SYSTEM "common/common.ent">
<manvolnum>3mp</manvolnum>
<refmiscinfo class="manual">Metaproxy Module</refmiscinfo>
</refmeta>
-
+
<refnamediv>
<refname>record_transform</refname>
<refpurpose>Metaproxy Module that performs record transformations</refpurpose>
syntax and elementset name according to the rules specified, to fetch
only existing record formats, and transform them on the fly to requested
record syntaxes.
- </para>
+ </para>
<para>
- The allowed record present syntax and
+ The allowed record present syntax and
element name are described in multiple
- <literal><retrieval></literal> elements inside the
+ <literal><retrieval></literal> elements inside the
<literal><retrievalinfo></literal>
element. The <literal>syntax</literal> attribute is mandatory, but
the <literal>name</literal> attribute
- may be omitted, in which case any
+ may be omitted, in which case any
element name is accepted. An additional
<literal>identifier</literal> attribute can be added to explicitly
describe the Z39.50 identifier string.
</para>
<para>
The <literal><retrieval></literal> element and the content
- is described in the
+ is described in the
<ulink url="&url.yaz.retrieval;">Retrieval Facility</ulink> section
of the YAZ manual.
</para>
+ <para>
+ From Metaproxy version 1.3.26 and onwards the backend conversion ma
+ also use <ulink url="&url.usemarcon;">USEMARCON</ulink>.
+ If USEMARCON is enabled, the <literal>backend</literal> may include
+ a <literal>usemarcon</literal> element with two attributes:
+ <literal>stage1</literal> and <literal>stage2</literal> that points to
+ conversion files as interpreted by USEMARCON. One or both must be given.
+ </para>
</refsect1>
-
+
<refsect1><title>SCHEMA</title>
- <literallayout><xi:include
- xi:href="../xml/schema/filter_record_transform.rnc"
- xi:parse="text"
- xmlns:xi="http://www.w3.org/2001/XInclude" />
- </literallayout>
+ <para>
+ Schema is in two parts.. One for the filter itself and one for the
+ retrieval info.
+ </para>
+ <literallayout>
+ <xi:include
+ xi:href="../xml/schema/filter_record_transform.rnc"
+ xi:parse="text"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </literallayout>
+ <literallayout>
+ <xi:include
+ xi:href="../xml/schema/retrievalinfo.rnc"
+ xi:parse="text"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </literallayout>
</refsect1>
-
+
<refsect1><title>EXAMPLES</title>
<para>
A typical configuration looks like this:
<backend syntax="usmarc" name="F">
</backend>
</retrieval>
+ <retrieval syntax="usmarc" name="C">
+ <backend syntax="unimarc" name="F">
+ <usemarcon stage1="/etc/usemarcon/uni2us/uni2us.ini"/>
+ </backend>
+ </retrieval>
</retrievalinfo>
</filter>
]]>
</screen>
</para>
- </refsect1>
-
+ </refsect1>
+
<refsect1><title>SEE ALSO</title>
<para>
<citerefentry>
</citerefentry>
</para>
</refsect1>
-
+
©right;
</refentry>