APS Administrator.OP Rozšiřující webový modul pro APS Administrator Přehled přítomnosti osob v oblastech a místnostech Instalační a uživatelská příručka 2004 2013,TECH FASS s.r.o., Věštínská 1611/19, Praha, www.techfass.cz, techfass@techfass.cz (vydáno dne 2013/05/28, minimální verze databáze APS400nAdministrator - 39)
1 Obsah 1 Obsah... 2 2 Popis produktu... 3 3 Instalace... 3 3.1 Podmínky instalace... 3 3.2 Instalace HTTP serveru... 3 3.3 Instalace produktu na Windows 2000 a XP... 3 3.4 Instalace produktu na Windows Vista, Windows 7 a Windows 8... 5 3.5 Zpřístupnění databáze... 7 3.6 Vyzkoušení aplikace... 7 4 Konfigurace aplikace APS Administrator.OP... 7 4.1 Nastavení oblastí a pravidel pro stanovení přítomnosti... 7 4.2 Nastavení místností... 7 4.3 Umístění odkazu na aplikaci na firemní Intranet... 8 5 Práce s programem... 8 5.1 Konfigurace výchozích zobrazení... 8 5.2 Zobrazení stránky... 9 Uvedené názvy produktů a společností mohou být ochrannými známkami a/nebo ochranné servisní známky jejich příslušných vlastníků.
2 Popis produktu Programový modul APS Administrator.OP rozšiřuje programový balík APS Administrator o možnost sledování aktuální přítomnosti uživatelů ve vybraných oblastech a místnostech prostřednictvím webového prohlížeče. 3 Instalace 3.1 Podmínky instalace Instalaci je vhodné provést na počítači, který slouží jako server pro systémy APS (tzn. ten, na kterém již je provozován databázový a komunikační server). Lze zvolit i jiné modely, pro ty je však nutná hlubší znalost databázových systémů, webových aplikací, atd. V této příručce nadále předpokládáme, že instalace je provedena na jednom počítači. Pro provoz aplikace APS Administrator.OP je nutná databáze APS400nAdministrator, verze 39 nebo vyšší. 3.2 Instalace HTTP serveru APS Administrator.OP využívá technologii ASP.NET, verze 2.0. Doporučeným HTTP serverem proto je Internetová Informační Služba (IIS) společnosti Microsoft, verze 5.1 (nebo vyšší), s podporou ASP.NET 2.0. IIS je součástí instalace operačního systému Windows 2000 nebo Windows XP (vyjma edice Home), dále v systémech Windows Vista kromě edicí Windows Vista Home Basic a Starter. Při standardní instalaci Professional edicí však není tato služba nainstalována a je nutné ji doinstalovat dodatečně. Potřebné položky jsou umístěny v ovládacím panelu Přidat nebo odebrat programy v části Součásti systému. 3.3 Instalace produktu na Windows 2000 a XP 3.3.1 Podpora IIS Při standardní instalaci Professional edicí není tato služba nainstalována a je nutné ji doinstalovat dodatečně. Potřebné položky jsou umístěny v ovládacím panelu Přidat nebo odebrat programy v části Součásti systému. 3.3.2 Instalace podpory ASP.NET 2.0 Podporu aplikací ASP.NET je nutné na IIS zaregistrovat. Registrace se provede spuštěním registračního programu aspnet_regiis.exe, umístěného ve složce se součástmi prostředí.net. Strana 3
V systému Windows 2000 je umístěn zde: C:\WINNT\Microsoft.NET\Framework\v2.0.50727 V systému Windows XP zde: C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727 Pro instalaci podpory ASP.NET je nutné program spustit s parametrem -i, tedy: aspnet_regiis i 3.3.3 Instalace webové aplikace APS Administrator.OP Celou složku obsahující součásti programu APS Administrator.OP (aps.op) zkopírujte do složky IIS, určené pro publikování informací na webu. Při výchozí konfiguraci IIS je tato složka umístěna zde: c:\inetpub\wwwroot Součásti aplikace tedy budou umístěny ve složce c:\inetpub\wwwroot\aps.op Při popisu instalace nadále předpokládáme, že výchozí pojmenování je zachováno. Poté je nutné IIS informovat o tom, že v dané složce je umístěna ASP.NET aplikace. To lze provést v ovládacím panelu IIS, dostupném např. v nabídce Nástroje pro správu. V seznamu objektů publikovaných serverem vyberte složku obsahující aplikaci APS Administrator.OP a otevřete okno Vlastnosti. Na záložce Adresář v sekci Nastavení aplikace stiskněte tlačítko Vytvořit (obr. 1). Vzhledem k možnosti běhu více verzí technologie ASP.NET na jednom serveru je vhodné na záložce ASP.NET zkontrolovat, zda je pro aplikaci APS Obr. 1: Vlastnosti webové aplikace Administrator.OP zvolena správná verze technologie ASP.NET (2.0.x). 3.3.4 Konfigurace připojení k databázi Konfigurační parametry webové aplikace se nastavují v souboru Web.Config, umístěném ve složce aplikace. Jde o běžný konfigurační XML soubor, který lze upravovat např. v Poznámkovém bloku. V něm je nutné upravit jediný parametr, jímž je připojovací řetězec pro databázi (řetězec SERVER_NAME je nutné nahradit skutečným názvem databázového serveru): Strana 4
<connectionstrings> <add name = "SystemDatabase" connectionstring = "Data Source=SERVER_NAME; Initial Catalog = aps400nadministrator; Integrated Security = True" /> </connectionstrings> Nezapomeňte, že při výchozí instalaci oblíbeného SQL Serveru 2005 Express Edition je nainstalována tzv. pojmenovaná instance. SERVER_NAME pak je nutné zadat ve tvaru: COMPUTER_NAME\INSTANCE_NAME, kde COMPUTER_NAME je jméno počítače, na němž SQL server pracuje a INSTANCE_NAME je název konkrétní instance, obvykle SQLEXPRESS. 3.4 Instalace produktu na Windows Vista, Windows 7 a Windows 8 Tento postup je možné provést na IIS verze 6.0 a novějším. 3.4.1 Podpora IIS Při standardní instalaci systému není tato služba nainstalována a je nutné ji doinstalovat dodatečně. Potřebné položky jsou umístěny v ovládacím panelu Programy a funkce v části Zapnout nebo vypnout funkce systému Windows. 3.4.2 Instalace podpory ASP.NET 2.0 Podporu aplikací ASP.NET je nutné na IIS zaregistrovat. Registrace se provede spuštěním registračního programu aspnet_regiis.exe, umístěného ve složce se součástmi prostředí.net. V systému Windows Vista je umístěn zde: C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727 Pro instalaci podpory ASP.NET je nutné program spustit s parametrem -i, tedy: aspnet_regiis i 3.4.3 Instalace webové aplikace APS Administrator.OP Celou složku obsahující součásti programu APS Administrator.OP (aps.op) zkopírujte do složky IIS, určené pro publikování informací na webu. Při výchozí konfiguraci IIS je tato složka umístěna zde: c:\inetpub\wwwroot Součásti aplikace tedy budou umístěny ve složce c:\inetpub\wwwroot\aps.op Při popisu instalace nadále předpokládáme, že výchozí pojmenování je zachováno. Poté je nutné IIS informovat o tom, že v dané složce je umístěna ASP.NET aplikace. To lze provést v ovládacím panelu IIS, dostupném např. v nabídce Správa počítače. V seznamu objektů publikovaných serverem vyberte složku obsahující aplikaci APS Administrator.OP a v kontextovém menu vyberte možnost Převést na aplikaci (obr. 2). Strana 5
Obr. 2: Vytvoření webové aplikace Do pole Alias vyplňte jméno, pod kterým bude aplikace dostupná z internetového prohlížeče (obvykle aps.op). Z fondu aplikací je třeba vybrat možnost podporující.net Framework 2.0 (možnost lze obvykle ponechat na výchozí hodnotě DefaultAppPool, viz obr. 3). Nyní vyberte možnost Připojovací řetězce a upravte řetězec s názvem SystemDatabase. Po výběru možnosti Server SQL vyplňte jméno serveru k atributu Server, k atributu Databáze vyplňte aps400nadministrator. Pověření lze standardně ponechat na výchozí hodnotě (obr. 4). Obr. 3: Přidání webové aplikace Obr. 4: Úprava připojovacího řetězce Nezapomeňte, že při výchozí instalaci oblíbeného SQL Serveru 2005 Express Edition je nainstalována tzv. pojmenovaná instance. Atributu Server je potom nutné zadat hodnotu ve tvaru: COMPUTER_NAME\INSTANCE_NAME, kde COMPUTER_NAME je jméno počítače, na němž SQL server pracuje a INSTANCE_NAME je název konkrétní instance, obvykle SQLEXPRESS. Strana 6
3.5 Zpřístupnění databáze Aby mohla webová aplikace APS Administrator.OP číst data z databáze APS400nAdministrator, je nutné ji zpřístupnit účtu ASPNET, pod kterým jsou standardně spouštěny aplikace využívající technologie ASP.NET. Zpřístupnění databáze se provede stejným způsobem, jako zpřístupnění libovolnému jinému uživateli (buď v programu APS Administrator, nebo jiným nástrojem pro správu databázového serveru). Byla-li účtu ASPNET oprávnění přiřazena ještě před rozšířením databáze (to je možné například díky provozu jiných webových rozšíření), není povolen přístup k nově vytvořeným objektům. Oprávnění je pak nutné rozšířit (v programu APS Administrator možnost Obnovit u účtu ASPNET). 3.6 Vyzkoušení aplikace Webová aplikace se spouští v okamžiku, kdy HTTP server přijme od klienta (v tomto případě jeho webového prohlížeče) vhodně formulovaný požadavek. Přímo na serveru spusťte webový prohlížeč a do panelu Adresa webového prohlížeče ve tvaru: http://computer_name/aps.op/default.aspx Pokud je vše nakonfigurováno správně, zobrazí se úvodní stránka se zobrazeným přehledem osob v nakonfigurované oblasti (podobná jako na obr. 6). V opačném případě je zobrazena stránka s chybovým hlášením a je nutné konfiguraci upravit. Nejčastějšími chybami konfigurace webové aplikace jsou: Nesprávně zadané jméno SQL serveru, nenastavená přístupová oprávnění účtu ASPNET k databázi APS400nAdministrator, vypnuté síťové komunikační rozhraní SQL serveru (viz. instalační příručka programu APS Administrator). 4 Konfigurace aplikace APS Administrator.OP Jakákoliv změna nastavení se projeví až po obnovení stránky aplikace. 4.1 Nastavení oblastí a pravidel pro stanovení přítomnosti Zobrazení aktuální přítomnosti uživatelů v oblastech je odvozeno z nastavení oblastí v programu APS Administrator. V menu Konfigurace vyberte Oblasti. Podrobný popis nastavení oblastí je uveden v uživatelské příručce k programu APS Administrator. 4.2 Nastavení místností Zobrazení aktuální přítomnosti uživatelů v místnostech je odvozeno z nastavení místností v programu APS Administrator. V menu Konfigurace vyberte Místnosti. Podrobný popis nastavení místností je uveden v uživatelské příručce k programu APS Administrator. Strana 7
4.3 Umístění odkazu na aplikaci na firemní Intranet Zadávání odkazů do adresného řádku není příliš komfortní. Proto je obvyklé, že firemní sítě Intranet obsahují nějakou stránku, obsahující odkazy na často používané služby. Odkaz na aplikaci APS Administrator.OP může vypadat například takto: <a href= http://computer_name/aps.op/default.aspx >APS Administrator.OP</a> Pro přístup s pomocí výše uvedeného odkazu je nutné, aby byly splněny následující podmínky: Název serveru je rozpoznán klientským počítačem (lze ověřit příkazem ping COMPUTER_NAME ); pokud nelze rozpoznat název počítače, je možné toto zajistit například nastavením souboru hosts, nebo použít v odkazu IP adresu serveru místo jeho názvu Povolení portu na bráně firewall standardně webové služby běží na TCP portu 80. 5 Práce s programem 5.1 Konfigurace výchozích zobrazení Konfigurační parametry webové aplikace se nastavují v souboru Web.Config, umístěném ve složce aplikace. Jde o běžný konfigurační XML soubor, který lze upravovat např. v Poznámkovém bloku. Konfigurační parametry jsou dostupné v sekci appsettings, jejich význam je následovný: DefaultLanguage: CZ (čeština), EN (angličtina) - výchozí jazyk DisplayAreas: 0 (ne), 1 (ano) - zobrazovat oblasti DisplayRooms: 0 (ne), 1 (ano) - zobrazovat místnosti DefaultGroup: 0 (rezidenti), 1 (návštěvníci), 2 (všichni uživatelé) - výchozí skupina uživatelů zobrazená při výběru oblasti DefaultArea: Index výchozí oblasti (z DB), 0 = nevybráno DefaultRoom: Index výchozí místnosti (z DB), 0 = nevybrána; nastavení výchozí místnosti má přednost před nastavením výchozí oblasti MaxDays: maximální stáří (ve dnech) posledního průchodu, který se má započítávat do přehledu <appsettings> <add key="defaultlanguage" value="cz"/> <add key="displayareas" value="1"/> <add key="displayrooms" value="1"/> <add key="defaultgroup" value="2"/> <add key="defaultarea" value="1"/> <add key="defaultroom" value="0"/> <add key="maxdays" value="7"/> </appsettings> Strana 8
5.2 Zobrazení stránky Pro práci s modulem APS Administrator.OP zadejte ve webovém prohlížeči adresu ve tvaru: http://computer_name/aps.op/default.aspx Zobrazí se okno podobné jako na obr. 5. Obr. 5: Webová stránka APS Administrator.OP Po zvolení oblasti a skupiny uživatelů nebo místnosti se zobrazí seznam přítomných osob. Stránka se automaticky aktualizuje každých 20 s. Pro okamžitou aktualizaci stiskněte tlačítko. Strana 9