[Koha-bugs] [Bug 10486] Allow external Z39.50 targets to be searched from the OPAC

[bugzilla-daemon at bugs.koha-community.org]

http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10486

--- Comment #77 from Katrin Fischer <katrin.fischer at bsz-bw.de> ---
Below my notes from testing and setting this up. I have kept the
paths as they are in my installation, hopefully I didn't miss a step 
so others can get this working as well.

I am using a newer Ubuntu version, so I cheated a bit with the Apache
configuration (bug 11404).

Adding a first sign off to this - but I think we need a bit more testing
to ensure it works alright with packages.

--

Setup steps

# Add indexdata repository
sudo vi /etc/apt/sources.list.d/indexdata.list 
deb http://ftp.indexdata.dk/debian wheezy main
deb-src http://ftp.indexdata.dk/debian wheezy main

wget http://ftp.indexdata.dk/debian/indexdata.asc
sudo apt-key add indexdata.asc
sudo apt-get update

# Install pazpar2
sudo apt-get purge pazpar2
sudo apt-get install pazpar2

# Activate Pazpar2 in Koha
[copy koha-httpd.conf - keep changes for new Apache version around]

perl Makefile.PL
Install the PazPar2 configuration files? [no] yes
Keep standard settings for Pazpar2, like port 11002

make
sudo make install

[reactivate old koha-httpd.conf

# Add proxy in OPAC koha-httpd.conf
    <Proxy *>
        AddDefaultCharset off
        Order deny,allow
        Allow from all
    </Proxy>

# Change, remove xslt
<DirectoryMatch "/home/katrin/kohaclone/koha-tmpl/.*/(modules|includes)">

restart apache]

#start pazpar2 server
$ pazpar2 -f /home/katrin/koha-dev/etc/pazpar2/pazpar2.xml 

# Add external search targets in Koha
SWB: z3950n.bsz-bw.de:20210/swb MARC21 utf-8
LOC: lx2.loc.gov:210/LCDB MARC21 utf-8
BNF2: z3950.bnf.fr:2211/TOUT (Z3950/Z3950_BNF) UNIMARC

Yes, you can mix UNIMARC and MARC21, but BNF records are not always very
pretty in the result list.

# Activate system preference OPACSearchExternalTargets

Testing
- Search terms entered in simple search will be used to search in 
  the external targets as well, a message on the top of the page 
  shows the number of records found. This works
  * from simple search
  * from advanced search, only for search options, not for limits
    Other search options will be turned into a keyword search for the
    external search targets.
  * when no records were found locally
  * with local results
  * if search goes directly to detail page, external targets are not
    searched
- When looking at the search, the targets are shown to the left
  * Unchecking and checking a target will change the result list 
    accordingly
- The result list is ordered by relevance, targets are sorted together
  * Results are sorted together by relevance
  * Only up to 100 results will be retrieved per target
- When clicking on the title a modal with the record details opens
  * Links except for 856 are removed, to avoid non-working links back
  into the catalog.
- Configuration
  * If you add a branch restriction to a target, it's only visible for
    users logged in at the other libraries
  * If you have no restriction by branch, the target will always be 
    searched, even when not logged in

Enhancement ideas:
- Add a timeout like for normal targets to avoid a long wait
- Lift limit on max 100 records and make that a per target setting
- Add ability to use separate XSLT files, to adapt for weirdness in 
  MARC records returned by the targets
- Add the ability to generate links to the original target - right
  now the user is trapped in Koha. Something similar to SearchForTitleIn
  would be great, giving an option to define different kinds of 
  links with placeholders.
- Offer sort options other than relevance, like publication date

-- 
You are receiving this mail because:
You are watching all bug changes.