website/koha.txt

   1 h1. Using Koha with zcc
   2
   3 "Koha":http://www.koha.org + "zcc":wzcc
   4
   5 h2. Hints
   6
   7 # Follow all the directions on the "main zcc page":wzcc carefully. Please let me know if you run into problems with configuration.
   8
   9 # "zcc":wzcc is *not* a part of Koha and is not developed by the same folks.
  10
  11 # "zcc":wzcc only creates utf-8 encoded records. If you want MARC-8 encoded records you're on your own. MARC-8 encoding has already caused enough problems in this world, so I encourage folks to move to UTF-8 ASAP. If you use a different encoding that you want supported, please let me know. To set up Koha properly for dealing with UTF-8 encoded records see "this wiki page":http://wiki.koha.org/doku.php?id=encodingscratchpad&s=utf8
  12
  13 # ZCC currently only works with a default install as paths are hardcoded. If there's a need I'll make it configurable for someone. Make sure the Koha modules are a part of your path. I accomplish this by adding "export PERL5LIB=/usr/local/koha/intranet/modules" and "export KOHA_CONF=/etc/koha.conf" without the quotes to my .bashrc (or add the path to /etc/profile for the root user). If your paths differ from the preceding saving to Koha will not work.
  14
  15 # You can then have 3 choices on how to get the records into koha:
  16
  17   * Using the Koha Administration interface you can "Upload MARC records to the resevoir." Then complete processing on the records like adding items and barcodes within the Koha web interface. The resevoir may strip out some fields that usually hold local content.
  18
  19   * If you have processed your records fully to include item numbers and barcodes, you can use the bulkmarcimport script to put the records directly into your database.  I've used bulkmarcimport without modification without problem. You may have different results and I'd like to hear them.
  20
  21   <pre syntax="ruby">perl
  22   /usr/local/koha/intranet/scripts/misc/migration_tools/bulkmarcimport.pl -v -file
  23   /path/to/marc-file.mrc</pre>
  24
  25   That is all one line.
  26
  27   * Or configure the save_record_syntax of your zcc.yaml file to 'koha2'.  If this gives you errors make sure you have exported environment variables with: "export -p". You may also need to change the permissions on /etc/koha.conf to allow all users to view the file. If you get errors you can (though it might not be the best solution) do the following as root:
  28
  29   <pre>chmod 644 /etc/koha.conf</pre>
  30
  31 h1. Contact
  32
  33 I use ZCC and Koha for my own work. So I'm very interested in making ZCC work better with Koha. Please send your comments, suggestions and patches to "Jason Ronallo":mailto:jronallo+zcc@gmail.com
  34
  35 [wzcc]http://zcc.rubyforge.org/zcc.html