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">
7 <refentry id="ref-record_transform">
9 <productname>Metaproxy</productname>
10 <info><orgname>Index Data</orgname></info>
14 <refentrytitle>record_transform</refentrytitle>
15 <manvolnum>3mp</manvolnum>
16 <refmiscinfo class="manual">Metaproxy Module</refmiscinfo>
20 <refname>record_transform</refname>
21 <refpurpose>Metaproxy Module that performs Z39.50 presentResponse record transformations</refpurpose>
24 <refsect1><title>DESCRIPTION</title>
26 This filter acts only on Z3950 present requests, and let all
27 other types of packages and requests pass untouched. It's use is
28 twofold: blocking Z3950 present requests, which the backend
29 server does not understand and can not honor, and transforming
30 the present syntax and elementset name according to the rules
31 specified, to fetch only existing record formats, and transform
32 them on the fly to requested record syntaxes.
35 The allowed record present syntax and
36 element name are described in multiple
37 <literal><retrieval></literal> elements inside the
38 <literal><retrievalinfo></literal>
39 element. The <literal>syntax</literal> attribute is mandatory, but
40 the <literal>name</literal> attribute
41 may be omitted, in which case any
42 element name is accepted. An additional
43 <literal>identifier</literal> attribute can be added to explicitly
44 describe the Z3950 identifier string.
47 The <literal><retrieval></literal> element and the content
49 <ulink url="&url.yaz.retrieval;">Retrieval Facility</ulink> section
54 <refsect1><title>SCHEMA</title>
55 <literallayout><xi:include
56 xi:href="../xml/schema/filter_record_transform.rnc"
58 xmlns:xi="http://www.w3.org/2001/XInclude" />
62 <refsect1><title>EXAMPLES</title>
64 A typical configuration looks like this:
66 <filter type="record_transform">
67 <retrievalinfo xmlns="http://indexdata.com/yaz" version="1.0">
68 <retrieval syntax="xml" name="dc"
69 identifier="info:srw/schema/1/dc-v1.1">
70 <backend syntax="usmarc" name="F">
71 <marc inputformat="marc" outputformat="marcxml"
72 inputcharset="marc-8"/>
73 <xslt stylesheet="../xml/xslt/MARC21slim2DC.xsl"/>
76 <retrieval syntax="opac"/>
77 <retrieval syntax="xml" name="opac">
78 <backend syntax="opac" name="F">
79 <marc inputformat="marc" outputformat="marcxml"
80 inputcharset="marc-8"/>
83 <retrieval syntax="usmarc">
84 <backend syntax="usmarc" name="F">
94 <refsect1><title>SEE ALSO</title>
97 <refentrytitle>metaproxy</refentrytitle>
98 <manvolnum>1</manvolnum>
106 <!-- Keep this comment at the end of the file