TinWeb. příručka správce systému k verzi 11

TinWeb příručka správce systému k verzi 11

Květen 2004

TinWeb v.11 – příručka správce systému

Obsah 1. Úvod ........................................................................................................................................................... 1 2. Hlavní konfigurační soubor TinWebu - tw.run ......................................................................................... 1 2.1. Nastavení databáze T Series, cesty k souborům, základní nastavení ........................................... 1 2.1.1. DATA_PATH ................................................................................................................................ 1 2.1.2. BLOCK_SIZE ............................................................................................................................... 1 2.1.3 OWN_DATABASE ........................................................................................................................ 1 2.1.4 CONFIG_FILES_PATH ................................................................................................................ 2 2.1.5 PICS_PATH .................................................................................................................................. 2 2.1.6 SESSION_PATH .......................................................................................................................... 2 2.1.7 SEL_LIB, SEL_LIB_GROUP........................................................................................................ 2 2.2. Nastavení vstupního formuláře TinWebu, vzhled úvodní stránky a hlavičky ................................. 3 2.2.1. LANG_XX ..................................................................................................................................... 3 2.2.2. TITLE_XX ..................................................................................................................................... 3 2.2.3. ADMIN_MAIL, ADMIN_MAILER ................................................................................................. 3 2.2.4. SID_TIMER .................................................................................................................................. 4 2.2.5. LIST_XX ....................................................................................................................................... 4 2.2.6. SEARCH_WHAT_XX .................................................................................................................. 4 2.2.7. SEARCH_WHERE_XX ............................................................................................................... 5 2.2.8. PARALEL ..................................................................................................................................... 5 2.2.9. GOOGLE_BUTTON .................................................................................................................... 5 2.3. Výpůjčka – prodlužování a rezervace dokumentů ........................................................................... 6 2.3.1. REZXXX ....................................................................................................................................... 6 2.3.2. REZ_IF_ON_RACK ..................................................................................................................... 6 2.3.3. REZ_IF_PENALTY ...................................................................................................................... 6 2.3.4. REZ_IF_INVALID_CARD............................................................................................................ 6 2.3.5. REZ_IF_NO_LOCATION ............................................................................................................ 6 2.3.6. REZ_TRANSPORT_DOCUMENT ............................................................................................. 6 2.3.7. REZ_ACCESS_NO ..................................................................................................................... 6 2.3.8. REZ_BRANCH_CHOICE ............................................................................................................ 7 2.3.9. REZ_MAILTO............................................................................................................................... 7 2.3.10. REZ_EXPORT_PATH ............................................................................................................... 7 2.3.11. REZ_IMPORT_SCRIPT ............................................................................................................ 7 2.3.12. LOAN_VIEW .............................................................................................................................. 7 2.3.13. LOAN_EXTENSION .................................................................................................................. 7 2.3.14. LOAN_EXPORT_PATH ............................................................................................................ 7 2.3.15. LOAN_IMPORT_SCRIPT ......................................................................................................... 7 2.3.16. TINEHOST_LOCK..................................................................................................................... 7 2.3.17. HOST_ONLINE.......................................................................................................................... 8 2.3.18. LOG_FILE .................................................................................................................................. 8 2.4. Základní rysy a funkce TinWebu ....................................................................................................... 8 2.4.1. DOC_BASE.................................................................................................................................. 8 2.4.2. L .................................................................................................................................................... 8 2.4.3. SID_TIMEOUT ............................................................................................................................. 9 2.4.4. MAX_SESSION ........................................................................................................................... 9 2.4.5. DEF_SORT .................................................................................................................................. 9 2.4.6. TIMEOUT_CONNECT................................................................................................................. 9 2.4.7. TIMEOUT_READ ......................................................................................................................... 9 2.4.8. VIEW_DISABLED_RECS ........................................................................................................... 9 2.4.9. DEFAULT_PASSWORD ........................................................................................................... 10 2.5. Propojení TinWebu se systémy Metalib a SFX .............................................................................. 10 2.5.1. SFX_PREFFIX, SFX_DNAME, SFX_SUFFIX......................................................................... 10 2.5.2. ML_QUERY_ID, ML_QUERY_ID_VAL, ML_OUTPUT_MIME_TYPE................................... 11 2.5.3. Paramtry ML_BOOK, ML_PRM_nn.......................................................................................... 12 2.5.3. Odpovědi TinWebu na dotazy od Metalibu – XML formát ...................................................... 12 Strana i

TinWeb v.11 – příručka správce systému 3. Definice polí a podmínek pro listování – popis souboru „list-tag.twb“.................................................. 13 4. Definice polí a podmínek pro slovníky – popis souboru „dict-tag.twb“ ................................................ 15 5. Definice polí a podmínek pro vyhledávání – popis souboru „title-tag.twb“ .......................................... 16 6. Nastavení zobrazování podrobností u seznamu záznamů - Popis souboru „listing.ext“.................... 18 7. Nastavení zobrazování podrobností v zobrazeném záznamu ............................................................. 20 7.1 Popis souborů labels.*....................................................................................................................... 20 7.2 Popis souboru „record.ext“................................................................................................................ 22 7.3 Popis souboru doc-stat.twb............................................................................................................... 23 8. Řazení vyhledaných záznamů – popis souboru „sort-tag.twb“ ............................................................ 24 9. Textové zprávy, popisy tlačítek, menu – popis souboru „texts.twb“ .................................................... 25 10. Definice prohledávaných databází – popis souboru libs.twb a libsldef.twb....................................... 25 10.1. Soubor „libs.twb“ ............................................................................................................................. 25 10.2. Soubor „libsldef.twb“....................................................................................................................... 26 11. Externí informace o lokacích dokumentů – soubor „location.twb“ ..................................................... 27 12. Přidávání vlastních odkazů na liště nástrojů – soubor „extrnfn.twb“.................................................. 28 13. Interaktivní služby TinWebu - prodlužování výpůjčky a rezervace dokumentů ................................ 29 Příloha A – seznam všech konfiguračních souborů .................................................................................. 31

Strana ii


1. Úvod Program TinWeb je spouštěn WWW serverem jako CGI script. Pouští se souborem tw (na unixových systémech) nebo tw.exe (na systémech Microsoft). TinWeb svou činnost řídí konfiguračními soubory, jejichž popis je hlavní náplní tohoto dokumentu. Editací těchto souborů se nastavují všechny parametrizovatelné rysy TinWebu. Nejdůležitějším konfiguračním souborem je tw.run. Tento soubor musí být umístěn ve stejném adresáři jako hlavní spouštěcí soubor (tw, nebo tw.exe). TinWeb pracuje s datovými soubory T Series. Tyto soubory se podle okolností mohou jmenovat fixit050.*, ufixit050.*, ubfixit050.* atp. (viz dokumentace k T Series), kde znak '*' (hvězdička) je třímístné dekadické číslo. V dalším textu je na tyto soubory odkazováno jako fixit č. nnn. Všechny textové výstupy TinWebu a stejně tak všechny texty v konfiguračních souborech od verze 11 jsou kódovány v UTF-8. Pro editaci konfiguračních souborů je tedy nutné používat editor, který znaky s hodnotou větší než 127 ukládá jako vícebytové znaky v kódování UTF-8. Pro správný převod všech textových řetězců uložených v databázi T Series v 8-bitovém kódování do kódování UTF-8 slouží převodní tabulka uložená v souboru encoding.twb (soubor je součástí distribuce TinWebu). V současných českých a slovenských verzích T Series jsou data uložená v kódování CP852. U jiných jazykových mutací T Series, nebo pokud by v budoucnu došlo ke změně kódování dat, stačí vyměnit, nebo editovat soubor encoding.twb .

2. Hlavní konfigurační soubor TinWebu - tw.run Soubor tw.run obsahuje parametry TinWebu ve formátu <parametr>=. Znak ‘#’ uvozuje komentář. Komentářem je jakýkoliv text, nacházející se mezi znakem ‘#’ a koncem řádku. Komentáře v souboru tw.run nemají na činnost TinWebu žádný vliv. Totéž platí i pro všechny další konfigurační soubory TinWebu, které tato příručka popisuje. Následující oddíly popisují význam jednotlivých parametrů v hlavním konfiguračním souboru TinWebu tw.run. 2.1. Nastavení databáze T Series, cesty k souborům, základní nastavení 2.1.1. DATA_PATH Cesta k databázi T Series. Musí být uvedena absolutní cesta, začínající v kořenovém adresáři, a musí být ukončena znakem ‘.’ (tečka). Za tečku TinWeb připojuje čísla jednotlivých datových souborů. V případě systémů fy Microsoft musí cesta začínat písmenem příslušného disku a dvojtečkou. Příklad: (unix) (Windows)

DATA_PATH=/usr/tinman/tinlib/ufixit050. DATA_PATH=d:\tinlib\data\fixit050.

2.1.2. BLOCK_SIZE Velikost datových bloků, na jakou je nastavena databáze T Series. Přípustné hodnoty jsou 4k, 8k, 16k, 32k (podrobnější informace viz manuál správy systému T Series) Příklad: BLOCK_SIZE=8k 2.1.3 OWN_DATABASE Parametr může mít hodnotu 1 nebo 0 a říká, zda TinWeb má vlastní databázi, kterou bude prohledávat (viz kap. 2.2.1), nebo bude sloužit pouze jako nástroj pro odesílání dotazů vzdáleným databázím. Parametr DATA_PATH popsaný v kapitole 2.2.1 musí obsahovat platnou cestu k databázi Strana 1

TinWeb v.11 – příručka správce systému i v případě, že parametr OWN_DATABASE bude mít hodnotu 0. V takovém případě adresář popsaný parametrem DATA_PATH nemusí obsahovat celou databázi, ale musí obsahovat alespoň fixity číslo 3, 8 a 16. V případě, že parametr OWN_DATABASE bude mít hodnotu 0 a soubor tw.run neobsahuje žádný vyplněný parametr SEL_LIB nebo SEL_LIB_GROUP (viz kap. 2.1.7), pak TinWeb při prvním spuštění nezobrazí formulář s vyhledávací maskou, ale nejdříve zobrazí nabídku knihoven, které mají být prohledávány. 2.1.4 CONFIG_FILES_PATH Cesta ke všem konfiguračním souborům TinWebu, které jsou popsány v dalších kapitolách této příručky. Cesta musí začínat v kořenovém adresáři a musí být ukončena znakem ‘/’ (pro unixové systémy), nebo ‘\’ (pro systémy Microsoft). Příklad: (unix) (Windows)

CONFIG_FILES_PATH=/usr/www/TinWeb/ DATA_PATH=c:\Program_Files\TinWeb\

2.1.5 PICS_PATH URL adresáře, ve kterém má TinWeb uloženy obrázky (ikony, tlačítka, atp.) Jedná se o URL, nikoliv fyzickou cestu ve file systému serveru. Příklad: Jestliže máme obrázky (ikony a tlačítka) TinWebu uloženy v adresáři /usr/lib/httpd/icons a v konfiguraci WWW serveru (např. httpd.conf pro server Apache) máme řádek Alias tinpics "/usr/lib/httpd/icons" pak v tw.run píšeme: PICS_PATH=/tinpics/ 2.1.6 SESSION_PATH Cesta k adresáři, ve kterém si TinWeb vytváří pracovní soubory s informacemi pro jednotlivá uživatelská sezení. Pomocí těchto souborů TinWeb vytváří stavové prostředí nad bezestavovým protokolem HTTP. Cesta musí začínat v kořenovém adresáři a musí být ukončena znakem ‘/’ (pro unixové systémy), nebo ‘\’ (pro systémy Microsoft). Příklad: (unix) (Windows)

SESSION_FILES_PATH=/usr/www/TinWeb/tmp/ SESSION_PATH=c:\Program_Files\TinWeb\tmp\

2.1.7 SEL_LIB, SEL_LIB_GROUP Tyto parametry se mohou v libovolném počtu opakovat a jejich hodnotou jsou zkrácené názvy knihoven a skupin knihoven, tak jak jsou definované v souborech libs.twb a libsldef.twb (viz kap.10). Pokud v souboru tw.run existuje alespoň jeden parametr SEL_LIB nebo SEL_LIB_GROUP a hodnotou je název knihovny, nebo skupiny knihoven, definovaný v souborech libs.twb a libsldef.twb, pak TinWeb po spuštění bude aktuálně prohledávat nastavenou knihovnu (skupinu knihoven). Uživatel může tuto předvolbu kdykoliv zrušit, nebo změnit. Pokud ovšem parametr OWN_DATABASE (viz kap. 2.1.3) má hodnotu ‘0’, nemůže uživatel vybrat nulový počet knihoven (což by znamenalo, že má být prohledávána pouze „domovská“ knihovna) a TinWeb mu nedovolí spustit jakékoliv vyhledávání, nebo listování, dokud nevybere alespoň jednu knihovnu.

Strana 2

TinWeb v.11 – příručka správce systému 2.2. Nastavení vstupního formuláře TinWebu, vzhled úvodní stránky a hlavičky 2.2.1. LANG_XX Tímto parametrem určíme pořadí, v jakém se zobrazí vlaječky (tlačítka) pro přepínání jednotlivých použitých jazyků. XX v názvu parametru určuje pořadí a hodnotou parametru je číslo jazyka (viz parametr L). Příklad: Chceme-li nabízet volbu mezi jazyky německy, španělsky, rusky, anglicky (v uvedeném pořadí), pak soubor tw.run bude obsahovat řádky: LANG_01=03 LANG_02=05 LANG_03=09 LANG_04=02 2.2.2. TITLE_XX Název (titulek) knihovny pro každý použitý jazyk. XX je číslo jazyka (viz parametr L). Mezery v textu názvu v tomto parametru musí být zapsány jako znak ‘_’ (podtržítko). Všechny texty musí být zapsány v kódování UTF-8. Příklad: Chceme li nabízet jazyky český, slovenský, německý a anglický a knihovna se jmenuje „Knihovna ABC“, pak soubor tw.run bude obsahovat řádky: TITLE_00=Knihovna_ABC TITLE_01=Kni nica_ABC TITLE_03=Bibliothek_ABC TITLE_02=Library_ABC Při spuštění TinWebu se pod názvem knihovny může objevit krátký text se základní informací o knihovně atp. Tento text je v souboru subtitle.twb. Obsah souboru musí mít strukturu: …. .... .... kde dvojice značek … ohraničují jednotlivé jazykové mutace příslušného textu a vlastní text mezi značkami je zapsán v kódování UTF-8. 2.2.3. ADMIN_MAIL, ADMIN_MAILER Hodnotou parametru ADMIN_MAIL je e-mail adresa pracovníka, na kterého mají být směrovány dotazy a připomínky uživatelů TinWebu. Hodnotou parametru ADMIN_MAILER je cesta ke scriptu (programu), který provede odeslání mailu – například tak, že ho předá systému sendmail atp.Tento mechanismus používá TinWeb od verze 11. V předchozích verzích vytvářel na nástrojové liště HTML odkaz ve tvaru , kde adresa byla dosazena z parametru ADMIN_MAIL. Tento postup ale není vhodný z hlediska ochrany proti SPAMu, proto byl ve verzi 11 upraven tak, aby adresa knihovníka nebyla vidět v žádném z výstupů TinWebu. Strana 3

TinWeb v.11 – příručka správce systému 2.2.4. SID_TIMER Tento parametr může nabývat pouze dvou hodnot – 1 nebo 0. TinWeb podle něj zobrazuje (=1) nebo nezobrazuje (=0) hodiny, které v okně WWW prohlížeče ukazují čas zbývající do vypršení (ukončení) jednoho uživatelského sezení. Tento čas se nastavuje vždy znovu na maximální hodnotu s každou uživatelskou akcí v rámci jednoho sezení. Hodnota, na kterou se časovač s každou akcí nastaví, je dána parametrem SID_TIMEOUT (viz kap. 2.4.3). 2.2.5. LIST_XX Tyto parametry definují pole, která jsou v TinWebu nabízena k listování. Dvoumístné dekadické číslo XX určuje pořadí, v jakém budou jednotlivé volby v TinWebu zobrazeny. Položka s nejmenší hodnotou XX je implicitní volba (bude v nabídce zobrazena jako první). Hodnoty tohoto parametru mají tvar: YYY|ZZZZ, kde YYY je třímístné dekadické číslo konfigurace, popsané v souboru list-tag.twb (viz kap. 3), který definuje v jakém fixitu a za jakých podmínek bude TinWeb vyhledávat listované položky. ZZZZ je čtyřmístné dekadické číslo textu v souboru texts.twb (viz kap. 9), který bude zobrazen v příslušné nabídce. Pro tyto texty jsou vyhrazena čísla v intervalu 2200-2299. Příklad: Dejme tomu, že chceme nabízet listování v názvech knih, ve jménech autorů a v číslech ISBN (v uvedeném pořadí). Jednotlivé konfigurace pro listování uvedenými položkami jsou definovány v souboru list-tag.twb (viz kap. 3) pod čísly 016, 019 a 017. V souboru texts.twb (viz kap. 9) budeme mít například pod čísly 2201, 2204, 2210 pro češtinu texty „Názvy knih“, „Jména autorů“ a „ISBN“. Pak v tw.run musí být následující tři řádky: LIST_00=016|2201 LIST_01=019|2204 LIST_02=017|2210 Nabídka v TinWebu potom bude vypadat takto:

2.2.6. SEARCH_WHAT_XX Těmito parametry nastavujeme typy dokumentů, jejichž vyhledávání chceme nabízet. Dvoumístné dekadické číslo XX určuje pořadí, v jakém budou jednotlivé volby v TinWebu zobrazeny. Položka s nejmenší hodnotou XX je implicitní volba (bude v nabídce zobrazena jako první). Hodnoty tohoto parametru mají tvar: YYY|ZZZZ kde YYY je třímístné dekadické číslo, které tvoří první polovinu šestimístného čísla konfigurace definované v souborech title-tag.twb a dict-tag.twb (viz kap. 4 a 5). ZZZZ je čtyřmístné dekadické číslo textu v souboru texts.twb (viz kap. 9), který bude zobrazen v příslušné nabídce. Pro tyto texty jsou vyhrazena čísla v intervalu 2300-2399. Příklad: Chceme nabízet vyhledávání knih, audiovizuálních dokumentů a jakýchkoliv (všech) typů dokumentů v uvedeném pořadí. Konfigurace uvedených položek je v souborech title-tag.twb a dict-tag.twb (viz kap. 4 a 5) definovaná pod čísly začínajícími 016…, 147… a 051… V souboru texts.twb (viz kap. 9) budeme mít například pod čísly 2301, 2304, 2310 pro češtinu texty „knihy“, „AV dokumenty“ a „všechny typy dokumentů“. Pak v souboru tw.run musí být následující tři řádky:

Strana 4

TinWeb v.11 – příručka správce systému SEARCH_WHAT_00=016|2301 SEARCH_WHAT_01=147|2304 SEARCH_WHAT_02=051|2310 Nabídka v TinWebu potom bude vypadat takto:

2.2.7. SEARCH_WHERE_XX Těmito parametry nastavujeme nabídku polí, která se mají nabízet pro konstrukci dotazu na dokumenty popsané parametry SEARCH_WHAT_XX. Dvoumístné dekadické číslo XX určuje pořadí, v jakém budou jednotlivé volby v TinWebu zobrazeny. Položka s nejmenší hodnotou XX je implicitní volba (bude v nabídce zobrazena jako první). Hodnoty tohoto parametru mají tvar: YYY|ZZZZ, kde YYY je třímístné dekadické číslo, které tvoří druhou polovinu šestimístného čísla konfigurace definované v souborech title-tag.twb a dict-tag.twb (viz kap. 4 a 5). ZZZZ je čtyřmístné dekadické číslo textu v souboru texts.twb (viz kap. 9), který bude zobrazen v příslušné nabídce. Pro tyto texty jsou vyhrazena čísla v intervalu 2400-2499. Příklad: Chceme nabízet vyhledávání podle autorů, předmětových skupin a klíčových slov z názvů v uvedeném pořadí. Konfigurace uvedených položek v souborech title-tag.twb a dict-tag.twb (viz kap. 4 a 5) končí trojčíslím …019, …022 a …024. V souboru texts.twb (viz kap. 9) budeme mít například pod čísly 2401, 2405, 2411 pro češtinu texty „Jméno autora“, „Předmětová skupina“ a „Klíčové slovo z názvu“. Pak v tw.run musí být následující tři řádky: SEARCH_WHERE_00=019|2401 SEARCH_WHERE_01=022|2405 SEARCH_WHERE_02=024|2411 Nabídka v TinWebu potom bude vypadat takto:

2.2.8. PARALEL Tento parametr má pouze dvě možné hodnoty a říká, zda TinWeb má (=1) nebo nemá (=0) nabízet paralelní prohledávání dalších knihoven. Parametry knihoven, které bude TinWeb nabízet, jsou popsány v souboru libs.twb. 2.2.9. GOOGLE_BUTTON Tento parametr povoluje (=1) nebo zakazuje (=0) zobrazení tlačítka „Google“ na nástrojové liště TinWebu, kterým může být dotaz zaslaný TinWebu přeposlán ještě vyhledávači Google.

Strana 5

TinWeb v.11 – příručka správce systému 2.3. Výpůjčka – prodlužování a rezervace dokumentů 2.3.1. REZXXX Parametr povoluje (=1) nebo zakazuje (=0) zobrazení tlačítka, kterým se vyvolává žádanka o rezervaci dokumentu, jehož záznam je zobrazen. Řetězec XXX je třímístné dekadické číslo fixitu, který obsahuje záznamy příslušného typu dokumentů. Chceme-li tedy například umožnit rezervace knih a článků a zakázat rezervace časopisů a audiovizuálních dokumentů, budou v souboru tw.run následující řádky: REZ016=1 REZ037=1 REZ043=0 REZ147=0

#knihy # lánky # asopisy #audiovizuálních dokumenty

2.3.2. REZ_IF_ON_RACK Parametr říká, zda se má (=1) nebo nemá (=0) povolit rezervace dokumentů, které nejsou kompletně půjčeny (mají nějaký výtisk na místě). 2.3.3. REZ_IF_PENALTY Parametr říká, zda se má (=1) nebo nemá (=0) povolit rezervace dokumentů, pokud rezervující uživatel má nějakou neuhrazenou pokutu. 2.3.4. REZ_IF_INVALID_CARD Parametr říká, zda se má (=1) nebo nemá (=0) povolit rezervace dokumentů, pokud rezervující uživatel má neplatný (prošlý) čtenářský průkaz. 2.3.5. REZ_IF_NO_LOCATION Parametr říká, zda se má povolit rezervace dokumentů, u kterých není vyplněno pole „lokace dokumentu“ 2.3.6. REZ_TRANSPORT_DOCUMENT Parametr říká, zda se má (=1) nebo nemá (=0) povolit přeprava rezervovaného dokumentu mezi pobočkami. TinWeb pracuje pouze s pobočkami a lokacemi dokumentů, které mu povolíme výčtem v souborech r-branch.twb a r-locs.twb. Soubory obsahují seznam poboček a lokací, zapsaných pod sebou na jednotlivých řádcích. Názvy musí být zapsány ve stejném kódování, jako data v databázi T Series. Např. pro české a slovenské prostředí je to v současné době CP852. Nejspolehlivější cesta jak soubory vytvořit ve správném kódování je export přímo z T Series. 2.3.7. REZ_ACCESS_NO Parametr říká, zda se má (=1) nebo nemá (=0) povolit rezervace konkrétního přírůstkového čísla dokumentu.

Strana 6

TinWeb v.11 – příručka správce systému 2.3.8. REZ_BRANCH_CHOICE Parametr říká, zda se má (=1) nebo nemá (=0) zobrazovat volba pobočky, na které bude možné su vyzvednout rezervovaný dokument 2.3.9. REZ_MAILTO E-mail adresa knihovníka, kterému má TinWeb posílat informaci o provedené rezervaci. 2.3.10. REZ_EXPORT_PATH Cesta k souboru, do kterého TinWeb exportuje žádost o rezervaci. Po provedení exportu TinWeb spouští script (viz parametr REZ_IMPORT_SCRIPT), který provede import exportovaných dat do databáze T Series. Posledním příkazem scriptu musí být příkaz pro smazání vyexportovaného souboru. Nepřítomnost (přítomnost) tohoto souboru slouží současně pro TinWeb jako semafor, indikující, že může (nemůže) být exportován případný další požadavek na rezervaci. 2.3.11. REZ_IMPORT_SCRIPT Cesta ke scriptu, který do databáze T Series importuje data ze souboru vytvořeného TinWebem v případě žádosti o rezervaci dokumentu (viz parametr REZ_EXPORT_PATH). Posledním příkazem scriptu po provedeném importu musí být smazání importovaného souboru. 2.3.12. LOAN_VIEW Parametr nastavuje zda TinWeb má(=1), nebo nemá(=0) nabízet prohlížení vlastních výpůjček. 2.3.13. LOAN_EXTENSION Parametr nastavuje zda TinWeb má(=1) nebo nemá(=0) nabízet prodlužování vlastních výpůjček. 2.3.14. LOAN_EXPORT_PATH Cesta k souboru, do kterého TinWeb exportuje identifikační údaje vypůjčeného dokumentu, u kterého je požadováno prodloužení výpůjčky. Po provedení exportu TinWeb spouští script (viz parametr LOAN_IMPORT_SCRIPT), který provede import exportovaných dat do databáze T Series. Posledním příkazem scriptu musí být příkaz pro smazání vyexportovaného souboru. Nepřítomnost (přítomnost) tohoto souboru slouží současně pro TinWeb jako semafor, indikující, že může (nemůže) být exportován případný další požadavek na prodloužení. 2.3.15. LOAN_IMPORT_SCRIPT Cesta ke scriptu, který do databáze T Series importuje data ze souboru vytvořeného TinWebem v případě žádosti o prodloužení výpůjčky (viz parametr LOAN_EXPORT_PATH). Posledním příkazem scriptu po provedeném importu musí být smazání importovaného souboru. 2.3.16. TINEHOST_LOCK Cesta k souboru, jehož přítomnost indikuje, zda má TinWeb umožnit provádění rezervací a prodlužování výpůjček. Ve chvíli, kdy probíhají údržbové akce na databázi T Series není vhodné, aby byly prováděny importy dat. Script, kterým se spouští jakákoliv údržba databáze, by měl ze všeho nejdřív vytvořit soubor popsaný parametrem TINEHOST_LOCK, čímž TinWebu řekne, že nemá umožnit provádění rezervací nebo prodlužování výpůjček. Po skončení údržby musí být soubor smazán, má-li TinWeb opět umožnit prodlužování a rezervace.

Strana 7

TinWeb v.11 – příručka správce systému Pozn: Soubor popsaný parametrem TINEHOST_LOCK může obsahovat cokoliv nebo může být prázdný. Pro TinWeb je důležitý pouze jeho název a přístupová práva nastavená tak, aby TinWeb mohl zjistit, zda soubor existuje. 2.3.17. HOST_ONLINE Parametr říká, jestli TinWeb pracuje (=1) nebo ne (=0) s aktivní databází tj. s takovou databází, nad kterou současně pracuje systém T Series. Tento parametr má význam pro mechanismus, který se použije v případě požadavku na rezervaci dokumentu. Existují knihovny, které TinWeb provozují nad kopií databáze, nad kterou neběží žádný T Series server. Pokud i v takovém případě chceme uživatelům umožnit rezervace dokumentů, musí TinWeb požadavky na rezervace ukládat někam, kde si je bude správce T Series pravidelně vyzvedávat a „ručně“ je importovat do aktuální databáze T Series. Pro TinWeb to znamená jedinou změnu. Pokud má parametr hodnotu 1, pak TinWeb při rezervaci do souboru popsaného parametrem LOG_FILE (viz kap. 2.3.15) zapíše status „ofline“. TinWeb bez ohledu na hodnotu parametru HOST_ONLINE spouští script popsaný parametrem REZ_IMPORT_SCRIPT (viz kap. 2.3.8), ten by se ale v případě že HOST_ONLINE=0 neměl pokoušet o import souboru popsaného parametrem REZ_EXPORT_PATH (viz kap. 2.3.7) ale měl by soubor pouze přidat do souboru LOG_FILE (viz kap. 2.3.15). Podrobně je tento mechanismus popsán v kapitole 13. 2.3.18. LOG_FILE Obsahem tohoto parametru je cesta k souboru, do kterého TinWeb ukládá informace o proběhlých požadavcích na rezervace a prodlouženích výpůjček

2.4. Základní rysy a funkce TinWebu 2.4.1. DOC_BASE Hodnotu tohoto parametru TinWeb dosazuje do HTML hlaviček svých výstupů jako hodnotu atributu BASE ve značce Hodnota tohoto parametru má tvar: http://<jméno serveru>[:<číslo TCP portu>] Parametr nesmí být ukončen lomítkem. 2.4.2. L Číslo použitého jazyka. Hodnota je dekadické číslo, zleva doplněné nulami na dvě místa. Přípustné hodnoty jsou: 00 (česky) 01 (slovensky) 02 (anglicky) 03 (německy) 04 (francouzsky) 05 (španělsky) 06 (maďarsky) 07 (dánsky) 08 (nizozemsky) 09 (rusky) TinWeb bude používat jazyk, nastavený parametrem L, dokud si uživatel nezvolí jiný.

Strana 8


2.4.3. SID_TIMEOUT Doba expirace jednoho uživatelského sezení v minutách. Hodnota se zapisuje jako dekadické číslo, zleva doplněné nulami na čtyři místa (např: „SID_TIMEOUT=0010“). Čas je měřen vždy od poslední uživatelské akce v daném sezení. 2.4.4. MAX_SESSION Maximální možný počet současně existujících uživatelských sezení. Hodnotou je dekadické číslo, zleva doplněné nulami na čtyři místa. 2.4.5. DEF_SORT Tento parametr určuje, jak budou řazeny vyhledané záznamy. Hodnota parametru má tvar „XXH“, kde „XX“ je dvoumístné dekadické číslo pole, podle kterého se má výsledek seřadit, a „H“ říká, jestli má být výsledek řazen podle abecedy vzestupně (=U), nebo sestupně (=D). Význam čísel polí (XX) se definuje v souboru „sort-tag.twb“ (viz popis souboru „sort-tag.twb“). Příklad: Chceme-li, aby TinWeb vždy seřadil vyhledané záznamy vzestupně podle jména autora, a pole „autor“ má v souboru „sort-tag.twb“ přidělenou hodnotu např. 4, pak v tw.run bude: DEF_SORT=04U Poznámka: Vyhledané záznamy seřazené podle implicitního nastavení (parametr DEF_SORT) si může uživatel vždy seřadit jinak, a to podle jednoho z až 10 nabízených polí, definovaných v souboru sort-tag.twb. 2.4.6. TIMEOUT_CONNECT Doba v sekundách, po jejímž uplynutí se TinWeb přestane pokoušet navázat spojení s knihovnou, která byla vybrána z nabídky prohledávaných knihoven. Hodnotou je dekadické číslo, zleva doplněné nulami na 4 místa. 2.4.7. TIMEOUT_READ Doba v sekundách, po jejímž uplynutí TinWeb přestane čekat na data od knihovny, která byla vybrána z nabídky prohledávaných knihoven. Hodnotou je dekadické číslo, zleva doplněné nulami na 4 místa.

2.4.8. VIEW_DISABLED_RECS Tento parametr nastavuje, jak má TinWeb pracovat se záznamy, které mají vyplněné pole 0x9977 nebo 0x9988 (skryté záznamy – dále jen SZ). Parametr má čtyři možné hodnoty: 0

bude potlačeno zobrazení jakéhokoliv odkazu na SZ,

1

budou se zobrazovat všechny odkazy na SZ, při navigaci na tyto záznamy se zobrazí pouze jejich hlavička (klíčové pole), místo podrobností se zobrazí text uvedený v souboru texts.twb (viz kap. 9) pod číslem 1140,

2

budou se zobrazovat všechny odkazy na SZ, při navigaci na tyto záznamy se zobrazí pouze ty podrobnosti (pole), které mají v příslušném souboru labels.* (viz popis souborů labels.*) čtvrtý „přepínač“ nastavený na ’0’,

Strana 9

TinWeb v.11 – příručka správce systému 3

budou se zobrzovat všechny odkazy na SZ a všechny podrobnosti těchto záznamů podle definic v souborech labels.* (viz popis souborů labels.*) stejně jako u ostatních neskrytých záznamů a nebere se přitom v úvahu hodnota čtvrtého „přepínače“ v souboru labels.* (viz popis souborů labels.*).

2.4.9. DEFAULT_PASSWORD Hodnotou tohoto parametru je implicitní heslo, na které TinWeb nedovolí prohlížení vlastních výpůjček, jejich prodlužování a rezervace dokumentů. Pokud tento parametr chybí nebo je nevyplněn, je povoleno jakékoliv heslo. 2.5. Propojení TinWebu se systémy Metalib a SFX 2.5.1. SFX_PREFFIX, SFX_DNAME, SFX_SUFFIX Pomocí těchto tří parametrů TinWeb generuje u nalezených záznamů odkazy ve formátu „Open URL“ do systému SFX. Odkazy jsou konstruovány tak, že TinWeb provede zřetězení prvních dvou parametrů, za ně připojí hodnoty některých polí z nalezeného záznamu (pole jsou definována v souboru sfx-tags.twb) a nakonec připojí třetí parametr. Pokud má některý z uvedených tří parametrů obsahovat znak ‘&’, musí být v tw.run zapsán podle konvencí pro speciální znaky v URL (tedy jako „%26“). Jednotlivé řádky v soubor sfx-tags.twb mají následující strukturu: XX:YYYY:<sfx_tag>[&<sfx_tag]... kde XX YYYY <sfx_tag>

je dvoumístné hexadecimální číslo fixitu je číslo pole je popis, jak má být dané pole zpracováno a zapsáno do SFX linku

Jako první SFX tag MUSÍ být vždy uvedeno "genre". Pokud se nekde v <sfx_tag> vyskytne řetězec "$*", bude nahrazen skutečným obsahem pole. Řetězec "$1" bude nahrazen částí pole od začátku až po první výskyt řetězce ", " (carka-mezera). Řetězec "$2" bude nahrazen částí pole ohraničenou zleva řetězcem ", " a zprava "," nebo " " nebo "\0" nebo "\0x0A" nebo "\0x0D". Příklad: Jsou-li v tw.run následující tři řádky: SFX_PREFFIX=http://www.jib.cz:9004/sfx_local?sid=TinWeb SFX_DNAME=UPOL SFX_SUFFIX=pid=lp=octopus.ruk.cuni.cz,Port=9909,ServiceClass=ALL a v souboru sfx-tags.twb jsou definována pole se jménem autora a ISBN: 10:0101:genre=book&title=$* 10:0303:genre=book&aulast=$1&aufirst=$2 10:0301:genre=book&isbn=$* 10:0403:genre=book&date=$* pak u záznamu knihy A farewell to arms od E. Hemingwaye s ISBN 0099910101 TinWeb vygeneruje tlačítko s následujícím URL: http://octopus.ruk.cuni.cz:8888/sfx_test?sid=TinWeb:UPOL&genre=book& title=A+farewell+to+arms&isbn=0099910101&aulast=Hemingway& aufirst=Ernest&pid=lp=octopus.ruk.cuni.cz,Port=9909,ServiceClass=ALL Pozn.: Pokud v tw.run chybí parametr SFX_PREFFIX nebo SFX_SUFFIX, nebude TinWeb tlačítko SFX nabízet.

Strana 10


2.5.2. ML_QUERY_ID, ML_QUERY_ID_VAL, ML_OUTPUT_MIME_TYPE Tyto parametry slouží pro propojení TinWebu se systémem Metalib firmy ExLibris. První dva parametry říkají TinWebu, jaký parametr a jaká jeho hodnota se objeví v dotazech od Metalibu (podle nich TinWeb jednoznačně detekuje, zda se jedná o dotaz vygenerovaný systémem Metalib). Třetí parametr TinWebu říká, jaký „Mime-Type“ má dosadit do HTTP hlavičky odpovědi, kterou posílá zpět systému Metalib.

Strana 11

TinWeb v.11 – příručka správce systému 2.5.3. Paramtry ML_BOOK, ML_PRM_nn Dotaz, který od Metalibu přijde má strukturu: OPND_1=string_1&OP=(AND/OR/NOT)&OPND_2=string_2 Kde OPND_n je typ operandu (např. autor, název, klíčové slovo atp.), string_n je řetězec, který se má hledat a OP je logická funkce mezi operandy (AND, OR, nebo NOT). Parametry ML_PRM_nn definují jména jednotlivých operandů, tak jak přicházejí v dotazech od Metalibu. Tato jména jsou součástí rozhraní dohodnutého mezi správcem Jednotné informační brány na UVT UK a autory TinWebu. V současné době jsou jména definována tak, že v souboru tw.run musí být následující řádky: ML_BOOK=550 ML_PRM_01=WAU:010 ML_PRM_02=WTI:020 ML_PRM_03=WSU:030 ML_PRM_04=WYR:040 ML_PRM_05=SBN:050 ML_PRM_06=SSN:050 ML_PRM_07=ANY:060 Z hodnot parametru ML_BOOK a ML_PRM_nn TinWeb skládá šestimístná čísla konfigurací pro vyhledávání, které jsou definovány v souboru title-tag.twb (viz kap. 5). Pokud budou v budoucnu možnosti Metalibu rozšířeny, nebo jakkoliv změněny, stačí upravit (rozšířit) parametry ML_… v souboru tw.run. 2.5.3. Odpovědi TinWebu na dotazy od Metalibu – XML formát Když TinWeb detekuje dotaz od Metalibu, reaguje na něj jinak, než na dotazy zaslané z WWW prohlížeče. Odpovědi TinWebu jsou v takovém případě formátované v XML. Popis DTD je mimo rámec této příručky. Důležité je pouze to, že formát XML výstupu je řízen souborem xml-tags.016, který je součástí distribuce TinWebu verze 11. Soubor xml-tags.016 definuje formátování záznamů knih. Pokud bude v budoucnu rozhraní Metalib-TinWeb rozšířeno o vyhledávání seriálů, příp. článků, bude k dispozici další konfigurační soubor xml-tags.043, příp. xml-tags.037.

Strana 12


3. Definice polí a podmínek pro listování – popis souboru „list-tag.twb“ Ve vyhledávací masce TinWebu je nabídka objektů (záznamů), kterými se může listovat (název knihy, jméno autora, předmětová skupina, atd.). Nabídka se definuje v souboru tw.run pomocí parametrů LIST_XX (viz kap. 2.2.5) a v souboru list-tag.twb se ke každé položce nabídky definují čísla fixitů a polí, jejichž obsahem se bude listovat, a podmínky za jakých jsou daná pole k listování použita. Každá nabídka, definovaná v tw.run má své tzv. číslo konfigurace (viz kap. 2.2.5). Ke každému číslu konfigurace musí být v souboru list-tag.twb definovány alespoň některé z následujících parametrů, začínající vždy odpovídajícím třímístným číslem konfigurace (xxx). 1. xxx_TITLE=dddd - číslo textu ve souboru texts.twb (viz kap. 9), který bude zobrazován jako nadpis daného listování. 2. xxx_DISPLAY_FIELD=XX|YYYY – hexadecimální číslo fixitu (XX) a pole (YYYY), jehož obsah má být listován. Pokud za rovnítkem je hodnota 0, nebo parametr neexistuje, bude výsledkem listování vždy prázdný seznam. 3. xxx_IF_FIELD_nn=(Y/N):YYYY:(+/*) Pokud parametr existuje, obsahuje čtyřmístné číslo pole uvozené "přepínačem" 'Y' nebo 'N'. Daný záznam se použije pro slovník pouze pokud přepínač má hodnotu 'Y' a pole YYYY v daném záznamu existuje, nebo pokud přepínač má hodnotu 'N' a pole v daném záznamu neexistuje. Tento parametr se může opakovat se stejnou hodnotou xxx a lineárně od 0 rostoucí hodnotou nn. Potom se jednotlivá čísla polí vyhodnocují postupně podle rostoucí hodnoty nn a mezi nimi se použije logická spojka, která je uvedena za "YYYY:" tak, ze '+' je logický součet (OR) a '*' je logicky součin (AND) 4. xxx_IF_CONTENT_nn="<string>" Obsahuje textový řetězec v uvozovkách. Daný záznam se použije pouze v případě, ze "přepínač" v předchozím parametru s odpovídajícím číslem nn má hodnotu 'Y' a současně obsah pole YYYY se shoduje s řetězcem <string>, nebo v případě že přepínač v předchozím parametru má hodnotu 'N' a obsah pole YYYY nevyhovuje řetězci <string>. Řetězec <string> se vyhodnocuje tak, ze pokud před ním je "0:...", vyhodnocuje se jeho shoda s obsahem pole a pokud před ním je "1:..." vyhodnocuje se shoda prvních n znaků obsahu pole, kde n je délka řetězce <string>. 5. xxx_TEXT_FILE="" Hodnotou parametru je jméno textového souboru, jehož obsah se zobrazí před listovanými položkami, nebo na jejich místě v případě, že není definováno, co se má listovat (parametr č. 2 - xxx_DISPLAY_FIELD). Obsah souboru musí mít strukturu: …. .... .... kde dvojice značek … ohraničují jednotlivé jazykové mutace příslušného textu

Strana 13

TinWeb v.11 – příručka správce systému Příklad: Chceme nabízet listování v MDT a v souboru tw.run tuto možnost máme definovanou například takto: LIST_15=041|2211 Pak v souboru list-tag.twb budeme mít řádky: 041_TITLE=2211 041_DISPLAY_FIELD=29|0101 041_IF_FIELD_00=Y:7777:+ 041_IF_FIELD_01=Y:2929:+ 041_IF_FIELD_02=Y:8777:+ 041_IF_FIELD_03=Y:9321:+ Tyto řádky budou řídit chování TinWebu tak, že při listování v MDT bude zobrazovat obsahy polí 0x0101 z fixitu číslo 0x29 a to pouze v případech, kdy příslušný záznam obsahuje pole 0x7777 nebo 0x2929 nebo 0x8777 nebo 0x9321.

Strana 14


4. Definice polí a podmínek pro slovníky – popis souboru „dict-tag.twb“ Soubor dict-tag.twb definuje z jakých fixitů, z jakých polí a za jakých podmínek jsou generovány slovníky, používané při zadávání výrazů pro vyhledávání ve vyhledávací masce TinWebu. Syntaktická struktura souboru dict-tag.twb je shodná se strukturou souboru list-tag.twb (viz kap. 3) včetně významu všech parametrů. Jediný rozdíl spočívá v tom, že čísla konfigurací jsou v souboru dict-tag.twb šestimístná (na rozdíl od třímístných v souboru list-tag.twb) a skládají se ze dvou částí. První třímístná část se odvozuje z hodnoty parametru SEARCH_WHAT_XX (viz kap. 2.2.6) a druhá z parametru SEARCH_WHERE (viz kap. 2.2.7). Příklad: Chceme nabízet vyhledávání knih podle autora. V souboru tw.run máme tento rys definován následovně: SEARCH_WHAT_00=016|2301 SEARCH_WHERE_00=019|2401 Pak v souboru dict-tag.twb budeme mít řádky: 016019_TITLE=2401 016019_DISPLAY_FIELD=13|0101 Tyto řádky budou řídit chování TinWebu tak, že když si uživatel vybere vyhledávání knih a na jednom z řádků vyhledávací masky vybere vyhledávání podle jména autora, pak při stisku tlačítka „slovník“ bude TinWeb generovat slovník z polí 0x0101 ve fixitu 0x13.

Strana 15


5. Definice polí a podmínek pro vyhledávání – popis souboru „title-tag.twb“ Když uživatel spustí v TinWebu vyhledávání dokumentů podle nabídek a voleb definovaných v souboru tw.run v parametrech SEARCH_WHERE a SEARCH_WHAT, TinWeb v souboru title-tag.twb zjišťuje, jaká pole v jakých datových souborech a za jakých podmínek mají být prohledána. Soubor title-tag.twb musí existovat v adresáři definovaném v souboru tw.run v parametru CONFIG_FILES_PATH. Jednotlivé typy (konfigurace) vyhledávání jsou podobně jako definice slovníků (viz kap. 4.) identifikovány šestimístnými čísly, skládajícími se ze dvou třímístných částí. První třímístná část se odvozuje z hodnoty parametru SEARCH_WHAT_XX (viz kap. 2.2.6) a druhá z parametru SEARCH_WHERE (viz kap. 2.2.7). Každý parametr v souboru title-tag.twb začíná tímto šestimístným identifikátorem. Jednotlivé parametry v souboru mají následující strukturu: 1. xxxxxx_SEARCH_FIELD_nn=XX|YYYY|Q Parametr definuje hexadecimální číslo fixitu (XX) a číslo pole (YYYY) kde bude hledán zadaný řetězec. Na konci je jednomístné číslo (Q), které říká, jak bude zadaný řetězec interpretován. Q může nabývat 4 hodnot: • • •

•

0 zadaný řetězec se bude hledat i se všemi pravostrannými rozšířeními 1 hledá se pouze přesná shoda se zadaným řetězcem 2 zadaný řetězec je chápán jako čtyřmístné číslo, nebo interval čísel. Může být zadána ve formátech aaaa, aaaa-bbbb, aaaa-, nebo –bbbb. Používá se například pro zadávání roku vydání. 3 zadaný řetězec bude chápán jako datum, nebo interval. Může být zadán ve formátech mm.dd.yyyy, mm.dd.y-mm.dd.yyyy, mm.dd.yyyy-, nebo -mm.dd.yyyy

Na konci názvu parametru je dvoumístné dekadické číslo (nn). V případě že u dané konfigurace je pouze jeden tento parametr, má hodnotu 01. V případě že se parametr pro dané číslo konfigurace opakuje, musí čísla nn růst po jedné. 2. xxxxxx_TITLES_nn=AAAA,BBBB,CCCC,DDDD,EEEE,FFFF,…. Tento parametr definuje seznam čísel polí, která ve fixitu číslo XX (v předchozím parametru) obsahují názvy nalezených dokumentů. Každé číslo nn v názvu parametru koresponduje se stejným číslem v předchozím parametru. 3. xxxxxx_ADD_SEARCH_FIELD_nn_ii=YYYY|yyyyyy Tento parametr umožňuje libovolně rekurzivně větvit každé vyhledávání. Obsahuje číslo pole, z něhož se přebírá další řetězec pro vyhledávání, které bude provedeno podle konfigurace číslo yyyyyy. Poznámka: třetí parametr představuje silný nástroj, kterým můžeme v TinWebu nastavit libovolně složité vyhledávání, ale při jeho použití je nutné postupovat opatrně. Jeho neuvážené použití může vyhledávání výrazně zpomalit a navíc není problém konfiguraci napsat tak nešťastně, že se vyhledávání zacyklí (jedná se o rekurzivní proceduru).

Strana 16

TinWeb v.11 – příručka správce systému Příklad: Mějme v souboru tw.run dva následující řádky (hledání knihy podle autora) SEARCH_WHAT_00=016|2301 SEARCH_WHERE_00=019|2401 A v souboru title-tag.twb řádky 016019_SEARCH_FIELD_01=13|0101|0 016019_SEARCH_FIELD_02=43|0101|0 016019_TITLES_01=0303,0344,0909,0910,cc13,cc14,cc15,cc16,cc12 016019_TITLES_02=ca08 016019_ADD_SEARCH_FIELD_01_01=8080|123456 016019_ADD_SEARCH_FIELD_01_02=8989|123456 016019_ADD_SEARCH_FIELD_01_03=9898|123456 016019_ADD_SEARCH_FIELD_01_04=8787|123456 016019_ADD_SEARCH_FIELD_01_05=CA06|123456

#1 #2 #3 #4 #5 #6 #7 #8 #9

123456_SEARCH_FIELD_01=13|0101|1 123456_SEARCH_FIELD_02=43|0101|1 123456_TITLES_01=0303,0344,0909,0910,cc13,cc14,cc15,cc16,cc12 123456_TITLES_02=ca08

#10 #11 #12 #13

TinWebu tím sdělujeme, že pokud někdo zadá vyhledávání podle autora např. „Hemingway“, bude řetězec „Hemingway“ hledán ve fixitu 0x13 v polích 0x0101 (řádek #1) a u záznamů, kde bude tento řetězec nalezen budou přečteny názvy knih z polí popsaných na řádku #3. Stejně tak se prohledají pole 0x0101 ve fixitu 0x43 (řádek #2) a přečtou relevantní názvy z polí, popsaných na řádku #4. Dále, protože k parametru na řádku #1 existují ještě parametry 016019_ADD_SEARCH_FIELD_01_ii Na řádcích #5 až #9, tak ve všech relevantních záznamech (těch které podle řádku #1 vyhověly řetězci „Hemingway“) budou postupně načítány ještě řetězce z polí 0x8080, 0x8989, 0x9898, 0x8787 a 0xCA06 (řádky #5 až #9) a ty předávány k dalšímu vyhledávání podle konfigurace číslo 123456 (řádky #10 až #11).

Strana 17


6. Nastavení zobrazování podrobností u seznamu záznamů - Popis souboru „listing.ext“ Soubor listing.ext řídí způsob, jakým TinWeb zobrazuje seznamy nalezených záznamů. Přidáváním (mazáním) a editací parametrů v soboru listing.ext můžeme určovat, jaké podrobnosti bude TinWeb zobrazovat v seznamech záznamů. Soubor listing.ext musí být umístěn v adresáři popsaném parametrem CONFIG_FILES_PATH v souboru tw.run. Znak ‘#’ uvozuje komentář. Komentářem je jakýkoliv text nacházející se mezi znakem ‘#’ a koncem řádku. Komentáře nemají na činnost TinWebu žádný vliv. Konfigurační parametry v souboru listing.ext se zadávají po řádcích ve formátu: |1a|1b|2a|2b|c|d|c1|d1|x|y|z Význam jednotlivých parametrů je následující: 1a:

Číslo zdrojového fixitu, z jehož klíčových polí je tvořen aktuální seznam. Hodnotou je dvoumístné hexadecimální číslo.

1b:

Číslo pole ve zdrojovém fixitu, jehož obsah se má zobrazovat nebo ze kterého se má navigovat do dalšího (cílového) fixitu. Hodnotou je čtyřmístné hexadecimální číslo.

2a:

Číslo cílového fixitu. Hodnotou je dvoumístné hexadecimální číslo. Pokud je rovno 0, bude se zobrazovat pouze obsah pole 1b z fixitu 1a.

2b:

Číslo pole v cílovém fixitu, jehož obsah se má zobrazovat, pokud hodnota 2a není rovna 0. Hodnotou je čtyřmístné hexadecimální číslo.

c:

Počet znaků, které se mají zobrazit z daného pole (1b, 2b). Hodnotou je třímístné dekadické číslo. Pokud c se rovná 0, zobrazuje se celý obsah daného pole.

d:

Binární přepínač (přípustné hodnoty jsou 0 nebo 1), který v případě, že parametr 2a se nerovná 0, TinWebu říká, zda se mají zobrazovat obě pole 1b a 2b (=1) nebo pouze pole 2b (=0) .

c1:

Ukončení zkráceného řetězce. Hodnotou je řetězec, který se připojuje za pole 1b nebo 2b v případě, že hodnota parametru c je různá od 0 a současně je menší než skutečná délka dat v poli 1b nebo 2b (data jsou zkrácena).

d1:

Oddělovač mezi poli 1b a 2b. Hodnotou je řetězec, který se má zobrazit mezi poli 1b a 2b v případě, že se obě pole mají zobrazit (d==1).

x:

Oddělovač (řetězec) před prvním výskytem pole 1b nebo 2b.

y:

Oddělovač (řetězec) mezi výskyty pole 1b nebo 2b.

z:

Oddělovač (řetězec) za posledním výskytem pole 1b nebo 2b.

Strana 18

TinWeb v.11 – příručka správce systému Příklad: Chceme-li, aby seznam záznamů s podrobnostmi vypadal takto:

pak v souboru listing.ext musíme mít následující řádky: |10|0A03|00|0000|000|0||| / ||.| |10|0402|00|0000|000|0||| - ||.| |10|0409|00|0000|000|0||| - ||| |10|0302|00|0000|000|0||| : ||| |10|0403|00|0000|000|0|||, ||.| |10|0404|00|0000|000|0||| - ||| |10|0301|00|0000|000|0||| ISBN ||| |10|9965|00|0000|000|0|||<<||>>|

# # # # # # # #

odpovednost vydani misto vydani nakladatel rok vydani fyzicky popis ISBN vlastnik dokumentu

Pozn: Pro soubor „listing.wap“ platí naprosto stejná syntaktická pravidla jako pro popisovaný soubor „listing.ext“. Soubor „listing.wap“ slouží pro definici zobrazovaných podrobností v seznamech pro službu WAP (přístup k TinWebu přes mobilní telefon).

Strana 19


7. Nastavení zobrazování podrobností v zobrazeném záznamu 7.1 Popis souborů labels.* Soubory „labels.*“ řídí způsob, jakým TinWeb zobrazuje jednotlivá pole v záznamech. Editací těchto souborů se nastavuje, jaká pole se mají v jednotlivých záznamech zobrazovat. Soubory labels.* musí být umístěny v adresáři popsaném parametrem CONFIG_FILES_PATH v souboru tw.run. Ke každému datovému souboru T Series, ze kterého má TinWeb zobrazovat záznamy, musí existovat příslušný soubor labels.* (hvězdička v názvu soboru labels.* je nahrazena číslem shodným s číslem v názvu příslušného datového souboru - fixitu). Znak ‘#’ uvozuje komentář. Komentářem je jakýkoliv text nacházející se mezi znakem ‘#’ a koncem řádku. Komentáře nemají na činnost TinWebu žádný vliv. Konfigurační parametry v souborech „labels.*“ se zadávají po řádcích v následujícím formátu: |XXXX|YY|abcdefgh|ddd|string....| kde XXXX:

čtyřmístné hexadecimální číslo pole, jehož obsah má TinWeb zobrazovat

YY:

dvoumístné dekadické číslo jazyka, ve kterém je zapsán „string...“ Pokud aktuálním jazykem TinWebu je například angličtina, pak z příslušného souboru labels.* se čtou pouze řádky, kde YY má hodnotu ‘02’ (viz parametr ‘L’ v souboru tw.run)

abcdefgh:

osm binárních přepínačů (hodnota ‘0’ nebo ‘1’), které mají zleva následující význam: a Přepínač je funkční pouze pro záznamy, do kterých jsme se dostali přes slovník z vyhledávacího formuláře. Nastavuje, zda má TinWeb pro dané pole (XXXX) nabízet „validační“ tlačítko – tlačítko, kterým se obsah daného pole dosazuje zpět do vyhledávacího formuláře. Tato tlačítka se zobrazují pouze v případě, že jsme se do aktuálního záznamu dostali přes slovník výrazů pro vyhledávání:

b Přepínač nastavuje, zda se má u daného pole nabízet skok na listování množinou polí (obvykle stejného typu jako dané pole). Jeho nastavení na jedničku např. pro pole, ve kterém je jméno autora, způsobí, že u jména autora se objeví tlačítko (modrá šipka doleva), jehož stiskem se dostaneme na požadovaný seznam.

Aby šipka fungovala správně, musí být pro dané pole současně nastaveno číslo ddd (viz níže), které TinWeb hledá v souboru list-tag.twb (viz kap. 3). V tomto konkrétním případě tedy budeme pravděpodobně chtít, aby číslo ddd bylo takovým číslem konfigurace v souboru list-tag.twb, které definuje listování ve jménech autorů. c Přepínač povoluje (zakazuje) navigaci z daného pole na záznam o tomto poli (např. navigace ze jména autora na záznam o tomto autorovi). Pozn: nastavení tohoto přepínače na ‘1’ ještě nemusí nutně znamenat, že dané pole v TinWebu opravdu umožní “navigaci”. Umožní ji pouze v případě, že je pole “navigovatelné” i v T Series. d V případě, že parametr VIEW_DISABLED_RECS v souboru tw.run má hodnotu ‘2’ (viz kap. 2.4.8), pak tento přepínač nastavuje, zda se má nebo nemá potlačovat zobrazení daného pole. Strana 20


e Přepínač povoluje (zakazuje) generování HTML odkazu na externí objekt, jehož URL je obsahem daného pole. Pokud má přepínač hodnotu ‘1’ a dané pole obsahuje řetězec „abcd“, pak TinWeb pro toto pole vygeneruje sekvenci: abcd f Pokud má přepínač hodnotu ‘1’, TinWeb obsah pole obalí párovou HTML značkou
. Tento rys slouží například pro cardex (rozpis objednaných a došlých časopisů) nebo obecně pro jakékoliv pole, které chceme zobrazit neproporcionálním fontem tak, aby zůstalo zachováno svislé zarovnání textu (různé tabulky atp.) g Přepínač povoluje (zakazuje) konverzi formátu data. Pokud má přepínač hodnotu ‘1‘, TinWeb s obsahem daného pole zachází jako s datem. Systém T Series zapisuje datum ve formátu YYYY/MM/DD a TinWeb při nastaveném přepínači g tento formát konvertuje na dd.mm.yyyy h Přepínač povoluje (zakazuje) konverzi charsetu daného pole do UTF-8. Pokud má přepínač hodnotu ‘0‘, TinWeb zobrazí obsah pole v kódování UTF-8. Pokud má hodnotu ‘1’, bude pole zobrazeno bez konverze charsetu ve vnitřním kódováni T Series.

ddd

Třímístné dekadické číslo konfigurace listování, podle kterého se generuje šipka doleva (viz přepínač b výše). Toto číslo TinWeb hledá v souboru list-tag.twb (viz kap. 3). Jako číslo ddd může být použito pouze takové číslo, které existuje v souboru list-tag.twb

string...

Textový řetězec, který má TinWeb zobrazovat jako název pole. Tyto řetězce MUSÍ být zapsány v kódování UTF-8.

Příklad: Chceme, aby v záznamech o knihách (fixit č. 16) byla zobrazována pole podle tohoto obrázku:

Dále má TinWeb nabízet české a anglické prostředí (viz parametry LANG_XX v souboru tw.run). Pak v adresáři popsaném parametrem CONFIG_FILES_PATH v souboru tw.run musí být soubor labels.016 s následujícími řádky: |0101|00|101000|000|Název| |0101|02|101000|000|Title| |0303|00|111000|019|Autor| |0303|02|111000|019|Author| |0302|00|111000|018|Nakladatel| |0302|02|111000|018|Publisher|

Strana 21

TinWeb v.11 – příručka správce systému |8001|00|000000|000|Poznámky| |8001|02|000000|000|Notes| |0306|00|111000|022|P edm tová skupina| |0306|02|111000|022|Subject heading| |1309|00|111000|024|Klí ové slovo| |1309|02|111000|024|Title keyword|

7.2 Popis souboru „record.ext“ Soubor „record.ext“ upřesňuje a rozvíjí definice polí v záznamech popsané v souborech „labels.*“. Při zobrazování záznamu z jednoho konkrétního datového souboru můžeme pomocí souboru „record.ext“ definovat další pole z dalších datových souborů, která se mají zobrazit. Můžeme tak například v záznamu o knize, který standardně leží ve fixitu č. 016, zobrazit současně podrobnosti o přírůstkovém čísle (lokace, vlastník, atp.), které leží ve fixitu č. 029. V jednotlivých záznamech tak můžeme zobrazovat tzv. podzáznamy, které se v souboru „record.ext“ definují po řádcích takto: |1a|1b|mnop|2a,2b,2c,.....: kde 1a dvoumístné hexadecimální číslo fixitu, ve kterém se nachází právě aktuální záznam, 1b čtyřmístné hexadecimální číslo pole ve fixitu 1a, ke kterému chceme zobrazit „podzáznam“ z jiného (cílového) fixitu (z toho, na který bychom v TinWebu jinak normálně navigovali), m binární přepínač, který nastavuje, zda má TinWeb před polem 1b zobrazit textové návěští přečtené v příslušném souboru labels.*, n binární přepínač, který nastavuje, zda má TinWeb zobrazit obsah pole 1b, o binární přepínač, který nastavuje, zda má TinWeb zobrazit před poli 2a, 2b, 2c,... textová návěští přečtená v příslušném souboru labels.*, p binární přepínač, který nastavuje, zda má být zobrazený „podzáznam“ zarámovný v tabulce, 2a,2b,2c,... seznam čtyřmístných hexadecimálních čísel polí, která mají být zobrazena z cílového fixitu. Seznam je oddělen čárkami a posledním znakem je dvojtečka. Z tohoto seznamu budou zobrazena pouze ta pole, která jsou definována současně v příslušném souboru labels.* Příklad: Chceme-li v záznamu o knize (fixit č. 016) zobrazit podrobnosti o výtiscích (přírůstkových číslech - fixit č. 029) daného titulu, pak v souboru record.ext bude následující řádek: |10|1001|1010|0101,1D04,1D05,1D90: Odpovídající část záznamu o knize pak TinWeb zobrazí takto:

Strana 22

TinWeb v.11 – příručka správce systému 7.3 Popis souboru doc-stat.twb V záznamech o přírůstkových číslech TinWeb zobrazuje informaci o výpůjčním statusu dokumentu (daného přírůstkového čísla). Tímto statusem může být např. „půjčeno“, „na místě“, „v přepravě“, „ztraceno“, atp. V databázi T Series jsou pro jednotlivé statusy zapsány čtyřpísmenné kódy a soubor doc-stat.twb obsahuje jednoduchou tabulku, která definuje jak se kódy jednotlivých statusů převádí na text, který pak TinWeb zobrazuje. Soubor doc-stat.twb má jednoduchou strukturu. Na jednotlivých řádcích je vždy TTTT|DDDD Kde TTTT je kód statusu a DDDD je číslo textu ze souboru texts.twb (viz kap. 9).

Strana 23


8. Řazení vyhledaných záznamů – popis souboru „sort-tag.twb“ TinWeb může vyhledané dokumenty řadit vzestupně nebo sestupně podle názvů nebo podle některého z až deseti definovaných polí. Implicitní řazení je dáno parametrem DEF_SORT v souboru tw.run. Po ukončení vyhledávání a zobrazení výsledku si může uživatel způsob řazení přepnout na jiné než implicitní. Parametr DEF_SORT v souboru tw.run, stejně jako uživatelské přepínače řazení, své chování odvozují z definic v souboru sort-tag.twb. Řádky v tomto souboru mají následující strukturu: |N|X1:F1:X2:F2| kde N

dvoumístné dekadické pořadové číslo přepínače řazení (01-10). Text, který se u daného přepínače zobrazuje, se čte ze souboru texts.twb (viz kap. 9) pod číslem 2000+10*N. Například u přepínače číslo “03” bude text číslo 2030;

X1

dvoumístné hexadecimální číslo fixitu, ve kterém se hledá pole F1;

F1

čtyřmístné hexadecimální číslo pole z X1, které bude použito pro řazení v případě, že X2 se rovná 0, nebo ze kterého se naviguje do X2 v případě, že X2 se nerovná 0;

X2

dvoumístné hexadecimální číslo fixitu, ve kterém se hledá pole F2;

F2

čtyřmístné hexadecimální číslo pole z X2, které bude použito pro řazení v případě, že X2!=0 .

Příklad: Chceme, aby TinWeb nabízel vyhledávání knih a článků a umožňoval řazení výsledku podle autora, roku vydání a země původu. Pak v sort-tag.twb budou řádky: |01|10:0303:00:0000| #autor knihy |01|10:0344:00:0000| |01|10:0909:00:0000| |01|10:0910:00:0000| |01|25:9201:92:0333| #autor clanku |01|25:9201:00:0000| |01|25:2513:00:0000| |02|10:0403:00:0000| #rok vydani knihy |02|25:1204:00:0000| #rok vydani clanku |03|10:CA03:00:0000| #zeme vydani knihy |03|25:252B:2B:1206| #zeme vydani clanku |03|25:1025:10:CA03| |03|25:DF10:10:CA03|

TinWeb pak u seznamu vyhledaných záznamů bude zobrazovat následující přepínače řazení:

Poznámka: - Odpovídající si řadicí pole pro různé typy dokumentů (např. rok vydání u knihy a rok vydání u článku) musí mít stejné pořadové číslo N. - Pokud se pro daný typ dokumentu opakuje několik řádků se stejným N, pak TinWeb prochází tyto řádky, dokud nenajde vyplněné pole (např. řádky z příkladu začínající „|02|25:…”). - Kromě polí popsaných v soboru sort-tag.twb bude TinWeb na prvním místě vždy nabízet řazení podle názvů.

Strana 24


9. Textové zprávy, popisy tlačítek, menu – popis souboru „texts.twb“ Všechny textové výstupy TinWebu jako položky menu, popisy ikon a tlačítek, chybové zprávy atp. jsou uloženy v souboru texts.twb po řádcích v následujícím formátu: |No|L|string...| kde No

čtyřmístné číslo textového řetězce, pod kterým ho TinWeb identifikuje. Většina textů používaných systémem má své pevné číslo. U textů, které může správce modifikovat jsou přiděleny intervaly čísel, které jsou popsány v tomto dokumentu tam, kde je to relevantní k probírané problematice;

L

číslo jazyka (viz parametry LANG_XX v souboru tw.run);

string.. textový řetězec v příslušném jazyce. Text musí být zapsán v kódování UTF-8. Příklad: Pokud má TinWeb nabízet české, anglické a německé prostředí, pak pro text definovaný parametrem SEARCH_WHERE v souboru tw.run pod číslem 2205 pro vyhledávání ve jménech autorů musí soubor texts.twb řádky: |2205|00|ve jménech autor | |2205|02|in author names| |2205|03|in Autornamen|

10. Definice prohledávaných databází – popis souboru libs.twb a libsldef.twb TinWeb umožňuje rozesílat dotazy paralelně několika knihovnám, které mají rovněž nainstalovaný TinWeb. Nabídka knihoven, ze které si uživatel vybírá ty, jejichž databáze chce prohledávat, se definuje v souborech libs.twb a libsldef.twb. Soubor libs.twb slouží pro definici parametrů všech knihoven, které přichází v úvahu – všech které mají v provozu TinWeb. Soubor libsldef.twb popisuje, které z těchto knihoven budou nabízeny k výběru, v jakém pořadí budou zobrazeny a definuje skupiny knihoven, tak aby se jedním „kliknutím“ daly vybrat např. všechny knihovny jedné univerzity. 10.1. Soubor „libs.twb“ Každá definovaná knihovna má v souboru libs.twb čtyři řádky: [ZKR]NAME= [ZKR]HOST= [ZKR]PORT= [ZKR]PATH= , kde ZKR je zkratka názvu knihovny, kterou TinWeb používá pro identifikaci. Název knihovny musí být zapsán v kódování UTF-8 a znaky ‘ ‘ (mezera) musí být zapsány jako ‘_’ (podtržítko). Číslo portu je zapsáno jako dekadické číslo, doplněné zleva nulami na pět míst. Příklad: Pro knihovnu s názvem „Knihovna ABC“, jejíž httpd běží na serveru „pokusny.server.cz“ na portu 80 a relativní URL TinWebu na tomto serveru je „/cgi-bin/tw“, budou v souboru libs.twb následující řádky: [ABC]NAME=Knihovna_ABC [ABC]HOST=pokusny.server.cz [ABC]PORT=00080 [ABC]PATH=/cgi-bin/tw

Strana 25

TinWeb v.11 – příručka správce systému 10.2. Soubor „libsldef.twb“ Tento soubor definuje, které z knihoven posané v souboru libs.twb (viz kap. 10.1) bude TinWeb nabízet k prohledávání a v jakém budou zobrazeny pořadí. Pokud soubor libs.twb obsahuje definice knihoven, jejichž zkrácené názvy budou například [AAA], [BBB], [CCC], [DDD] a [EEE] a my se rozhodneme, že budeme nabízet k prohledávání poslední tři z nich v obráceném pořadí, pak soubor libsldef.twb bude obsahovat následující řádky: 012[EEE] 103[DDD] 211[CCC] Třímístné dekadické číslo, kterým začíná každý řádek může mít libovolnou hodnotu od 0 do 999 a určuje pořadí, v jakém bude TinWeb knihovny v nabídce zobrazovat. Pokud se nějaké číslo opakuje na více řádcích, TinWeb bere v úvahu pouze první výskyt. Dále můžeme v souboru libsldef.twb definovat skupiny knihoven, takže uživatel tak bude moci jediným „kliknutím“ vybrat k prohledávání např. všechny knihovny jedné univerzity, všechny okresní knihovny atp. Chceme li například první dvě knihovny z výše uvedených sloučit do skupiny, která se bude jmenovat „První skupina“ a poslední tři do skupiny s názvem „Druhá skupina“, může soubor libsldef.twb obsahovat následující řádky: [XXX]GROUPNAME=První_skupina [XXX]ITEM001=[AAA] [XXX]ITEM002=[BBB] [YYY]GROUPNAME=Druhá_skupina [YYY]ITEM001=[CCC] [YYY]ITEM002=[DDD] [YYY]ITEM003=[EEE] Identifikátory [XXX] resp. [YYY] mohou být libovolné řetězce uzavřené v hranatých závorkách a TinWeb podle nich sdružuje řádky [….]GROUPNAME=… s jednotlivými řádky [….]ITEMnnn=…

Strana 26


11. Externí informace o lokacích dokumentů – soubor „location.twb“ Při zobrazování podrobností o konkrétním výtisku (přírůstkovém čísle) může TinWeb generovat HTML odkaz na externí objekt, například stránky pracoviště, na kterém je dokument umístěn. Tyto odkazy jsou vázány na pole, ve kterém je zapsána lokace výtisku, a definují se v souboru location.twb. Soubor musí být umístěn v adresáři popsaném parametrem CONFIG_FILES_PATH v souboru tw.run. Jednotlivé lokace a příslušné odkazy jsou po řádcích popsány takto: |||

.

Když TinWeb zobrazuje záznam, jehož lokační údaje jsou popsány v location.twb, tak u příslušné lokace bude ikona : Příslušná část záznamu pak vypadá například takto:

Poznámka: Názvy lokací musí být v location.twb zapsány přesně tak, jak jsou uvedeny v databázi T Series – ve stejné znakové sadě, se všemi bílými znaky atp. Nejspolehlivější způsob, jak získat správný seznam lokací je export přímo z T Series (viz manuály T Series). HTML odkaz musí být uveden jako úplné URL (<protocol>://<server_name>[:port]/<path>) .

Strana 27


12. Přidávání vlastních odkazů na liště nástrojů – soubor „extrnfn.twb“ Na liště nástrojů:

můžeme definovat další tlačítka s HTML odkazy. Definují se v souboru „extrnfn.twb“. Každé definované tlačítko má v tomto souboru tři řádky: XXIMG= XXURL= XXALT= , kde XX je libovolné dvoumístné dekadické číslo (pro dvě různé trojice popsaných řádků se nesmí opakovat). ALT_text_k_obrazku je číslo textu v souboru texts.twb (viz kap. 9). Příklad: Chceme, aby se na liště nástrojů objevovalo tlačítko:

jehož URL je http://nejaky.server.cz/obrazky/tlacitko_1.gif s odkazem http://www.google.com, a aby se při „najetí“ myší nad tlačítko objevoval alternativní text „vyhledávač Google“ který je v souboru texts.twb zapsán pod číslem 3002. Pak v souboru extrfn.twb musíme mít tři řádky:

00IMG=http://nejaky.server.cz/obrazky/tlacitko_1.gif 00URL=http://www.google.com 00ALT=3002 Nástrojová lišta TinWebu potom bude vypadat takto:

Strana 28


13. Interaktivní služby TinWebu - prodlužování výpůjčky a rezervace dokumentů TinWeb z bezpečnostních důvodů neumožňuje přímý zápis do databáze T Series, takže v případě že je potřeba nějaká data do databáze zapsat postupuje tak, že příslušná data vyexportuje do textového souboru a zavolá příslušnou službu T Series, která tato data vlastními prostředky do databáze naimportuje. Tak je tomu i v případech, kdy si uživatel chce přes TinWeb rezervovat nějaký dokument, nebo prodloužit své výpůjčky. Parametry, které přesně určují, jak se tyto dvě služby v TinWebu mají chovat jsou nastaveny v souboru tw.run a jsou přesně popsány v kapitole 2.3 této příručky. Aby obě popisované služby začaly fungovat, je nutné učinit následující kroky: Nastavení jména souboru pro export/import V příručce administrátora k T Series zjistíme název a cestu k souborům, ve kterých daná verze systému T Series očekává vyexportované požadavky na prodloužení nebo rezervaci. Tyto názvy použijeme jako hodnoty parametrů REZ_EXPORT_PATH a LOAN_EXPORT_PATH v souboru tw.run (viz kap. 2.3.7 a 2.3.11). Zjištění "LOGNAME" T Series Pro spuštění požadované akce, kterou je v tomto případě import požadavku na prodloužení výpůjčky, nebo rezervace dokumentu, jsou v systému T Series vyhrazená jména (UID). Při přihlášení pod těmito jmény systém T Series automaticky provádí danou akci. Jména se mohou v různých verzích T Series lišit, proto je potřeba je zjistit z příručky administrátora T Series. Vytvoření importovacího scriptu Po vyvolání požadavku na prodloužení, nebo rezervaci na straně WWW prohlížeče, TinWeb spustí script, z něhož se spustí clientský proces T Series. Tento proces provede v neinteraktivním režimu import požadavku na prodloužení, nebo rezervaci a ukončí se. Script pak musí jako poslední krok smazat soubor, vyexportovaný TinWebem, protože existence tohoto souboru slouží současně jako semafor, který TinWebu říká, že nemůže provádět další akci (prodloužení, rezervace). Pokud se tedy dva uživatelé pokusí prodloužit svou výpůjčku současně, nebo těsně za sebou, pak ten který je systémem obsloužen jako první, zablokuje druhého a ten pak čeká, až je ukončena akce prvního. V okamžiku, kdy je dokončena, je smazán vyexportovaný soubor, což dá TinWebu signál, že může vytvořit další export a spustit importovací script. Celá akce probíhá "mžikově" (řádově milisekundy), takže uživatelé čekající ve frontě subjektivně nezaregistrují žádné zpoždění. Script musí mít nastavena přístupová práva tak, aby ho byl TinWeb schopen spustit. Jinak řečeno - UID vlastnící běžící procesy TinWebu musí mít na importovací script právo alespon "r-x" (read, execute). Stejná práva musí mít tato UID na programy a konfigurační soubory systému T Series. Příklad rezervace: Máme povolenou rezervaci monografií (viz parametry popsané v kapitole 2.3), a v souboru tw.run máme nastavené parametry: REZ_EXPORT_PATH=/usr/tinman/run/rez_exp REZ_IMPORT_SCRIPT=/usr/tinman/run/rez_imp Z dokumentace k T Series zjistime, že "Logname" pro import rezervace je například imp_rez. Potom importovací script (/usr/tinman/run/rez_imp) může vypadat takto: #!/bin/bash export LOGNAME=imp_rez export TERM=vt100 export HOME=/usr/tinman /bin/chmod 777 /usr/tinman/run/r cd /usr/tinman/run /usr/tinman/fixit/fixit /usr/tinman/run/Runfile.twb > /usr/tinman/run/log.imp 2>&1 tput sgr0 tput cnorm /bin/rm /usr/tinman/run/rez_exp

Strana 29


Pozn: K příslušnému "Logname" (v tomto případě "imp_rez") musí mezi konfiguračními soubory T Series existovat příslušný "runfile" se jménem imp_rez.run (více viz manuál Správy systému T Series) Popsaný mechanismus se uplatňuje, pokud hodnota parametru HOST_ONLINE v souboru tw.run (viz kap. 2.3.14) má hodnotu ‘1‘. Pokud má parametr hodnotu ‘0’ říkáme tím TinWebu, že nad databází, se kterou právě pracuje, neběží žádný T Series server a pokus o import by tedy neměl žádný smysl (případy, kdy TinWeb pracuje pouze nad kopií „ostré“ databáze). Pokud ale přesto chceme umožnit požadavky na rezervace, měl by výše uvedený script obsah souboru popsaného parametrem REZ_EXPORT_PATH (viz kap. 2.3.7) pouze přidat do nějakého souboru, který pak správce T Series musí pravidelně importovat do aktuální „ostré“ databáze. Struktura, kterou takový soubor musí mít, je posaná v dokumentaci T Series. Tento postup se týká pouze rezervací. Pokud parametr HOST_ONLINE v souboru tw.run má hodnotu ‘0’, měli bychom současně potlačit možnost prodlužování výpůjček (viz parametr LOAN_EXTENSION popsaný v kap. 2.3.10).

Strana 30


Příloha A – seznam všech konfiguračních souborů TinWeb řídí své chování podle mnoha různých parametrů, uložených v konfiguračních souborech. Tato příručka se zabývá popisem těchto souborů a parametrů v nich. Zde uvádíme přehledný seznam všech souborů, které TinWeb potřebuje ke svému životu.

*fixit*.* Datové soubory systému T Series (viz kap. 1. a 2.1.1) dict-tag.twb Definice slovníků, které slouží k validaci vyhledávací masky TinWebu (viz kap. 4) doc-stat.twb Definice výpůjčních statusů dokumentů (viz kap. 7.3) encoding.twb Tabulka pro převod mezi vnitřním kódování diakritiky, v jakém uložena data v databázi T Series a kódováním UTF-8, které používá TinWeb (viz kap. 1) extrnfn.twb Definice vlastních tlačítek na liště nástrojů TinWebu (viz kap. 12) labels.* Řízení způsobu zobrazování jednotlivých polí v podrobnostech záznamu (viz kap. 7.1) libsldef.twb Lokální definice prohledávaných knihoven a skupin knihoven (viz kap. 10.2) libs.twb Definice parametrů všech prohledávaných knihoven (viz kap. 10.1) listing.ext Definice podrobností, zobrazovaných v seznamu záznamů (viz kap. 6) list-tag.twb Definice polí a podmínek pro listování (viz kap. 3) location.twb Externí informace o lokacích jednotlivých dokumentů (viz kap. 11) r-branch.twb Seznam poboček, u jejichž dokumentů TinWeb umožňuje provádění rezervací (viz kap. 2.3.5) record.ext Definice dalších podrobností u jednotlivých polí v zobrazených záznamech (viz kap. 7.2) r-locs.twb Seznam lokací, u jejichž dokumentů TinWeb umožňuje provádění rezervací (viz kap. 2.3.5) sfx-tags.twb Definice polí pro generování URL na SFX server (viz kap. 2.5.1) sort-tag.twb Definice polí, podle kterých TinWeb umožňuje řazení vyhledaných záznamů (viz kap. 8) subtitle.twb Rozšíření názvu knihovny – krátký vysvětlující, nebo upřesňující text (viz kap. 2.2.2)

Strana 31

TinWeb v.11 – příručka správce systému texts.twb Textové zprávy, popisy tlačítek, menu atp. (viz kap. 9) title-tag.twb Definice polí a podmínek pro vyhledávání (viz kap. 5) tw (tw.exe) TinWeb – hlavní spustitelný soubor systému TinWeb (viz kap. 1) tw.run (tw.exe.run) Hlavní konfigurační soubor TinWebu (viz kap. 2) xml-tags.* Definice polí, pro XML výstup, který TinWeb používá jako formát odpovědí pro systém Metalib (viz kap. 2.5.3)

Strana 32

TinWeb. příručka správce systému k verzi 11

Recommend Documents