View | Details | Raw Unified | Return to bug 12828
Collapse All | Expand All

(-)a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt (-18 / +34 lines)
Lines 1-35 Link Here
1
[% INCLUDE 'help-top.inc' %]
1
[% INCLUDE 'help-top.inc' %]
2
2
3
<h1>Z39.50 Servers</h1>
3
<h1>Z39.50/SRU Servers</h1>
4
4
5
<p>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.</p>
5
<p>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.)</p>
6
6
7
<p>Koha comes with a default list of Z39.50 targets set up that you can add to, edit or delete</p>
7
<p>Koha comes with a default list of Z39.50/SRU targets set up that you can add to, edit or delete.</p>
8
8
9
<p>To find additional targets you use IndexData's IRSpy: <a href="http://irspy.indexdata.com/" target="_top">http://irspy.indexdata.com</a></p>
9
<p>To find additional targets you use IndexData's IRSpy: <a href="http://irspy.indexdata.com/" target="_top">http://irspy.indexdata.com.</a></p>
10
10
11
<h2>Add a Z39.50 Target</h2>
11
<h2>Add a Z39.50/SRU Target</h2>
12
12
13
<p>From the main Z39.50/SRU page, click 'New Z39.50 Server' or 'New SRU server'.</p>
13
<ul>
14
<ul>
14
	<li>From the main Z39.50 page, click 'New Z39.50 Server'
15
    <li>'Server name' should be populated with a name that will help you identify the source (such as the library name).</li>
15
<ul>
16
    <li>'Hostname' will be the address to the Z39.50 target. For a SRU target, only enter the domain name here. (See example below.)</li>
16
	<li>'Z39.50 server' should be populated with a name that will help you identify the source (such as the library name).</li>
17
	<li>'Hostname' will be the address to the Z39.50 target.</li>
18
	<li>'Port' tells Koha what port to listen on to get results from this target.</li>
17
	<li>'Port' tells Koha what port to listen on to get results from this target.</li>
18
    <li>'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.</li>
19
	<li>'Userid' and 'Password' are only required for servers that are password protected.</li>
19
	<li>'Userid' and 'Password' are only required for servers that are password protected.</li>
20
	<li>Check the 'Checked' box if you want this target to always be selected by default.</li>
20
	<li>Check the 'Checked' box if you want this target to always be selected by default.</li>
21
	<li>'Rank' lets you enter where in the list you'd like this target to appear.
21
    <li>'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.</li>
22
<ul>
23
	<li>If this is left blank the targets will be in alphabetical order.</li>
24
</ul>
25
</li>
26
	<li>'Syntax' is the MARC flavor you use.</li>
22
	<li>'Syntax' is the MARC flavor you use.</li>
27
	<li>'Encoding' tells the system how to read special characters.</li>
23
	<li>'Encoding' tells the system how to read special characters.</li>
28
	<li>'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.</li>
24
	<li>'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.</li>
29
	<li>'Record type' lets you define if this is a bibliographic or an authority target.</li>
25
	<li>'Record type' lets you define if this is a bibliographic or an authority target.</li>
26
    <li>'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.</li>
27
    <li>'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.</li>
28
    <li>'XSLT file(s)': You can enter here one or more XSLT file names that you want to apply on the search results.</li>
30
</ul>
29
</ul>
31
</li>
30
32
</ul>
31
<h2>SRU example</h2>
32
<p>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:</p>
33
<table>
34
<tr><td>Host</td><td>lx2.loc.gov</td></tr>
35
<tr><td>Port</td><td>210</td></tr>
36
<tr><td>Database</td><td>LCDB</td></tr>
37
<tr><td>Syntax</td><td>MARC21/USMARC</td></tr>
38
<tr><td>Encoding</td><td>utf8</td></tr>
39
</table>
40
<p>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.</p>
41
<table>
42
<tr><td>Title</td><td>dc.title</td></tr>
43
<tr><td>ISBN</td><td>bath.isbn</td></tr>
44
<tr><td>Any</td><td>cql.anywhere</td></tr>
45
<tr><td>Author</td><td>dc.author</td></tr>
46
<tr><td>ISSN</td><td>bath.issn</td></tr>
47
<tr><td>Subject</td><td>dc.subject</td></tr>
48
<tr><td>Standard ID</td><td>bath.standardIdentifier</td></tr>
49
</table>
33
50
34
<h2>Suggested Bibliographic Z39.50 Targets</h2>
51
<h2>Suggested Bibliographic Z39.50 Targets</h2>
35
52
Lines 58-63 Link Here
58
	<li>LIBRARY OF CONGRESS NAME AUTHORITIES lx2.loc.gov:210 NAF</li>
75
	<li>LIBRARY OF CONGRESS NAME AUTHORITIES lx2.loc.gov:210 NAF</li>
59
	<li>LIBRARY OF CONGRESS SUBJECT AUTHORITIES lx2.loc.gov:210 SAF</li>
76
	<li>LIBRARY OF CONGRESS SUBJECT AUTHORITIES lx2.loc.gov:210 SAF</li>
60
</ul>
77
</ul>
61
<p><strong>See the full documentation for Z39.50 Servers in the <a href="http://manual.koha-community.org/[% helpVersion %]/en/additionaladmin.html#z3950admin">manual</a> (online).</strong></p>
78
<p><strong>See the full documentation for Z39.50/SRU Servers in the <a href="http://manual.koha-community.org/[% helpVersion %]/en/additionaladmin.html#z3950admin">manual</a> (online).</strong></p>
62
79
63
[% INCLUDE 'help-bottom.inc' %]
80
[% INCLUDE 'help-bottom.inc' %]
64
- 

Return to bug 12828