X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Frecord_transform.xml;h=e298a406048915341dddbc8798e705d33ef368b9;hb=915efbba95f2a46ef5abf35e8fe85f2d0d0567ea;hp=c414ef4965f57f6f2de0aec8f2be60e9c3e8996f;hpb=9960226abe1700d3dc87e68529755e5cff09f0d9;p=metaproxy-moved-to-github.git diff --git a/doc/record_transform.xml b/doc/record_transform.xml index c414ef4..e298a40 100644 --- a/doc/record_transform.xml +++ b/doc/record_transform.xml @@ -1,31 +1,35 @@ - - - %common; + + %idcommon; ]> - - + + + Metaproxy + Index Data + + record_transform 3mp - Metaproxy Module - + Metaproxy Module + record_transform - Metaproxy Module that performs Z39.50 presentResponse record transformations + Metaproxy Module that performs record transformations DESCRIPTION - This filter acts only on Z3950 present requests, and let all - other types of packages and requests pass untouched. It's use is - twofold: blocking Z3950 present requests, which the backend - server does not understand and can not honor, and transforming - the present 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. + This filter acts on Z39.50 present requests and Z39.50 search requests, + and let all other types of packages and requests pass untouched. Its + use is twofold: blocking Z39.50 present/search requests that the backend + server does not understand or can not honor, and transforming the present + 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. The allowed record present syntax and @@ -37,69 +41,51 @@ may be omitted, in which case any element name is accepted. An additional identifier attribute can be added to explicitly - describe the Z3950 identifier string. - - - Record transformations are invoked when the optional attributes - backendsyntax and backendname - as well as the <convert> element are specified. - Record conversions come in two flavors: - <marc> binary conversions between different - binary MARC formats and MarcXML formats, and - <xslt> stylesheet transformations performed - on any kind of XML records. These conversions can be stacked in any - order, and are performed linearly in file order. + describe the Z39.50 identifier string. - The binary MARC record transformations - <marc> are defined using the following - attributes: inputformat, outputformat, - inputcharset and outputcharset. - - - XML <xslt> transformation instructions - accept only one mandatory stylesheet attribute, - which is either an absolute path, or a relative path from the - working directory of metaproxy to the location - of the requested XSLT stylesheet. + The <retrieval> element and the content + is described in the + Retrieval Facility section + of the YAZ manual. + SCHEMA + + + + EXAMPLES A typical configuration looks like this: - - - - - - + + + + - + + - - - - + + + + + - - - - - + + + - + ]]> @@ -119,15 +105,7 @@