Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- doplnky:verbisbox [2026/02/09 16:39] – [Spuštění serveru] ece
+++ doplnky:verbisbox [2026/02/13 13:51] (aktuální) – ece
@@ Řádek 1: / Řádek 1: @@
 ====== VerbisBox (rezervační box) ======
-===== Instalace SIP serveru =====
-V této části najdete stručný popis k instalaaci SIP serveru Evergreenu
+VerbisBox je jedním z typů rezervačních boxů v českém prostředí, které v propojení s knihovním systémem slouží zejména k samoobslužnému vyzvedávání rezervovaných knih čtenáři. Jakmile jsou knihy pro čtenáře připraveny v boxu, dostane čtenář e-mail s PINem, pomocí kterého objednané knihy vyzvedne. Při vyzvednutí z boxu se knihy automaticky zapíší do čtenářského konta jako vypůjčené.
+===== Propojení Evergreenu s VerbisBoxem =====
-==== Zdrojový kód SIP serveru ====
-Aktuální kód serveru SIP se nachází v repozitáři Evergreen git:
+Propojení VerbisBoxu s Evergreenem je realizováno prostřednictvím protokolu SIP2. Komunikaci s boxem zajišťuje SIP server Evergreenu. Hlavními používanými dotazy SIP2 při komunikaci výdajového boxu s Evergreen jsou
+  * dotaz 17 ke zjištění údajů o exempláři,
+  * dotazy 09((S ohledem na využití dotazu 09 je vhodné, aby byl výdejní box nastaven jako podřazená organizační jednotka knihovny, nikoliv jako organizační jednotka stejné úrovně jako knihovna.)) a 63 ke zjištění údajů o čtenáři,
+  * dotaz 11 k provedení výpůjčky;
+Dotazy protokolu SIP2 jsou k dispozici v popisu standardu:
+[[https://developers.exlibrisgroup.com/wp-content/uploads/2020/01/3M-Standard-Interchange-Protocol-Version-2.00.pdf|3M™ Standard Interchange Protocol (PDF, 104 kB)]] .
-  cd /opt
+Při testování lze využít připojení na server pomocí protokolu telnet.
-  git clone git://git.evergreen-ils.org/SIPServer.git SIPServer
-==== Konfigurace serveru ====
+===== SIP2 server Evergreenu =====
-. Zadejte následující příkazy z příkazového řádku:
+[[doplnky:sip2_server|Instalace a zprovoznění SIP serveru]] (informace k instalaci a konfiguraci SIP serveru, nastavení kódovaní a datových typů, přidání SIP uživatelů aj.)
-  $ sudo su opensrf
-  $ cd /openils/conf
-  $ cp oils_sip.xml.example oils_sip.xml
-. Upravte soubor oils_sip.xml. Změňte komentovanou sekci <server-params> na následující:
-  <server-params
-    min_spare_servers=‚1‘
-    max_spare_servers='2'
-    min_servers=‚3‘
-    max_servers=‚25‘
-  />
-. max_servers bude přímo odpovídat počtu povolených SIP klientů. Nastavte počet odpovídajícím způsobem, ale mějte na paměti, že příliš mnoho připojení může vyčerpat paměť. Na serveru s 4 GB RAM/4 CPU (na kterém také může běžet Evergreen) se nedoporučuje překročit 100 připojení SIP klienta.
-==== Nastavení kódování ====
-SIPServer vyhledávání informace o kódování na následujících místech:
-  - Atribut kódování v prvku účtu pro aktuálně aktivní účet SIP.
-  - Prvek kódování, který je podřízeným prvkem prvku instituce aktuálně aktivního účtu SIP.
-  - Prvek kódování, který je podřízeným prvkem prvku implementation_config, který je sám podřízeným prvkem prvku instituce aktuálně aktivního účtu SIP.
-  - Pokud nic z výše uvedenéo není k dispozici, použije se výchozí kódování (ASCII).
-Možnost 3 je starší možnost. Doporučujeme změnit konfiguraci tak, aby byl tento prvek přesunut z prvku implementation_config do nadřazeného prvku institution. V ideálním případě by SIPServer v konfiguraci implementace neměl hledat a mělo by být možné tuto kontrolu v budoucnu odstranit.
-==== Datové typy ====
-Nastavení msg64_hold_datatype je podobné nastavení msg64_summary_datatype, ale ovlivňuje rezervace namísto výpůjček. Pokud je nastaveno na čárový kód, budou informace o rezervacích  pro požadavky na informace o čtenářích doručeny jako sada čárových kódů exemplářů namísto řetězců názvů titulů. Pomocí čárových kódů mohou SIP klienti SIP nejen získat řetězce názvů pro zobrazení (prostřednictvím požadavků na informace o jednotkách) a také následně vykonat požadavky na akce související s rezervacemi, jako je zrušení rezervace.
-===== Přidání SIP uživatelů =====
-. Do příkazového řádku zadejte následující příkazy:
-    $ sudo su opensrf
-    $ cd /openils/conf
-. V sekci <accounts> zadejte přihlašovací údaje klienta SIP. Ujistěte se, že všechny <logins> používají stejný atribut instituce a že instituce je uvedena v <institutions>. Všechny atributy v sekci <login> budou použity SIP klientem.
-. V Evergreenu vytvořte novou skupinu profilů s názvem SIP. Tato skupina by měla být podskupinou Users (Uživatelé), nikoliv Staff (Personál)  nebo Patrons (Čtenáři). Nastavte editační oprávnění na group_application.user.sip_client a přidělte skupině následující oprávnění:
-COPY_CHECKIN
-COPY_CHECKOUT
-    CREATE_PAYMENT
-    RENEW_CIRC
-    VIEW_CIRCULATIONS
-    VIEW_COPY_CHECKOUT_HISTORY
-    VIEW_PERMIT_CHECKOUT
-    VIEW_USER
-    VIEW_USER_FINES_SUMMARY
-    VIEW_USER_TRANSACTIONS
-    CANCEL_HOLDS
-Alternativně můžete použít použijte SQL:
-<code>
-INSERT INTO permission.grp_tree (name,parent,description,application_perm)
-VALUES ('SIP', 1, 'SIP2 Client Systems', 'group_application.user.sip_client');
-INSERT INTO
-  permission.grp_perm_map (grp, perm, depth, grantable)
-SELECT
-  g.id, p.id, 0, FALSE
-FROM
-  permission.grp_tree g,
-  permission.perm_list p
-WHERE
-  g.name = 'SIP' AND
-  p.code IN (
-    'COPY_CHECKIN',
-    'COPY_CHECKOUT',
-    'RENEW_CIRC',
-    'VIEW_CIRCULATIONS',
-    'VIEW_COPY_CHECKOUT_HISTORY',
-    'VIEW_PERMIT_CHECKOUT',
-    'VIEW_USER',
-    'VIEW_USER_FINES_SUMMARY',
-    'VIEW_USER_TRANSACTIONS',
-    'CANCEL_HOLDS'
-  );
-  </code>
-Kontrola nastavení pomocí SQL:
-    SELECT *
-    FROM permission.grp_perm_map pgpm
-      INNER JOIN permission.perm_list ppl ON pgpm.perm = ppl.id
-      INNER JOIN permission.grp_tree pgt ON pgt.id = pgpm.grp
-    WHERE pgt.name = ‚SIP‘;
-Pro každý účet vytvořený v sekci <login> souboru oils_sip.xml vytvořte uživatele (pomocí editoru uživatelů klienta staff) se stejným uživatelským jménem a heslem a zařaďte tohoto uživatele do skupiny SIP.
-<WRAP center  important>
-Datum vypršení platnosti ovlivní připojení uživatelů SIP, proto si jej raději někde poznamenejte.
-</WRAP>
-===== Spuštění serveru =====
-Chcete-li spustit server SIP, zadejte do příkazového řádku následující příkazy:
-  $ sudo su opensrf
-  $ oils_ctl.sh -a [start|stop|restart]_sip
-====== Oprava formátu data SIP serveru ve verzi 3.13 ======
-V současné době se v Evergreenu vyskytuje chyba formátu data, která může ovlivnit fungování rezervačního boxu.
-Při žádosti o informace o jednotce (žádost 17 v terminologii protokolu SIP), je vrácena  odpověď 18, ta však obsahuje hodnotu pole CM (datum vyzvednutí) ve formátu RRRRMMDD, který neodpovídá standardu SIP2. ((Podrobnosti jsou k dispozici v e-mailové konferenci Evergreenu: https://list.evergreen-ils.org/archives/list/evergreen-general@list.evergreen-ils.org/thread/V4RKKOGBPN46BKKJVMU7XSEK4ACLQH52/, zpráva od Joshe Stompro obsahuje možné řešení této chyby: https://list.evergreen-ils.org/archives/list/evergreen-general@list.evergreen-ils.org/message/SMRLKJUGQ7JXRG4QBHUCJ6M5VXSCNKH6/)).
-Řešením této chyby je změna nastavení formátu data v souboru  /usr/local/share/perl/5.36.0/OpenILS/SIP/Item.pm.
+[[https://docs.evergreen-ils.org/docs/latest/admin/sip_server.html|Oficiální anglická dokumentace k SIP serveru Evergreenu]]
-Původní kód v řádku 415: \\
+===== Nastavení Evergreenu pro VerbisBox =====
-//return OpenILS::SIP->format_date($date) if $date;// \\
+Aby si čtenáři při zadání rezervaci mohli vybrat rezervaci do VerbisBoxu, je potřeba rezervační box přidat do struktury knihoven a poboček v nastavení Evergreenu.
-změňte na:
-  return OpenILS::SIP->format_date($date, 'due') if $date;
+[[doplnky:nastaveni_evergreenu_pro_verbisbox|]]
+===== Pracovní postupy při vyřizování rezervací do VerbisBoxu =====
-===== SIP2 příkazy =====
+[[knihovna_jabok:vyrizovani_rezervaci_do_jaboxu|]] - Dokumentace pracovních postupů Knihovny Jabok
+===== Manuály pro uživatele =====
-===== Doporučené nastavení Evergreenu pro Verbisbox =====
+  * [[https://knihovna.jabok.cz/cs/rady-navody/navody/chci-si-rezervovatobjednat-knihy-do-rezervacniho-boxu|Chci si rezervovat/objednat knihy do rezervačního boxu]] - Návod pro čtenáře na objednání rezervace do JABoxu
+  * [[https://youtu.be/q8MsbvUts7c?si=N2uvjZ-n8X0TW1Fi|Rezervace knih do rezervačního boxu Knihovny Jabok]] - Videonávod pro čtenáře Knihovny Jabok
-===== Možné postupy pro rezervace a půjčování ve VerbisBoxu v Evergreenu =====