Net::Z3950::Simple2ZOOM::Config

Net::Z3950::Simple2ZOOM::Config contains a configuration file for the Simple2ZOOM gateway.
Download

Net::Z3950::Simple2ZOOM::Config Ranking & Summary

Advertisement

  • Rating:
  • License:
  • Perl Artistic License
  • Price:
  • FREE
  • Publisher Name:
  • Mike Taylor
  • Publisher web site:
  • http://search.cpan.org/~mirk/

Net::Z3950::Simple2ZOOM::Config Tags


Net::Z3950::Simple2ZOOM::Config Description

Net::Z3950::Simple2ZOOM::Config contains a configuration file for the Simple2ZOOM gateway. Net::Z3950::Simple2ZOOM::Config contains a configuration file for the Simple2ZOOM gateway.SYNOPSIS < client > < authentication >http://some.url/{user}/pwd={pass}< authentication > < database name="srubooks" > < zurl >http://z3950.loc.gov:7090/voyager< /zurl > < option name="sru" >get< /option > < charset >marc-8< /charset > < search > < querytype >cql< /querytype > < map use="4" >< index >title< /index >< /map > < map use="1003" >< index >creator< /index >< /map > < /search > < /database > < /client >The universal Swiss Army Gateway simple2zoom is configured by a single file, named on the command-line, and expressed in XML. This file specifies which back-end databases are supported, how the back-ends are contacted, what character-sets they provide records in, and how to map Z39.50 searches to CQL.The structure of the file is pretty simple.Top Level< client >The top-level element is < client >. It contains a single optional < authentication > element, any number of < database > elements and a single optional < search > element. The second of these specifies how to interpret requests to search in the configured databases; the last provides query mapping specifications for dynamically specified databases.< authentication >This element contains a URL template, specifying the address of an HTTP authentication server. The template must include the special strings {user} and {pass}, which are substituted with the username and password supplied in the Init request, if any. The resulting URL is actioned and the result examined: any successful response (HTTP status 200) indicates that the username/password combination is acceptable, and that the session can continue; any other response (e.g. 401 Authorization Required) results in the Init request being refused with BIB-1 diagnostic 1014 (Init/AC: Authentication System error).If the < authentication > element is omitted from the configuration, no authentication credentials are required, and any that are provided are ignored.(A trivial example of an authentication server script is included in the Simple2ZOOM distribution, as etc/sru-auth.)< database >The < database > element carries a name attribute specifying the Z39.50 database name by which is it is known to clients. It contains several complex elements, and is discussed in more detail below.< search >Each < search > element, whether contained within a specific < database > (see below) or at the top level, consists of a single mandatory < querytype > element followed by any number of < map >s. The content of < querytype > indicates the type of query that should be sent to the back-end server, with Simple2ZOOM reposible for translating incoming queries as required into that format. At present, the only supported value is cql.< map >Each < map > element carries a use attribute, which is the numeric value of BIB-1 use attribute to be supported, and optionally contains a single < index > element which in turn contains the name of the corresponding CQL index. Type-1 searches against the specified BIB-1 access point are mapped to CQL searches against the specified index.If the < index > is omitted within a < map >, then the generated CQL query term has no index specified. This can be useful for BIB-1 attributes such as 1016 (any) and 1035 (anywhere). Requirements: · Perl


Net::Z3950::Simple2ZOOM::Config Related Software