TinWeb příručka správce systému k verzi 11 Květen 2004
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
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>=<hodnota>. 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
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
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: <LANG_01>. </LANG_01> <LANG_02>... </LANG_02> <LANG_xx>... </LANG_xx> kde dvojice značek <LANG_xx> </LANG_xx> 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 <A HREF= mailto:adresa >, 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
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
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
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
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
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 <HEAD> 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
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
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="<file_name>" 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: <LANG_01>. </LANG_01> <LANG_02>... </LANG_02> <LANG_xx>... </LANG_xx> kde dvojice značek <LANG_xx> </LANG_xx> ohraničují jednotlivé jazykové mutace příslušného textu Strana 13
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
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 #1 016019_SEARCH_FIELD_02=43 0101 0 #2 016019_TITLES_01=0303,0344,0909,0910,cc13,cc14,cc15,cc16,cc12 #3 016019_TITLES_02=ca08 #4 016019_ADD_SEARCH_FIELD_01_01=8080 123456 #5 016019_ADD_SEARCH_FIELD_01_02=8989 123456 #6 016019_ADD_SEARCH_FIELD_01_03=9898 123456 #7 016019_ADD_SEARCH_FIELD_01_04=8787 123456 #8 016019_ADD_SEARCH_FIELD_01_05=CA06 123456 #9 123456_SEARCH_FIELD_01=13 0101 1 #10 123456_SEARCH_FIELD_02=43 0101 1 #11 123456_TITLES_01=0303,0344,0909,0910,cc13,cc14,cc15,cc16,cc12 #12 123456_TITLES_02=ca08 #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
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 <I> /.</I> 10 0402 00 0000 000 0 <I> -.</I> 10 0409 00 0000 000 0 <I> - </I> 10 0302 00 0000 000 0 <I> : </I> 10 0403 00 0000 000 0 <I>,.</I> 10 0404 00 0000 000 0 <I> - </I> 10 0301 00 0000 000 0 <I> ISBN </I> 10 9965 00 0000 000 0 <FONT COLOR="GREEN"><< >></FONT> # 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: YY: abcdefgh: čtyřmístné hexadecimální číslo pole, jehož obsah má TinWeb zobrazovat 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) 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: <A HREF= abcd TARGET= _new >abcd</a> f Pokud má přepínač hodnotu 1, TinWeb obsah pole obalí párovou HTML značkou <PRE></PRE>. 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
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: kde 1a 1b mnop 2a,2b,2c,...: 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
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: kde N X1:F1:X2:F2 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: kde No L string... 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=<nazev knihovny> [ZKR]HOST=<IP adresa, nebo jmeno serveru s TinWebem> [ZKR]PORT=<cislo TCP portu, na kterem bezi httpd s TinWebem> [ZKR]PATH=<relativni URL TinWebu>, 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