Ovdje se nalaze poveznice na lokalnu dokumentaciju nastalu u pojedinim ustanovama koje su implementirale i planiraju implementirati Kohu.

Za sad nudimo:

• Filozofski fakultet u Zagrebu

Pozivamo i druge ustanove da ovdje stave linkove na svoju dokumentaciju.

Tko nema vlastiti prostor (web ili wiki) za objavljivanje svoje dokumentacije, može otvoriti novi workspace na ovom wikiju.

Dubrovnik

Čemu služi MARC bibliographic framework?

Služi za konfiguraciju sučelja za unos bibliografskih podatka pri katalogizaciji --- Katalogizacija

Podržani standardi: UNIMARC i MARC21. Iskustva u HR postoje za MARC21.

Definiranje MARC predložaka ključni je proces tijekom implementacije. Prije početka rada obavezno je pokrenuti MARC Bibliographic framework test.

Omogućuje:

• difiniranje potrebnih MARC polja i potpolja
• prikaz polja u formi za unos
• definiranje default vrijednosti
• mapiranje polja u koha bazu
• korištenje alata za normiranje podataka i dodataka koji olakšavaju točan unos podataka

Upute za konfiguraciju

Koha administration -> MARC Bibliographic framework

• Koha User Manual

Zašto želimo imati iste predloške?

1. općeniti razlog - standardi

Standardizirani unos podataka olakšava razmjenu podataka

2. Koha specifičan razlog:

Mogućnost razmjene SQL upita za potrebe različitih izvještaja.

Koha wiki: http://wiki.koha.org/doku.php?id=sql_library

Sastavni dio predloška su mapiranja MARC polja u Koha bazu. U Koha bazi ne nalaze se sva MARC polja, nego samo ona koja smo mapirali.
Interne funckije u Kohi (npr. cirkulacija, reporting) odvijaju se uz pomoć podataka u Koha bazi.
Prikaz podataka nije limitiran mapiranjem, ali do verzije 3.2 nije postojala elegantna metoda za dodavanje polja za display u intranetu, pa je display u intranetu bio limitiran na polja iz baze. Od verzije 3.2 postoji Keywords to MARC mapping.

Kako importati framework?

Trebaju nam:

a) podaci koji se nalaze u tablicama:
biblio_framework
marc_tag_structure
marc_subfield_structure

b) plugini za unos podataka (value builder).

1. backup lokalnih tablica

$ mysqldump --add-drop-table -u _root_ -p_password_ koha marc_tag_structure > 2009-12-10_marc_tag_structure.sql
$ mysqldump --add-drop-table -u _root_ -p_password_ koha marc_subfield_structure > 2009-12-10_marc_subfield_structure.sql

2. download

• FFZG MARC frameworks

3. napraviti framework

Preko Koha admin sučelja:

Administration -- MARC Bibliographic framework -- New Framework

upisati Framework Code i Description

Pod frameworkcode piše se kod koji odgovra kodu frameworka koji se zeli importati.

Npr. za LIB framework preuzet s FFZG, treba upisati LIB. Description može biti bilo šta.

Ako se stavi nešto drugo pod frameworkcode onda u preuzetim fajlovima treba LIB promijeniti u to nešto drugo.

4. import podataka

mysql> LOAD DATA LOCAL INFILE '/tmp/mysql/lib-tags.csv' 
INTO TABLE marc_tag_structure
FIELDS TERMINATED BY ',' 
OPTIONALLY ENCLOSED BY '"'  
LINES TERMINATED BY '\n' ;

mysql> LOAD DATA LOCAL INFILE '/tmp/mysql/lib-subfields.csv' 
INTO TABLE marc_subfield_structure 
FIELDS TERMINATED BY ',' 
OPTIONALLY ENCLOSED BY '"'  
LINES TERMINATED BY '\n' ;

Ako nešto pođe krivo, ovo će rekreirati originalne podatke u tablicama:

$ mysql -u _root_ -p_password_ koha.marc_tag_structure < 2009-12-10_marc_tag_structure.sql
$ mysql -u _root_ -p_password_ koha.marc_subfield_structure < 2009-12-10_marc_subfield_structure.sql

5. provjeriti i promijenti default vrijednosti

Koha Administration -> MARC Bibliographic framework

Preuzeti podaci sadrže default vrijednosti koje se odnose na ustanovu iz koje su podaci za framework preuzeti.

mysql> select tagfield, tagsubfield, liblibrarian, mandatory, frameworkcode, defaultvalue from marc_subfield_structure where defaultvalue = 'HR-ZaFF' ;
+----------+-------------+-----------------------------------------------+-----------+---------------+--------------+
| tagfield | tagsubfield | liblibrarian                                  | mandatory | frameworkcode | defaultvalue |
+----------+-------------+-----------------------------------------------+-----------+---------------+--------------+
| 040      | a           | Središte koje obavlja izvornu katalogizaciju |         0 | LIB           | HR-ZaFF      | 
| 040      | c           | Središte koje transkribira zapis             |         1 | LIB           | HR-ZaFF      | 
| 040      | a           | Središte koje obavlja izvornu katalogizaciju |         0 | MIN           | HR-ZaFF      | 
| 040      | c           | Središte koje transkribira zapis             |         0 | MIN           | HR-ZaFF      | 
| 040      | a           | Središte koje obavlja izvornu katalogizaciju |         0 | OCJ           | HR-ZaFF      | 
| 040      | c           | Središte koje transkribira zapis             |         1 | OCJ           | HR-ZaFF      | 
| 040      | a           | Središte koje obavlja izvornu katalogizaciju |         0 | PER           | HR-ZaFF      | 
| 040      | c           | Središte koje transkribira zapis             |         1 | PER           | HR-ZaFF      | 
+----------+-------------+-----------------------------------------------+-----------+---------------+--------------+
8 rows in set (0.05 sec)

6. instalirati value builder

Value builder dolazi u obliku plugina. Olakšava unos podataka i osigurava točnost unesenih podataka.

Redovito se koristi za unos kodiranih podataka (polje LDR, 008, i sl), ali moguće ga je kristiti za različita druga poboljšanja forme za unos podataka.

Download: FFZG MARC frameworks plugins

Gdje se se moraju smjestiti dateteke plugina?

Template: /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/modules/cataloguing/value_builder/
Skripta: /usr/share/koha/intranet/cgi-bin/cataloguing/value_builder/

Vidi i:

• Pisanje Koha plugina

7. premapirati polja (opcionalno)

Nakon toga treba obavezno pokrenuti skriptu batchRebuildBiblioTables.pl

mglavica@koha-upgrade:/srv/koha/misc$ ./batchRebuildBiblioTables.pl -h
This script rebuilds the non-MARC DB from the MARC values.
You can/must use it when you change your mapping.

Example: you decide to map biblio.title to 200$a (it was previously mapped to 610$a).
Run this script or you will have strange results in OPAC !

Syntax:
        ./batchRebuildBiblioTables.pl -h (or without arguments => shows this screen)
        ./batchRebuildBiblioTables.pl -c (c like confirm => rebuild non marc DB (may be long)
        -t => test only, change nothing in DB

Ova skripta rekreira non-MARC DB iz MARC vrijednosti. Obavezno ju je pokreniti nakon svake promjene u mapiranju polja.
Ako se ne pokrene u OPAC-u će se pojaviti čudni rezultati.

Ova skripta će rekreirati samo polja u biblio zapisu (sve osim podataka u 952, odnosno u items tablici). Master verzija podataka o primjercima nalazi se u items tablici.

Ako nešto mijenjamo u polju 952, pokreće se skripta
maintenance/sync_items_in_marc_bib.pl

Ne pokretati ovu skriptu ako nije nužno!

mglavica@koha-upgrade:/srv/koha/misc/maintenance$ ./sync_items_in_marc_bib.pl -h
./sync_items_in_marc_bib.pl: synchronize item data embedded in MARC bibs

Replaces the item data embedded in the MARC bib 
records (for indexing) with the authoritative 
item data as stored in the items table.

If Zebra is used, run rebuild_zebra.pl -b -r after
running this script.

NOTE: this script should be run only if there is
reason to suspect that the embedded item tags are
not in sync with the items table.

Parameters:
    --run-update            run the synchronization
    --where condition       selects the biblios on a criterium (Repeatable)
    --help or -h            show this message.

8. testirati

U Admin sučelju intraneta:

• pokrenuti MARC Bibliographic framework test
• pogledati MARC links

Što ako test javi greške?

primjer:

OK      itemnum : the field itemnumber is mapped to a field in tab -1
item fields     ALL items fields MUST :

   * be mapped to the same tag,
   * and they must all be in the 10 (items) tab

OK      Only 1 MARC tag mapped to items
OK      biblioitems.itemtype defined
OK      homebranch defined
OK      holdingbranch defined
OK      at least 1 item type defined
OK      at least 1 branch defined
OK      biblionumber and biblioitemnumber mapped correctly
OK      no NULL value in frameworkcode
OK      all subfields for each tag are in the same tab (or ignored)
OK      all authority types used in the frameworks are defined
TOTAL   You have 1 error(s) in your MARC configuration. Please fix them before using Koha

Ovo će pokazati u koja MARC polja (tagfield) i potpolja (tagsubfield) su mapirana polja iz items tablice, za svaki framework.

Format broja

Odabran je 10-tero znamenkasti broj (3+7 znamenki)

III1234567

• III - zadnje tri znamenke iz broja ministarstva
• 130 - Filozofski fakultet
• 098 - Institut Ruđer Bošković
• 1234567 = oznaka primjerka

7 zmaneki omogućava omogućava 9,999,999 primjeraka po ustanovi, a troznamenkasni prefix je odabran jer Crolist već koristi dvije znamenke za ustanovu i 7 za primjerak (ukupno 9 znamenki), pa je moguće razlikovati barcode iz Crolista od barcoda iz Kohe prema broju znamenki

Barcode standardi

Nadopisati lijepi opis, a do tada, Barcode journy opisuje Dobricine eksperimente sa barcode softverom.

Iskustva sa opermom

• Zebra barcode printer