Uživatelské nástroje

Nástroje pro tento web


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/01/27 16:53] – [Nastavení SIP2 serveru] 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 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 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 =====
  
-1. Zadejte následující í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ů, idání SIP uživatelů aj.
-  $ sudo su opensrf +
-  $ cd /openils/conf +
-  $ cp oils_sip.xml.example oils_sip.xml +
  
-2Upravte soubor oils_sip.xml. Změňte komentovanou sekci <server-params> na následující:  +[[https://docs.evergreen-ils.org/docs/latest/admin/sip_server.html|Oficiální anglická dokumentace k SIP serveru Evergreenu]]
-  <server-params +
-    min_spare_servers=‚1‘ +
-    max_spare_servers='2' +
-    min_servers=‚3‘ +
-    max_servers=‚25‘ +
-  />+
  
-3. max_servers bude ímo odpovídat počtu povolených SIP klientů. Nastavte počet odpovídajícím způsobemale 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 ekročit 100 připojení SIP klienta.+===== Nastavení Evergreenu pro VerbisBox ===== 
 +Aby si čtenáři i zadání rezervaci mohli vybrat rezervaci do VerbisBoxuje potřeba rezervační box idat do struktury knihoven a poboček v nastavení Evergreenu.
  
-==== Nastavení kódování ====+[[doplnky:nastaveni_evergreenu_pro_verbisbox|]]
  
 +===== Pracovní postupy při vyřizování rezervací do VerbisBoxu =====
  
-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. +[[knihovna_jabok:vyrizovani_rezervaci_do_jaboxu|]] Dokumentace pracovních postupů Knihovny Jabok
-  - 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.+===== Manuály pro uživatele =====
  
-==== Datové typy ====+  * [[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
  
-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 
- 
- 
- 
-===== SIP2 příkazy ===== 
- 
- 
-===== Doporučené nastavení Evergreenu pro Verbisbox ===== 
- 
- 
-===== 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.1769529180.txt.gz · Poslední úprava: 2026/01/27 16:53 autor: ece