Koha-community/Koha: Main Koha release repository - Koha - Koha: The world's first free and open source library system

Main Koha release repository https://koha-community.org

David Cook 1e0b890b0c Bug 10096 - Add a Z39.50 interface for authority searching This patch introduces a new Z39.50 interface for searching Z39.50 compliant databases for MARC authority records. These databases aren't as common as their bibliographic equivalents, but they're out there and very useful. I have included info at the bottom of this messsage for sample authority databases you can try. To test this patch: 1) Set up Z39.50 client targets for authority databases. (I've included information at the bottom of this message for LibrariesAustralia's test server for authorities as well as instructions on how to use your Koha's z39.50 authority server as well. The Library of Congress also has authority databases available (unsure if these are test or prod), and you might have access to others through OCLC or RLIN. OCLC provides login credentials for their test databases. 2) Go to the Authorities module 3) Click on the new "Z39.50 search button" 4) Select your authority search targets from the list. 5) Do a search for an authority you would like using either the "Raw" input box or the more specific input boxes for names, subjects, subject sub divisions, or titles. (I like searching Name (personal): Eric on the LibrariesAustralia test DB.) 6) You should see a table listing the server, heading, authority type, and two other columns (MARC and a nameless column). "Authority type" is the type of authority it will become when imported in to Koha. In the Eric example, "PERSO_NAME". 7) Click on "MARC" next to the results of interest to review the MARC authority record. 8) When you're satisfied with a record, click on "Import". 9) The pop-up window will close and your original Koha window will change to the "Adding authority Personal Name" screen (in the Eric example). 10) All the relevant fields should be filled out for the record. Review them and make any changes as necessary. (N.B. The 001 will be cleared when saved, so if you have a use for the imported control number, move it to the 010, 016, or 035 as appropriate. If you have a default value for the 003, this will also likely be overwritten. Move it if necessary. The 005 will also be updated when saved, so do not worry about that.) 11) When you're satisfied, click save. 12) Presto! You've imported your first authority record via Z39.50! -- Here is the info for the LibrariesAustralia test Z39.50 authority database: Z39.50 server: LibrariesAustralia Authorities Hostname: z3950-test.librariesaustralia.nla.gov.au Port: 210 Database: AuthTraining Userid: ANLEZ Password: z39.50 Syntax: MARC21/USMARC Encoding: utf8 - The U.S.A. Library of Congress also provides Z39.50 access to its Name and Subject Authorities (http://www.loc.gov/z3950/lcserver.html). Name Authority: Z39.50 server: Library of Congress Name Authority File Hostname: lx2.loc.gov Port: 210 Database: NAF Syntax: MARC21/USMARC Encoding: utf8 Subject Authority: Z39.50 server: Library of Congress Subject Authority File Hostname: lx2.loc.gov Port: 210 Database: SAF Syntax: MARC21/USMARC Encoding: utf8 (N.B. Both of these databases also include title authorities.) - For testing purposes, you can also set up a Z39.50 client target, which points at your own Koha instance's Z39.50 authority server. To find the hostname, go to /etc/koha-conf.xml and find the value for the <listen id="authorityserver"> element. Depending on your configuration, this could be something like the following: unix:/zebra/koha/var/run/zebradb/authoritysocket (N.B. You might be using a different scheme than unix sockets...) To find the database, scroll down to the bottom of koha-conf.xml until you reach the <config> element. Within this, look for the value of the element <authorityserver>. It should probably be "authorities". To set up this Z39.50 client target in Koha... Z39.50 server: my koha authorities Hostname: unix:/zebra/koha/var/run/zebradb/authoritysocket Port: Database: authorities Userid: Password: Syntax: MARC21/USMARC (or whichever flavour you need) Encoding: utf8 Signed-off-by: Mason James <mtj@kohaaloha.com> Bug 10096 [FOLLOW-UP] - Add a z39.50 interface for authority searching This patch adds the "recordtype" column to the "z3950servers" table. The value in this column (biblio or authority) then controls whether the z3950 server shows up in a bibliographic search (through the Acq and Cataloguing modules) or in an authority search (through the Authorities module). I also edited the z3950 management console to show this value and allow users to edit it. The default value is "biblio", since the vast majority of z3950 targets will be bibliographic. However, there is an option to add/edit a z3950 target as a source of authority records. Test Plan: 1) Apply both patches 2) Run updatedatabase.pl (after setting your KOHA_CONF and PERL5 environmental variables) 3) Use the test plan from the 1st patch N.B. Make sure that your Z39.50 client target has a Record Type of Authority, otherwise it won't display when you're doing a Z3950 search for authorities. Signed-off-by: Mason James <mtj@kohaaloha.com> Bug 10096 [FOLLOW-UP] - fix tabs/whitespace errors to pass QA Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com> Signed-off-by: Galen Charlton <gmc@esilibrary.com>		11 years ago
C4	Bug 10096 - Add a Z39.50 interface for authority searching	11 years ago
Koha	Bug 9755: (follow-up) tweak test for tag visibility in merge hash	11 years ago
OpenILS	Bug 9239 QA follow-up: remove stray debug code	11 years ago
acqui	Bug 10096 - Add a Z39.50 interface for authority searching	11 years ago
admin	Bug 10096 - Add a Z39.50 interface for authority searching	11 years ago
authorities	Bug 10096 - Add a Z39.50 interface for authority searching	11 years ago
basket	Bug 9073 - Download option from the cart should match the menu button in lists	12 years ago
catalogue	Bug 5645: improve converting simple search to Z39.50 search	11 years ago
cataloguing	Bug 10096 - Add a Z39.50 interface for authority searching	11 years ago
circ	Bug 9761: Make it possible to confirm future hold requests at checkin time	11 years ago
course_reserves	bug 8215: (followup) avoid spurious warning in Apache log	11 years ago
debian	Bug 9611: (follow-up) add libcrypt-eksblowfish-perl to debian/control	11 years ago
docs	Bug 10550: Fix database typo wthdrawn	11 years ago
errors	Housekeeping in errors scripts	14 years ago
etc	Bug 9252 - Add option to send patron's home branch in AF field	11 years ago
install_misc	Bug 8840 - [SIGNED-OFF] Patch to solve false "All dependencies installed!"	11 years ago
installer	Bug 10096 - Add a Z39.50 interface for authority searching	11 years ago
koha-tmpl	Bug 10096 - Add a Z39.50 interface for authority searching	11 years ago
labels	Bug 10527: remove disused routine C4::Branch::get_branch_code_from_name	11 years ago
members	Bug 9611: Change the password hashing algorithm from MD5 to Bcrypt	11 years ago
misc	bug 10419: (follow-up) improvements to the usage text	11 years ago
offline_circ	Bug 8220 - Allow koc uploads to go to process queue instead of being applied directly.	11 years ago
opac	Bug 9611: Change the password hashing algorithm from MD5 to Bcrypt	11 years ago
patroncards	Bug 9924: (follow-up) ensure that correct error message is displayed	11 years ago
plugins	Bug 7804 - Add Koha Plugin System - QA Followup 2	11 years ago
reports	Bug 10718: fix items with no checkouts report	11 years ago
reserve	Bug 10663: QA Followup: Typo in comment in renewscript	11 years ago
reviews	Bug 1623 - Provide view of approved comments	13 years ago
rotating_collections	Bug 9605: rotating collections permissions are wrong	11 years ago
selenium	Adding selenium tests for filterMembers	15 years ago
serials	bug 10728: fix additional log noise generated by subscription-renew.pl	11 years ago
services	Bug 7178: Acquisition item creation improvement	12 years ago
skel	Bug 7804 - Add Koha Plugin System	11 years ago
sms	Bug 2505 - Add commented use warnings where missing in the sms/ directory	14 years ago
suggestion	Bug 9307: QA Followup	11 years ago
svc	Bug 7813: (follow-up) improvements for deleting local cover images	11 years ago
t	Bug 9735: Unit tests for get_template_and_user (cookies handling)	11 years ago
tags	Bug 10730: Use DataTables on the tag review page	11 years ago
test	Bug 5449: JSON malformed in Koha - Blocker with jQuery 1.4.x	13 years ago
tmp/modified_authorities	changing DO_NOT_REMOVE to README.txt	17 years ago
tools	Bug 10601: Add a counter on batch items modifications	11 years ago
virtualshelves	Bug 7788: [SIGNED-OFF] Followup: GetShelf call in addbybiblio script corrected	12 years ago
xt	Bug 9802 - add test case to ensure man pages have correct XML	11 years ago
.htaccess	Fix file permissions: if it is not a script, it should not be executable.	14 years ago
.mailmap	7439 Mailmap for master	12 years ago
INSTALL	Bug 7759, update of install files to use background indexing (and some whitespace tidy)	12 years ago
INSTALL.debian	Bug 8092 follow-up: Add optional dependency on CHI	12 years ago
INSTALL.fedora7	Bug 7440 - Remove NoZebra vestiges	11 years ago
INSTALL.opensuse	Bug 7759, update of install files to use background indexing (and some whitespace tidy)	12 years ago
INSTALL.ubuntu	Bug 8092 follow-up: Add optional dependency on CHI	12 years ago
INSTALL.ubuntu.12.04	Bug 9267 - Ubuntu 12.04 install docs broken	11 years ago
INSTALL.ubuntu.lucid	Bug 8092 follow-up: Add optional dependency on CHI	12 years ago
LICENSE	Bug 9440 - update Koha's LICENSE file from GPL2 to GPL3	11 years ago
MANIFEST.SKIP	Bug 9546 : Updating make manifest tardist	11 years ago
Makefile.PL	Bug 10539: Followup for removing KohaTest unit tests	11 years ago
README	Bug 9440 - update Koha's LICENSE file from GPL2 to GPL3	11 years ago
README.robots	Bug 6411 add another example to README.robots	13 years ago
about.pl	Bug 10915: (QA followup) warn if cannot read history.txt	11 years ago
changelanguage.pl	Bug 6755 Problems with switching languages	13 years ago
edithelp.pl	7368 Typo in edithelp.pl warning	11 years ago
fix-perl-path.PL	installer: improvements to fix-path-perl.PL on Win32	17 years ago
help.pl	Bug 10052: QA Followup	11 years ago
install-CPAN.pl	Bug 5370: Fix all the references to koha.org	14 years ago
koha_perl_deps.pl	bug 10548: fix count of missing required dependencies by koha_perl_deps.pl	11 years ago
kohaversion.pl	Bug 9611: DBRev 3.13.00.023	11 years ago
mainpage.pl	Bug 10080 - Change system pref IndependantBranches to IndependentBranches	11 years ago
rewrite-config.PL	Bug 10712: Save missing config variables to install log	11 years ago

README

Koha is a free software integrated library system.

Koha is distributed under the GNU GPL version 3 or later.
Please read the file LICENSE for more details.

To install or upgrade Koha, please see the INSTALL file appropriate
to your platform.

Report bugs at http://bugs.koha-community.org/

Visit the Koha Project website at http://www.koha-community.org/