Evergreen DokuWiki CZ

Uživatelské nástroje

Nástroje pro tento web

Umístění: Dokumentační portál české komunity Evergreenu » doplnky » VerbisBox (rezervační box)
Historie: • VerbisBox (rezervační box)
doplnky:verbisbox

Rozdíly

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

Odkaz na výstup diff

Obě strany předchozí revizePředchozí verze
Následující verze		Předchozí verze
doplnky:verbisbox [2026/02/09 16:52] – [SIP2 příkazy] ecedoplnky:verbisbox [2026/02/13 13:51] (aktuální) – ece
Řádek 1: Řádek 1:
 ====== VerbisBox (rezervační box) ====== ====== 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,  
-  cd /opt +  * 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,  
-  git clone git://git.evergreen-ils.org/SIPServer.git SIPServer +  * dotaz 11 k provedení výpůjčky;  
- +
-==== Konfigurace serveru ==== +
- +
-1. Zadejte následující příkazy z příkazového řádku:  +
-  $ sudo su opensrf +
-  $ cd /openils/conf +
-  $ cp oils_sip.xml.example oils_sip.xml  +
- +
-2. 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‘ +
-  /> +
- +
-3. 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ů ===== +
-1. Do příkazového řádku zadejte následující příkazy: +
- +
-    $ sudo su opensrf +
-    $ cd /openils/conf +
- +
-2. 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. +
- +
-3. 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 +
- +
- +
-===== Cyhbný formát 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. +Dotazy protokolu SIP2 jsou k dispozici v popisu standardu:  
-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/)).+[[https://developers.exlibrisgroup.com/wp-content/uploads/2020/01/3M-Standard-Interchange-Protocol-Version-2.00.pdf|3M™ Standard Interchange Protocol (PDF, 104 kB)]] .
  
-Ř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.  +Při testování lze využít připojení na server pomocí protokolu telnet.
  
-Původní kód v řádku 415: \\ +===== SIP2 server Evergreenu =====
-//return OpenILS::SIP->format_date($date) if $date;// \\  +
-změňte na:+
  
-  return OpenILS::SIP->format_date($date, 'due') if $date;+[[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.) 
  
 +[[https://docs.evergreen-ils.org/docs/latest/admin/sip_server.html|Oficiální anglická dokumentace k SIP serveru Evergreenu]]
  
 +===== Nastavení Evergreenu pro VerbisBox =====
 +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.
  
-===== SIP2 příkazy využité pro komunikaci s výdajovým boxem =====+[[doplnky:nastaveni_evergreenu_pro_verbisbox|]]
  
-Příkazy protokolu SIP2 jsou k dispozici v popisu standardu:  +===== Pracovní postupy při vyřizování rezervací do VerbisBoxu =====
-[[https://developers.exlibrisgroup.com/wp-content/uploads/2020/01/3M-Standard-Interchange-Protocol-Version-2.00.pdf|3M™ Standard Interchange Protocol (PDF, 104 kB)]] +
  
-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;   
  
-  +[[knihovna_jabok:vyrizovani_rezervaci_do_jaboxu|]] - Dokumentace pracovních postupů Knihovny Jabok
-Při testování lze využít připojení na server pomocí protokolu telnet.+
  
 +===== 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 ===== 
  
/var/www/eg-wiki.osvobozena-knihovna.cz/data/attic/doplnky/verbisbox.1770652334.txt.gz · Poslední úprava: 2026/02/09 16:52 autor: ece