Content Manager OnDemand for i verze 7 vydání 1 Common Server ODWEK - Instalace a konfigurace SC09-3879-00
Content Manager OnDemand for i verze 7 vydání 1 Common Server ODWEK - Instalace a konfigurace SC09-3879-00
Poznámka Před použitím těchto informací a produktu, ke kterému se vztahují, si přečtěte informace uvedené v části Poznámky na stránce 173. Toto vydání se týká produktu IBM Content Manager OnDemand for i (číslo produktu 5770-RD1) verze 7 vydání 1 a všech následných vydání a modifikací, dokud nebude v nových vydáních uvedeno jinak. Copyright IBM Corporation 2001, 2010.
Obsah O publikaci IBM OnDemand for i Common Server Web Enablement Kit - Instalace a konfigurace (SC09-3879).. v Kdo by měl číst tuto knihu........... v Jak je tato kniha uspořádána.......... v Nezbytné předpoklady a související informace.... v Jiné informace dostupné v síti WWW...... vi Co byste již měli vědět.......... vi Informační centrum pro systém OnDemand.... vi OnDemand - informace o přístupnosti...... vii IBM i Navigator............ vii Jak zasílat připomínky........... vii Přehled změn............ ix Nové funkce............... ix Rozšíření příkazů............. xi Další funkce přidané dříve a zahrnuté do verze 7.1 produktu OnDemand............ xii Při přechodu na verzi 7.1 dbejte následujících skutečností xii Kapitola 1. Přehled o produktu..... 1 O programovacích rozhraních......... 2 Příklady použití rozhraní ODWEK Java API z obchodní perspektivy............... 4 Běžný příklad použití u zákazníka....... 4 O prohlížečích.............. 5 Použití aplikace ODWEK........... 6 Funkce produktu............. 6 Funkce Add Annotation (Přidání anotace)..... 7 Funkce Change Password (Změna hesla)..... 7 Funkce Document Hit List (Seznam nalezených dokumentů).............. 7 Funkce Logoff (Odhlášení)......... 7 Funkce Logon (Přihlášení).......... 7 Funkce Retrieve Document (Načtení dokumentu)... 7 Funkce Search Criteria (Vyhledávací kritéria).... 7 Funkce Server Print Document (Tisk dokumentů na serveru)............... 7 Funkce Update Document (Aktualizace dokumentu).. 8 Funkce View Annotations (Zobrazení anotací).... 8 Funkce Delete Annotations......... 8 Zabezpečení serveru a dat........... 8 Produkt IBM Web Interface for Content Management (WEBi)................ 9 Kapitola 2. Kontrolní seznam instalace 11 Kapitola 3. Instalace a konfigurace HTTP serveru............ 13 Požadavky na instalaci........... 13 Jiné požadavky.............. 13 Instalace v operačním systému IBM i....... 14 Další krok............... 14 Zadání souboru ARSWWW.INI......... 14 [@SRV@_DEFAULT].......... 15 [@SRV@_server]............ 16 [CONFIGURATION]........... 17 [SECURITY]............. 23 [AFP2HTML]............. 25 [AFP2PDF].............. 26 [MIMETYPES]............ 27 [ATTACHMENT IMAGES]......... 31 [NO HTML]............. 32 [DEFAULT BROWSER].......... 33 [browser].............. 40 [DEBUG].............. 41 Příklad souboru ARSWWW.INI........ 41 Další krok.............. 44 Kapitola 4. Konfigurace vzorových aplikací.............. 45 LOGON.HTM.............. 46 CREDIT.HTM.............. 46 TEMPLATE.HTM............ 47 Další krok............... 47 Kapitola 5. Instalace webových prohlížečů............. 49 Přehled................ 49 Požadavky............... 50 Instalace................ 50 AFP Web Viewer............. 50 Distribuce uživatelsky definovaných souborů..... 51 Instalace souborů AFP Web Viewer...... 52 Přidávání podadresářů.......... 52 Ukládání uživatelsky definovaných souborů.... 53 Konfigurace souborů fontů......... 53 Vytvoření instalačního souboru AFP Web Viewer.. 54 Instalace softwaru AFP Web Viewer na pracovní stanici uživatele.............. 54 Mapování fontů AFP............ 55 Zobrazení zpráv AFP............ 55 Zobrazení překryvů............ 56 Image Web Viewer............ 56 Java prohlížeč Line Data Viewer........ 57 Další krok............... 59 Kapitola 6. Ověření instalace..... 61 Ověření programu CGI........... 61 Ověření servletu............. 62 Odstraňování problémů........... 62 Další krok............... 63 Dodatek A. Referenční informace pro rozhraní CGI API.......... 65 Funkce Add Annotation (Přidání anotace)...... 66 Funkce Change Password (Změna hesla)...... 69 Copyright IBM Corp. 2001, 2010 iii
Funkce Document Hit List (Seznam nalezených dokumentů)............... 71 Funkce Logoff (Odhlášení).......... 75 Funkce Logon (Přihlášení).......... 77 Funkce Print Document (Server) (Tisk dokumentu)... 79 Funkce Retrieve Document (Načtení dokumentu)... 83 Funkce Search Criteria (Vyhledávací kritéria).... 86 Funkce Update Document (Aktualizace dokumentu).. 88 Funkce Zobrazení anotací (View Annotations).... 90 Dodatek F. Transformace AFP na PDF 153 Zadání souboru AFP2PDF.INI......... 153 Prohlížení konvertovaných dokumentů...... 154 Dodatek G. Konfigurační soubory HTTP serveru........... 155 HTTP Apache Server........... 155 WebSphere Application Server........ 156 Dodatek B. Reference pro Java servlet 93 Dodatek C. Reference pro rozhraní Java API................ 95 Dodatek D. Průvodce programováním rozhraní Java API.......... 97 Architektura klient/server.......... 97 Balení pro prostředí Java........... 97 Rady k programování.......... 99 Konfigurování systémových parametrů..... 99 Příklad souboru ARSWWW.PROPS...... 100 Trasování a diagnostické informace....... 100 Trasování.............. 101 Zacházení s výjimkami.......... 101 Konstanty............... 102 Spuštění aplikace ODWEK.......... 102 Připojování k serveru OnDemand........ 102 Vytvoření připojení........... 103 Nastavení a získání hesel......... 103 Práce se serverem OnDemand......... 103 Připojení k nepředvolenému portu pomocí rozhraní Java API................. 106 Sestavení ODConfig............ 106 Výpis skupin aplikací ve složce........ 106 Hledání složky............. 109 Vyhledání složky pomocí řetězce SQL...... 114 Zrušení hledání............. 118 Výpis kritérií hledání........... 120 Výpis složek a informací o složkách....... 124 Zobrazení informací o kritériích složky...... 125 Zobrazení seznamu dokumentů........ 127 Načtení dokumentu............ 131 Tisk dokumentu............. 134 Výpis informací o poznámkách........ 136 Přidání poznámky............ 138 Odstranění poznámky........... 141 Aktualizace dokumentu........... 143 Změna hesla.............. 146 Dodatek E. Transformace AFP na HTML............... 149 Formát souboru AFP2HTML.INI........ 149 Volby pro službu AFP2WEB......... 150 Prohlížení konvertovaných dokumentů..... 151 Dodatek H. Žádný HTML výstup... 157 Výstup ASCII s oddělovači......... 157 Funkce Logon (Přihlášení).......... 157 Poznámky.............. 158 Funkce Search Criteria (Vyhledávací kritéria).... 158 Poznámky.............. 158 Funkce Document Hit List (Seznam nalezených dokumentů).............. 159 Poznámky.............. 159 Funkce View Annotations (Zobrazení anotací).... 160 Chybová zpráva............. 160 Poznámky.............. 160 Dodatek I. Podpora národního jazyka 161 Konfigurace aplikace ODWEK pro jazyky používající DBCS................ 161 Konverze kódových stránek v aplikaci ODWEK... 161 Knihovna konverzí ICU........... 162 Dodatek J. Nástroje k určování problémů............. 163 Java Dump.............. 164 IBM Thread and Monitor Dump Analyzer.... 164 Diagnostické příkazy Java.......... 165 jmap............... 165 jstat................ 165 HPROF: Heap Profiler.......... 165 HAT: Heap Analysis Tool......... 166 Diagnostic Tool for Java Garbage Collector.... 166 HeapAnalyzer............ 166 HeapRoots............. 167 Dodatek K. Vícejazyčná podpora pro CGI pomocí serveru Apache HTTP Server.............. 169 Nezbytný software............ 169 Implementace.............. 169 Poznámky............. 173 Ochranné známky a servisní značky....... 174 Rejstřík.............. 177 iv ODWEK - Instalace a konfigurace
O publikaci IBM OnDemand for i Common Server Web Enablement Kit - Instalace a konfigurace (SC09-3879) Kdo by měl číst tuto knihu Jak je tato kniha uspořádána Tato kniha uvádí informace, které můžete použít k plánování, instalaci, konfiguraci a užívání produktu IBM Content Manager OnDemand for i Version 7 Release 1 Common Server (OnDemand) Web Enablement Kit. Tato kniha je určena hlavně pro systémové administrátory, kteří potřebují implementovat, instalovat a udržovat software a aplikace OnDemand Web Enablement Kit (ODWEK). Také ji mohou používat programátoři, kteří potřebují integrovat server OnDemand s webovými aplikacemi. Tato kniha poskytuje informace, které potřebujete k instalaci a konfiguraci softwaru ODWEK k plánování přístupu uživatelů k datům z prostředí systému IBM Content Manager OnDemand for i Common Server pomocí webového prohlížeče. Tato publikace obsahuje následující sekce: v Kapitola 1, Přehled o produktu, na stránce 1 v Kapitola 3, Instalace a konfigurace HTTP serveru, na stránce 13 v Kapitola 4, Konfigurace vzorových aplikací, na stránce 45 v Kapitola 5, Instalace webových prohlížečů, na stránce 49 v Dodatek A, Referenční informace pro rozhraní CGI API, na stránce 65 v Dodatek B, Reference pro Java servlet, na stránce 93 v Dodatek C, Reference pro rozhraní Java API, na stránce 95 v Dodatek D, Průvodce programováním rozhraní Java API, na stránce 97 v Dodatek E, Transformace AFP na HTML, na stránce 149 v Dodatek F, Transformace AFP na PDF, na stránce 153 v Dodatek G, Konfigurační soubory HTTP serveru, na stránce 155 v Dodatek H, Žádný HTML výstup, na stránce 157 v Dodatek I, Podpora národního jazyka, na stránce 161 v Dodatek J, Nástroje k určování problémů, na stránce 163 v Dodatek K, Vícejazyčná podpora pro CGI pomocí serveru Apache HTTP Server, na stránce 169 Nezbytné předpoklady a související informace Jako výchozí bod při vyhledávání technických informací o systému IBM i použijte aplikaci Informační centrum IBM i. Přístup k aplikaci Informační centrum je možný dvěma způsoby: v Na webu: http://www.ibm.com/systems/i/infocenter/ v Z disků CD-ROM, které jste obdrželi s programem IBM i: Informační centrum pro systém IBM i SK3T-4091-07 Informační centrum IBM i obsahuje: Copyright IBM Corp. 2001, 2010 v
v Aktualizované a nové informace včetně instalace a přechodu na vyšší verzi IBM i, migrace dat, servisu a odstraňování problémů, dostupnosti, integrace System i, připojení k systému System i, databází, systémů Linux, WebSphere, Java, příkazů CL, systémových rozhraní API a příruček. v Poradce a další interaktivní nástroje, které vám pomohou s odstraňováním problémů a s konfigurací vašeho softwaru IBM i. Jiné informace dostupné v síti WWW Další informace o systému IBM i jsou k dispozici na WWW. K obecným informacím můžete přistupovat z domovské stránky systému IBM i, která je k dispozici na adrese: http://www.ibm.com/systems/i/ Přístup k seminářům o pokročilých funkcích systému IBM i získáte prostřednictvím webového serveru Technical Studio na adrese: http://www.redbooks.ibm.com/tstudio/ Prostřednictvím Internetu můžete kdekoli na světě získávat informace, vybírat, objednávat a získávat kumulativní balíky PTF produktu IBM i. PTF pro systém IBM i (ke stažení) a dokumenty PSP (Preventive Service Planning) jsou k dispozici na níže uvedené internetové adrese: http://as400service.ibm.com Dokumentace k produktu se ze stránky knihovny přesunula na stránku podpory v rámci webového serveru k produktu CM OnDemand for i. Chcete-li si prohlédnout seznam veškeré dostupné dokumentace k produktu OnDemand for i, přejděte na stránku http://www.ibm.com/software/data/ondemand/400/support.html. Podívejte se na levý sloupec do části "Self help", záhlaví "Learn". Co byste již měli vědět Dokumentace k softwaru ODWEK předpokládá, že jste obeznámeni s Internetem, webovými servery, prohlížeči, protokolem TCP/IP (Transmission Control Protocol/Internet Protocol), sítěmi a produktem OnDemand. Tato kniha předpokládá, že jste obeznámeni s jazykem Hypertext Markup Language (HTML), s Common Gateway Interface (CGI) a programováním v jazyce Java, že dodáváte obsah pro webové stránky, že víte, jak konfigurovat a provozovat server Hypertext Transfer Protocol (HTTP) a Java webový server a Java aplikační server, a že dokážete administrovat server OnDemand. Jestliže zamýšlíte používat prohlížeče Java AFP2HTML Viewer, musíte získat službu AFP2WEB Transform a musíte ji nainstalovat a nakonfigurovat na serveru, na kterém máte uloženu aplikaci ODWEK. Více informací o AFP2WEB Transform získáte u svého zástupce IBM. Dále musíte zajistit konfigurační volby pro dokumenty a zdroje Advanced Function Presentation (AFP), které zamýšlíte zpracovávat prostřednictvím AFP2WEB Transform. Další informace o konfiguračním souboru najdete v tématu Dodatek E, Transformace AFP na HTML, na stránce 149. Jestliže zamýšlíte konvertovat dokumenty AFP načtené ze serveru OnDemand na dokumenty PDF, které lze prohlížet pomocí programu Adobe Acrobat Viewer, musíte si zakoupit službu AFT2PDF Transform od IBM a musíte ji nainstalovat a nakonfigurovat na webový server. Další informace o službě AFP2PDF Transform vám sdělí odpovědný pracovník IBM. Dále musíte zajistit konfigurační volby pro dokumenty a zdroje AFP, které zamýšlíte zpracovávat prostřednictvím AFP2PDF Transform. Další informace o konfiguračním souboru najdete v tématu Dodatek F, Transformace AFP na PDF, na stránce 153. Informační centrum pro systém OnDemand Kromě Informačního centra pro systém IBM i (které bylo zmíněno výše) nezapomeňte navštívit Informační centrum pro systém OnDemand, které se zaměřuje pouze na informace vi ODWEK - Instalace a konfigurace
vztahující se k produktu CM OnDemand. OnDemand Information Center poskytuje rychlý, online přístup k informacím o produktu. Jde o úložiště dokumentace s úlohami, které vám umožňuje vyhledávání příkazů, chybových kódů a dalších témat v celé knihovně produktu. Můžete si označit zajímavé nebo obecně platné stránky pro příští snadné použití. Chcete-li získat přístup k Informačnímu centrum pro systém OnDemand, přejděte na http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1//index.jsp OnDemand - informace o přístupnosti Úplné informace o funkcích přístupnosti podporovaných tímto produktem najdete v publikaci IBM Content Manager OnDemand for i: Common Server Administration Guide. IBM i Navigator IBM i Navigator je výkonné grafické uživatelské rozhraní pro správu vašich serverů IBM i. Funkce produktu IBM i Navigator zahrnují navigaci v systému, konfiguraci, funkce pro plánování a online nápovědu, která vás provede vašimi úlohami. Produkt IBM i Navigator usnadňuje a zefektivňuje provoz a správu serveru a je jediným uživatelským rozhraním, které umožňuje přístup k novým a rozšířeným funkcím systému IBM i. Zahrnuje také funkci Centrální správa, pomocí které je možné spravovat několik serverů z centrálního systému. Jak zasílat připomínky Další informace o produktu IBM i Navigator najdete v rámci aplikace IBM Informační centrum pro systém i a na adrese: http://www.ibm.com/servers/eserver/iseries/navigator/ Vaše zpětné informace pomáhají IBM poskytovat kvalitní informace. Pokud máte nějaké připomínky k této publikaci nebo jiné dokumentaci k produktům OnDemand, laskavě nám je zašlete. Navštivte stránku IBM Data Management Online Reader's Comment Form (RCF) na adrese www.ibm.com/software/data/rcf. Nezapomeňte uvést jméno produktu, číslo verze produktu a název knihy. Pokud komentujete konkrétní text, uve te, prosím, umístění textu (například název kapitoly a oddílu, číslo tabulky, číslo stránky nebo název tématu). O publikaci IBM OnDemand for i Common Server Web Enablement Kit - Instalace a konfigurace (SC09-3879) vii
viii ODWEK - Instalace a konfigurace
Přehled změn Nové funkce Toto vydání příručky IBM Content Manager OnDemand for i: Common Server ODWEK - Instalace a konfigurace obsahuje nové technické informace. Mohou se vyskytnout případy, kde byla provedena změna, která zde není označena pruhem. Mezi důležité změny, které je nutné vést v patrnosti, patří tyto skutečnosti: v v v Byly přidány nové příkazy, které nahrazují programová volání pro řadu různých funkcí OnDemand: Nový příkaz CRTINSTOND (Vytvoření instance pro OnDemand) použijete namísto volání programu QRLMINST k vytvoření nových instancí OnDemand. Nový příkaz poskytuje další parametry navíc oproti těm, které poskytuje program QRLMINST. Příkaz vám umožňuje specifikovat v rámci příkazu parametry týkající se portu, automatického spuštění, bezpečnosti a oblasti ASP, takže v mnoha případech již není nutno editovat konfigurační soubory ars.ini a ars.cfg. Povšimněte si, že rozhraní programového volání již není podporováno. Jediným podporovaným rozhraním ve verzi 7.1 je příkazové rozhraní. Nový příkaz MRGSPLFOND (Sloučení souborů pro souběžný tisk) použijete namísto starého vzorového příkazu MRGSPLFOND (dodaného v předchozím vydání) nebo namísto volání programu QRLMQMRGF ke sloučení malých souborů pro souběžný tisk do jednoho většího souboru před archivováním. Nový příkaz MRGSPLFOND dodávaný ve verzi 7.1 obsahuje nové a zdokonalené parametry, které poskytují výrazně více funkcí než předchozí vzorový příkaz. Veškeré vaše existující programy, které používají předchozí vzorový příkaz musí být změněny tak, aby používaly parametry verze 7.1. Příkaz MGRMEDRDAR (Migrování média) použijete namísto volání programu QRLCSFAMMF k migrování dat OnDemand z jednoho typu média na jiný. (Tento příkaz již byl ve verzi 6.1 programu OnDemand k dispozici, ale je zde uveden proto, abyste si povšimli, že volání programů již není podporováno. Ve verzi 7.1 je podporováno pouze příkazové rozhraní.) Příkaz CHGPLDOND (Změna data úrovně strategie) použijete namísto volání programu QRLCASMCLD, pokud budete potřebovat změnit data úrovně strategie u archivovaných dat. (Tento příkaz již byl ve verzi 6.1 programu OnDemand k dispozici, ale je zde uveden proto, abyste si povšimli, že volání programů již není podporováno. Ve verzi 7.1 je podporováno pouze příkazové rozhraní.) Byla přidána nová funkce v produktu System i Navigator, která nahradí programové volání pro nastavení diskových oblastí NFS (Network File System) při použití s aplikací OnDemand. Používejte nové panely NFS (Network File System) modulu plug-in OnDemand System i Navigator namísto volání programu QRLCASMNFS. Pokyny k použití NFS s produktem OnDemand naleznete v příručce Content Manager OnDemand for i: Common Server Administration Guide. Rozšířené schopnosti správy doby uchování jsou nyní ve verzi 7.1 k dispozici jako samostatná placená funkce produktu OnDemand for i, která poskytuje nové funkce podržení a uvolnění dat pro koncové klienty a parametry HOLD-ADD a HOLD-RELEASE pro rozhraní API ARSDOC a rozhraní Java API ODHold a ODHit aplikace ODWEK. Vypršení platnosti zadržených dokumentů lze zabránit, dokud není zadržení uvolněno. Další informace naleznete v tématu o nové položce Copyright IBM Corp. 2001, 2010 ix
ARS_SUPPORT_HOLD pro soubor ARS.CFG v příručce IBM Content Manager OnDemand for i: Common Server Planning and Installation Guide. DŮLEŽITÁ POZNÁMKA: Při použití rozšířené správy doby uchování musí mít produkt OnDemand Disk Storage Manager (DSM) plnou kontrolu nad zpracováním vypršení platnosti. Používáte-li produkt OnDemand Archive Storage Manager (ASM) nebo Tivoli Storage Manager, musíte deaktivovat schopnost těchto správců úložiš ukončovat platnost dat. Například v produktu ASM to znamená vypnout nebo odstranit veškeré úrovně expirace ve strategiích migrace, které se používají se skupinami aplikací OnDemand, jež mají aktivovány rozšířenou správu doby uchování. v Všechna data týkající se správy úložiště byla přesunuta z knihovny QUSRRDARS do individuální knihovny instance, se kterou jsou spojena. V knihovně QUSRRDARS zůstává několik objektů. Díky této změně není potřeba přesunovat knihovnu QUSRRDARS do nezávislé diskové oblasti (IASP). v Knihovnu instance lze umístit do některé uživatelské oblasti ASP (ASP 2 až 32). v v v v v v v v v Byla přidána nová aplikační skupina System Load, která obsahuje jednu položku pro každý vstupní soubor načtený do produktu OnDemand. Pomocí klienta OnDemand můžete ověřit, která data byla úspěšně načtena do produktu OnDemand. K dispozici je nový obslužný program na bázi Java ARSSUPPORT pro shromaž ování diagnostických informací jako jsou záznamy protokolu. Tento nástroj je užitečný v případě, kdy potřebujete nahlásit problémy softwarové podpoře společnosti IBM. Podrobnější informace naleznete v příručce IBM Content Manager OnDemand for i: Common Server Administration Guide. Produkt Xerces2 Java Parser Version 2.6.2 je zahrnut do této verze produktu Content Manager OnDemand for i. Pokyny k použití této verze syntaktického analyzátoru naleznete v příručce IBM Content Manager OnDemand for i: Common Server Planning and Installation Guide. Ve verzi 7.1 je začleněna řada změn aplikace OnDemand Web Enablement Kit (ODWEK). Identifikaci změn vám usnadní pruhy označující změny v textu v rámci této příručky IBM Content Manager OnDemand for i: Common Server ODWEK - Instalace a konfigurace. Byly provedeny aktualizace funkce pro administraci dávek (rozhraní API ARSXML), včetně nových, přejmenovaných a odebraných atributů. Například hodnota atributu jména _ALL byla odebrána u aktualizace a odstranění. (Hodnota _ALL je stále podporována u operací exportu.) Podrobnější informace naleznete v příručce IBM Content Manager OnDemand for i: Common Server Administration Guide. Byly přidány nové vzorové programy a existující vzory byly aktualizovány. Bližší informace naleznete ve zdrojovém souboru QSAMPLES2 v knihovně QRDARS. Byla přidána dokumentace ohledně vypršení platnosti v produktu Archive Storage Manager (ASM), což může eliminovat potřebu spustit produkt Disk Storage Manager (DSM). Tato schopnost byla k dispozici již ve verzi OnDemand 6.1, ale je zde uvedena proto, abyste si povšimli, že k tomuto tématu byla přidána dokumentace v příručce IBM Content Manager OnDemand for i: Common Server Administration Guide. Také si přečtěte výše uvedenou DŮLEŽITOU POZNÁMKU u správy doby uchování dat týkající se existujících funkcí pro správu úložiště produktu OnDemand a nových schopností v oblasti správy doby uchování dat. Funkce AFP2WEB Transform (zahrnující jak AFP2PDF tak AFP2HTML), která umožňuje prohlížet data AFP za použití rozhraní ODWEK (OnDemand Web Enablement Kit), je ve verzi 7.1 k dispozici jako samostatně placená funkce produktu OnDemand. Další informace o funkci AFP2WEB získáte u zástupce nebo obchodního partnera IBM. Modul pro indexování PDF podporuje seskupování zdrojů a odebrání nepoužívaných zdrojů. Po aktivaci seskupování zdrojů se obecné zdroje v rámci dokumentů v jednom vstupním souboru seskupí a uloží do jednoho objektu, a nepoužívané zdroje lze před indexováním odebrat. Byly přidány nové parametry modulu pro indexování PDF x ODWEK - Instalace a konfigurace
Rozšíření příkazů v v v v v v v v (RESTYPE a REMOVERES), aby podporovaly tuto novou schopnost. Více informací naleznete v příručce IBM Content Manager OnDemand for i: Common Server Indexing Reference. Integrace s platformou FileNet P8 je nyní ve verzi 7.1 podporována jako samostatně placená funkce, která vám umožní posílat metadata produktu Content Manager OnDemand for i do produktu FileNet a využívat schopností FileNet Business Process Management (BPM) a FileNet Records Manager (RM). Další informace o této funkci Content Federation Services for OnDemand naleznete v tématu o nové položce ARS_SUPPORT_CFSOD souboru ARS.CFG v příručce IBM Content Manager OnDemand for i: Common Server Planning and Installation Guide a v tématu o nové funkci CFSOD-FED pro ARSDOC v příručce IBM Content Manager OnDemand for i: Common Server Administration Guide. Dokumentace o různých oblastech dat, která řídí funkce produktu OnDemand, byla konsolidována a přidána do příručky IBM Content Manager OnDemand for i: Common Server Administration Guide. Do postprocesorového vstupního souboru programu OnDemand bylo přidáno nové záhlaví sloupce. Toto nové záhlaví začíná znakem "<" a končí znakem ">". Je nutno otestovat vaše postprocesorové programy, aby se prověřila kompatibilita s tímto dodatkem. Nový typ monitoru *DIR2 byl přidán do příkazu STRMONOND (Spuštění monitoru pro OnDemand), který je vyvolán soubory typu.ard (jako rozhraní API ARSLOAD) namísto soubory typu.ind jako současný typ monitoru *DIR. Povšimněte si, že typ monitoru *DIR v příkaze ENDMONOND (Ukončení monitoru pro OnDemand) ukončí oba typy monitoru, bez ohledu na to, zda byl spuštěn jako monitor *DIR nebo *DIR2. Dva nové parametry byly přidány do příkazu STRMONOND (Spuštění monitoru pro OnDemand). Parametr ENDSVR (Ukončení serveru) vám umožní ukončit instanci serveru, když monitor skončí. Parametr JOB (Název úlohy monitoru) vám umožní zadat název, který chcete používat pro úlohu monitoru. Dva nové parametry byly přidány do příkazů ADDRPTOND (Přidání sestavy do OnDemand), PRTRPTOND (Tisk sestavy z OnDemand), STRMONOND (Spuštění monitoru pro OnDemand), RMVRPTOND (Odebrání sestavy z OnDemand), STRIMPOND (Spuštění importu do OnDemand), STRASMOND (Spuštění správy archivního úložiště), STRDSMOND (Spuštění správy diskového úložiště), MRGSPLFOND (Sloučení souborů pro souběžný tisk), CHGPLDOND (Změna data úrovně strategie) a MGRMEDRDAR (Migrování média). Pomocí parametru INSTANCE(*DFT), který je novou předvolbou namísto INSTANCE(QUSROND), lze získat předvolené jméno instance z datové oblasti nazvané QDFTINST, takže není potřeba jméno instance explicitně v každém příkazu zadávat. Podrobnější informace o datové oblasti QDFTINST naleznete v nápovědě online a v příručce IBM Content Manager OnDemand for i: Common Server Administration Guide. Zadáním parametru STRSVR (Spuštění serveru) lze spustit instanci serveru, když je daný příkaz dokončen. (Parametr STRSVR se nepoužívá u příkazu CHGPLDOND.) Další informace najdete v nápovědě online. Nový parametr VALIDATE přidaný do příkazu STRDSMOND (Spuštění správy diskového úložiště) zajiš uje, aby všechny soubory diskového úložiště byly správně propojeny a obsahovaly řádná souborová povolení. Parametr Maximální počet spouštěných monitorů v příkazu STRMONOND (Spuštění monitoru pro OnDemand), když se spouští monitor výstupní fronty, byl zredukován z 99 na 9, aby se zabránilo blokujícím zpožděním, ke kterým může docházet v případě spuštění velkého počtu monitorů vůči stejné výstupní frontě. Přehled změn xi
Další funkce přidané dříve a zahrnuté do verze 7.1 produktu OnDemand v v v v v Parametr INSTANCE příkazů STRTCPSVR (Spuštění serveru TCP/IP) a ENDTCPSVR (Ukončení serveru TCP/IP) je nyní podporován, když se zadává *ONDMD (pro OnDemand) pro parametr SERVER. Můžete uvést konkrétní instanci, která se má spustit, nebo použít tři speciální hodnoty (*DFT, *ALL, *AUTOSTART). Povšimněte si, že volání programu QRLMCTL pro spuštění nebo ukončení instance je stále podporováno, ale doporučuje se použití příkazů STRTCPSVR a ENDTCPSVR. Další informace naleznete v nápovědě online a v příručce IBM Content Manager OnDemand for i: Common Server Planning and Installation Guide. Protokol LDAP (Lightweight Directory Access Protocol), otevřený průmyslový standard, který zajiš uje sdílení informací mezi distribuovanými aplikacemi ve stejné síti, lze použít ke správě základní autentizace při přihlašování přímo na serveru. Další informace naleznete v příručce IBM Content Manager OnDemand for i: Common Server Administration Guide. Podpora adresovacího formátu IPv6 (Internet Protocol Version 6), který je revizí adresovacího schématu IPv4 pro TCP/IP je zahrnuta do verze 7.1 produktu Content Manager OnDemand for i. Další informace naleznete v příručce IBM Content Manager OnDemand for i: Common Server Planning and Installation Guide. *ASM lze nyní zadat jako cíl (TGT) v příkazu MGRMEDRDAR (Migrace média), takže lze přesunovat data z architektury Spool File Archive (spravované pomocí RMC) do architektury Common Server (spravované pomocí ASM). Modul pro indexování PDF nyní umožňuje používat pro část jména vstupního souboru indexovou hodnotu, když se data ukládají pomocí rozhraní API ARSLOAD. Při přechodu na verzi 7.1 dbejte následujících skutečností v v v v v Pokud přecházíte na vyšší verzi z předchozí verze produktu OnDemand, musíte mít spuštěný server OnDemand verze 7.1.2.8 nebo vyšší předtím, než budete přecházet na verzi 7 vydání 1 produktu Content Manager OnDemand for i. Chcete-li určit vaši současnou verzi serveru, vyhledejte pokyny v příručce IBM Content Manager OnDemand for i: Common Server Planning and Installation Guide. Verze 7.1 produktu Content Manager OnDemand for i nepodporuje software klienta OnDemand před verzí 7.1.2.0. To zahrnuje, mezi jinými, klienta OnDemand Windows (koncový uživatel), rozhraní API ODWEK CGI/Servlet/Java, CICS a II4C (eclient). Klient OnDemand Administrator musí mít stejnou verzi nebo vyšší než server OnDemand. U verze 7.1 produktu Content Manager OnDemand for i musí mít klient OnDemand Administrator verzi 8.4.1.3 nebo vyšší. Spuštění instance nebo spuštění procesu ASM (Správa archivního úložiště) poprvé po přechodu na verzi 7.1 zabere delší dobu než obvykle kvůli konverzi souborů a přesunu dat a objektů specifických pro instanci z QUSRRDARS do knihoven instance. Neukončujte úlohu serveru nebo proces ASM, když máte obavy, že zpracování neprobíhá. Během konverze souborů a přesunu dat z QUSRRDARS do knihovny instance se zapisují do protokolu úlohy stavové zprávy, které můžete zkontrolovat a potvrdit si, že je úloha v chodu. Pokud v knihovně QUSRRDARS existuje popis úlohy (typ objektu *JOBD), který odpovídá jménu instance OnDemand definovanému pro váš systém, přesune se popis úlohy z knihovny QUSRRDARS do knihovny instance. Když produkt OnDemand hledá popis úlohy, kterou má spustit na serveru instance, nejprve OnDemand hledá objekt *JOBD, který má stejné jméno jako jméno instance v knihovně instance. Pokud takový nenajde, hledá OnDemand objekt *JOBD, který má stejné jméno jako je jméno instance v knihovně QUSRRDARS. Pokud takový nenajde, použije OnDemand popis úlohy QOND400 umístěný v knihovně QRDARS. xii ODWEK - Instalace a konfigurace
v v v v v v v Ve verzi 7.1 byla následující programová volání nahrazena novými příkazy nebo novým rozhraním v produktu System i Navigator: Vzorový program MRGSPLF a předchozí vzorový příkaz MRGSPLFOND nahra te novým příkazem MRGSPLFOND. Program QRLMINST nahra te příkazem CRTINSTOND. Program QRLCASMNFS nahra te plug-in rozhraním System i Navigator. Program QRLCSFAMMF nahra te příkazem MGRMEDRDAR. Program QRLCASMCLD nahra te příkazem CHGPLDOND. Nabídka CMDOND (Příkazy OnDemand), která zahrnuje všechny příkazy produktu OnDemand for i Common Server, je jedinou nabídkou 5250, která se dodává s produktem OnDemand verze 7.1. Následující nabídky OnDemand 5250 byly odebrány: CMDRDAR ONDEMAND RDARS RDARSDEF RDARSM RDARSOBJ RDARSRLA RDARSRPT RDARSUTL Pokud máte nainstalované fonty pro použití s modulem pro indexování PDF, měli byste ověřit umístění fontů a v případě potřeby je přesunout do adresářů, které modul pro indexování PDF vyžaduje. Podrobnější informace naleznete v příručce IBM Content Manager OnDemand for i: Common Server Indexing Reference. Tiskový soubor QPRLR133 v knihovně QRDARS již není součástí produktu, protože to byla komponenta Archívu souborů pro souběžný tisk, který již není k dispozici. Tiskový soubor se odebere při instalaci verze 7.1. Program QRLCASMUFS již nepodporuje parametr *ALL pro jméno instance, protože všechny soubory specifické pro instanci jsou nyní v jednotlivých knihovnách instance. Když voláte program, musíte uvést konkrétní instanci. Než budete používat nejnovější verzi produktu OnDemand Web Enablement Kit (ODWEK) CGI/Servlet, musíte odstranit všechny soubory z mezipaměti produktu Web Enablement Kit a adresáře typu temp. Soubory jsou určeny položkami CACHEDIR a TEMPDIR v souboru arswww.ini. Existující implementace Spool File Archive je nutno migrovat z prostředí Spool File Archive do prostředí Common Server předtím, než je systém, na kterém jsou spuštěny, převeden na verzi 7.1. Produkt Content Manager OnDemand ve vydání 5.3 a 5.4 obsahoval prostředí Common Server a také původní prostředí Spool File Archive, AnyStore, Record Archive a Object Archive. Všechna tato prostředí jsou plně podporována průběžně a včetně systému i5/os 5.4. Jak bylo uvedeno v oznamovacím letáku IBM Announcement Letter #206-030 z 14. února 2006, verze 5.4 byla posledním vydáním, kdy byly dodávány a podporovány funkce Spool File Archive, AnyStore, Record Archive a Object Archive. Počínaje produktem Content Manager OnDemand 5.3 byl k dispozici program pro migraci implementací Spool File Archive jako součást licencovaného programu Content Manager OnDemand. Program pro migraci umožňuje provést migraci definic sestav a indexů z původního prostředí Spool File Archive do prostředí Common Server. Podrobnější informace o tomto programu pro migraci naleznete v Dodatku A příručky IBM Content Manager OnDemand for iseries: Common Server Planning and Installation Guide for version 5.4. Existující implementace Spool File Archive je nutno migrovat z prostředí Spool File Archive do prostředí Common Server předtím, než je systém převeden na verzi 7.1. Přehled změn xiii
xiv ODWEK - Instalace a konfigurace
Kapitola 1. Přehled o produktu Aplikace ODWEK umožňuje uživatelům přistupovat k datům, která jsou uložena na serveru IBM Content Manager OnDemand, pomocí webového prohlížeče nebo programu napsaného uživatelem. Například můžete některým lidem dát k dispozici adresu URL (Uniform Resource Locator) webové stránky, která jim umožní přihlásit se k serveru OnDemand; jiným lidem můžete dát k dispozici URL webové stránky, která jim umožní prohledat určitou složku. Aplikace ODWEK ověří, zda uživatelské informace jsou na serveru OnDemand platné, například povolení pro přístup k serveru a k datům uloženým ve skupině aplikací. Jakmile uživatel zadá vyhledávání, ODWEK zobrazí webovou stránku, která obsahuje seznam dokumentů, jež odpovídají dotazu. Uživatel vybere dokument, který se má zobrazit, a aplikace ODWEK dokument odešle do prohlížeče. Obrázek 1 zobrazuje pracovní stanici s webovým prohlížečem, který se používá pro přístup k datům ze serveru OnDemand. Obrázek 1. Přístup k datům uloženým na serveru OnDemand pomocí ODWEK Aplikace ODWEK může vyhledávat a načítat dokumenty ze serverů OnDemand, které provozují produkt IBM Content Manager OnDemand for i Common Server. Aplikace ODWEK obsahuje několik komponent: v Programovací rozhraní OnDemand. Programovací rozhraní používá standardní rozhraní a protokoly OnDemand pro přístup k datům uloženým na serveru OnDemand. Na serveru OnDemand není zapotřebí žádný další kód pro podporu aplikace ODWEK. Pro řízení aplikace ODWEK můžete použít jedno z následujících programovacích rozhraní: Program Common Gateway Interface (CGI). Program CGI poskytuje způsob pro přístup k datům OnDemand z webového prohlížeče. Program CGI se spouští v systému, který používá server HTTP (Hypertext Transfer Protocol), například IBM HTTP Server. Java servlet. Program CGI poskytuje způsob pro přístup k datům OnDemand z webového prohlížeče. Tento servlet se spouští na HTTP serveru s povolenou Javou, který má spuštěný aplikační server Java, například IBM WebSphere Application Server. Java API. Rozhraní Java API poskytuje způsob pro přístup k datům OnDemand z programu napsaného uživatelem. Rozhraní Java API vyžaduje Javu, verzi 1.4 nebo pozdější. v IBM OnDemand Advanced Function Presentation (AFP) (webový prohlížeč). Webový prohlížeč AFP umožňuje uživatelům vyhledávat, načítat, prohlížet, navigovat a tisknout dokumenty AFP z webového prohlížeče. v Prohlížeč IBM OnDemand Image Web Viewer. Program Image Web Viewer umožňuje uživatelům vyhledávat, načítat, prohlížet, navigovat a tisknout dokumenty BMP, GIF, JPEG, PCX a TIFF z webového prohlížeče. v Aplet Line Data Java. Aplet Line Data umožňuje uživatelům zobrazit dokumenty řádkových dat z webového prohlížeče. Administrátor umožňuje použití apletu Line Data konfigurací souboru ARSWWW.INI pro program CGI a Java servlet nebo souboru ARSWWW.PROPS pro rozhraní Java API. Copyright IBM Corp. 2001, 2010 1
v Java aplet AFP2HTML. Aplet AFP2HTML umožňuje uživatelům prohlížet výstup generovaný službou AFP2WEB Transform. AFP2WEB Transform konvertuje dokumenty a prostředky AFP na soubory HTML, které mohou být zobrazeny pomocí apletu AFP2HTML. Po instalaci a konfiguraci služby AFP2WEB Transform administrátor povolí používání apletu AFP2HTML konfigurací souboru ARSWWW.INI pro program CGI a Java servlet nebo souboru ARSWWW.PROPS pro rozhraní Java API. O programovacích rozhraních Důležité: Chcete-li zobrazit jiné typy dokumentů uložených na serveru OnDemand, musíte získat a instalovat vhodný prohlížeč. Chcete-li například zobrazit dokumenty ve formátu PDF (Adobe Portable Data Format), IBM doporučuje, abyste získali prohlížeč Adobe Acrobat pro webové prohlížeče, které se používají ve vaší organizaci. Instance aplikace ODWEK je kód ODWEK, který přistupuje k datům na serveru OnDemand. Instance řídí, co lze dělat s daty, a spravuje systémové prostředky, které jsou této instanci přiřazeny. Každá instance je samostatné prostředí. Instance má vlastní soubor ASWWW.INI pro rozhraní CGI a Java servlet nebo soubor ARSWWW.PROPS pro rozhraní Java API a programovací rozhraní ODWEK, k němuž jiné instance nemohou přistupovat. Existují tři programovací rozhraní ODWEK: v Program CGI, rozhraní mezi webovým prohlížečem a serverem OnDemand. v Java servlet, rozhraní mezi webovým prohlížečem a serverem OnDemand. v Rozhraní Java API, sada metod, kterou lze použít pro přístup k datům OnDemand z uživatelem napsaného programu Je velmi důležité chápat, že instance může používat pouze jedno programovací rozhraní. Programovací rozhraní se vzájemně vylučují. Není možné je použít v určité instanci zároveň. Je však možné spustit více instancí ODWEK na jednom počítači a přimět každou instanci používat jiné programovací rozhraní tak, že pro každou konfiguraci konfigurujete jiné číslo portu. Nejobvyklejší implementací ODWEK je jediná instance v systému. Konfigurace s jedinou instancí je obvykle pro vývojáře nebo samostatné počítače a také pro instanci jednoho aplikačního serveru pracující nezávisle na jiných aplikacích. Obrázek 2 uvádí příklad jedné instance používající rozhraní CGI. Obrázek 2. Jediná instance používající rozhraní CGI Obrázek 3 na stránce 3 uvádí příklad jediné instance používající rozhraní Java servletu. 2 ODWEK - Instalace a konfigurace
Obrázek 3. Jediná instance používající rozhraní Java Obrázek 4 uvádí příklad jediné instance používající rozhraní Java API. Obrázek 4. Jediná instance používající rozhraní Java API Můžete konfigurovat více instancí ODWEK ve stejném systému. Pro rozhraní CGI a servletu Java vyžaduje každá instance své vlastní programovací rozhraní a soubor ARSWWW.INI, který uvádí jedinečné číslo portu, na kterém se odehrává komunikace mezi programovacím rozhraním a serverem OnDemand. Pro rozhraní Java API je jedinečné číslo portu specifikováno ve vašem kódu Java, který přistupuje k funkcím rozhraní ODWEK Java API. Každá instance také vyžaduje své vlastní uložení a zabezpečení. Konfigurace s více instancemi je obvykle pro zákazníky, kteří potřebují spouštět jednu nebo více vývojářských, testovacích nebo výrobních aplikací ve stejném systému. Instance pracují nezávisle na sobě. Obrázek 5 uvádí příklad topologie s více instancemi. Obrázek 5. Topologie s více instancemi Kapitola 1. Přehled o produktu 3
Příklady použití rozhraní ODWEK Java API z obchodní perspektivy K datům uloženým na serveru OnDemand můžete přistupovat dvěma způsoby: prostřednictvím Internetu a prostřednictvím intranetu. Při přístupu k datům prostřednictvím Internetu dostávají uživatelé (uživatelé, kteří jsou externí vůči organizaci) přístup ke konkrétním podmnožinám informací. Například v bankovních implementacích se internetoví uživatelé mohou přihlásit a prohlédnout aktuální výpisy za posledních dvanáct měsíců. To je jediný přístup, který má uživatel k archívu OnDemand, a uživateli je poskytnuta pouze velmi omezená sada nabídek k získání těchto dat. Typické internetové využití zahrnuje desítky tisíců uživatelů, kteří přistupují k archivu OnDemand souběžně. Architektura OnDemand umožňuje přizpůsobovat velikost systému limitům dostupných hardwarových a sí ových zdrojů, a tím umožňuje podnikům rozšiřovat jejich systémy, když se jejich využití zvýší. Při přístupu k datům prostřednictvím intranetu dostávají uživatelé (uživatelé, kteří pracují pro organizaci) přístup k široké škále dat v závislosti na přístupových oprávněních jejich ID uživatele v archívu OnDemand. Uživateli je poskytnuto kritérium výběru, které mu umožní přistupovat k libovolným uloženým datům v závislosti na profilu zabezpečení. Flexibilita, kterou poskytují rozhraní ODWEK Java API, umožňuje vytvářet přizpůsobená rozhraní schopná splňovat specifické požadavky organizace. Běžný příklad použití u zákazníka Běžným příkladem použití v rámci mnoha různých obchodních segmentů je umožnit registrovaným zákazníkům vybrat rozsah dokumentů pro zobrazení. V bankovním odvětví mohou být těmito dokumenty bankovní výpisy, které lze vybírat z předdefinovaného počtu měsíců. U organizací zdravotního pojištění mohou být těmito dokumenty výpisy příspěvků. U rozvodných společností mohou být těmito dokumenty účty nebo faktury. Zákazník je obvykle uživatelem, který je registrovaný na webových stránkách dané společnosti. Proces registrace poskytuje ověřovací prostředky, například ID uživatele a heslo. Chce-li uživatel získat přístup k některé z aplikací společnosti, zadá na webové stránce, jako je například portál, ověřovací prostředky, aby byl prověřen webovou aplikací společnosti. Po ověření uživatele aplikace omezí, co uživatel může provádět, když se bude pohybovat po webových stránkách. Produkt OnDemand vyžaduje, aby pro každého uživatele, který bude potřebovat přístup, bylo definováno ID uživatele. Administrátoři nemohou vytvořit ID uživatele pro každého registrovaného internetového uživatele. Populace uživatelů může dosahovat tisíců nebo milionů. Proto většina aplikací provádí vyhledání jménem ID uživatele, které má oprávnění prohledávat konkrétní složku a načíst dokument. Je zde předpoklad, že pokud uživatel nebyl ověřen a na hledané hodnoty byla uplatněna omezení zajiš ující jedinečné výsledky, pak lze definovat jedno nebo více ID uživatele, které mají plné povolení ke složce, která se prohledává. Bez ohledu na odvětví, které dokumenty programu OnDemand poskytuje zákazníkům, mohou zákazníci provádět dva typy transakcí: Bez interakce uživatele Jeden typ transakce zahrnuje aplikaci zobrazující seznam dokumentů, obvykle s nějakým předdefinovaným rozsahem dat. Po ověření uživatele aplikace zvolí jedinečný klíč nebo kombinaci klíčů, aby zajistila, že výsledky hledání jsou pro tohoto uživatele, a provede hledání bez jakékoliv interakce uživatele. Interakce uživatele Další typ transakce zahrnuje uživatele vybírajícího dokument ze seznamu výsledků 4 ODWEK - Instalace a konfigurace
hledání. Datový typ dokumentu ovlivní způsob, jakým se obsah uživatelům zobrazuje. Pokud je například dokument uložen v produktu OnDemand jako datový proud AFP, uživatel potřebuje prohlížeč AFP, který je lokálně instalovaný na jeho počítači, nebo je potřeba uskutečnit datovou konverzi, která datový proud upraví pro potřeby prohlížení. V mnoha případech aplikace soubory jako jsou soubory typu AFP transformuje do souborů PDF, které uživatelé mohou snadněji prohlížet. Prohlížeč souborů typu PDF lze snadno nainstalovat. Avšak prohlížeč AFP, jako například modul plug-in, může být pro společnost, která poskytuje webové služby, obtížnější získat a spravovat. Tento příklad použití zahrnuje následující kroky: 1. Uživatelé se přihlásí na webové stránky pomocí svých ověřovacích prostředků. Webová aplikace provede ověření uživatelů a vyvolá připojení OnDemand z fondu připojení. 2. Webová aplikace vybere předdefinovanou složku, kterou bude prohledávat. 3. Webová aplikace přidělí jednu nebo více hodnot pole složky OnDemand, aby provedla hledání, které je pro každého uživatele jedinečné. 4. Webová aplikace provede hledání, například podle čísla účtu a časového rozmezí, a vrátí uživateli seznam výsledků hledání. 5. Webová aplikace zavře složku a uvolní připojení zpět do fondu připojení. 6. Uživatel vybere ze seznamu výsledků hledání dokument, který se má zobrazit. Volitelně je uživatel znovu ověřen předtím, než je mu povoleno dokument načíst. 7. Webová aplikace vyvolá připojení OnDemand z fondu připojení. 8. Webová aplikace načte dokument a volitelně provede před vydáním dat uživateli transformaci dat. 9. Webová aplikace uvolní připojení OnDemand zpět do fondu připojení. O prohlížečích Aplikace ODWEK obsahuje následující prohlížeče: v AFP Web Viewer. v Image Web Viewer. v Java aplet Line Data. v Java aplet AFP2HTML. Produkty AFP Web Viewer a Image Web Viewer jsou softwarové programy, které rozšiřují schopnosti webového prohlížeče. Prohlížeč AFP Web Viewer umožňuje uživatelům prohlížet dokumenty AFP. Prohlížeč Image Viewer umožňuje uživatelům prohlížet dokumenty ve formátu BMP, GIF, JPEG, PCX, PNG a TIFF. Tyto prohlížeče mohou zobrazovat dokumenty v okně prohlížeče. Každý prohlížeč přidává panel nástrojů do horní části zobrazovacího okna. Uživatelé mohou přidat panel nástrojů prohlížeče k panelu nástrojů hlavního prohlížeče. Přidaný panel nástrojů obsahuje ovládací prvky, které pomáhají uživatelům pracovat s dokumenty. Pracovníci ve vaší organizaci, kteří chtějí prohlížet dokumenty pomocí webových prohlížečů, musí webové prohlížeče instalovat na svých pracovních stanicích. Aplet Line Data umožňuje uživatelům prohlížet SCS a napojené datové dokumenty, které jsou uloženy na serveru OnDemand. Aplet Line Data zobrazuje napojené datové dokumenty v okně prohlížeče a přidává panel nástrojů k horní části okna prohlížeče. Panel nástrojů apletu Line Data poskytuje ovládací prvky, které mohou uživatelům pomoci pracovat s dokumenty. Administrátor umožňuje použití apletu Line Data konfigurací souboru ARSWWW.INI pro program CGI a Java servlet nebo souboru ARSWWW.PROPS pro rozhraní Java API. Kapitola 1. Přehled o produktu 5
Aplet AFP2HTML umožňuje uživatelům prohlížet výstup generovaný službou AFP2WEB Transform. Služba AFP2WEB Transform konvertuje dokumenty a prostředky AFP na dokumenty HTML. Po instalaci a konfiguraci služby AFP2WEB Transform administrátor povolí používání apletu AFP2HTML konfigurací souboru ARSWWW.INI pro program CGI a Java servlet nebo souboru ARSWWW.PROPS pro rozhraní Java API. Applet AFP2HTML poskytuje panel nástrojů s ovládacími prvky, které mohou uživatelům pomoci pracovat s dokumenty, včetně ovládacích prvků pro velké objekty. Použití aplikace ODWEK Funkce produktu Jednou z výhod apletů je to, že vaši uživatelé nemusí nikdy instalovat nebo inovovat software na pracovní stanici, aby je mohli používat, na rozdíl od webových prohlížečů, které musí být instalovány na pracovní stanici. Navíc, když IBM poskytne novou verzi webového prohlížeče, musíte aktualizovaný webový prohlížeč distribuovat svým uživatelům. Když používáte aplety a prohlížeče od IBM, dokumenty, které jsou načteny ze serveru OnDemand, zůstanou komprimovány, dokud nedosáhnou klienta. Klient dokumenty zobrazí a zobrazí je v okně webového prohlížeče. Jestliže byl dokument uložen v OnDemand jako velký objekt, pak klient načte a rozbalí segmenty dokumentu podle potřeby, jak uživatel prochází stránkami dokumentu. Nejběžnější metodou používání aplikace ODWEK je přizpůsobení vzorových aplikací HTML, které jsou dodány s produktem. Vzorová aplikace LOGON.HTM podporuje uživatele, kteří mají povolen přístup k několika složkám. Nejprve upravte stránku LOGON.HTM s informacemi o svém serveru OnDemand. Pak můžete publikovat URL ze souboru LOGON.HTM. Vaši uživatelé se pak mohou připojit k URL a přihlásit se k zadanému serveru. Aplikace ODWEK automaticky zobrazí řadu webových stránek, které mohou uživatelé prohledávat, načítat a zobrazovat dokumenty OnDemand. Vzorové aplikace CREDIT.HTM podporují nahodilé použití OnDemand tím, že nabízejí webovou stránku, která obsahuje vyhledávací kritéria pro specifickou složku. Jakmile si vzor upravíte, uživatel se připojí k URL, dokončí vyhledávací kritéria a stiskne tlačítko Submit. Aplikace ODWEK zobrazí webovou stránku, která vypisuje dokumenty, které odpovídají dotazu. Důležité: Aplikace ODWEK vyžaduje schopnost pro zápis dat objektů cookie na klientovi. Zajistěte, aby vaši uživatelé konfigurovali své prohlížeče pro příjem objektů cookie. Většina zákazníků definuje jeden ID uživatele OnDemand pro k přístup k serverům s ODWEK. To je běžné v prostředích s mnoha příležitostnými uživateli OnDemand, kteří budou přistupovat ke stejné složce. Každému uživateli můžete také přidělit vlastní ID uživatele OnDemand. Nehledě na to, jak se rozhodnete přistupovat k aplikaci ODWEK, musíte spravovat ID uživatele v OnDemand: musíte je přidat do serveru a nastavit pro uživatele skupinu aplikací a oprávnění ke složkám. Aplikace ODWEK podporuje následující funkce OnDemand. Funkce se obvykle vyvolávají vytvořením webových stránek, které obsahují odkazy na serverový program ODWEK. Každým odkazem se vyvolává specifická funkce. Výstupem jedné funkce je jiná webová stránka s odkazy, které vedou uživatele k dalším logickým funkcím. Například počáteční webová stránka, může vyvolávat funkce k přihlášení. Funkce k přihlášení generuje webovou stránku s odkazem na funkci Search Criteria (Vyhledávací kritéria). Každá funkce může být volána z rozhraní API (Application Programming Interface). Podrobnosti viz téma Dodatek A, Referenční informace pro rozhraní CGI API, na stránce 65. 6 ODWEK - Instalace a konfigurace
Funkce Add Annotation (Přidání anotace) Funkce Add Annotation (Přidání anotace) umožňuje uživatelům přidávat anotaci k zadanému dokumentu. Při pozdějším zobrazení se v rámci anotace zobrazí text anotace a rovněž datum, čas a identifikace uživatele, který anotaci vytvořil. K přidávání anotace musí uživatel mít oprávnění pro přidávání anotace pro každou skupinu aplikací, která obsahuje dokumenty, jež mají být anotovány. (Oprávnění Application Group Access umožňuje uživatelům přidávat anotace.) Funkce Change Password (Změna hesla) Funkce Change Password (Změna hesla) umožňuje uživatelům měnit jejich hesla na serveru OnDemand. Funkce Document Hit List (Seznam nalezených dokumentů) Funkce Document Hit List vytváří seznam položek, která odpovídají vyhledávacím kritériím. Seznam je uveden v tabulce HTML. Každá položka, která odpovídá kritériím vyhledávání, se uloží do pole v tabulce a obsahuje odkaz na funkci Retrieve Document (Načtení dokumentu). Důležité: Znaky procenta (%) a dvojtečky (:) v indexovaných datech způsobí selhání nebo nepředvídatelné výsledky při načítání dokumentů v rozhraní aplikace ODWEK. Funkce Logoff (Odhlášení) Funkce Logoff (Odhlášení) umožňuje uživatelům odhlášení od serveru OnDemand. Funkce Logon (Přihlášení) Funkce Logon (Přihlášení) umožňuje uživatelům přihlášení k serveru OnDemand. Jestliže funkce Logon (Přihlášení) je úspěšná, uživatel obdrží webovou stránku, která obsahuje seznam složek, které je uživatel oprávněn otevřít. Funkce Retrieve Document (Načtení dokumentu) Funkce Retrieve Document (Načtení dokumentu) načítá dokument ze serveru OnDemand. Datový tok vrácený ze serveru zahrnuje dokument a v závislosti na typu dat i prostředky požadované k zobrazení dokumentu. Datový tok nesmí být žádným způsobem pozměněn. Prohledávací program spolu s prohlížečem mohou interpretovat a dekódovat datový tok a zobrazit dokument. Jestliže je dokument uložen na serveru OnDemand jako velký objekt, pak se vrátí pouze první segment dokumentu. Následující segmenty dokumentu lze podle potřeby načíst a zobrazit. Funkce Search Criteria (Vyhledávací kritéria) Po úspěšném přihlášení obdrží uživatel seznam složek, které je uživatel oprávněn otevřít. Uživatel vybere složku, kterou chce otevřít. Po otevření složky se zobrazí webová stránka, která obsahuje vyhledávací pole pro složku. Uživatel může přijmout předvolená vyhledávací kritéria nebo zadat vyhledávací kritéria pro vyhledání specifických dokumentů. Když uživatel stiskne tlačítko Submit (Odeslat), požadavek na vyhledání se odešle do serveru OnDemand. Funkce Server Print Document (Tisk dokumentů na serveru) Funkce Server Print Document (Tisk dokumentů na serveru) odesílá kopie dokumentů na tiskárnu serveru OnDemand. Pro tisk na serveru musí uživatel mít oprávnění Document Print ke každé skupině aplikací, která obsahuje dokumenty, které uživatel potřebuje vytisknout. (Oprávnění Application Group Access umožňuje uživatelům tisknout dokumenty.) Na serveru OnDemand musí být definována alespoň jedna serverová tiskárna. Kapitola 1. Přehled o produktu 7