slobodni softver za podršku knjižničnom poslovanju

Dokumentacija o implementaciji Koha softvera u Knjižnici FFZG

MODULI

• Korisnici
• Cirkulacija građe
• Katalogizacija
• Katalozi
• Periodika
• Nabava

PODACI

• Konverzija podataka
• Migracija bibliografskih podataka
• Podaci na korisničkim karticama
• Greške u podacima

INTEGRACIJA S DRUGIM SUSTAVIMA

• Pregled sustava - Koha je povezana s još nekoliko softverskih sustava u Knjižnici i u matičnoj ustanovi Filozofskom fakultetu u Zagrebu
• Fotokopirni strojevi
• RFID sustav - manipulacija i zaštita
• Knjižnične Web stranice

DOKUMENTACIJA I ZAJEDNICA KORISNIKA

• pretraživanje mailing lista: http://www.google.com/cse/home?cx=012030839526267669208:c5r4yzaftug
• Koha dokumentacija i zajednica korisnika
• Prijevodi

EDUKACIJA

• UPUTE za knjižničare
• Edukacija za vrijeme implementacije

$ cd misc/translator
$ ./translate update hr-HR

$ cd misc/translator
$ ./translate install hr-HR

mysql> insert into language_descriptions (subtag,type,lang,description) values ("hr","language","hr","Hrvatski") ;

FFZG lokalne promjene

nakon preuzimanja datoteke s koha-translate stranice, treba pokrenuti:

./translate update hr-HR

nakon toga popraviti ovo u hr-HR-i-opac-t-prog-v-3006000.po

#: opac-tmpl/prog/en/modules/opac-results.tt:445
#, c-format
msgid "Available for loan:"
msgstr "Dostupno za posudbu: "

#: opac-tmpl/prog/en/xslt/MARC21slim2OPACResults.xsl:1000
#, c-format
msgid "Available for use in library: "
msgstr "Dostupno za rad u čitaonici: "

#: opac-tmpl/prog/en/modules/opac-results.tt:504
#, c-format
msgid "Log in to add tags and create lists."
msgstr "Prijavite se ako želite dodati tagove ili izraditi popis."

#: opac-tmpl/prog/en/xslt/MARC21slim2OPACDetail.xsl:515
#, c-format
msgid "Responsiblity: "
msgstr "Odgovornost: "

#: opac-tmpl/prog/en/modules/opac-detail.tt:404
#: opac-tmpl/prog/en/modules/opac-detail.tt:408
#, c-format
msgid "Tags from this library:"
msgstr "Tagovi:"

#: opac-tmpl/prog/en/modules/opac-results.tt:468
#, c-format
msgid "No items available for loan:"
msgstr "Nema slobodnih primjeraka za posudbu: "


#: opac-tmpl/prog/en/modules/opac-sendbasket.tt:5
#, c-format
msgid ""
"Hi, %s %s (%s) sent you a cart from our online catalog. Please note that the "
"attached file is a MARC bibliographic records file which can be imported "
"into a Personal Bibliographic Software like EndNote, Reference Manager or "
"ProCite. "
msgstr ""
"Pozdrav, %s %s (%s) vam šalje popis iz knjižničnog kataloga. U privitku se "
"nalaze bibliografski zapisi u MARC formatu spremni za učitavanje u osobni "
"bibliografski softver kao što je EndNote, Reference Manager ili ProCite. "

#: opac-tmpl/prog/en/modules/opac-user.tt:87
#, c-format
msgid ""
"Your account will expire on %s. If you use AAI@EduHR account please contact "
"the IT Services Department. If not, please contact the Library."
msgstr ""
"Vaš korisnički račun ističe %s. Ako koristite AAI@EduHR račun, molimo "
"kontaktirajte Službu za informatiku. Ako vaš račun nije AAI, obratite se u Knjižnicu."

pre

Upute

• MARC Bibliographic framework (Koha CUG)
• Koha User Manual

Kako napraviti export

Ako user na bazi nema potrebne ovlasti, kao root user treba prvo napraviti ovo:

mysql -u root koha
mysql>grant file on koha.* to 'kohaadmin'@'localhost';

a onda napraviti exprort:

select * into outfile '/tmp/mysql/lib-tags.csv' FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"' LINES TERMINATED BY '\n' from marc_tag_structure where frameworkcode = 'LIB' ;

select * into outfile '/tmp/mysql/lib-subfields.csv' FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"' LINES TERMINATED BY '\n' from marc_subfield_structure where frameworkcode = 'LIB' ;

Export FFZG tablica

LIB framework - Koha verzija 3.01.00.100

Koristi se za katalogizaciju knjiga

• lib-tags.csv
• lib-subfields.csv

PER framework - Koha verzija 3.01.00.145

Koristi se za katalogizaciju časopisa

• per-tags.csv
• per-subfields.csv

Plugins

FFZG MARC frameworks plugins

UPUTE SU PRESELJENE NA http://saturn.ffzg.hr/knjiznica/

OBRADA PRIMJERAKA (ITEM)

• Upute za čipiranje
• Dodavanje primjerka
• Djela sa više svezaka
• Upute za printanje naljepnica
• Izgubljeni primjerci
• Primjerci za otpis
• Primjerci za uvez

• Signiranje za OP
• Signiranje za ZS

KATALOGIZACIJA

• ORIGINALNA KATALOGIZACIJA
• DUPLICIRANJE ZAPISA - Edit as new (Duplicate)
• PREUZIMANJE ZAPISA
• Sakrivanje zapisa u javnom katalogu
• BRISANJE ZAPISA
• Spajanje zapisa

• UPUTE ZA MINIMALNI ZAPIS KNJIGE
• MARC21 upute - monografije
• MARC21 upute časopisi
• MARC21 upute analitika
• Djela u više svezaka
• Obrada diplomskih radnji, disertacija i magistarskih radnji
• Obrada nakladničkih cjelina

• Unos znakova za različite jezike
• MARC 21 tablice kodova

BARATANJE POPISIMA

• Kako dodati zapis na popis.doc

POSUDBA I KORISNICI

• Upis korisnika
• AAI korisnicki racuni
• Anonimnost korisnika
• Zaduživanje i razduživanje građe
• Pravila posudbe
• Cirkulacija časopisa
• Cirkulacija knjiga iz Zatvorenog spremišta

vidi i: UPUTE ZA KORISNIKE

Instalacija zpl printera na Windowse

Nova verzija printanja koristi Koha Spine Label printanje i zahtjeva instalaciju Zebra printera na Windowsima prema
uputama na https://github.com/dpavlin/Printer-Zebra/blob/master/README

Video instalacije

Upute za instalaciju Zebra printera / Vivainfo

Pritanje signatura zahtjeva ODBC driver za MySQL i korisnika na bazi sa kojim će se spajati program.

Nazivi korisnika:

• printer_zs - Zatvoreno spremište
• printer - svi ostali printeri, migrirati na nazive

Dodavanje korisnika u MySQL:

dpavlin@koha:~$ mysql -u root mysql

mysql> create user printer_zs identified by 'password_za_ovaj_account' ;
Query OK, 0 rows affected (0.01 sec)

mysql> grant select,insert on koha.items_print_log to 'printer_zs' ;
Query OK, 0 rows affected (0.15 sec)

mysql> grant select on koha.items to 'printer_zs' ;
Query OK, 0 rows affected (0.00 sec)

mysql> grant select on koha.biblio to 'printer_zs' ;
Query OK, 0 rows affected (0.00 sec)

Passwordi za printere nalaze se na zaštićenom wiki-ju: Zebra printer

Provjera:

mysql> select * from tables_priv ;
+------+------+------------+-----------------+----------------+---------------------+---------------+-------------+
| Host | Db   | User       | Table_name      | Grantor        | Timestamp           | Table_priv    | Column_priv |
+------+------+------------+-----------------+----------------+---------------------+---------------+-------------+
| %    | koha | printer    | items_print_log | root@localhost | 2009-03-27 12:12:17 | Select,Insert |             | 
| %    | koha | printer    | items           | root@localhost | 2009-03-27 12:14:38 | Select        |             | 
| %    | koha | printer    | biblio          | root@localhost | 2009-03-27 12:15:03 | Select        |             | 
| %    | koha | printer_zs | biblio          | root@localhost | 2010-03-09 14:26:30 | Select        |             | 
| %    | koha | printer_zs | items           | root@localhost | 2010-03-09 14:26:24 | Select        |             | 
| %    | koha | printer_zs | items_print_log | root@localhost | 2010-03-09 14:26:19 | Select,Insert |             | 
+------+------+------------+-----------------+----------------+---------------------+---------------+-------------+
6 rows in set (0.00 sec)

Stare bilješke:

Iz tablice items_print_log obnoviti podatak items.datelastseen.

POKRENE SE INSTALACIJA PRINTERA SA PrnInstZBR.exe

ODABERE SE PROIZVOÐAČ ZDesigner (jedini na lijevom spisku)
odabere se model ZDesigner S4M-203dpi ZPL

hardversko podešavanje na samom printeru

tipka menu

DARKNESS: 15,2
TEAR OFF: 0
LABEL TOP: 0
LEFT POSITION: 0
MEDIA TYPE: MARK
SENSOR SELECT: REFLECTIVE
REMOVAL: TEAR
PRINT SPEED: 4 IPS
PRINT WIDTH: 831
LENGH: AUTO
ADVANCED: SETUP 3

ponov tipka menu, save changes: yes
tipka enter

softversko podešavanje u windowsima
control panel
printers & faxes
odaberemo ZDesigner S4M-203dpi ZPL
desnim mišem i postavimo ga za default
desnim mišem i properties

na strani general kliknemo dugme printig preferences

na tabu opcije

broj kopija: 1
brzina: 10,1
zatamnjenje: 0
format papira: user defined
format papira: mjere: cm
format papira: orijentacija: portrait
veličina: širina 10,5
visina: 4,10
zona koja se NE može tiskati
lijevo: 0
desno: 0,10
gore: 0
dolje: 0

na tabu zahtjevni parametri
način rada: otkidanje
način izbacivanja: termo
Senzor: senzor trake
poravnanje
gore: 0
otkidanje: 0
lijevi pomak: 0

klik na kalibracija.

Pripreme

Na staroj produkciji pokrenuti

sync_items_in_marc_bib.pl
rebuid_zebra.pl

bibs wiht errors (corrupted)
248612
249478
250682
251126
251127
251128
253059
253170
253916
262292
268925
269096
269097
269099
269101
269102

Koha sysadmin

• uključiti Amazon covers za intranet
• XSLT za sve osim za intranet results

frameworks

leader plugin
008 plugin

Testiranje

• signature ZS

• selfcheck - cirkulacja + rezervacije

• čipiranje (što se upisuje u title nakon upisivanja podataka na čip?)

• printanje signatura

• cirkulacija

Prijevodi

• osim hrvatskog, dodati njemački, francuski, ...

1. download
2. ./translate update hr-HR
3. popraviti:
• Available for
• No items available...
• Your account will expire on
4. ./translate install

Upute za čipiranje

Obavijesti

• obavijest za web
• obavijest za knjižničare

insert into biblio (select * from deletedbiblio where biblionumber=100);
delete from deletedbiblio where biblionumber=100;
insert in to items (select * from deleteditems where biblionumber=100);
delete from deleteditems where biblionumber=100;
insert in to biblioitems (select * from deletedbiblioitems where biblionumber=100);
delete from deletedbiblioitems where biblionumber=100;

How to make new batch using mysql?

mysql> select '232' as batch_id, itemnumber as item_number, 'SRE', 'Labels' 
into outfile '/tmp/zpm-label-batch.txt' from items where homebranch = 'ZPM' 
and enumchron is null order by copynumber + 0;

mysql> load data local infile '/tmp/zpm-label-batch.txt' into table 
creator_batches (batch_id, item_number, branch_code, creator);

Dokumentacija SIP2 protokola: SIP2_3M_Standard_Interchange_Protocol_2.10.pdf

Koha SIP2 server

Koha koristi SIPServer implementaciju sa https://github.com/atz/SIPServer

SIPconfig.xml

Dodati korisničke račune za svaki selfcheck jedan

<accounts>
      <login id="sc1kat"  password="**password**" delimiter="|" error-detect="enabled" institution="FFZG" />
...

I instituciju

<institutions>
    <institution id="FFZG" implementation="ILS" parms="">
          <policy checkin="true" renewal="true" checkout="true"
                  status_update="false" offline="false"
                  timeout="100"
                  retries="5" />
    </institution>

start server

run from lib directory with

perl -IC4/SIP -MILS C4/SIP/SIPServer.pm /etc/koha/SIPconfig.xml

http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2362

Skripta za pokretanje

dpavlin@koha:/srv$ sudo ./sip2-server.sh start

syslog

SIP server zapisuje transakcije u syslog sa local6 facility:

dpavlin@koha:/var/log$ grep LOG_SIP /usr/share/koha/lib/C4/SIP/SIPServer.pm 
use constant LOG_SIP => "local6"; # Local alias for the logging facility

Da bi preusmjerili logiranje u poseban file treba dodati slijedeće u /etc/syslog.conf:

local6.*        -/var/log/sip2.log

Analiza logova

Broj različitih SIP2 poruka u našoj implementaciji

dpavlin@klin:/srv/ps-trend$ grep MSG sip.*/* | cut -d: -f6 | cut -d\' -f2 | cut -c-2 | sort | uniq -c
   6614 09
   3234 10
   7526 11
   3763 12
   4778 35
   2389 36
   4784 63
   2392 64
    828 93
    414 94
   2875 98
   5750 99

• 09 Checkin
• 10 Checkin Response

• 11 Checkout
• 12 Checkout Response

• 35 End Patron Session
• 36 End Session Response

• 63 Patron Information
• 64 Patron Information Response

• 93 Login
• 94 Login Response

• 98 ACS Status
• 99 SC Status

3M SIP emulator

3M self check emulator kako iskonfigurirati
0d 00 ne radi
0d 0A radi

Popravak za taj problem sa SIP2 server strane

Putty tunnel

Konfiguracija

C:\Program Files\3M Library Systems\3M SIP2 Development Kit\SC_Emulator

Jedina stvarno bitna promjena je:

[COM]
com_type = sockets

[TCP/IP]
ip_address = 127.0.0.1
host_name =
tcp_port = 6001

Pokretanje pod wine-om

dpavlin@klin:/virtual/win$ sudo mount kvm-winxp.img /mnt/usb/ -o loop,offset=`expr 63 \* 512`,uid=dpavlin -t ntfs
dpavlin@klin:/virtual/win$ wine /mnt/usb/Program\ Files/3M\ Library\ Systems/3M\ SIP2\ Development\ Kit/Program/SCEmul.exe

Skripta za pokretanje: SC_Emulator.sh - provjerava da li je SIP server startan i povezuje se na njega

KOHA lokalne promjene

u našem git-u

BUGS

• #250: SIP2 output encoding
• 01-PatInfo.scs
• #400: Selfcheck konfiguracija
• #408: sip2: issuingrules.finedays nedostaje

Nova implementacija

https://github.com/dpavlin/Biblio-SIP2

Primjer korištenja:

dpavlin@klin:~/klin/Net-SIP2-Simple$ ACS=10.60.0.252:6001 ./sc-emulator.pl