APS T&A.WEB Rozšiřující programový modul pro identifikační systémy APS Instalační a uživatelská příručka 2004 2014,TECH FASS s.r.o., Věštínská 1611/19, Praha, Česká republika, www.techfass.cz, techfass@techfass.cz (vydáno dne 2014/12/11, platné pro sestavení APS Administrator 2.0.5450.15838)
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... 5 3.5 Zpřístupnění databáze... 7 3.6 Vyzkoušení aplikace... 7 4 Práce s programem APS T&A.WEB... 7 4.1 Nastavení přístupových oprávnění... 7 4.2 Změna přihlašovacích údajů... 8 4.3 Složky... 8 4.4 Události... 9 4.5 Kalendář... 10 4.6 Přehled... 11 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 T&A.WEB rozšiřuje programový balík APS Administrator o možnost prohlížení a správy docházky uživatelů ve vybraných organizačních složkách prostřednictvím webového prohlížeče. Program pracuje s docházkovými událostmi uživatelů, umožňuje zobrazit kalendářní a celkový měsíční přehled docházky. Uživateli s oprávněním ke správě docházky je umožněno vkládat, upravovat a mazat docházkové události uživatelů v příslušné složce. 3 Instalace 3.1 Podmínky instalace Instalaci je vhodné provést na počítači, který slouží jako server pro systém 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 práce 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 400 T&A.WEB je nutná databáze APS400nAdministrator, verze 23 nebo vyšší (od APS Administrator, verze 2.0.3631.21343). 3.2 Instalace HTTP serveru APS T&A.WEB 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. 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. 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 Strana 3
3.3.3 Instalace webové aplikace APS T&A.WEB Celou složku obsahující součásti programu APS T&A.WEB (ta.web) 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\ta.web\ 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 T&A.WEB a otevřete okno Vlastnosti. Na záložce Adresář v sekci Nastavení aplikace stiskněte tlačítko Vytvořit (obr. 1). Obr. 1: Vlastnosti webové aplikace 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 T&A.WEB 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 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 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 z příkazového řádku v kontextu správce. 3.4.3 Instalace webové aplikace APS T&A.WEB Celou složku obsahující součásti programu APS T&A.WEB (ta.web) 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\ta.web\ 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 T&A.WEB a v kontextovém menu vyberte možnost Převést na aplikaci. Na záložce Adresář v sekci Nastavení aplikace stiskněte tlačítko Vytvořit (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 ta.web). 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 aps400nadministratorconnectionstring. 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 T&A.WEB čí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/ta.web/default.aspx Pokud je vše nakonfigurováno správně, zobrazí se úvodní stránka s přihlašovacím dialogem (obr. 5). V opačném případě je zobrazena stránka s chybovým hlášením a je nutné upravit konfiguraci. Obr. 5: Přihlašovací dialog 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 Práce s programem APS T&A.WEB 4.1 Nastavení přístupových oprávnění Přístupová oprávnění daného uživatele úzce souvisejí s možností pracovat s programy APS Administrator a APS T&A. Samotné nastavení oprávnění se provádí ve vlastnostech uživatele a vlastnostech složky v programu APS Administrator. Uživateli se zakázaným přihlašováním nebo prázdnými přihlašovacími údaji není přístup na webové stránky umožněn. Uživateli bez kteréhokoliv z níže uvedených oprávnění se po přihlášení do programu zobrazí pouze vlastní docházková data bez možnosti jejich editace. Uživateli s oprávněním Uživatel je oprávněn upravovat vlastní docházku (WEB) je navíc umožněno editovat vlastní docházková data. Uživateli s oprávněním Uživatel je operátorem docházky se po přihlášení zobrazí organizační struktura uživatelů, bude mít možnost zobrazit si veškeré informace o Strana 7
docházce uživatelů ve složkách, ke kterým bude mít nastaveno oprávnění. Oprávnění zobrazit uživatele v dané složce se definuje v programu APS Administrator ve Vlastnostech organizační složky na záložce Oprávněné osoby (osobu lze přidat, pouze pokud má oprávnění Uživatel je operátorem nebo administrátorem docházky). Uživatel nemá možnost definovat docházkové stavy v programu APS T&A. Uživatel s oprávněním Uživatel je administrátorem docházky má stejná práva jako uživatel s oprávněním Uživatel je operátorem docházky, ale navíc má možnost definovat docházkové stavy v programu APS T&A. Uživatel s administrátorským oprávněním má všechna výše uvedená práva, navíc má možnost zobrazit informace o docházce uživatelů ve všech složkách. 4.2 Změna přihlašovacích údajů Po platném přihlášení může každý uživatel změnit své přihlašovací údaje volbou odkazu Nastavení (obr. 6).. Po změně přihlašovacího jména není vyžadováno nové přihlášení uživatele. 4.3 Složky Obr. 6: Změna přihlašovacích údajů Po přihlášení se na úvodní obrazovce zobrazí okno umožňující výběr uživatele z daných organizačních složek pro vybrané období (obr. 7). Obr. 7: Výběr složky a uživatele V levé horní části okna lze vybrat zobrazovanou složku z adresářové struktury vytvořené v programu APS Administrator. Možnost prohlížet obsah složky je indikována zámkem Strana 8
vedle názvu složky. Pokud je zámek otevřený se zelenou šipkou, uživatel má do složky přístup, pokud je zámek zamčený s červeným křížkem, uživatel do složky přístup nemá. Pokud je složka zobrazena šedou barvou, je vyloučena z vyhodnocování docházky. Pod výběrem organizační složky lze vybrat období, pro které jsou následovně zobrazeny docházkové záznamy. V pravé části je zobrazen seznam uživatelů, obsahuje-li složka nějaké uživatele a má-li přihlášený uživatel příslušná oprávnění. U uživatele je zobrazeno jméno, příjmení, titul, osobní číslo a pracoviště dle údajů zadaných v programu APS Administrator. Atribut zámek udává stav uzamčení docházky. Uživatele lze řadit dle libovolného sloupce. Pokud není zobrazen klíč signalizující uzamčení docházky, nebyla docházka doposud pro daného uživatele a měsíc uzamčena. Je-li zobrazen červený klíč, byla docházka uzamčena a není možné upravovat docházkové události daného uživatele a měsíc. Je-li zobrazen zelený klíč, byla docházka opět odemčena. U událostí upravených uživateli se znovu odemčenou docházkou je zobrazen stejný zelený klíč signalizující úpravu události po uzamčení docházky. 4.4 Události Po výběru uživatele ve složce nebo po přepnutí do obrazovky Událostí v menu Zobrazení se objeví obrazovka s docházkovými událostmi (obr. 8). Obr. 8: Docházkové události V levé části je zobrazeno několik nabídek. Vedle nápisu Osobní list se lze pomocí ikony dostat zpět na výběr složky a uživatelů. Pod nápisem osobní list je zobrazeno jméno, příjmení, titul a osobní číslo vybraného uživatele. Stav uzamčení docházky je indikován přítomností a barvou klíče, který zde má stejný význam jako v kap. 4.2. V nabídce Zobrazení lze vybrat mezi zobrazením Událostí (kap. 4.4), Kalendáře (kap. 4.5) a Přehledu (kap. 4.6). Pod touto nabídkou je opět možné vybrat zobrazované období a možnost vkládání události. Strana 9
V pravé části je zobrazen seznam všech událostí pro daný měsíc. Události jsou seřazeny podle Data a Času, kdy nastaly, v barevném schématu nastaveném v programu APS T&A. Každá událost dále obsahuje informaci o Názvu stavu, do kterého uživatele uvedla, Operátorovi, který událost vložil, pokud událost nenastala běžným způsobem (tzn. nastavenou identifikací na čtecím modulu) a ikonu klíče, pokud byla událost vložena po odemčení docházky. Pro vložení nové události zvolte možnost Nová událost či hvězdičku vedle data události. Pro editaci události klikněte na požadovanou událost (obr. 9). Po nastavení stavu, do kterého událost uživatele dovede, času, kdy událost nastala, a výběru data lze událost uložit. Pro smazání události zvolte možnost smazat. Pro návrat do předchozí obrazovky zvolte možnost zpět. Při vložení a úpravě události je do pole Operátor vloženo Obr. 9: Editace události přihlášeného uživatele, který událost upravil. Pokud tato změna nastane po odemčení docházky, je u události zobrazen zelený klíč. 4.5 Kalendář Po výběru možnosti Kalendář je zobrazen kalendářní přehled vybraného uživatele pro daný měsíc (obr. 10). Obr. 10: Kalendář Na obrazovce je zobrazen přehled docházky za celý měsíc vybraný v nabídce období. Hvězdičkou jsou označeny pracovní dny ve sloupci Datum, dále následuje sloupec Den se jménem dne, ve sloupci Typ jsou zobrazena jména událostí při zobrazených podrobnostech o dni. Sloupce Od a Do udávají čas první a poslední události daného dne. Ve sloupcích Odprac., Náhradní volno a Dovolená jsou zobrazeny doby trvání stavů započítávané do jednotlivých kategorií. Ve sloupci Saldo je uveden rozdíl mezi odpracovanou dobou a nastaveným úvazkem, sloupec Průběžné saldo udává průběžný součet salda od začátku měsíce. Ve sloupci Zobrazit lze zobrazit nebo skrýt podrobnosti o událostech každého dne. Strana 10
4.6 Přehled Po výběru možnosti Přehled je zobrazen celkový měsíční přehled docházky pro daného uživatele a měsíc (obr. 11). Obr. 11: Celkový měsíční přehled docházky Přehled je rozdělen do sloupců dle dne odpracování na pracovní den, sobotu + neděli a svátek. V posledním sloupci je zobrazen součet všech předchozích sloupců. Na jednotlivých řádcích je potom zobrazena celková odpracovaná doba, náhradní volno, dovolená, vypočtena celková pracovní doba daná úvazkem a celkové měsíční saldo. V podrobnostech jsou uvedeny stavy, které jsou nastaveny k zobrazení v měsíčním přehledu v programu APS T&A. Většina zobrazovaných informací v modulu APS T&A.WEB je přímo vázána na nastavení v programu APS T&A. V případě změny nastavení v tomto programu je následně stejně ovlivněno i zobrazování ve webovém modulu. Strana 11