Klient distribučního portálu Instalace a možnosti nastavení

Pracovní postup pro IT č. 090819 Nezvalova 984/2, Olomouc

Klient distribučního portálu Instalace a možnosti nastavení

Upozornění Tento dokument včetně všech příloh je výhradním duševním vlastnictvím společnosti Laboratoře Mikrochem a.s. Jakékoliv další využití (kopírování, opisování, předávání či prodej) lze provádět pouze se souhlasem vedení společnosti.

Dokument: Číslo verze: Platnost od: Výtisk č.:

PP IT 090818 1 2009-08-18

Název: Klient distribučního portálu – instalace a možnosti nastavení Typ dokumentu: Zpracoval: Jan Bumba Přezkoumal: Schválil: Převzal: Strana: 1 / 14


1. Účel, pojmy Účelem aplikace „Klient distribučního portálu“ (dále jen i DK = distribuční klient) je zajistit bezpečný přenos údajů mezi laboratorním informačním a manažerským systémem (dále jen LIMS), který provozuje společnost Laboratoře Mikrochem a.s., a vzdálenými koncovými uživateli (např. lékaři). DK dále zajišťuje převod přenesených údajů koncovým uživatelům do čitelné podoby bez nutnosti instalovat další softwarové vybavení (prohlížení a tisk výsledků). DK také zajišťuje případný přenos dat k dalšímu zpracování ve specializované aplikaci (například v nemocničním informačním systému (NIS) nebo v programu pro vedení zdravotní dokumentace). Pod pojmem instalace se rozumí zavedení aplikace na straně vzdáleného koncového uživatele, zpravidla na jednotlivém počítači u lékaře nebo zdravotní sestry. Pod pojmem možnosti nastavení se rozumí úplný výklad možností nastavení chování distribučního klienta (konfigurace) tak, aby co nejlépe vyhovoval provozu a potřebám koncového uživatele. 2. Princip Distribuční portál LIMS je webová serverová aplikace, která má přímý přístup k datům v databázi LIMS – výsledkům laboratorních vyšetření. Distribuční portál zpřístupňuje zabezpečeným způsobem jednotlivé laboratorní výsledky klientům distribučního portálu (dále jen i DK = distribuční klient), a to v rozsahu přidělených oprávnění. Zabezpečení spočívá v ověření klienta vůči serverové distribučního portálu a dále navázání zabezpečeného (šifrovaného) spojení mezi DK a distribučním portálem pomocí certifikátů na straně serveru a na klienta. Požadavky na zabezpečení datového přenosu vyplývají z povahy přenášených údajů (osobní data, citlivé údaje o zdravotním stavu) a je vyžadováno platnou legislativou.1 DK umožňuje připojit se současně k více distribučním portálům a zajistit tak přenos dat zabezpečeným kanálem i z více distribučních míst (z více laboratoří). DK v pravidelných nastavitelných intervalech komunikuje s distribučním místem, provede ověření a vytvoří zabezpečené spojení. Na základě předvolených nastavení se pomocí zabezpečeného spojení dotáže na údaje. Portál ověří požadavek klienta a sdělí pomocí zabezpečeného spojení výsledek. Podle dalšího nastavení DK buď oznámí, že jsou k dispozici nové dosud neznámé údaje (nové výsledky laboratorního vyšetření), nebo provede další zpracování dat – stažení výsledků ve formě datových souborů v požadovaném formátu k dalšímu zpracování. Komunikaci s distribučním místem a stažení souborů je možné vynutit i ručně. 1

Například zákonem č. 101/2000 Sb., o ochraně osobní údajů, zákonem č. 133/2000 Sb., o evidenci obyvatel a rodných číslech, zákonem č. 480/2004 Sb., o některých službách informační společnosti, zákonem č. 499/2004 Sb., o archivnictví a spisové službě, zákonem č. 127/2005 Sb., o elektronických komunikacích.


PP IT 090818 1 2009-08-18



3. Požadavky na systém •

Operační systém Microsoft Windows 98 SE a vyšší.

•

Nainstalovaný Microsoft .NET Framework 2.0 nebo vyšší.

•

Připojení k Internetu (program spojení neinicializuje).

•

Program přistupuje na internetovou adresu vpn.michem.cz na portu 23456 protokolem http / https.

•

K instalaci je potřeba mít administrátorská práva, k nastavení a vlastní práci s programem dostačují práva běžného uživatele.

4. Postup instalace 4.1. Přihlaste se k počítači s oprávněním správce systému. Výsledek: Uživatel je přihlášen jako správce systému. 4.2. Zkontrolujte zda je nainstalován Microsoft .NET Framework 2.0 nebo vyšší. Přítomnost platformy .NET Framework je indikována v seznamu nainstalovaných programů (například ovládací panely / přidat nebo odebrat programy). V případě, že platforma .NET Framework není nainstalována, nainstalujte ji. Instalaci je možné provést buď pomocí aktualizační služby Windows Update ze serveru dodavatele operačního systému nebo je možné spustit soubor přiložený na instalačním médiu ve složce „Instalace .NET Framework“. Po spuštění instalace se řiďte pokyny zobrazenými na obrazovce. Výsledek: Na počítači je nainstalována platforma Microsoft .NET Framework.


PP IT 090818 1 2009-08-18



4.3. Zkopírujte složku „Michem“ z instalačního média do programové složky. Z instalačního média zkopírujte celou složku „Michem“ do složky, kde jsou uloženy programové soubory. Programové soubory jsou zpravidla umístěny ve složce „C:/ProgramFiles“, ale pokud si nejste jisti zadejte v příkazovém řádku příkaz „%ProgramFiles%“ (psáno bez uvozovek) a otevře se složka, kde operační systém očekává nainstalované aplikace.

Aplikaci DK je možné nainstalovat i do jiné složky, například síťové. Tento postup však předpokládá, že instalace bude standardně provedena do složky „C:/ProgramFiles“. V případě, že instalujete aplikaci do jiné složky, je vlastní postup instalace shodný, pouze je nutné důsledně opravit cestu v zástupcích programu a v inicializačních a konfiguračních souborech – například namísto cesty „C:/ProgramFiles“ uvádět cestu „F:/Aplikace“. Výsledek: V složce s programovými soubory je nainstalována aplikace DK.


PP IT 090818 1 2009-08-18



4.4. Nastavte oprávnění ke složce „Michem“ V případě, že používáte operační systém, kde běžní uživatelé nepracují s oprávněním správce systému a máte nastaveno omezení pro běžné uživatele k programovým souborům. Je nutné nastavit pro běžné uživatele oprávnění ke složce „Michem“. Toto nastavení se typicky týká operačních systémů na bázi NT (Windows 2000, Windows XP, Windows Vista, Windows 7), se systémem souborů NTFS, kde oprávněný uživatel pracuje jako běžný uživatel. Protože běžní uživatelé budou chtít měnit nastavení programu podle svých potřeb a budou také ukládat data, je potřeba nastavit pro tyto uživatele oprávnění na úrovni „Měnit“.


PP IT 090818 1 2009-08-18



Nastavení oprávnění není nutné provádět v případě, že uživatelé pracují na počítači v vyššími oprávněními, například jako „PowerUsers“ nebo „Administrators“ – příslušná oprávnění mají v tomto případě již k dispozici. Nastavení oprávnění nelze provést v případě, že váš disk používá souborový systém FAT. Tento souborový systém nastavení oprávnění nepodporuje, takže uživatelé mohou provádět všechny změny. Nastavení oprávnění provedete na kartě „Zabezpečení“ pomocí dialogu „Vlastnosti“ složky „Michem“. V případě, že se karta „Zabezpečení“ nezobrazuje, je možné, že používáte funkci „Zjednodušení sdílení souborů“. V tomto případě, je nutné funkci vypnout pomocí dialogu „Možnosti složky“, kterou zpřístupníte z průzkumníka souborů (např. „Tento počítač“) pomocí menu „Nástroje“ / „Možnosti složky“.


PP IT 090818 1 2009-08-18



Výsledek: Oprávnění uživatelé mají příslušná práva ve složce „Michem“. 4.5. Vytvořte zástupce programu Pro pohodlné spouštění aplikace je vhodné vytvořit zástupce aplikace na všech místech, kde je uživatel využije. Zástupce není nutné opakovaně vytvářet, stačí zkopírovat připraveného zástupce z instalační složky na všechna místa, kde je uživatel s výhodou použije. Nejčastějším místem je „Plocha“. V případě, že s počítačem pracuje více uživatelů nebo jeden uživatel pod více uživatelskými účty, je vhodné umístit zástupce na plochu do profilu všech uživatelů („All Users“). S výhodou je možné umístit také zástupce do složky „Po spuštění“. Aplikace se tak spustí již při přihlášení uživatele a ten už nemusí myslet na její spuštění. Aplikace je velmi nenáročná na výkon počítače, v podstatě mimo interval stahování dat neprovádí žádné operace a tudíž nezatěžuje systém. 4.6. Spusťte aplikaci Instalační sada je už ve výchozím stavu připravena ke spuštění. Prvotní spuštění může být využito k přizpůsobení chování aplikace, tomuto tématu je věnována následující kapitola. Úkolem prvotního spuštění je především ověřit základní funkčnost aplikace. Spuštění aplikace se provádí pomocí zaváděcího modulu „Starter“. Tento modul má za úkol ověřit integritu aplikace a v případě, že je k dispozici připojení k Internetu, tak „Starter“ zkontroluje prostřednictvím distribučního portálu, zda není k dispozici nová verze aplikace. Úplný popis chování modulu „Starter“ je uveden v příloze č. 1 tohoto dokumentu. Jednotlivé kroky spouštění jsou přehledně zobrazovány:

V posledním kroku dojde vždy ke spuštění aktuální funkční verze DK.


PP IT 090818 1 2009-08-18



5. Postup nastavení Aplikace DK je sice od dodavatele nastavena pro práci již po prvním spuštění, ale toto obecné nastavení nemusí koncovým uživatelům vždy plně vyhovovat. Z tohoto důvodu aplikace DK umožňuje měnit nastavení tak, aby se s aplikací uživatelům lépe pracovalo. Nastavení se obecně skládá ze dvou částí. Nastavení z pohledu systému (aplikace jako takové), zde hovoříme o tzv. konfiguraci. A nastavení chování a vzhledu aplikace z pohledu uživatele, například nastavení velikosti a barvy písma, zde hovoříme o tzv. „Settings“. Oba typy nastavení se ukládají buď do konfiguračních souborů (formát *.ini, *.config, conf*.xml) či nastavovacích souborů (formát *.settings, settings*.xml). Po spuštění aplikace DK si tato přečte ze souboru „DistribuceVysledku.exe.config“, který je vždy umístěn ve stejné složce jako aplikace samotná, prvotní konfiguraci. Odtud vyčte zejména způsob spuštění aplikace a případně i ze kterých souborů se má číst další nastavení a konfigurace. Nejsou-li v tomto souboru cesty ke konfiguračním a nastavovacím souborům explicitně uvedeny, tak aplikace předpokládá, že konfigurační a nastavovací soubory jsou umístěny ve stejné složce jako aplikace (výchozí nastavení). Různé umístění nastavovacích souborů, umožňuje velmi pružné uzpůsobení aplikace podle různých požadavků. Například umístěním „Settings“ souborů do jednotlivých uživatelských profilů, lze dosáhnout individuálního vzhledu a chování aplikace pro každého uživatele zvlášť. Podobně lze využít i hardwarové profily, případně měnit pružně nastavení pomocí dávkových souborů či skriptů. Tato problematika však dalece přesahuje rámec této kapitoly a proto budeme nadále předpokládat, že konfigurační soubory jsou umístěny dle výchozího nastavení ve složce aplikace a nastavení je tak jednotné. Koncept aplikace DK předpokládá, že nastavení mohou provádět uživatelé sami, bez pomoci správce aplikace či správce systému. V případě, že chcete zabránit, aby běžní uživatelé měnili nastavení aplikace, dostačuje nastavit u příslušných nastavovacích souborů oprávnění tak, aby je uživatelé nemohli měnit, ale je třeba zajistit, aby uživatelům zůstal zachován přístup k souborům alespoň s oprávněním číst. V případě neexistence či nepřístupnosti nastavovacího souboru buď aplikace selže – objeví se chybové hlášení – nebo v některých případech vygeneruje nový soubor s nastavením, do kterého uloží nejnutnější výchozí hodnoty. Protože si uživatelé mohou zvyknout na určité chování aplikace DK je doporučeno umožnit uživatelům provádět změny v nastavení (výchozí stav po instalaci). Z důvodu uživatelského komfortu je možné provádět většinu změn nastavení pomocí formulářů (dialogových oken) přímo v aplikaci. Správce aplikace či správce systému může, stejně jakož i zkušenější uživatelé, editovat nastavovací soubory přímo. Soubory jsou upravitelné v běžném textovém editoru (např. pomocí poznámkového bloku - „Notepad“).


PP IT 090818 1 2009-08-18



S nastavovacími soubory je možné manipulovat samostatně, což je výhodné pro zálohování nastavení či jeho přenosu nebo zkopírování na více počítačů či pro další uživatele. Nastavení se z pohledu uživatele provádí následovně: 5.1. Spusťte aplikaci Po spuštění aplikace se tato projeví na obrazovce jako ikona v informačním řádku systému (tzv. „Tray“), zpravidla je umístěn informační řádek umístěn v pravém dolním rohu vedle hodin. Na obrázku je ikona aplikace v červeném kroužku.

5.2. Zobrazte menu aplikace Poklepáním sekundárním tlačítkem myši (zpravidla pravé tlačítko) na ikoně aplikace se zobrazí menu, odkud se budou provádět další kroky.

5.3. Nakonfigurujte aplikaci Spusťte menu „Konfigurace“. Dialogové okno „Konfigurace“ je rozděleno na dvě části. V horní části obrazovky se vkládají jednotlivé datové pumpy. Každá datová pumpa může pracovat právě za jednu organizaci (jedno IČZ = zdravotnické zařízení) a přistupuje právě k jednomu zdroji (datům z laboratoře). Datových pump může být více, což umožňuje nastavit aplikaci tak, aby čerpala data jak z více zdrojů (laboratoří), tak i pro více organizací (zdravotnických zařízení), např. do společného informačního systému polikliniky nebo nemocnice.


PP IT 090818 1 2009-08-18



V dolní části obrazovky je možné nastavit omezení práce datových pump pro jednotlivá pracoviště (jednotlivé IČP). Není-li zadána žádná omezující podmínka jsou data pro všechna IČP zpracována podle výchozího nastavení datové pumpy. Doporučujeme však vždy nastavení pracoviště specifikovat.


PP IT 090818 1 2009-08-18



5.3.1. Konfigurace datové pumpy Datovou pumpu vytvoříte pomocí tlačítka „Nový“ v menu příslušného formuláře. Otevře se dialog pro nastavení datové pumpy. Stejný dialog se otevře při zvolení tlačítka „Editovat“ nad zvolenou datovou pumpou.

V dialogu vyplňte identifikaci příjemce dat (přidělené IČZ, název příjemce pro zobrazení v komunikaci, cestu k elektronickému certifikátu pro ověření pravosti příjemce dat, výchozí místo pro ukládání přijatých dat, prefix přijatých dat a místo pro uložení provozních a ladicích informací).


PP IT 090818 1 2009-08-18



Dále vyplňte informace o místě odkud se budou čerpat data (místo umístění webové služby, veřejný klíč pro certifikát ověření pravosti místa, přihlašovací údaje). Datovou pumpu je možné odstranit pomocí tlačítka „Smazat“. Tlačítko „Aktualizovat“ slouží pro občerstvení údajů zobrazovaných v tabulce. 5.3.2. Konfigurace omezení zpracování dat V mnoha zdravotnických zařízeních se vykytuje více pracovišť. Protože jsou pracoviště často rozmístěna v různých lokalitách, je vhodné nastavit omezení práce datové pumpy tak, aby zpracovávala jen data určená pro příslušná pracoviště v dané lokalitě, případně ukládala data jednotlivých pracovišť odděleně a podobně. Pomocí tlačítka „Nový“ se objeví dialog pro vytvoření omezení zpracování dat pro jednotlivá pracoviště (jednotlivá IČP). Stejný dialog se objeví i v případě změny nastavení omezení.

V dialogu vyplňte identifikaci pracoviště (IČP) a specifická nastavení pro jednotlivá pracoviště (místo pro ukládání přijatých dat, prefix přijatých dat). Není-li pracoviště specifikováno, řídí se nastavení výchozím nastavením nadřízené datové pumpy. Tlačítkem „Smazat“ je možné odstranit vybrané omezení. Tlačítko „Aktualizovat“ slouží pro občerstvení údajů zobrazovaných v tabulce.


PP IT 090818 1 2009-08-18



5.4. Nastavte stahování dat V případě, že chcete automatizovaně stahovat data, je potřeba nastavit četnost spouštění datových pump a způsob zpracování získaných dat. Spusťte v menu „Nastavení“. Zobrazí se dialogové okno pro nastavení chování aplikace. Zde je možné nastavit hloubku hledaných údajů (ve výchozím stavu 3 měsíce dozadu), interval spouštění datových pump (výchozí nastavení je 60 minut) a způsob zpracování dat. !!!!!Nedoporučujeme nastavovat tuto hodnotu na údaj nižší než 30 minut.

Právě volba způsobu zpracování dat je klíčová pro zamýšlený účel aplikace. V případě, že chcete data zpracovávat ručně, je doporučeno zvolit „Pouze upozornit“. V tomto případě budete na nové údaje upozorněni grafickou změnou ikony aplikace.

Zbylé volby ocení především ti uživatelé, kteří používají specializované aplikace (například program pro vedení zdravotní dokumentace). Ti mohou s výhodou použít automatické stahování dat do místa, odkud si data může převzít jejich aplikace. V případě, že aplikace pracuje samostatně , je


PP IT 090818 1 2009-08-18



možné použít volbu „Stahovat bez upozornění“, ale pokud jejich aplikace vyžaduje provést nějaké úkony (například import data) , tak doporučujeme volbu „Stahovat s upozorněním“, protože tak budou vždy upozorněni na nutnost provedení úkonu v případě, že budou k dispozici nová data.

6. Sledování chodu programu a řešení problémů Ani správná instalace a konfigurace aplikace ještě nemusí být zárukou spolehlivého fungování aplikace DK. To je dáno tím, že aplikace DK je závislá na další službách operačního systému a k zajištění bezpečného a spolehlivého přenosu potřebuje mít zajištěn přístup k Internetu. K tomu, aby bylo možné případné problémy rychle vyřešit slouží několik technik, které by měly zajistit, aby aplikace fungovala vždy bezpečně a spolehlivě. V první řadě jde o kontrolu aplikace před spuštěním. V případě, že je aplikace poškozena, dokáže se za určitých podmínek „sama opravit“. Stejně tak se umí aplikace „sama zaktualizovat“. Jde o to, že „Starter“ – zavaděč aplikace DK, umožňuje v případě poškození nebo neaktuálnosti aplikace provést (i opakovaně) aktualizaci aplikace z distribučního místa, a v případě jeho nedostupnosti spustit předchozí verzi aplikace, je-li k dispozici. Tyto operace se projeví zvětšením času při spouštění aplikace. Aktuální spouštěnou verzi programu lze zjistit ze souboru „vision.ini“ v kořenové složce aplikace. Úplný popis chování modulu „Starter“ je uveden v příloze č. 1 tohoto dokumentu. Jednotlivé kroky spouštění jsou přehledně zobrazovány. Při další činnosti je aplikace schopna všechny kroky zaznamenávat do tzv. „logů“. Soubory logů obsahují klíčové údaje v případě, řešení problémů. Mimo běžný „event log“ systému, kam zapisuje aplikace zásadní chyby se v případě problémů podívejte do také složky s komunikačními logy, výchozí umístění složky je „C:\Program Files\Michem\Client\Log“. V případě přetrvávajících problémů kontaktuje vašeho dodavatele.


PP IT 090818 1 2009-08-18


Klient distribučního portálu Instalace a možnosti nastavení

Recommend Documents