Konwerter z MAK+

Struktura pliku konfiguracji

---
mak+:
  hostname: localhost    # adres serwera DB2
  port: 50000            # numer portu serwera DB2
  protocol: TCPIP

  database: mak_c_2      # nazwa bazy danych
  uid: db2               # nazwa użytkownika bazy danych
  pwd: secret            # hasło użytkownika

  # Parametry konwertera - te wartości są domyślne, jeśli nie zostaną podane
  status.removed: 7      # status egzemplarzy usuniętych - będą one pomijane przy eksporcie
  status.discarded: 8    # status egzemplarzy ubytkowanych - będzie kontrola przy eksporcie ubytków

  # Mapowanie numerów ksiąg inwentarzowych
  map.inventory:
    622:  '5000'  # Księga inwentarzowa wypożyczalni
    623:  '5001'  # Księga inwentarzowa czytelni
    1300: '5010'  # księga inwentarzowa filii nr 1

  # Mapowanie agend
  map.agenda:
    '636+376': '00'  # Wypożyczalnia
    '636+375': '01'  # Czytelnia
    '666':     '10'  # Filia 1

---
sowasql:
  service: miasto_mbp_ks   # nazwa ISTNIEJĄCEGO serwisu w sowizorze

  parameters:
    '001': leg  # parametr 001

Mapowanie numerów ksiąg inwentarzowych

Kluczem mapowania jest identyfikator wiersza z tabeli /wiki/spaces/SOKR/pages/298423. Jego wartością musi być wyrażony jako łańcuch znaków (stąd w apostrofach) nr księgi inwentarzowej w SOWIE. Na podstawie tego mapowania zostaną utworzone odpowiednie parametry w SOWIE, a także zostaną wykorzystane do budowy numerów inwentarzowych (sn).

Można uruchomić konwerter BEZ ustawienia tego mapowania, wówczas konwerter wypisze listę identyfikatorów ksiąg inwentarzowych z MAK+ wraz z ich opisem. Na podstawie tej informacji należy odpowiednio ustawić mapowanie w pliku konfiguracji.

Mapowanie numerów agend

W MAK+ lokalizacja egzemplarza określona jest za pomocą pary kolumn: ID_BIBLIOTEKI oraz ID_DZIAL (przy czym ID_DZIAL może być puste). Zwykle ID_DZIAL rozdziela lokalizację w placówce na wypożyczalnię i czytelnię. Tam, gdzie nie ma rozdziału (np. w filii czy punkcie bibliotecznym) identyfikatora tego nie będzie. W mapowaniu - jeśli ID_DZIAL jest niepusty - wartości te są łączone znakiem +. Z tego tytułu zarówno klucze jak i wartości mapowania muszą być wyrażone jako łańcuch znaków (stąd są w apostrofach). Na podstawie tego mapowania tworzone są parametry w SOWIE i przydzielane egzemplarze do odpowiednich agend.

Ustawianie parametrów

Niektóre parametry w SOWIE muszą być ustawione zanim rozpocznie się import danych!!! Dlatego w konfiguracji systemu docelowego należy te parametry wskazać. W szczególności niezbędne jest określenie wartości parametru 001. Ważne - trzeba go wyrazić jak łańcuch znaków w apostrofach (inaczej zostanie zinterpretowany jako liczba)