Author: [see doc]
Document comments: generated by HTML::FormatRTFWithImages (v?, using HTML::TreeBuilder v3.130, and HTML::Parser v3.55)

Contents: [Koha Croatian user group]
• Koha Croatian user group (Čemu služi MARC bibliographic framework?) 
• Koha Croatian user group (Upute za konfiguraciju) 
• Koha Croatian user group (Zašto želimo imati iste predloške?) 
• Koha Croatian user group (Kako importati framework?) 
• Koha Croatian user group (1. backup lokalnih tablica) 
• Koha Croatian user group (2. download) 
• Koha Croatian user group (3. napraviti framework) 
• Koha Croatian user group (4. import podataka) 
• Koha Croatian user group (5. provjeriti i promijenti default vrijednosti) 
• Koha Croatian user group (6. instalirati value builder) 
• Koha Croatian user group (7. premapirati polja (opcionalno)) 
• Koha Croatian user group (8. testirati) 
• Koha Croatian user group (Što ako test javi greške?)

Č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.