From 25df10e4d84aee069c795f4d02a73a9fee2da7c8 Mon Sep 17 00:00:00 2001 From: Marcel de Rooy Date: Tue, 26 Aug 2014 17:06:57 +0200 Subject: [PATCH] Bug 12828: Update Z39.50/SRU online help MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Test plan: Go to Z39.50/SRU servers, click Help and read the text. Signed-off-by: Marc Véron Signed-off-by: Katrin Fischer Additions to help file, no problems found. Signed-off-by: Tomas Cohen Arazi --- .../en/modules/help/admin/z3950servers.tt | 51 ++++++++++++------- 1 file changed, 34 insertions(+), 17 deletions(-) diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt b/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt index ad5829ff92..e73058eb66 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt @@ -1,35 +1,52 @@ [% INCLUDE 'help-top.inc' %] -

Z39.50 Servers

+

Z39.50/SRU Servers

-

Z39.50 is a client–server protocol for searching and retrieving information from remote computer databases, in short it's a tool used for copy cataloging. Using Koha you can connect to any Z39.50 target that is publicly available or that you have the log in information to and copy both bibliographic and/or authority records from that source.

+

Z39.50 and SRU are client–server protocols for searching and retrieving information from remote computer databases, in short tools used for copy cataloging. Using Koha you can connect to any Z39.50/SRU target that is publicly available or that you have the log in information to and copy both bibliographic and/or authority records from that source. (Note that not all SRU targets will offer bibliographic information in MARC format.)

-

Koha comes with a default list of Z39.50 targets set up that you can add to, edit or delete

+

Koha comes with a default list of Z39.50/SRU targets set up that you can add to, edit or delete.

-

To find additional targets you use IndexData's IRSpy: http://irspy.indexdata.com

+

To find additional targets you use IndexData's IRSpy: http://irspy.indexdata.com.

-

Add a Z39.50 Target

+

Add a Z39.50/SRU Target

+

From the main Z39.50/SRU page, click 'New Z39.50 Server' or 'New SRU server'.

    -
  • From the main Z39.50 page, click 'New Z39.50 Server' -
      -
    • 'Z39.50 server' should be populated with a name that will help you identify the source (such as the library name).
      • -
    • 'Hostname' will be the address to the Z39.50 target.
      • +
    • 'Server name' should be populated with a name that will help you identify the source (such as the library name).
      • +
    • 'Hostname' will be the address to the Z39.50 target. For a SRU target, only enter the domain name here. (See example below.)
    • 'Port' tells Koha what port to listen on to get results from this target.
      • +
    • 'Database' is the name of the database for Z39.50 targets. For SRU targets enter the path name part of the URL (the local part following domain and port). See also example below.
    • 'Userid' and 'Password' are only required for servers that are password protected.
    • Check the 'Checked' box if you want this target to always be selected by default.
      • -
    • 'Rank' lets you enter where in the list you'd like this target to appear. -
        -
      • If this is left blank the targets will be in alphabetical order.
        • -
      -
      • +
    • 'Rank' lets you enter where in the list you'd like this target to appear. If this is left blank the targets will be in alphabetical order.
    • 'Syntax' is the MARC flavor you use.
    • 'Encoding' tells the system how to read special characters.
    • 'Timeout' is helpful for targets that take a long while. You can set the timeout so that it doesn't keep trying the target if results aren't found in a reasonable amount of time.
    • 'Record type' lets you define if this is a bibliographic or an authority target.
      • +
    • 'Additional SRU options': You can enter additional options of the external server here, like sru_version=1.1 or schema=marc21, etc. Note that these options are server dependent.
      • +
    • 'SRU Search field mapping': Click on Modify to add or update the mapping from the available fields on the Koha search form to the specific server dependent index names. For instance, a SRU server could use 'cql.anywhere' for the Any field on the Koha form. If you do not enter an index name for a specific search field, the whole record will be searched.
      • +
    • 'XSLT file(s)': You can enter here one or more XSLT file names that you want to apply on the search results.
    -
    • -
+ +

SRU example

+

If you want to enter the Library of Congress SRU server, you should at least use the following information. The full URL http://lx2.loc.gov:210/LCDB must be entered as follows:

+ + + + + + +
Hostlx2.loc.gov
Port210
DatabaseLCDB
SyntaxMARC21/USMARC
Encodingutf8
+

To further refine your searches, you could add the following index names to the SRU search field mappings. To do this, edit the server and click the Modify button next to this field.

+ + + + + + + + +
Titledc.title
ISBNbath.isbn
Anycql.anywhere
Authordc.author
ISSNbath.issn
Subjectdc.subject
Standard IDbath.standardIdentifier

Suggested Bibliographic Z39.50 Targets

@@ -58,6 +75,6 @@
  • LIBRARY OF CONGRESS NAME AUTHORITIES lx2.loc.gov:210 NAF
  • LIBRARY OF CONGRESS SUBJECT AUTHORITIES lx2.loc.gov:210 SAF
    • -

    See the full documentation for Z39.50 Servers in the manual (online).

    +

    See the full documentation for Z39.50/SRU Servers in the manual (online).

    [% INCLUDE 'help-bottom.inc' %] -- 2.39.5