evergreen-admin:sru_and_z39.50
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
| evergreen-admin:sru_and_z39.50 [2009/06/12 13:22] – Change the evergreen index target to an available one miker | evergreen-admin:sru_and_z39.50 [2022/02/10 13:34] – external edit 127.0.0.1 | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ======Evergreen: | ||
| + | [[http:// | ||
| + | |||
| + | |||
| + | **NOTE:** This documentation is also available in the Evergreen documentation at http:// | ||
| + | |||
| + | =====Testing Evergreen SRU with yaz-client===== | ||
| + | yaz-client is installed as a part of Index Data's YAZ software. Recent versions include support for querying SRU servers. Evergreen has shipped an SRU configuration that works out of the box since Evergreen 1.4. To search Evergreen with yaz-client, choose the GET query method and issue the '' | ||
| + | < | ||
| + | $ yaz-client http:// | ||
| + | Z> sru GET 1.1 | ||
| + | Z> find hemingway | ||
| + | </ | ||
| + | If your database has records that match that term, you will get the corresponding MARCXML records in your response from yaz-client. | ||
| + | |||
| + | Here's what the SRU request looks like as sent to the Evergreen web server:< | ||
| + | GET / | ||
| + | </ | ||
| + | |||
| + | You can see what the response looks like by hitting the same URL in your Web browser: http:// | ||
| + | |||
| + | |||
| + | =====CQL queries===== | ||
| + | |||
| + | Evergreen supports some [[http:// | ||
| + | |||
| + | ^ DC element ^ Evergreen index ^ | ||
| + | | title | title | | ||
| + | | creator | author | | ||
| + | | contributor | author | | ||
| + | | publisher | keyword | | ||
| + | | subject | subject | | ||
| + | | identifier | keyword | | ||
| + | | type | **none** | | ||
| + | | format | **none** | | ||
| + | | language | lang | | ||
| + | |||
| + | Here are a few examples of SRU searches against some of these indexes: | ||
| + | |||
| + | * [[http:// | ||
| + | * [[http:// | ||
| + | * [[http:// | ||
| + | * [[http:// | ||
| + | |||
| + | =====Setting up Z39.50 server support in Evergreen===== | ||
| + | |||
| + | **Prerequisite**: | ||
| + | |||
| + | This support uses an Z39.50-to-SRU translator service supplied by the Net:: | ||
| + | |||
| + | ====Setting up the Z39.50 server==== | ||
| + | - Install a recent version of yaz (the Makefile.install should have installed a suitable version). | ||
| + | - Install Net:: | ||
| + | - Create a Simple2ZOOM configuration file. Something like the following is a good start, and is based on the Simple2ZOOM documentation example. We'll name the file '' | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | =====Using your z39.50 server to access remote databases===== | ||
| + | - Simple2zoom is not concerned if your data is local or remote, so you can use your server to query remote data as well as local holdings. | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | - To query that from the Evergreen staff-client you would add " | ||
| + | | ||
| + | =====Setting up Yaz Configuration===== | ||
| + | - We need to create a configuration file that will tell YAZ how to transform marcxml to binary MARC21. Along the way, we force the output character set to be MARC-8, because in the dinosaur world of library technology some major Z39.50 clients such as RefWorks and OCLC VDX still appear to be unable to support Unicode UTF-8 encoding. We will call this one '' | ||
| + | <code xml> | ||
| + | < | ||
| + | <server id=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | <backend syntax=" | ||
| + | <marc inputformat=" | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | - As root, run simple2ZOOM as a daemon, specifying the configuration files and one or more listener addresses that the Z39.50 server will be accessible on. If you do not specify a port, it will automatically run on port 9999. In the following example, we tell it to listen both to localhost on port 2210, and on dev.gapines.org on port 210:< | ||
| + | simple2zoom -c dgo.conf -- -f xml2marc-yaz.cfg localhost: | ||
| + | |||
| + | To test the Z39.50 server, we can use yaz-client again:< | ||
| + | yaz-client | ||
| + | Z> open localhost: | ||
| + | Connecting...OK. | ||
| + | Sent initrequest. | ||
| + | Connection accepted by v3 target. | ||
| + | ID : 81/81 | ||
| + | Name : Simple2ZOOM Universal Gateway/ | ||
| + | Version: 1.03/ | ||
| + | Options: search present delSet triggerResourceCtrl scan sort namedResultSets | ||
| + | Elapsed: 0.010718 | ||
| + | Z> format xml | ||
| + | Z> find " | ||
| + | Sent searchRequest. | ||
| + | Received SearchResponse. | ||
| + | Search was a success. | ||
| + | Number of hits: 0, setno 4 | ||
| + | records returned: 0 | ||
| + | Elapsed: 0.611432 | ||
| + | Z> find "dead zone" | ||
| + | Sent searchRequest. | ||
| + | Received SearchResponse. | ||
| + | Search was a success. | ||
| + | Number of hits: 4, setno 5 | ||
| + | records returned: 0 | ||
| + | Elapsed: 1.555461 | ||
| + | Z> show 1 | ||
| + | Sent presentRequest (1+1). | ||
| + | Records: 1 | ||
| + | []Record type: XML | ||
| + | <record xmlns:... (rest of record deliberately truncated) | ||
| + | </ | ||
| + | |||
evergreen-admin/sru_and_z39.50.txt · Last modified: 2023/07/26 11:53 by stompro