zvem Specifikacija rešitve

Transcription

1 zvem Specifikacija rešitve KAZALO 1 Arhitektura rešitve Okolje Podatkovni strežnik Aplikacijski strežniki Aplikacijski strežnik Integracijski strežnik Strežnik za logiranje Load balancer Storitve portala zvem Struktura uporabniških strani portala Identifikacija, avtentikacija in avtorizacija uporabnikov Avtentikacija uporabnikov Shibboleth Identity provider (IdP) Shibboleth Service provider (SP) Registracija novih uporabnikov Spreminjanje kontaktnih podatkov Avtorizacija uporabnikov Avtorizacija dostopa do podatkov ostalih aplikacij Upravljanje z uporabniki Tipi uporabnikov Uporabniški vmesnik portala zvem Upravljanje, postavitev in prilagodljivost portala Prilagodljivost uporabniškega vmesnika Večjezičnost Pomoč uporabnikom portala Prilagoditve za ljudi s posebnimi potrebami Povzetek Lastnosti načel, smernic in merilo uspeha Načela in smernice standarda WCAG Zaznavanje Upravljanje Razumljivost Robustnost Posamezni posnetki spletne rešitve Viri Analitika portala Statistika portala Beleženje dostopov do podatkov (revizijska sled) Objava in urejanje novic, podobnih vsebin in dogodkov Spletni blogi Koledar Spletni forum Iskalnik po vsebinah portala Priprava in izvajanje različnih e-usposabljanj in e-izobraževanj Izdelava in objava spletnih vprašalnikov, anket in drugih obrazcev Periodičnost anket Uvoz distribucijske liste...24

2 16.3 Preverjanje tipa datotek Dopolnitev prikaza uporabnikov Uporabniške skupine Modul za zahtevnejši sprejem podatkov Vnos podatkov preko grafičnega vmesnika Priprava spletnega obrazca Vnos tipiziranih oznak Izpolnjevanje obrazca Oddaja obrazca Pregled oddanih obrazcev Paketni vnos (preko XML-a) Priprava obrazca za paketni vnos Paketna oddaja XML-datoteke (v aplikaciji) Paketna oddaja XML-datoteke (preko spletne storitve PaketnaOddajaWS) Opis servisa Kode napak Pregled oddanih XML paketov Obdelava in objava zajetih podatkov Prenos podatkov v OBI Podatkovni model OBI Preslikava iz Limesurvey Podrobnosti preslikave Razlaga tabel Razlaga pogledov (view) Šifrant tipov vprašanj Vključitev storitev ezz, erecept, enaročanje Integracija erecept Pregled seznama ereceptov Dnevnik vpogledov v erecepte Tehnična specifikacija integracije storitev erecept Seznam ereceptov Dnevnik vpogledov v erecept Integracija enaročanje Pregled čakalnih dob Prikaz seznama enapotnic Prikaz seznama enaročil Tehnična specifikacija integracije storitev enaročanje Skupna logika Pregled čakalnih dob Izpis napotnic Izpis naročil Integracija ezz Tehnična specifikacija integracije storitev EZZ (integracija IHMZ) Podrobnosti in nastavitve backbone strežnik Podrobnosti in nastavitve portalski strežnik Naročanje na obveščanje ter obveščanje Integracija z enaročanjem Storitev za obveščanje Varnostno kopiranje podatkov Priloge... Napaka! Zaznamek ni definiran. Stran 2 od 65

3 1 Arhitektura rešitve 1.1 Okolje Sistem sestavljajo Podatkovni strežnik Aplikacijski strežniki Proxy strežnik/load balancer (SSL endpoint) Citrix Netscaler load balancer Storitve izven projekta zvem Integracijski strežnik (a02t.zvem.ezdrav) OS: CentOS bit Aplikacijski strežnik (a01t.zvem.ezdrav) OS: CentOS bit Bazni strežnik (db01t.zvem.ezdrav) OS: Windows Server 2008 R2 Standard 64bit DB: SQL Server 2012 EE Strežnik za logiranje (a03t.zvem.ezdrav) OS: CentOS bit Podatkovni strežnik Slika 1: Shema sistema zvem Operacijski sistem: Windows Server 2008 R2 64 bit Bazni strežnik: SQL Server 2012 Podatkovne baze: liferay moodle limesurvey shibboleth Stran 3 od 65

4 1.1.2 Aplikacijski strežniki Aplikacijski strežnik Operacijski sistem: Centos bit Java aplikacijski strežnik: WildFly Web strežnik: Apache 2.2 PHP: 5.6 Aplikacije: Liferay Portal Community Edition 6.2 CE GA4 zvem portal Shibboleth Identity provider Shibboleth service provider Limesurvey Moodle Web servis za paketno oddajo anket Integracijski strežnik Operacijski sistem: Centos bit Java aplikacijski strežnik: WildFly Aplikacije: Backbone za povezavo na IH REST servisi za obveščanje Solr Strežnik za logiranje Operacijski sistem: Centos bit Bazni strežnik: MySQL 5.1 Web strežnik: Apache 2.2 PHP: 5.6 Aplikacije: Piwik Podatkovne baze: xtl-piwik Load balancer Uporablja se obstoječi Citrix Netscaler load balancer, ki služi tudi kot SSL endpoint. 2 Storitve portala zvem Portal zvem je postavljen na osnovi odprtokodne portalske platforme LifeRay ( Portal v grobem sestavlja ogrodje portala s svojimi internimi storitvami (prikaz vsebin ter orodja za upravljanje portala), na katere se navezujejo zunanje storitve bodisi v obliki portletov (storitve ezdravje) bodisi v obliki čisto ločenih sistemov, do katerih dostopamo iz portala (eučilnica, Zajem podatkov, Analitika portala). Stran 4 od 65

5 EZZ dokumenti CRPP erecept Dnevnik vpogledov v erecept Pregled čakalnih dob Seznam napotnic Seznam naročil Vsebine: Upravljanje portala: Novice Upravljanje vsebin Obvestila Upravljanje uporabnikov Iskanje Upravljanje portala Forum Blog Koledar Naročanje na obvestila Uporabniška pomoč eučilnica Priprava učilnic Izvedba Analitika portala Spremljanje aktivnosti Zajem podatkov: Priprava anket Priprava spletnih obrazcev Oddaja podatkov Analiza zajetih podatkov Slika 2: Storitve portala zvem 2.1 Struktura uporabniških strani portala Portal je sestavljen iz treh sklopov: Zgoraj se nahajajo jezički dostop do posameznih vsebin Osrednji del prikazuje vsebino posameznega jezička- V nogi se nahajajo povezave do dodatnih vsebin ter različne zunanje povezave, kjer uporabnik najde dodatne informacije. Slika 3: Struktura portala zvem Stran 5 od 65

6 Sam dostop do vsebin je opredeljen s tipom uporabnika. V grobem gre za neprijavljene in prijavljene uporabnike (glej poglavje 4.1). nekateri prijavljeni uporabniki imajo še dodatne pravice npr. za urejanje vsebin, administracijo portala, ipd. Domača stran Moje ezdravje eučilnica Koledar Objave Upravljanje Pregled Novice Upravljanje vsebin Dokumenti Obvestila Priprava anket erecept Iskanje Oddaja podatkov Recepti Analitika portala Dnevnik vpogledov v e-recept enaročanje Pregled čakalnih dob Seznam napotnic Seznam naročil Ostale vsebine: Forum Blog Uporabniška navodila Slika 4: Struktura strani prijavljeni uporabniki Domov Objave Iskanje Prijava Novice Oglasna deska Ankete Ostale vsebine: Uporabniška navodila Blog Forum Slika 5: Struktura strani neprijavljeni uporabniki 3 Identifikacija, avtentikacija in avtorizacija uporabnikov 3.1 Avtentikacija uporabnikov Vsa avtentikacija na portalu zvem se bo izvajala preko Varnostne sheme razen delov portala, ki bodo dostopni tudi anonimnim uporabnikom, npr: Javno objavljenih anket, do katerih bo lahko dostopil vsakdo. Branje novic. Branje foruma. Anket, kjer se uporabniki povabijo v reševanje. V tem primeru se bo poslala elektronska pošta s povezavo do ankete. T.i. javnih učilnic, za katere se bo izdelala ločena postavitev izobraževalnega okolja. V tem okolju ne bo potrebna prijava. ipd. Avtentikacija uporabnikov se bo izvajala preko digitalnih potrdil. Vsak registriran uporabnik portala zvem bo moral imeti svoje digitalno potrdilo registrirano v Varnostni shemi. Stran 6 od 65

7 Registracija novih uporabnikov je opisana v poglavju Registracija novih uporabnikov. Portal zvem bo omogočal enkratno prijavo (angl. Single Sign-On, SSO) v vse dele portala. Za implementacijo SSO sistema bomo uporabili Shibboleth, ki je sestavljen iz dveh delov: Identity provider Servis za enkratno prijavo uporabnika. Service provider Servis za avtentikacijo uporabnika v posameznih aplikacijah Shibboleth Identity provider (IdP) Na portalu zvem bomo izdelali prijavno stran preko katere se bo uporabnik s kvalificiranim digitalnim potrdilom prijavil na portal. Ker bo prijava uporabnika potekala preko digitalnega potrdila bomo v IdP uporabili X.509 Login handler, ki omogoča prijavo uporabnika z digitalnim potrdilom. Ob prijavi je potrebno uporabnika avtenticirati v Varnostni shemi. Shibboleth nima že izdelanih modulov za povezavo z varnostno shemo zato bomo izdelali dodatni modul (Login handler) za Shibboleth IdP, ki bo omogočah avtentikacijo uporabnika v Varnostni shemi preko spletnih servisov. Preko spletnih servisov bomo iz varnostne sheme pridobili pridobili naslednje podatke uporabnika: Ime Priimek Elektronska pošta Telefon KZZ številka Pravice uporabnika v zvem (Trenutno samo vloga Državljan) Shibboleth Service provider (SP) Portal zvem bo v osnovi sestavljen iz treh različnih aplikacij: Liferay (osnovni portal) Moodle (modul za izobraževanje) Limesurvey (modul za zajem podatkov) Shibboleth SP bo postavljen nad vsako od teh treh aplikacij in bo skrbel za enotno prijavo uporabnikov. Hkrati bo aplikacijam posredoval tudi podatke uporabnikov, kot so Ime, Priimek, elektronska pošta, telefon, pravice uporabnika, KZZ številka. Uporabnik se bo ob prvi prijavi vpisal v lokalni imenik portala zvem. 3.2 Registracija novih uporabnikov Vsi uporabniki portala zvem morajo biti registrirani v Varnostni shemi. Na portalu zvem bo tako na voljo tudi stran za registracijo za nove uporabnike. Uporabnik bo na strani za registracijo moral vpisati svoj elektronski naslov (obvezno) ter telefon (neobvezno). Po potrditvi mu bo aplikacija poslala elektronsko sporočilo s katerim bo potrdil svojo registracijo. Po potrditvi se bodo njegovi registracijski podatki (certifikat, elektronska pošta, telefon) preko spletnih servisov vpisali v Varnostno shemo. Varnostna shema bo poskrbela za pridobitev ostalih podatkov iz zalednih sistemov (Ime, Priimek, KZZ številka). Ob prvi prijavi uporabnika se bodo vsi njegovi podatki prinesli na portal zvem, kjer se bo kreiral nov uporabnik. Stran 7 od 65

8 3.2.1 Spreminjanje kontaktnih podatkov V kolikor bo uporabnik želel spremeniti kontaktne podatke ( , telefon), mu bo portal zvem podobno kot pri registraciji poslal potrditveno elektronsko sporočilo. Po kliku na link v potrditvenem sporočilu se bodo spremenjeni kontaktni podatki uporabnika vpisali v varnostno shemo. V kolikor bo uporabnikove kontaktne podatke spreminjal administrator, se potrditveno sporočilo ne bo poslalo, ampak se bodo podatki tako spremenili v Varnostni Shemi. V primeru da podatke spremeni administrator namreč ne moremo za potrditve vprašati uporabnika. 3.3 Avtorizacija uporabnikov V varnostni shemi se pravice ne bodo preverjale, razen pravice za dostop do portala. Pravice se bodo preverjale ob prijavi v posamezen del portala (Liferay, Moodle, Limesurvey), kjer bodo tudi shranjene Avtorizacija dostopa do podatkov ostalih aplikacij Na portalu bodo prijavljenim uporabnikom na voljo tudi podatki iz drugih aplikacij (erecept, enaročanje, ezz..).. Portal zvem se pri dostopu do teh aplikacij ne bo avtoriziral kot posamezen uporabnik, ampak kot aplikacija zvem. Portal zvem se bo na Varnostno shemo prijavil s svojim aplikacijskim certifikatom in pridobil SAML žeton za klic spletnih servisov ostalih aplikacij. 4 Upravljanje z uporabniki Dostop uporabnikov do samega portala se bo urejal v varnostni shemi, pravice pa v posameznih aplikacijah (Liferay (zvem portal), Moodle, Limesurvey). Globalne (sistemske) pravice uporabnikov se bo urejalo na enem mestu in sicer na administracijskih straneh portala Liferay, kjer bo mogoče poleg pravic za LifeRay urejati tudi globalne pravice v aplikaciji LimeSurvey in role uporabnike v sistemskem kontekstu aplikacije Moodle. Ostale pravice aplikacij Limesurvey in Moodle se bo urejalo znotraj teh aplikacij. Ker se bo vse sistemske pravice urejalo znotraj Liferay portala bo urejanje teh pravic potrebno onemogočiti v aplikacijah Moodle in Limesurvey. V aplikaciji Limesurvey bomo onemogočili urejanje globalnih pravic. V aplikaciji Moodle pa bomo onemogočili urejanje rol uporabnika v sistemskem kontekstu. V aplikaciji Moodle in Limesurvey bomo tudi dopolnili postopek prijave da bo v aplikacijo za uporabnika prenesel njegove globalne pravice, ki se urejajo znotraj Liferay portala (enako se prenese tudi izbrani jezik s portala zvem v Moodle oz. LimeSurvey). Na portalu zvem bomo v administracijskem modulu izdelali stran za pregled vseh pravic znotraj aplikacij portala evem. Na strani za pregled pravic bodo vidni naslednji podatki. Limesurvey: Skupine uporabnika Globalne pravice Pravice do predlog Moodle: Pravice v Moodle kontekstih Skupine v predmetih Kohorte Liferay: Vloge uporabnika Organizacijske vloge uporabnika Grupe uporabnika Stran 8 od 65

9 Pravice na forumih, koledarjih, novicah ne bodo vidne enem mestu, ampak na pripadajočih modulih v aplikaciji. 4.1 Tipi uporabnikov Uporabnike lahko v grobem razdelimo v naslednje skupine: anonimni (neprijavljeni) uporabnik: Brez prijave. Možen ogled nekaterih osnovnih vsebin. državljan/pacient: Prijava z digitalnim potrdilom. Dostop do vseh storitev portala zvem kot so forum, ankete, e-učilnice, storitve ezdravja, ipd. urednik vsebin: Prijava z digitalnim potrdilom. Možnost urejanja in objave vsebin na portalu. poročevalec: Prijava z digitalnim potrdilom. Oddaja podatkov v okviru zajema podatkov. administrator: Prijava z digitalnim potrdilom. Upravljanje portala in uporabnikov, spremljanje analitike portala. 5 Uporabniški vmesnik portala zvem Uporabniški vmesnik portala zvem upošteva: Priročnik celostne grafične podobe kohezijskega in strukturnih skladov EU v programskem obdobju Priročnik Celostne grafične podobe državne uprave. Priročnik Celostne grafične podobe projekta ezdravje. Elementi CGP portala z vem so opisani v: Priloga 1: MZ-ZVEM - CGP.pdf V uporabniški vmesnik portala zvem se bodo, poleg integriranih rešitev (erecept, enaročanje, EZZ), kasneje integrirane tudi ostale rešitve ezdravja, ki svoje storitve nudijo končnim uporabnikom (osebam/pacientom). V ta namen je pripravljen kratek standard za tehnološki način integracije uporabniških vmesnikov prihodnjih rešitev zvem v uporabniški vmesnik portala zvem: Priloga 2: MZ-ZVEM - Standard za tehnološki način vključitve novih rešitev.doc Pripravili smo tudi smernice za implementacijo ukrepov za čim boljšo uvrstitev v iskalnikih. Priloga 3: SEO (Search Engine Optimization).pdf Vsebina portala zvem se normalno prikazuje v spletnih brskalnikih Chrome, Firefox, Safari, Internet Explorer na delovnih postajah, tabličnih računalnikih in pametnih telefonih. 6 Upravljanje, postavitev in prilagodljivost portala Administrator portala ima na voljo orodja za upravljanje in postavitev portala. Poljubno lahko definira nove strani in podstrani (največ trije nivoji). Za prikaz oz. umestitev portletov na posamezno stran lahko izbere vnaprej pripravljene oblike razporeditve posameznih elementov. Na strani lahko dodaja oz. umika posamezne vsebinske elemente (portlete), ki so na voljo na portalu ter nastavlja pravice dostopa. Sama postavitev strani je dvojno organizirana: Postavitev za neprijavljene (anonimne) uporabnike. Postavitev za prijavljene uporabnike. Znotraj tega se dostop do posameznih vsebin nastavlja s pomočjo uporabniških pravic. Pripravljeni portleti upoštevajo standarde in specifikacije na področju: JSR 286 (Java Portlet Specification), WSRP (Web Services for Remote Portlets). Stran 9 od 65

10 6.1 Prilagodljivost uporabniškega vmesnika Z vidika uporabnikov portal ne omogoča prevelike personalizacije uporabniškega vmesnika. Ker mora uporabniški vmesnik slediti CGP smernicam, recimo niso na voljo možnosti izbire različnih barv ipd. Za posameznega v portal prijavljenega uporabnika je vgrajen profil, znotraj katerega so omogočene določene nastavitve (e-pošta, telefon, naročanje na obvestila erecepta in enaročanja, profilna slika), ki si jih bo lahko urejal vsak uporabnik. Prav tako ima uporabnik možnost izbire enega od štirih jezikov portala. Zadnja izbira jezika se zabeleži. 7 Večjezičnost Uporabniški vmesnik portala zvem je zasnovan večjezično. Podpira 4 jezike: slovenščina, angleščina, italijanščina ter madžarščina. Uporabnik lahko kadarkoli nastavi izbrani jezik oz. ga zamenja. Večjezičnost deluje usklajeno v vseh funkcionalnostih portala zvem. Ob prehodu med funkcionalnostmi ter storitvami zvem se ohrani prej izbran jezik (npr. prehod iz ogrodja v eučilnico). Prevedena so vsa sporočila ter nazivi za vse vidne gradnike portala, do katerih dostopajo navadni uporabniki (nazivi oken, gumbov, meniji, ipd.). Princip večjezičnosti je poleg uporabniškega vmesnika upoštevan tudi pri prikazu vsebin portala. Prevodi teh vsebin so/bodo predmet od uredniške politike portala (zagotovi jih urednik vsebine). Podobno velja za prikaz podatkov storitev ezdravja. Preveden je sam portalski del, vsebina pa se prikazuje v obliki oz. jeziku, kakršnega portal pridobi. 8 Pomoč uporabnikom portala Vgrajena je infrastruktura, ki omogočala uporabniško pomoč ter možnost večjezičnosti te pomoči. Pomoč je vgrajena v obliki wiki vsebine. Na vsaki strani portala je na voljo kontekstna pomoč. Uporabnik pa ima možnost dostopiti tudi do celotne pomoči (ne glede na trenutni kontekst). 9 Prilagoditve za ljudi s posebnimi potrebami Portal je pripravljen v skladu s smernicami prilagoditve za ljudi s posebnimi potrebami. V nadaljevanju so predstavljene značilnosti rešitve in skladnosti s smernicami WAI priporočila W3C. 9.1 Povzetek Portal je zasnovan v skladu s smernicami prilagoditve za ljudi s posebnimi potrebami (WAI priporočilo W3C), navedenimi v specifikaciji zahtev, ki jih je pripravilo Ministrstvo za zdravje: vse slike, razen dekorativnih, imajo ALT oznake, omogočen je prikaz avdio datotek in video vsebine z opisi, naslov strani je prvi element na strani. Je specifičen za vsako stran (jasen in deskriptiven), omogočena je tekstovna navigacija, obstaja možnost, da se navigacijo preskoči, dostop do najpomembnejših funkcionalnosti je omogočen z uporabo bližnjic (»access keys«), premikanje med povezavami je omogočeno s tipko TAB, povezave so smiselno umeščene in deskriptivne, besedilo na strani je logično razporejeno ter strukturirano z naslovi in podnaslovi, pri obrazcih ima vsako polje svoj naziv. Naziv polja se izpiše kot tekst pred samim poljem. Oznaka, da je polje obvezno, je izpisana pred samim poljem, uporabljen je CSS, kjer so velikosti v CSS dokumentu definirane sicer absolutno, ampak rešitev zagotavlja možnost normalne uporabe storitve s funkcionalnostjo povečave v brskalniku, Stran 10 od 65

11 uporabljen je dober kontrast teksta in ozadja, brez kompleksnih vzorcev, pomen in razumevanje vsebine ni vezano na njeno barvo in obliko, povezave v besedilu so konvencionalno označene podčrtane, animacij na portalu ni. V nadaljevanju dokumenta se nahajajo podrobnejši opisi posameznih načel standarda WCAG 2.0, pripadajočih smernic in predstavitev skladnosti rešitve. 9.2 Lastnosti načel, smernic in merilo uspeha Načela in smernice standarda WCAG 2.0 Standard sestavljajo 4 glavna načela, ki vsebujejo 12 smernic, smernice pa 61 meril uspeha. ZAZNAVANJE: možnosti besedila za ne-besedilne vsebine, časovno omejen medij, prilagodljivost, razlikovanje. UPRAVLJANJE: dostopnost preko tipkovnice, zagotavljanje zadostnosti časa za uporabnike, zdravstveni napadi, navigacija. RAZUMLJIVOST: berljivost, prilagodljivost, vhodna pomoč. ROBUSTNOST: združljivost Zaznavanje Pri načelu zaznavanja je izrednega pomena način priprave in objave vsebine na portalu, saj načelo zaznavanja narekuje, da so vse informacije in komponente napisane tako, da jih uporabnik lahko zazna. To pomeni, da mora za pomembne informacije vedno obstajati enakovredna alternativa za ljudi, ki ne morejo uporabljati vsaj enega izmed svojih čutov. Izjema so primeri, kadar za določeno komponento ali informacijo že obstaja alternativa. Ker so vsebine v pristojnosti in domeni naročnika, v nadaljevanju opisujemo merila uspeha in skladnosti rešitve glede omogočanja, ne pa tudi podajanja dejanskih vsebin. Id SMERNICA MERILO USPEHA 1. Možnosti besedila za ne-besedilne vsebine Možnosti besedila za ne-besedilne vsebine 2. Časovno omejen medij Samo avdio in samo video (vnaprej posneto) Napisi (vnaprej posneto) Zvočni opis ali medijska alternativa (vnaprej posneto) Napisi (v živo) Zvočni opis (vnaprej posneto) Stran 11 od 65

12 Id SMERNICA MERILO USPEHA Znakovni jezik (vnaprej posneto) Obširnejši zvočni opis (vnaprej posneto) Medijska alternativa (vnaprej posneto) Samo avdio (v živo) 3. Prilagodljivost Informacije in relacije Smiselno zaporedje elementov Senzorične lastnosti 4. Razlikovanje Uporaba barv Nadzor zvoka Minimalni kontrast Nastavljiva velikost besedila Okrepljen kontrast Tišji zvok oz. brez zvoka v ozadju Vizualna predstavitev (širina znakov ne sme presegati 80 znakov, razmiki med vrsticami vsaj 1.5,...) Slike besedila (brez izjem) Tabela 1: Razdelitev načel zaznavanja OPIS SKLADNOSTI Oblikovna zasnova portala upošteva: da je vsebino možno prilagoditi in predstaviti na različne načine z uporabo različnih medijev, da kljub prilagodljivosti ohranja prvotno strukturo in informacije, da je zaporedje elementov smiselno, da so upoštevani kontrasti med izbranimi barvami, da pri minimalnem kontrastu razmerje ni manjše kot 3:1, da ima uporabnik možnost nadzora zvoka (v primeru, da se le-tega uporabi), da uporabnik s pomočjo povečave v brskalniku regulira velikost željene vsebine, da besedila niso poravnana obojestransko, da so upoštevani razmiki med vrsticami vsaj 1.5 in odstavki vsaj 1.5x kot razmiki med vrsticami Upravljanje Načelo upravljanja narekuje, da so vse komponente vključno z navigacijo, upravljive. Zagotavljati je potrebni enostavno upravljivost, da lahko vsi uporabniki preberejo in uporabijo vsebino. Id SMERNICA MERILO USPEHA 1. Dostopnost preko tipkovnice Tipkovnica Brez pasti tipkovnice Tipkovnica (brez izjeme) 2. Dovolj časa za uporabnike Prilagodljiv čas Stran 12 od 65

13 Id SMERNICA MERILO USPEHA Premor, zaustavitev, nevidnost Brez časovnega roka Prekinitve Ponovno preverjanje pristnosti 3. Zdravstveni napadi Tri utripi ali pod pragom Tri utripi 4. Navigacija Izogibanje blokov vsebine Naslov strani Žarišče vrstnega reda Povezava namena (v kontekstu) Različni načini iskanja spletne strani Naslovi in nalepke Vidno žarišče Lokacija Povezava namena Področje naslovov Tabela 2: Razdelitev načel upravljanja OPIS SKLADNOSTI Rešitev ustreza načelu enostavnega upravljanja na način, da: vsebuje enostavno navigacijo, omogoča iskanje po vsebinah, izpis vsebin ni animiran, zunanje strani niso časovno omejene in niso vezane na sejo, da je pri notranjih straneh (za prijavljene uporabnike) zaradi varnosti sicer seja določena, a je uporabnik pred potekom časovnega roka ustrezno opozorjen in ga lahko podaljša, obstaja možnost, da se navigacijo preskoči s pomočjo skritih anchor linkov, ki so prvi element na strani in berljivi t.i.»screen readerjem«in ob izbiri se uporabnik premakne do vsebine z #main-content, da rešitev ne vsebuje in predvideva premikajočih ali kakorkoli utripajočih vsebin, ki bi lahko izzvale zdravstvene napade uporabnikov. OPOMBA: urednik portala bo moral upoštevati in biti pozoren, da je pri imenovanju povezav dosleden in da bo pomensko ustrezno povezoval funkcionalnosti in vsebinske sklope. Stran 13 od 65

14 9.2.4 Razumljivost Pri načelu razumljivosti je pomembno, da so informacije predstavljene na razumljiv način, prav tako pa tudi delovanje uporabniškega vmesnika. Id SMERNICA MERILO USPEHA 1. Berljivost Jezik strani Jezik določenih delov vsebine Nenavadne besede Okrajšave Stopnja branja Izgovorjava 2. Predvidljivost Žarišče Vhod Dosledna navigacija Dosledna identifikacija Sprememba na zahtevo 3. Vhodna pomoč Napaka identifikacije Nalepke in navodila Predlogi napak Preprečevanje napak (pravnih, finančnih, podatkovnih) Pomoč Preprečevanje napak (vseh) Tabela 3: Razdelitev načel razumljivosti OPIS SKLADNOSTI Razumljivost vsebin se v večji meri nanaša na podajanje vsebin torej zavisi od urednika, ki bo vsebine na portalu urejal in pri tem upošteval načela razumljivosti. Rešitev kot taka omogoča vnos html vsebin in že v sami zasnovi sledi načelom razumljivosti. Napake pri uporabi uporabniškega vmesnika so jasne in razumljivo predstavljene uporabniku Robustnost Načelo robustnosti temelji na usmeritvi, da mora biti vsa vsebina dovolj robustna, da lahko interpretira s strani različnih uporabniških agentov, podporne tehnologije in brskalnikov, pri katerih je pomembna združljivost s sedanjimi in prihodnjimi izdelki. Id SMERNICA MERILO USPEHA 1. Združljivost Razčlenjevanje Ime, vloga, vrednost Tabela 4: Razdelitev načel robustnosti Stran 14 od 65

15 OPIS SKLADNOSTI Rešitev striktno uporablja polno formiran HTML, vključno z elementi, ki se praviloma pojavljajo sami (npr. <BR />). Stilsko je oblikovanje izvedeno s CSS2, vendar ni ovir za zamenjavo na novejše različice. Stran je testirana za brskalnike, ki podpirajo W3C priporočila in sicer z zadnjo različico brskalnikov na tistih različicah operacijskih sistemov iz družin Windows, Mac in Linux, ki so še podprte v vzdrževalnem ciklu. 9.3 Posamezni posnetki spletne rešitve Slika 6: WCAG Contrast checker v Firefox potrjuje primernost barvne sheme in ustreznost po WCAG 2.0 Stran 15 od 65

16 Slika 7: Vsebino lahko poljubno povečujemo s pomočjo funkcionalnosti brskalnika. Slika 8: Stran ostane berljiva tudi po izjemni povečavi v brskalniku. Stran 16 od 65

17 Slika 9: Prikaz razmikov med vrsticami in sestavki. Slika 10: Jasen in pregleden vpogled v podatke s podporo iskalnika in filtriranja izpisa (prijavljen uporabnik) Stran 17 od 65

18 Slika 11: Podčrtane povezave v besedilu z alternativnim besedilom, ki je berljivo tudi z Braillovo vrstico 9.4 Viri (1) Babinszki, T. WCAG Tutorial: WCAG 2.0 Dostopno na: (2) Dračina, A. POVEČEVANJE E-VKLJUČENOSTI Z UPORABO SMERNIC WCAG 2.0, Analitika portala Za spremljanje analitike portala je vgrajeno odprtokodno orodje Piwik ( Statistika portala Piwik izvaja beleženje statistike na portalu. Administratorjem portala imajo tako pregled nad: različnimi statistikami o obiskovalcih (npr.: predhodna spletna stran, geografski podatki, podatki o programski opremi, jezikovnih nastavitvah), statistike glede dostopov do različnih vsebin (npr.: čas na posamezni podstrani, prehajanje med stranmi na portalu), grafično predstavitev statistik, izvoz podatkov v nekatere standardne formate (npr.: XML, MS Excel), s strani uporabnika nastavljive pogledi statističnih podatkov. Pri vsakem zapisu se kot edini uporabnikov»osebni podatek«zabeleži uporabniško ime iz portala zvem (določi ga VS) Beleženje dostopov do podatkov (revizijska sled) Zagotovljena je tudi revizijsko sled pri uporabi zvem, ki zagotavlja dokazila o zaporedju aktivnosti izvira in ponora, v času operacije ali dogodka (branje, spreminjanje, dodajanje, brisanje). Upoštevani so tudi zakonski predpisi glede varstva osebnih podatkov (osebni podatki se ne prikazujejo). Pri vsakem zapisu se kot edini uporabnikov»osebni podatek«zabeleži uporabniško ime iz portala zvem (določi ga VS). Stran 18 od 65

19 V okviru storitev ezdravja je možno spremljati so zabeleženi dostopi do posameznega portleta, ne beleži pa se vsebina posameznega vpogleda. Piwik ponuja različne možnosti beleženja podatkov. Privzeto se uporablja Javascript vmesnik, vse podatke pa je možno zapisovati tudi s pomočjo HTTP API-ja v praksi gre za GET ali POST zahteve na določen URL, z določenimi parametri (podrobneje opisani tukaj : Te zahteve je možno izvajati s strežnika iz različnih aplikacij in platform. Za namene beleženja dostopov do posameznih funkcionalnosti ali vsebin se uporablja t.i. Event tracking beleženje posebnih dogodkov v aplikaciji. Za to beleženje orodje predvideva nabor treh podatkov: Kategorije (Event Category) Akcije (Event action) Nazivi (Event names) Za potrebe beleženja dostopov se uporabljajo kategorije skladno s smiselno razdelitvijo aplikacije na module. Primer kategorije bi bil torej npr. EZZ Dokumenti, Moodle, ipd. Akcija ustreza aktivnosti na posameznem resursu, npr. ogled dokumenta EZZ. Naziv se uporablja za zapis konkretnih nazivov izvedenih funkcij (le za Moodle in LimeSurvey). 11 Objava in urejanje novic, podobnih vsebin in dogodkov V portal je vgrajen uporabniški vmesnik za pripravo, objavo novic oz. raznih vsebin, ki se uporabnikom prikazujejo v za to namenjenih gradnikih portala. Uporabniški vmesnik je dostopen le administratorjem portala ter urednikom vsebin. Portal omogoča prikaz dveh tipov vsebin: Novice (različne daljše objave), Obvestila (krajše novice, sporočil, objave). Omogočena je tudi podpora preprostemu workflowom (osnutek-objava-potrditev). Končno potrditev vsebine izvede urednik vsebine. Objava vsebin je mogoča na enostaven način, brez pomoči IT osebja oz. razvijalcev, preko html urejevalnika (WYSIWYG). Objavljena vsebina je lahko splošna (vidna vsem), ali pa namenjena le posamezni skupini uporabnikov. V ta namen je vgrajena tudi opcija dodeljevanja pravic dostopa do posamezne vsebine glede na želeno skupino uporabnikov. Nekaj osnovnih značilnosti: Kompleksne html prispevke. Kategorizacijo vsak pisni prispevek je mogoče uvrstiti v določeno kategorijo in/ali podkategorijo. Možnost zapiranja/odpiranja dostopa do pisnih prispevkov za posamezne skupine uporabnikov. Uporabnikom je omogočeno naročanje na vsebine (RSS). Statuse pisnih prispevkov administrator lahko določi: Datum objave, Datum prenehanja objave, Datum arhiviranja. Atribute, kot so avtor, datum, status, dostopne pravice pri vsakem pisnem prispevku. Ločevanje besedil pisnih prispevkov na uvodno besedilo in jedro besedila. Objavo pisnih prispevkov, ki vsebujejo multimedijske vsebine (avdio ali video posnetek) v obliki, ki je primerna za prenos datoteke na odjemalca (»download«) ali predvajanje. Stran 19 od 65

20 Objavo pisnih prispevkov, ki vsebujejo druge tipe dokumentov, v obliki, ki je primerna za prenos datoteke na odjemalca (»download«). Možnost tiskanja pisnega prispevka v tiskalniku prijazni obliki. Socialno označevanje vsebin (Twitter, Facebook, ipd) in možnost komentarjev posameznih vsebin. Administrator portala lahko določi obliko prikaza, npr. število stolpcev na strani, v katerih so prikazani članki Spletni blogi Posebna vrsta objav so spletni blogi. Poleg objave vsebin omogočajo tudi komentiranje, ocenjevanje, prijavljanje neprimernih vsebin, ipd. Urejanje blogov je vezano na pravice. Prav tako je posamezen zapis vezan na pravice, ki jih lahko urejajo lastniki/upravljalci bloga. Blog podpira podobne osnovne funkcionalnosti, kot veljajo za objavo in urejanje novic 12 Koledar Na portal je postavljen tudi koledar, v katerega uporabniki vpisujejo različne dogodke. Uporabniki lahko na portalu uporabljajo (in dodajajo nove) osebne koledarje. Administratorji in uredniki vsebin pa skrbijo za skupni koledar (lahko oblikujejo tudi več skupnih koledarjev npr. glede na vsebino). Posamezni vnosi v koledar oz. tudi sam koledar je vezan na pravice, ki jih urejajo lastniki/upravljalci posameznega koledarja. Omogočena je tudi priprava in uporaba koledarja različnih virov, ki se uporabljajo za izvedbo posameznih dogodkov (npr. koledarji sejnih sob, predavalnic, opreme, ipd.). Uporabnikom je omogočeno naročanje na vsebine (RSS). Sinhronizacija z zasebnimi koledarji (MS Exchange, Google Calendars, Lotus Notes) je mogoča s pomočjo.ics datotek. 13 Spletni forum Spletni forum bo imel administratorski vmesnik za spreminjanje nastavitev foruma. S forumom upravljajo uredniki vsebin, ki odpirajo posamezne kategorije, določajo pravice za ogled vsebin, ipd. Navadni uporabniki lahko dodajajo nove diskusije znotraj kategorij ter komentirajo oz. objavljajo v okviru obstoječih. Vsak posamezen vnos v forum je vezan na pravice, ki jih urejajo lastniki/upravljalci posameznega kategorije/diskusije. Spletni forum omogoča: Možnost zapiranja/odpiranja dostopa do foruma za posamezne skupine uporabnikov. Možnost zapiranja/odpiranja dostopa do posamezne teme foruma (kategorija/diskusija) za posamezne skupine uporabnikov. Možnost pošiljanja zasebnih sporočil med uporabniki. Možnost odgovarjanja, popravljanja, brisanja, citiranja, poudarjanja sporočil na forumu. Možnost oblikovanja kategorij in pod-kategorij razprav. Možnost naročanja na spremembe v temi. Uporabo html urejevalnika pri pisanju sporočil. Uporabnikom je omogočeno naročanje na vsebine (RSS). 14 Iskalnik po vsebinah portala Na portal smo vgradili iskalnik po vsebinah portala zvem, ki je na voljo vsem uporabnikom. Vsaki skupini uporabnikov bo omogočeno iskanje le po področjih, ki so dostopne tej skupini. Stran 20 od 65

21 V iskanje so vključene vsebinah ogrodja portala (novice, obvestila, forum, blog, koledar). Iskanje v povezanih rešitvah se izvaja v okviru teh rešitev (eučilnica, priprava/zajem podatkov). Storitve ezdravja imajo vsaka svoj vsebinsko prilagojen iskalnik. Iskalnik je uporabniku dostopen ne glede na to, kje na portalu trenutno je. Omogoča ločeno iskanje v več jezikih. Vsebuje pravila za korenjenje besed (v slovenskem jeziku). Omogoča razvrščanje rezultatov iskanja glede na skladnost s poizvedbo. 15 Priprava in izvajanje različnih e-usposabljanj in e- izobraževanj Za pripravo in izvajanje e-usposabljanj in e-izobraževanj smo uporabili odprtokodno platformo Moodle ( Avtorizacija je zagotovljena na nivoju modula. Modul omogoča upravljanje z uporabniki. Predvidene so tri uporabniške vloge: učitelj, učenec, administrator. Modul vsebuje funkcionalnosti: Kreiranje delovnih skupin. Posamezna skupina lahko vključuje enega ali več učencev ter enega ali več učiteljev. Okolje za ustvarjanje in urejanje vsebine. Dostop do vsebin za posamezni e-tečaj in možnost dodajanja komentarjev in zaznamkov k celotni učni vsebini. Dostop do informacij o e-tečajih, urniku in učiteljih, učencih, dostop do učnih vsebin in ostalih učnih orodij posameznega e-tečaja. Okolje za preverjanje znanja in ustvarjanje testov. Orodje za samodejno testiranje in ocenjevanje (kadar je to mogoče, glede na tip vprašanja in odgovora). Možnost sklicevanja e-tečajev. Udeleženci e-tečaja so lahko člani določene skupine ali pa jih izberemo namensko za določen e-tečaj. Povezava s koledarjem v okviru portala zvem (prenos vnosov v skupni koledar s pomočjo.ics datotek). Funkcionalnost omogoča splošni in osebni koledar. Splošni koledar vsebuje vse dogodke, povezane s funkcionalnostjo e-usposabljanja. V splošnem koledarju lahko prikazane dogodke omejimo na eno skupino ali osebo. Osebni koledar prikazuje samo dogodke posamezne osebe/pacienta. Podpora osnovni komunikaciji med uporabniki: Forumi; Izmenjava datotek; Elektronska pošta; Klepetalnica. Upravljanje e-tečaja. Orodje za ocenjevanje in pregledovanje ocen po učencu, nalogi ali e-tečaju. Posredovanje in prejemanje vaj, domačih nalog, seminarskih nalog. Sledenje učencem (informacije o prijavah v sistem, številu dostopov do učnih materialov in diskusijskih forumov). Izdelavo slovarja strokovnih izrazov za posamezen e-tečaj ali skupnega za vse tečaje. Orodje za generiranje poročil in statistik. Stran 21 od 65

22 16 Izdelava in objava spletnih vprašalnikov, anket in drugih obrazcev Vgradili bomo modul, ki bo omogočal izdelavo in objavo spletnih vprašalnikov, anket in drugih obrazcev. Uporabili bomo odprtokodno orodje LimeSurvey ( Obrazci bodo lahko namenjeni uporabniškim skupinam in posameznim uporabnikom portala. Omogočena bo hkratna objava več obrazcev, za katere bo možno določiti različne časovne intervale (npr. enkratno, ponavljajoče ali večkratno oddajo podatkov, ). Primeri spletnih obrazcev na portalu: Ankete na temo portala (izpolnjevanje na željo uporabnika). Ankete, ki so namenjene ciljnim skupinam uporabnikom (obvezno in neobvezno izpolnjevanje). Spletni obrazci za spremljanje zdravstvenega sistema (kazalniki, poročila). Orodje za izdelavo in objavo spletnih obrazcev bo omogočalo upravljanje s spletnim vprašalnikom: kreiranje, določitev datuma/ure in trajanja objave, določitev tipa spletnega vprašalnika (javno dostopen (tudi zanje se lahko pošljejo povabila), zaprt (vedno se pošljejo samo povabila)..), določitev frekvence ponavljanja vprašalnika (ni ponavljanja, dnevno, tedensko, štirinajstdnevno, mesečno, vsakega X. v mesecu), (podrobneje opisano v spodnjem odstavku) vnos besedila za obveščanje izpolnjevalcev, pošiljanje elektronskega sporočila v primeru zaprtega vprašalnika (možnost izbire vseh, tistih, ki so že odgovorili na anketo za določeno obdobje ali tistih, ki še niso odgovorili na anketo za določeno obdobje), pošiljanje sporočila tistim, ki so odgovorili na odprti vprašalnik. Opomba: To dosežemo tako, da vprašalnik označimo kot zaprt in izberemo nastavitev, da se odprti uporabniki lahko registrirajo za sodelovanje. Pri registraciji uporabniki vpišejo ime, priimek in elektronski naslov. S tem se vpišejo v seznam anketirancev in jim lahko pošiljamo sporočila. možnost dodajanja manjše priloge k elektronskemu sporočilu. Orodje bo omogočalo izdelavo strukturiranih spletnih obrazcev z elementi, kot so: imena polj, vnosna polja (različnih tipov), vnos omejitev vrednosti, ki se lahko vpišejo v polje, izbor tipa polja (tekstovno, številčno, elektronski naslov,, ), za elektronski naslov ter URL je možen vnos v navadno tekstovno polje izbirna polja (označitev, koliko izbir je možnih itd.), pogojne dele vprašalnikov (take, ki se prikažejo, če je določen odgovor bil določene vrednosti), označitev obveznih vprašanj, strukturiranje vprašanj po straneh, uporabo šifrantov za vnosna polja v obrazcih, ki se prenesejo v orodje, itd.., Orodje bo omogočalo različne poglede in analize nad zajetimi podatki: sprotni vpogled za administratorja vprašalnika v število odgovorjenih vprašalnikov, odstotek izpolnjenih vprašalnikov, seznam izpolnjenih vprašalnikov itd., grafični prikaz porazdeljenosti odgovorov pri posameznem vprašalniku, prikaz vseh odgovorov pri vprašanju, možnost izvoza odgovorov za nadaljnjo obdelavo itd. Orodje bo omogočalo enostavno kopiranje vseh elementov obstoječega vprašalnika ob kreiranju novega Periodičnost anket Ponavljanje vprašalnika se omogoči z novim poljem»ponavljanje ankete«v sklopu»uredi nastavitve za anketo«, zavihek»kontrola objavljanja in dostopa«. Polje ima obliko spustnega seznama z Stran 22 od 65

23 vrednostmi»brez ponavljanja, Dnevno, Tedensko, Štirinajstdnevno in Mesečno«. Prikazuje ga Slika 12. Slika 12: Polje za določitev periodičnosti ankete V primeru izbranega intervala Mesečno, se pojavi spustni seznam z imenom»dan v mesecu«, kjer je treba izbrati, kateri dan v mesecu naj se anketa ponovi. Spustni seznam je omejen na 31 dni. Ob shranjevanju ankete se na bazo shrani interval ponavljanja. Izdela se postopek, ki se izvaja samodejno v aplikaciji (cron job), in vsakodnevno preverja, ali je potrebno pripraviti kakšno novo anketo. Postopek pregleda ankete in poišče tiste, kjer je nastavljeno ponavljanje. Za vsako takšno pregleda, ali velja: (datum_začetka + perioda) <= (trenutni_datum +1). Če velja, ustvari novo anketo, ki je kopija prejšnje ankete. Nova anketa ima datum začetka vedno nastavljen na naslednji dan. Razlog je, da je postopek namenjen vsakodnevni izvedbi. Če se iz kakršnega koli razloga postopek kakšen dan ne bi izvedel in se ankete, ki naj bi začele veljati naslednji dan ne bi kopirale, se bodo skopirale naslednjič, ko se bo postopek izvedel. Če postopek datuma začetka ankete ne bi nastavljal na naslednji dan, bi v primeru zamujenih anket nastavil datum začetka v preteklost, kar ni prav. To tudi pomeni, da se bo perioda v takem primeru zamaknila. Primer: anketa se začne 10 v mesecu s tedenskim intervalom. Normalno bi se 16. v mesecu skopirala in nastavil začetek 17. v mesecu. V primeru prekinitve v delovanju postopka npr. 3 dni 16., 17. in 18. bi se 19., ko hipotetično postopek ponovno deluje, anketa skopirala in nastavila začetek na 20. Naslednji interval bi bil po novem 27. v mesecu in ne 24, kot bi bil, če bi postopek deloval neprekinjeno vsak dan. To pravilo pa ne drži za interval Mesečno, ker je dan točno določen. Po kopiranju (ponovni objavi) nova anketa podeduje periodiko in dan v mesecu iz stare ankete, stari pa se ta dva podatka (dan pričetka ankete in periodika) izbrišeta. Novi anketi se datum začetka nastavi na naslednji dan (jutrišnji datum), datum konca pa se izbriše (to se dela, ker je možno, da je na stari anketi obstajal in se ob kopiranju prenesel, ampak tega podatka na novi seveda nočemo). Naslov nove ankete je naslov stare ankete brez datuma + nov datum začetka. Logika bo datum, ki ga bo iz imena ankete izbrisala, iskala v zadnjih 10 znakih v formatu DD.MM.YYYY. Če datuma ne bo našla, bo vseeno vzela ime stare ankete in dodala nov datum. Postopek kopijo in originalno anketo med sabo v ozadju na bazi tudi poveže, da se bo v primeru morebitnih težav hitreje odkrilo, kaj se je zgodilo. Lastnik nove ankete bo vedno osnovni administrator portala. V primeru, da ima anketa uvožene anketirance preko skupin iz portala ZVEM, se kot povabljenci vedno vzamejo osebe, ki imajo na dan kreiranja nove ankete to skupino v portalu ZVEM. Torej se uvoz izvede ponovno in se takih anketirancev iz stare ankete ne kopira. Dodatno pa se iz stare ankete prepišejo ročno dodane osebe in se jim, če izhajajo iz portala ZVEM, posodobi podatke. Na koncu postopek pošlje elektronska vabila vsem povabljenim anketirancem. Stran 23 od 65

24 16.2 Uvoz distribucijske liste V primeru zaprtega vprašalnik bo možno določiti skupine (iz portala ZVEM) za osebe, ki lahko izpolnjujejo določen vprašalnik. Na strani»anketiranci«se v ta namen doda modul skupine anketirancev, kot prikazuje Slika 13. za uvoz Slika 13: Pregled anketirancev Ob kliku na ikono se odpre okno»uvozi skupine anketirancev«, kot prikazuje Slika 14. V oknu je možno v seznamu izbrati skupine uporabnikov (kot so definirane v portalu ZVEM, ki jih želimo uvoziti med anketirance. S klikom na gumb»uvozi«se v seznamu anketirancev dodajo, oz. posodobijo vsi zapisi, ki se navezujejo na anketirance v tej skupini. Slika 14: Okno za uvoz skupine anketirancev Seznam skupin, ki so se uvozile se zapiše tudi na anketo kot prikazuje Slika 15. Prav tako se pri vsakem anketirancu, ki je bil uvožen preko skupin iz ZVEM, to označi na bazi (tabela dbo.lime_tokens_#sid#, polje uvoz_zvem), v aplikaciji pa se ta podatek ne prikazuje. Slika 15: Seznam skupin ki so bile uvožene na anketo Stran 24 od 65

25 16.3 Preverjanje tipa datotek Možnost dodajanja datotek različnih tipov (npr. csv, xml, jpg, txt, doc ) in nastavitev omejitve velikosti datotek. Predvideno se omeji možen nabor izbire tipa datoteke na npr. 20 najpogostejših: png, jpg, gif, bmp, pdf, doc, docx, rtf, xls, xlsx, ppt, pptx, odt, ods, xml, xsd, txt, csv, zip in rar. Pri tem mora logika preverjati, da gre za datoteko določenega tipa (glede na končnico in dodatno še obravnava mimetype, ki ga z uporabo PHP knjižnic pridobi iz datoteke) Dopolnitev prikaza uporabnikov Del podatkov prikaza uporabnikov (anketirancev) so podatki o uporabniku in izvajalcu zdravstvene dejavnosti, za katerega je imel pravice po varnostni shemi. Za uporabnika se prikazujejo: ime, priimek, elektronski naslov, pri podatkih o izvajalcu zdravstvene dejavnosti, pa se v uporabniškem vmesniku prikazuje le Naziv izvajalca, na bazi pa je shranjen podatek o BPI številki izvajalca, ki enolično opredeljuje posameznega izvajalca. Dopolni se prikaz uporabnikov na straneh: Plošča anketirancev ( v sklopu Osrednja podatkovna zbirka/plošča anketirancev) Prikaži žetone (v sklopu Urejanje žetonov) Prikaži odzive (v sklopu Odzivi in statistika) Podrobnosti odziva (v sklopu Odzivi in statistika) 16.5 Uporabniške skupine Predvideni uporabniki, na nivoju orodja za zajem podatkov: Uporabniki, ki sestavljajo obrazce za prejem podatkov. Uporabniki, ki oddajo podatke preko vprašalnikov, anket, obrazcev ali datotek. Uporabniki, ki pregledujejo podatke. Za potrebe omejevanja pravic se ustvari (glede na zgornje predvidene tipe uporabnikov) štiri skupine uporabnikov: PRIPRAVA_ANKET UVOZ_PODATKOV PREGLED_PODATKOVADMINISTRATOR Skupina uporabnikov PRIPRAVA_ANKET omogoča pripravo spletnega obrazca za prejem podatkov. Skupini se dodeli pravice za sklopa»ankete«in»upravljaj skrbnike ankete«. V sklopu»ankete«se jim dodeli vse pravice:»ustvari«,»poglej/beri«,»urejaj«,»izbriši«in»izvoz«. V sklopu»upravljaj skrbnike ankete«pa imajo že avtomatsko možnost urejati samo svoje uporabniške podatke (polno ime, geslo in elektronski naslov). Skupina uporabnikov UVOZ_PODATKOV omogoča paketno XML oddajo in pregled oddanih paketov. Skupini se dodeli samo pravice za sklopa»paketna XML oddaja«in»upravljaj skrbnike ankete«. V sklopu»paketna XML oddaja«imajo pravice le za pregledovanje, torej»poglej/beri«. V sklopu»upravljaj skrbnike ankete«pa imajo že avtomatsko možnost urejati samo svoje uporabniške podatke (polno ime, geslo in elektronski naslov). To je edina skupina uporabnikov, ki oddaja podatke, da potrebuje posebne pravice. Ostali uporabniki, ki oddajajo podatke preko spletnih obrazcev, vprašalnikov, anket, pravic ne potrebujejo, saj se prijavljajo/uporabljajo orodje s pomočjo povabila (žetona). Skupina PREGLED_PODATKOV omogoča pregled podatkov anket, pregled oddanih XML paketov in spremembo statusa paketa. Skupini se dodeli pravice za sklope»ankete«,»paketna XML oddaja«in»upravljaj skrbnike ankete«. V sklopu»ankete«imajo pravice le za pregledovanje in spreminjanje statusa, torej:»poglej/beri«. V sklopu»paketna XML oddaja«imajo pravice za pregledovanje in urejanje, torej»poglej/beri«in»posodobi«. V sklopu»upravljaj skrbnike ankete«pa imajo že avtomatsko možnost urejati samo svoje uporabniške podatke (polno ime, geslo in elektronski naslov).. Skupina ADMINISTRATOR ima vse pravice do vseh sklopov, razen pravice spreminjanja odzivov anket in oddanih XML paketov. Stran 25 od 65

26 17 Modul za zahtevnejši sprejem podatkov Izdela se orodje za sprejem podatkov, ki bo omogočalo vnos podatkov na dva načina: preko grafičnega vmesnika (pripravi se spletni obrazec) preko spletnega servisa (paketna oddaja XML datotek). Za posamezen tip obrazca bo možen le en način izvedbe: ali preko spletnega obrazca ali preko spletnega servisa (ne pa oboje hkrati) Vnos podatkov preko grafičnega vmesnika Priprava spletnega obrazca Uporabnik iz skupine PRIPRAVA_ANKET s pomočjo orodja za izdelavo spletnih vprašalnikov LimeSurvey pripravi spletni obrazec, kot prikazuje spodnja slika. Slika 16: Primer spletnega obrazca V zavihku»splošno«označi, da gre za obrazec, ki predstavlja zahtevnejši sprejem podatkov (v polju»zahtevnejša oddaja podatkov«izbere vrednost»da«). To je potrebno zato, da lahko pri oddaji obrazca ustrezno obravnavamo takšne obrazce, saj zahtevajo specifično delovanje (elektronski podpis, generiranje XML, ustrezno nastavitev statusov ipd). Uporabnik, ki pripravlja obrazec izbere tudi tip kontrole, ki se bo izvajal nad obrazcem (avtomatska ali ročna), kot prikazuje Slika 17. Stran 26 od 65

27 Slika 17: Izbira načina kontrole podatkov Vnos tipiziranih oznak Orodje Limesurvey že omogoča nastavitev različnih logičnih kontrol za vsa polja v eni tabeli. Za omejitev kontrol na posamezen stolpec pa se uporabi v naprej definirana pravila za kontrolo vnosa podatkov v besedilna polja. Pravila je možno uporabljati le za tip vprašanja: Polje (besedila). Pravila so definirana v obliki šifranta tipiziranih polj, ki se ga pripravi v naprej. Primer takšnega šifranta tipiziranih polj predstavlja spodnja tabela. Šifrant se nahaja na bazi v tabeli dbo.lime_sifrant_tipiziranih_polj, tako da ga je možno urejati brez posega v aplikacijsko logiko. Navodila za delo z omenjenim šifrantom se nahajajo v Navodilih za aministratorja»mz-zvem - LimeSurvey - Navodila za administratorja.doc«. oznaka tip sifrant dolzin decimaln format mi ma reg_ opis a a_mesta n x ex znesek NUMBE / 10 2 znesek v EUR R st_ljudi INTEG / število ljudi ER st_ur NUMBE / število ur R cas TIME / HH:MM:S Čas S status INTEG ER STATU S Status zdravnika sifra NUMBE Šifra specialnosti R zdravnika naziv STRIN NAZIV Naziv specialnosti G zdravnika datum DATE DD.MM.L LL Datum podrocje INTEG Šifra področja izvajanja ER dela meseci INTEG ER 0 12 Št. mesecev B CHAR 1 Blokada vnosa O CHAR 1 Napaka sproži opozorilo OBV CHAR 3 Obvezno polje Tabela 1: Primer šifranta tipiziranih polj Stran 27 od 65

28 Podrobna razlaga polj v šifrantu: OZNAKA Polje OZNAKA je obvezno polje tipa varchar(100), ki enolično določa zapis v šifrantu (primary key). Predstavlja tipizirano oznako, ki jo uporabniki vnašajo pri pripravi ankete. Posebne oznake so B, O in OBV, ki jih skrbnik aplikacije ne spreminjati! TIP Polje TIP je obvezno polje tipa varchar(20), ki opredeljuje podatkovni tip vnosnega polja v aplikaciji. Možne so vrednosti: STRING vnos besedila CHAR vnos posameznih znakov NUMBER vnos poljubnega števila INTEGER vnos celega števila DATE vnos datuma (brez časa) TIME vnos časa (brez datuma) Od vpisane vrednosti v polju TIP je odvisno, katera polja nadaljnje izpolnjujemo. V primeru: STRING izpolnjujemo polja SIFRANT, REG_EX in OPIS. CHAR izpolnjujemo polja SIFRANT, DOLZINA in OPIS. NUMBER izpolnjujemo polja SIFRANT, DOLZINA, DECIMALNA_MESTA, FORMAT, MIN, MAX in OPIS. INTEGER izpolnjujemo polja SIFRANT, DOLZINA, MIN, MAX in OPIS. DATE izpolnjujemo polja FORMAT in OPIS. TIME - izpolnjujemo polja FORMAT in OPIS. SIFRANT Polje SIFRANT je neobvezno polje tipa varchar(100), ki določa šifrant, kateremu morajo vrednosti v vnosnem polju v aplikaciji zadoščati. Polje se navezuje na tabelo (foreign key) dbo.lime_seznam_sifrantov, polje naziv. V aplikaciji se nato uporabniku pri izpolnjevanju ankete v vnosnem polju pojavi spustni seznam z vrednostmi iz podanega šifranta. Slika 18: Tipizirano polje z vrednostmi iz šifranta DOLZINA Polje DOLZINA je neobvezno polje tipa int, ki opredeljuje dolžino vnosnega polja v aplikaciji. Smiselno jo je uporabljati le pri tipih: CHAR, NUMBER in INTEGER. DECIMALNA_MESTA Polje DECIMALNA_MESTA je neobvezno polje tipa int, ki določa število decimalnih mest vnosnega polja v aplikaciji. Namenjena je le tipu NUMBER. Če jo kljub temu vnesemo pri kakšnem drugem tipu, se vrednost ignorira. FORMAT Polje FORMAT je neobvezno polje tipa varchar(100), ki določa format, ki mu mora zadoščati vnosno polje v aplikaciji. Uporabljamo ga pri tipih DATE, TIME in NUMBER v tri namene: DATE: Za določanje formata vpisa datuma. Možni so formati: DD/MM/LLLL, DD-MM-LLLL in DD.MM.LLLL. DD-dan v mesecu, MM-mesec(s številko), LLLL-leto. Če format ni vnesen ali je vpisan neveljaven format, se pri polju tipa DATE privzeto uporabi format DD.MM.LLLL. Stran 28 od 65

29 TIME: Za določanje formata vpisa časa. Možni so formati: HH:MM, HH.MM in HH:MM:SS. HH- ura, MM-minute, SS-sekunde. Če format ni vnesen ali je vpisan neveljaven format, se pri polju tipa TIME privzeto uporabi format HH:MM:SS. NUMBER: Za določitev decimalnega znaka (vejice ali pike). Možen je vpis vejice(,) ali pike (.). Če decimalni znak ni vnesen ali je vpisan neveljaven znak, se pri polju tipa NUMBER privzeto uporabi decimalna vejica (,).. MIN Polje MIN je neobvezno polje tipa decimal, ki določa najmanjšo (minimalno) vrednost vnosnega polja v aplikaciji. Namenjena je le tipoma NUMBER in INTEGER. Če jo kljub temu vnesemo pri kakšnem drugem tipu, se vrednost ignorira. MAX Polje MAX je neobvezno polje tipa decimal, ki določa največjo (maksimalno) vrednost vnosnega polja v aplikaciji. Namenjena je le tipoma NUMBER in INTEGER. Če jo kljub temu vnesemo pri kakšnem drugem tipu, se vrednost ignorira. REG_EX Polje REG_EX je neobvezno polje tipa varchar(max), ki opredeljuje regularni izraz, kateremu naj zadošča vrednost vnosnega polja v aplikaciji. Vnesemo ga v standardni obliki regularnih izrazov (regex): Uporabljamo ga v posebne namene, kadar npr. želimo vnos le črkovnih znakov (vnesemo [^0-9]), vnos brez posebnih znakov, samo črke in številke (vnesemo [A-Za-z0-9]) itd OPIS Polje OPIS je neobvezno polje tipa varchar(max), ki predstavlja opis tipiziranega polja. V njem je na kratko opisano, kaj tipizirano polje predstavlja in čemu je namenjeno. Posebnost predstavljajo oznake B,O in OBV, ki jih skrbnik aplikacije ne sme spreminjati. Oznaki B in O se uporabljata le v kombinaciji z ostalimi oznakami. Oznako OBV pa lahko uporabljamo tudi samostojno. B - oznaka določa, da gre za blokado. V primeru kršenih pravil pri ostalih oznakah nadaljevanje izpolnjevanja ni možno. O - oznaka določa, da gre za opozorilo. V primeru kršenih pravil pri ostalih oznakah je nadaljevanje izpolnjevanja možno, prožene kontrole pa se zabeležijo na bazo v tabelo lime_survey_#sid# v polje errors. Če ni vnesene nobene oznake B ali O, se privzeto vzame oznaka O. OBV - oznaka določa, da gre za obvezni vnos polja. Nadaljevanje izpolnjevanja ni možno, dokler v polju ni vnesena vrednost. Seznam šifrantov, ki jih uporabljamo pri vnosu vrednosti v tipizirana polja, je podan na bazi limesurvey, v tabeli dbo.lime_seznam_sifrantov. Vzorčen primer predstavlja spodnja tabela. id naziv opis BPI_ime 1 STATUS Šifrant vitalnih statusov sif_vitsta 2 NAZIV Šifrant nazivov zdravstvenega delavca sif_nazzd 3 POKLIC_SKUP Šifrant poklicnih skupin sif_poksku 4 SLUZBA Šifrant služb sif_slu 5 SKUP_SLUZBA Šifrant skupin služb sif_skuslu Tabela 2: Primer seznama šifrantov Stran 29 od 65

30 Polje id predstavlja enolični identifikator tabele. Polje naziv je obvezno polje, ki predstavlja naziv šifranta, na katerega se tudi sklicujemo v tabeli dbo.lime_sifrant_tipiziranih_polj. Naziv šifranta je enoličen. Polje opis je neobvezno polje, ki predstavlja opis šifranta. Polje BPI_ime je neobvezno polje, ki predstavlja ime šifranta v BPI šifrantih. Vsebina posameznih šifrantov pa je podana v tabeli dbo.lime_sifranti. Vzorčen primer vnosa predstavlja spodnja tabela. sif_id id vrednost 1 1 ZAPOSLEN 1 2 BREZ ZAPOSLITVE 1 3 UPOKOJEN 1 4 ODSELJEN 1 5 UMRL 1 6 TUJEC, NIMA ZAPOSLITVE 1 7 ZAPOSLEN V NEZDRAVSTVU 1 9 NEZNANO 2 1 ZDR.SVETNIK 2 2 VIŠ.ZDR.SVETNIK 2 3 PRIM. 2 4 RED.PROF. 2 5 IZR.PROF. 2 6 DOC. 2 7 VIŠJI PREDAVATELJ 2 8 ASIST. 2 9 PREDAVATELJ 2 10 MAG DR. Tabela 3: Primer vsebine šifrantov Polje sif_id predstavlja povezavo na id šifranta v tabeli dbo.lime_seznam_sifrantov (foreign key). Polje id predstavlja enolični identifikator zapisa v šifrantu, v polju vrednost pa je navedena posamezna vrednost iz šifranta. Uporabnik nato pri izdelavi spletnega obrazca za posamezen stolpec s klikom na gumb»dodaj«(slika 19) odpre okno za vnos tipizirane oznake (Slika 20). V njem v polju»tipizirana oznaka«izbere eno izmed navedenih oznak iz šifranta tipiziranih oznak. V polju»blokada ob kršenju«izbere tip obravnavanja napake, kadar je kršeno pravilo tipizirane oznake (B - blokada vnosa ali O opozorilo pri vnosu). V polju»obvezen vnos polja«pa izbere, ali naj bo vnos v polje obvezen. Ob kliku na gumb»dodaj«se v polje doda tipizirana oznaka z izbranimi lastnostmi, kar prikazuje Slika 21. Slika 19: Gumb za dodajanje oznake za uporabo kontrol tipiziranega polja Slika 20: Okno za vnos tipizirane oznake Stran 30 od 65

31 Slika 21: Vnos tipizirane oznake v polje Izpolnjevanje obrazca Uporabnik je nato o izpolnjevanju obrazca pozvan po elektronski pošti, v kateri prejme povezavo do obrazca. Pri izpolnjevanju podatkov v spletni obrazec se te predhodno določene kontrole izvajajo in prožijo opozorila v primeru napačno vnesenih podatkov, kar prikazuje Slika 22. Slika 22: Prožena kontrola nad tipiziranim poljem Za vsako kontrolo se preveri tip napake, ki se proži, kadar je pravilo kršeno (oznaka B ali O). Če oznaka B ali O ni vnesena, se privzame, da je tip napake opozorilo. V primeru hujše napake (blokade) logika ne dovoli nadaljevanja vnosa spletnega obrazca, dokler ni napaka odpravljena. V primeru opozorila pa logika izpiše opozorilo o kršeni kontroli, vendar uporabniku dovoli nadaljevanje vnosa obrazca. Opozorila se tudi zabeležijo na bazo bazo v tabelo lime_survey_#sid# v polje errors. Prav tako se v primeru, da se polje nanaša na vrednost iz šifranta, v obliki spustnega seznama odpre ustrezen nabor vrednosti iz šifranta, izmed katerih nato uporabnik izbere določeno vrednost, kar prikazuje Slika 23. Slika 23: Spustni seznam iz šifranta Oddaja obrazca Ob oddaji se vsebina oddanega obrazca zapiše na bazo, obrazec dobi status SHRANJEN. Nato se iz oddane vsebine pripravi XML vsebina obrazca, ki se prikaže uporabniku na zaslon. Poleg pa je gumb»podpiši«, s katerim uporabnik elektronsko podpiše dan XML dokument, kar prikazuje Slika 24. Stran 31 od 65

32 Slika 24: XML vsebina oddanega obrazca Za podpisovanje se uporabi podpisna komponenta ProXSign za podpisovanje XML dokumentov. Pri tem obstajajo omejitve brskalnikov, ki jih lahko uporabljajo uporabniki (trenutno ne deluje v Google Chrome od verzije 42 dalje in v Mozilla Firefox od verzije 33 dalje). Ob vklopu posebne nastavitve arhitekture NPAPI Google Chrome (glej navodila) je možno Chrome uporabljati tudi od verzije 42 do 45, dalje pa ne. V primeru, da uporabnik še nima nameščene podpisne komponente, se izpiše opozorilo:»opozorilo: Za oddajo paketa je potrebno namestiti dodatek ProXSign za elektronsko podpisovanje XML dokumentov. Za namestitev sledite tej povezavi. Po namestitvi ponovno naložite to stran.«ob kliku na povezavo se uporabnika usmeri na naslov: kjer se nahajajo ustrezne podpisne komponente za posamezne brskalnike. Ob tem se preveri, da sta serijska številka in izdajatelj certifikata enaka, kot je za uporabnika zabeleženo v portalu ZVEM. Če nista, se javi napaka:»napaka: Uporabljen certifikat ne pripada prijavljenemu uporabniku! Uporabite isti certifikat kot pri prijavi v portal ZVEM«. Če pa sta, se na bazo shrani še podpisan XML obrazca in izračuna ustrezen status. Če je določena ročna vrsta kontrole, se obrazcu nastavi status ROCNA_KONTROLA. Če je določena avtomatska kontrola, se določi status SPREJET. Postopek nastavitve statusov prikazuje spodnji diagram. Stran 32 od 65

33 Diagram 1: Statusi pri oddaji obrazca preko uporabniškega vmesnika Pregled oddanih obrazcev Uporabnik, ki se nahaja v uporabniški skupini PREGLED_PODATKOV, lahko pregleduje že oddane vnose obrazca. Za oddane obrazce, ki se nahajajo v statusu ROCNA_KONTROLA, lahko spremeni status. In sicer določi lahko tri možne statuse: SPREJET, SPREJET_POGOJNO in ZAVRNJEN_KONTROLE, kar prikazuje Slika 25. Slika 25: Urejanje statusa oddanega obrazca 17.2 Paketni vnos (preko XML-a) Priprava obrazca za paketni vnos Predpogoji za izvedbo paketne oddaje XML datotek so: Pripravljena.xsd shema Vnos obrazca za paketno oddajo (v orodju LimeSurvey) Za paketni vnos se na strani naročnika pripravijo sheme za zajem podatkov (.xsd datoteke), ki vnaprej predpišejo obliko in kontrole, ki jim mora zadoščati XML datoteka pri paketnem prenosu. Prav tako je potreben vnos ankete v programu LimeSurvey, ki omogoči, da lahko uporabniki oddajajo XML datoteke. Uporabnik, ki pripravlja anketo za paketno oddajo, mora ustvariti novo anketo na sledeč način. V zavihku»kontrola objavljanja in dostopa«mora obvezno izpolniti polji»datum/ura začetka«in»datum/ura poteka«, kot kaže Slika 26. Prav tako določi, da anketa ni javno dostopna. Stran 33 od 65

34 Slika 26: Nastavitve lastnosti obrazca za paketno oddajo V zavihku»splošno«izbere, da gre za zahtevno oddajo podatkov ( v polju»zahtevnejša oddaja podatkov«izbere vrednost»da«). Prav tako doda pripravljeno.xsd shemo in izbere način izvajanje kontrole: «Avtomatska«ali»Ročna«, kot kaže Slika 27. Slika 27: Gumb za dodajanje.xsd sheme in izbira načina kontrole obrazca za paketno oddajo Ob kliku na gumb»shrani«se na bazi doda nov zapis za spletni obrazec, shrani se dodana.xsd shema in način kontrole podatkov. Sedaj je vse pripravljeno za paketno oddajo XML-datotek Paketna oddaja XML-datoteke (v aplikaciji) Uporabnik, ki želi paketno oddati XML datoteko, to stori s klikom na gumb v sklopu»paketna XML oddaja«(glej Slika 32). Ob kliku na gumb se odpre stran za oddajo XML datoteke, njen izgled prikazuje Slika 28. Na strani se nahaja seznam obrazcev, ki omogoča paketno oddajo, seznam izvajalcev zdravstvene dejavnosti, za katere ima pravico oddati obrazec, gumb za naložitev XML datoteke in gumb za oddajo paketa. Stran 34 od 65

35 Slika 28: Izgled strani "Oddaj paket" Uporabnik, ki oddaja XML datoteko, tako iz seznama obrazcev izbere, za kateri obrazec želi oddati. V seznamu so navedene ankete, ki imajo določeno zahtevno oddajo podatkov in naloženo.xsd shemo, ter so veljavne (so se že začele in še niso potekle). Uporabnik nato izbere ustanovo, za katero želi oddati obrazec. V seznamu se navedeni izvajalci zdravstvenih dejavnosti, za katere ima pravico. Uporabnik nato naloži XML datoteko in pritisne gumb»oddaj paket«. Ob klicu se najprej preveri, ali je za dan obrazec možno oddati XML paket. V kolikor za ta ID ankete(obrazca) že obstaja zapis za tega izvajalca (gleda se BPI številka) s statusom SPREJET, SPREJET_POGOJNO ali ROCNA_KONTROLA, potem obrazca ni možno oddati. Tedaj se uporabniku javi obvestilo: «Paketa ni možno oddati, ker so bili za ta obrazec podatki že oddani.«ponovna oddaja je možna le, kadar je prejšnja oddaja v statusu ZAVRNJEN_SPREJEM ali ZAVRNJEN_KONTROLE. Nato se za sprejeto XML datoteko izvede preveritev ustreznosti glede na definirano.xsd shemo. V primeru, da poslana datoteka ne ustreza shemi, logika zavrne celotno datoteko, oddaja se prekine, izpiše se obvestilo o napaki:»podani XML ni veljaven glede na definirano xsd shemo. Preverite ustreznost XML dokumenta.«na bazi se ustvari se nov zapis oddaje paketa (uporabnik, datum in čas oddaje, status, XML oddane datoteke), in sicer se zapiše s statusom ZAVRNJEN_SPREJEM. Prav tako se tudi na bazo zabeleži podrobnosti o hujši napaki. Če pa je XML datoteka ustrezna glede na definirano shemo, se odpre stran za pregled in podpisovanje paketa, kot prikazuje Slika 29. V njem so navedeni podatki o anketi in izvajalcu, za katerega oddaja paket ter XML vsebina paketa. Spodaj je gumb»podpiši«, s katerim uporabnik elektronsko podpiše oddan paket. Stran 35 od 65

36 Slika 29: Pregled in podpisovanje paketa Ob kliku na gumb»podpiši«se odpre okno za izbiro certifikata za elektronsko podpisovanje. Za podpisovanje se uporabi podpisna komponenta ProXSign. Pri tem obstajajo omejitve brskalnikov, ki jih lahko uporabljajo uporabniki (trenutno ne deluje v Google Chrome od verzije 42 dalje in v Mozilla Firefox od verzije 33 dalje). Ob vklopu posebne nastavitve arhitekture NPAPI Google Chrome (glej navodila) je možno Chrome uporabljati tudi od verzije 42 do 45, dalje pa ne. V primeru, da uporabnik še nima nameščene podpisne komponente, se izpiše opozorilo:»opozorilo: Za oddajo paketa je potrebno namestiti dodatek ProXSign za elektronsko podpisovanje XML dokumentov. Za namestitev sledite tej povezavi. Po namestitvi ponovno naložite to stran.«ob kliku na povezavo se uporabnika usmeri na naslov: kjer se nahajajo ustrezne podpisne komponente za posamezne brskalnike. Stran 36 od 65

37 Slika 30: Izbira digitalnega certifikata Po izbiri certifikata se preveri, da sta serijska številka in izdajatelj certifikata enaka, kot je za uporabnika zabeleženo v portalu ZVEM. Če nista, se javi napaka:»napaka: Uporabljen certifikat ne pripada prijavljenemu uporabniku! Uporabite isti certifikat kot pri prijavi v portal ZVEM«. Če pa sta, se javi obvestilo:»dokument je podpisan. S klikom na gumb 'Pošlji' dokončno oddajte paket.«. Pojavi se gumb za pošiljanje podpisanega paketa. S klikom na gumb»pošlji«uporabnik dokončno odda paket. Slika 31: Pošiljanje elektronsko podpisanega paketa Stran 37 od 65

38 Ob tem se na podatkovno bazo v tabelo dbo.lime_xmlpackages zapišejo podatki o oddaji (uporabnik, datum in čas oddaje, status, XML oddane datoteke in morebitne napake pri oddaji). Preveri se, ali je za isti tip obrazca in za isto ustanovo že bil oddan paket. V primeru, da je bil, se podatki prejšnje oddaje deaktivirajo. Na bazi se zapisi prejšnje oddaje sicer ohranijo, vendar so neaktivni in se v aplikaciji ne prikazujejo. Ustvari se nov zapis oddaje in nastavi ustrezen status. Če je za obrazec izbran tip kontrole»ročna«, se nastavi status»rocna_kontrola«. Če pa je za obrazec izbran tip kontrole»avtomatska«, dobi oddan paket status SPREJET. Potek statusov nazorneje podaja Diagram 2. ODDAJA PAKETA Ali je MOŽNA ODDAJA? NI Paket ni oddan. JE KONTROLA xsd SHEME NI OK ZAVRNJEN_SPREJEM SPREJET OK Potrditev AVTOMATSKA ali ROČNA KONTROLA? ROČNA ROCNA_KONTROLA ROČNA OBDELAVA Pogojno SPREJET_POGOJNO AVTOMATSKA Zavrnitev SPREJET ZAVRNJEN_KONTROLE Diagram 2: Potek nastavitve statusa paketa Paketna oddaja XML-datoteke (preko spletne storitve PaketnaOddajaWS) Izdelana je spletna storitev (webservice) PaketnaOddajaWS, ki temelji na SOAP standardu in omogoča paketno oddajo XML datotek. Pred prvim klicem servisa mora imeti uporabnik urejeno sledeče: Certifikat, ki ga bo uporabil pri klicu servisa, mora biti shranjen v varnostni shemi Klicatelj mora biti registriran v aplikaciji Portal ZVEM Klicatelj mora imeti v portalu ZVEM dodeljeno vlogo za oddajo podatkov»xml - oddaja«podpisnik XML dokumenta mora biti shranjen v varnostni shemi Podroben opis spletnega servisa se nahaja v navodilih: MZ-ZVEM - LimeSurvey - Navodila za oddajo podatkov MZ-ZVEM - Limesurvey - Navodila za administratorja Opis servisa Spletni servis PaketnaOddajaWS je namenjen paketni oddaji XML obrazcev za zahtevnejšo oddajo podatkov. Nameščen je na Wildfly strežniku, kjer se nahaja tudi portal ZVEM, na lokaciji Stran 38 od 65

39 Spletni servis PaketnaOddajaWS vsebuje metodo oddajpaket, ki sprejme paket, preveri uporabnika v varnostni shemi in odda paket v aplikacijo Limesurvey (kliče spletni servis za paketno oddajo submit_signed_xml_package). Ob klicu servis zahteva avtentikacijo klicatelja s certifikatom, ki mora biti zabeležen v varnostni shemi in imeti pravice za oddajo podatkov. Vhodni parametri metode oddajpaket so: idobrazca: Id obrazca (ankete) za katerega oddajamo podatke bpiizvajalca: BPI številka izvajalca zdravstvene dejavnosti, za katerega oddajamo podatke podpisanxml: Elektronsko podpisan XML s podatki obrazca, ki mora biti ustrezen glede na definirano xsd shemo obrazca (ankete). Podpisnik XML dokumenta mora biti zabeležen v varnostni shemi. Metoda pa vrača odgovor s parametri: rezultat: Rezultat izvedbe servisa. Možne vrednosti so: ODDAN, ZAVRNJEN in NAPAKA. o ODDAN - paket je bil uspešno oddan. o ZAVRNJEN - paket bil sicer shranjen na podatkovno bazo, vendar zaradi vsebinske napake pri oddaji ni bil sprejet. o NAPAKA - pri oddaji je prišlo do tehnične ali težje vsebinske napake. Paket ni bil shranjen na podatkovno bazo. Opis: Opis podaja razlago rezultata izvedbe servisa. Primeri vrednosti so: o»paket je bil uspešno oddan.«, o»paket je bil zavrnjen, vendar shranjen. Odpravite pomanjkljivosti paketa in ponovno oddajte.«o»paket ni bil oddan zaradi napake pri oddaji. Odpravite napake in ponovno oddajte.«o»prišlo je do napake pri izvedbi klica. Preverite ustreznost klicnih parametrov.«o»prišlo je do nepričakovane napake pri oddaji. Paket ni bil oddan.«idpaketa Identifikator shranjenega paketa (polje idpackage, tabela limesurvey.dbo.lime_xmlpackages ) statuspaketa Status shranjenega paketa (polje status, tabela limesurvey.dbo.lime_xmlpackages) kodanapake Koda, ki enolično opredeljuje vrsto napake. Glej seznam»kode napak«. Napaka Podrobnejši izpis besedila napake Kode napak Kode napak so razvrščene po sklopih, kot si po vrsti sledijo operacije pri izvedbi servisa: KODA NAPAKE RAZLAGA Napake dostopa do nastavitev servisa [XML_DOSTOP_1] Sistemska spremenljivka PROPERTY_HOME ni nastavljena (na strežniku Wildfly) [XML_DOSTOP_2] Napaka pri branju nastavitvene datoteke paketnaoddaja.properties (preveri, ali se nahaja na lokaciji, ki jo določa spremenljivka PROPERTY_HOME) [XML_DOSTOP_3] Spremenljivka limesurvey.remotecontrol.url ni nastavljena (datoteka paketnaoddaja.properties) Napake pri preverjanju v varnostni shemi [XML_VS_1] Napaka pri izvedbi klica na varnostno shemo (z nastavitvami iz datoteke handler.xml) preveri nastavitve v vozlišču <ph:loginhandler> [XML_VS_2] Napaka pri izvedbi klica metode za preverjanje certifikata v varnostni shemi (metoda IxCheckCertificate.CheckCertificate) [XML_VS_3] Preverjanje certifikata v varnostni shemi ni uspelo (certifikata ni v varnostni shemi ali podatki uporabnika niso ustrezno nastavljeni) Napake pri avtomatski prijavi v Limesurvey aplikacijo [XML_LIME_1] Napaka pri dostopu do aplikacije Limesurvey (do remotecontrol servisa). Preveri, ali je nastavitev limesurvey.remotecontrol.url v datoteki paketnaoddaja.properties ustrezno Stran 39 od 65

40 KODA NAPAKE RAZLAGA nastavljena. [XML_LIME_2] Napaka pri klicu metode za avtomatsko prijavo uporabnika v Limesurvey aplikacijo (metoda get_session_key_for_certificate). Preveri, ali je nastavitev limesurvey.remotecontrol.url v datoteki paketnaoddaja.properties ustrezno nastavljena. Napake pri izvedbi klica servisa za paketno oddajo v Limesurvey [XML_LIME_3] Napaka pri dostopu do servisa za paketno oddajo v Limesurvey (servis submit_signed_xml_package) [XML_LIME_4] Napaka pri izvedbi klica servisa za paketno oddajo v Limesurvey(servis submit_signed_xml_package) Napake pri oddaji paketa v Limesurvey (vsebinske napake) [XML_PAKET_1] Napaka pri pridobivanju podatkov uporabnika (session key). (verjetno se avtomatska prijava uporabnika v Limesurvey ni uspešno izvedla). [XML_PAKET_2] Id obrazca ni veljaven (v LimeSurvey aplikaciji ne obstaja anketa z ID, ki je podan v vhodnem parametru»idobrazca«). [XML_PAKET_3] Obrazec ne omogoča paketne oddaje (v LimeSurvey ima ta anketa pri nastavitvi»zahtevna oddaja podatkov«določeno vrednost»ne«.) [XML_PAKET_4] Obrazec ne omogoča paketne oddaje - xsd shema ni določena (v LimeSurvey ta anketa nima nastavljene xsd sheme za zahtevno oddajo podatkov). [XML_PAKET_5] Čas za oddajo se še ni pričel! (v LimeSurvey ima ta anketa nastavljen»datum/ura začetka«, ki je večji od datuma/ure v trenutku oddaje paketa). [XML_PAKET_6] Čas za oddajo je potekel! (v LimeSurvey ima ta anketa nastavljen»datum/ura poteka«, ki je manjši od datuma/ure v trenutku oddaje paketa). [XML_PAKET_7] Za podani obrazec in BPI izvajalca so bili podatki že oddani. (za vhodna parametra idobrazca in bpiizvajalca že obstaja uspešno oddan paket). [XML_PAKET_8] Napaka pri shranjevanju XML vsebine v začasni imenik! (XML datoteke se shranjujejo na lokalni disk v mapo /var/www/html/limesurvey/tmp/upload. Ime datoteke je oblike XML_{idObrazca}_{bpiIzvajalca}.xml) [XML_PAKET_9] Podpisnik XML-ja nima pravic za oddajo za izvajalca s podanim BPI. (vhodni parameter»bpiizvajalca«). [XML_PAKET_10] Napaka pri preverjanju pravic podpisnika XML dokumenta za izvajalca s podanim BPI. (vhodni parameter»bpiizvajalca«). [CHECK_USER_1] Napaka pri branju shranjene oddane XML datoteke na disku. (Vhodni podpisanxml se shrani na lokalni disk na lokacijo: /var/www/html/limesurvey/tmp/upload. Ime datoteke je oblike XML_{idObrazca}_{bpiIzvajalca}.xml) [CHECK_USER_2] Napaka pri pridobivanju podpisnika dokumenta iz oddanega xml. [CHECK_USER_3] Napaka pri pridobivanju podatkov podpisnika dokumenta iz Varnostne sheme. [CHECK_USER_4] Ni bilo možno pridobiti podatkov podpisnika XML dokumenta. [CHECK_USER_5] Podpisnik oddanega XML dokumenta ni registriran v portalu zvem. [CHECK_USER_6] Napake pri preverjanju pravic podpisnika oddanega XML dokumenta, da ima pravico oddaje za podan bpi izvajalca. [CHECK_USER_7] Podpisnik oddanega XML dokumenta nima pravic oddaje za podan bpi izvajalca. [VALID_XSD_1] Napaka pri pridobivanju xsd sheme podanega obrazca/ankete. Xsd shema je shranjena na bazi limesurvey v tabeli dbo.lime_surveys (id je vhodni parameter»idobrazca«). [VALID_XSD_2] Napaka pri branju shranjene XML datoteke na disku. (Vhodni podpisanxml se shrani na lokalni disk na lokacijo: /var/www/html/limesurvey/tmp/upload. Ime datoteke je oblike XML_{idObrazca}_{bpiIzvajalca}.xml) [VALID_XSD_3] Vhodni podpisanxml ni veljaven glede na definirano xsd shemo, ki je določena za ta obrazec (anketo). [VALID_XSD_4] Napaka pri validaciji podanega vhodnega XML (vhodni parameter podpisanxml) glede na xsd shemo, ki je določena za ta obrazec (anketo). [CHECK_SIGNATURE_1] Napaka pri preverjanju elektronskega podpisa podanega vhodnega XML (vhodni parameter podpisanxml). [CHECK_SIGNATURE_2] Elektronski podpis ni veljaven (ni ustrezen glede na vsebino XML-a). Druge napake pri izvajanju [XML_ERR_1] Druga napaka pri izvedbi servisa, ki ne sodi v nobeno od zgornjih sklopov Tabela 4: Kode napak Stran 40 od 65

41 Pregled oddanih XML paketov V aplikaciji LimeSurvey se doda nov sklop»paketna XML oddaja«za oddajo in pregledovanje oddanih paketov, kot ga prikazuje Slika 32. Sklop se nahaja v skupini Upravljanje, viden pa je le uporabnikom, ki se nahajajo v skupinah UVOZ_PODATKOV, PREGLED_PODATKOV ali ADMINISTRATOR. Sklop vsebuje podatke o oddanih paketih, in sicer polja Id paketa, Id ankete, Podatke o vnašalcu (ID uporabnika, uporabniško ime, elektronski naslov, naziv izvajalca zdravstvene dejavnosti, za katerega oddaja), Čas oddaje, in Status oddaje. Slika 32: Nov sklop za upravljanje s paketnim uvozom podatkov Skupina uporabnikov UVOZ_PODATKOV ima v sklopu»paketna XML oddaja«pravico le do vpogleda v seznam oddanih paketov in njihove podrobnosti, ne pa tudi pravic urejanja in brisanja. Uporabnik vidi le pakete, ki jih je oddal sam, ne pa tudi pakete drugih uporabnikov. Skupina uporabnikov PREGLED_PODATKOV ima v sklopu»paketna XML oddaja«pravico do vpogleda v seznam vseh oddanih paketov vseh uporabnikov in pravico za spreminjanje statusa paketov, ki imajo status ROCNA_KONTROLA (zavrnejo ali potrdijo oddan paket), ne pa tudi pravic brisanja. Naknadno lahko administrator po potrebi doda posameznim uporabnikom pravice brisanja paketov. Skupina uporabnikov ADMINISTRATOR ima v sklopu»paketna XML oddaja«vse pravice (pregledovanje, urejanje, brisanje) vseh paketov vseh uporabnikov. Ob kliku na ikono za urejanje pri posameznem paketu se prikaže XML vsebina paketa in polja, ki jih je dovoljeno urejati. Trenutno je predvideno, da je možno urejati le polje STATUS. In sicer lahko uporabniki, ki izvajajo ročno kontrolo, izberejo dva možna statusa:»sprejet«,»sprejet_pogojno«in»zavrnjen_kontrola«. Slika 33: Urejanje statusa oddanega paketa Stran 41 od 65

42 Ob kliku na ikono za pregled pri posameznem paketu se odprejo podrobnosti o posameznem paketu, kjer je možen ogled celotne XML vsebine paketa in seznama napak, kar prikazuje Slika 34. Poleg seznama napak je tudi gumb za izvoz seznama napak v tekstovni obliki. Seznam vsebuje kodo napake (enolično opredeli, za kateri tip napake gre) in besedilo napake. Slika 34: Podrobnosti oddanega paketa 17.3 Obdelava in objava zajetih podatkov Prenos podatkov v OBI Za izdelavo zahtevnejše analize oddanih podatkov anket je potrebno vse odgovore posamezne ankete preslikati v bazo orodja za obdelavo podatkov Oracle BI Publisher. Preslikavo odgovorov posamezne ankete izvedemo tako, da s klikom na gumb v orodni vrstici ankete odpremo sklop»odgovori in statistika«. Odpre se nam sklop za upravljanje z odgovori ankete, kjer nato v menijski vrstici kliknemo gumb»prenos podatkov v OBI«. Odpre se nam stran za prenos ankete v bazo OBI (Slika 35). Slika 35: Prenos ankete v bazo OBI Prenesi anketo: V polju je naveden identifikator ankete, ki jo želimo prenesti v OBI. Prenesi: V spustnem seznamu izberemo, ali želimo prenesti samo zaključene odgovore ali vse odgovore. Stran 42 od 65

43 Gumb»Prenesi anketo«: Ob kliku na gumb se prične prenos odgovorov ankete v bazo OBI. Pri tem se morebitni prejšnji prenos v bazi OBI pobriše in se nadomesti s podatki novega prenosa. Ko je prenos uspešno končan se pojavi obvestilo javi napaka. ali pa se OPOZORILO: Postopek lahko traja dlje časa (tudi 1 minuto ali dlje), kadar imamo zahtevno anketo z zapleteno strukturo vprašanj in velikim številom oddanih odgovorov. Prosim ne izvajajte ponovnega prenosa ankete, dokler se prejšnji postopek prenosa ne konča (javi se opozorilo o uspešnem prenosu ali pa napaka pri prenosu) Podatkovni model OBI Preslikava iz Limesurvey Podatkovni model baze za orodje Oracle BI Publisher (krajše OBI) je zgrajen s pomočjo preslikave iz podatkovnega modela orodja za pripravo anket LimeSurvey. Shemo preslikave podatkovnih modelov prikazuje spodnji diagram (Slika 36). Z zeleno so označene tabele iz Limesurvey, z rdečo pa tabele iz OBI. Po prenosu podatkov v bazo OBI so podatki pripravljeni za obdelavo z orodjem OBI. Sama obdelava z orodjem OBI je podrobneje opisana v dokumentu»navodila za delo z Oracle BI Publisher.«Stran 43 od 65

44 Slika 36: Shema preslikave podatkovnega modela Limesurvey v OBI Stran 44 od 65

45 Podrobnosti preslikave Podrobnosti preslikave so predstavljene na spodnjih slikah za vsako tabelo posebej. V prvem stolpcu na levi strani so navedena polja v tabeli iz OBI, v zadnjem stolpcu na desni strani pa polja v tabelah v LimeSurvey, iz katerih podatek prepišemo. OPOMBA: Niz {ID} označuje enolični identifikator ankete, saj se nekatere tabele dinamično ustvarijo in poimenujejo glede na ID ankete. Tabela ANKETE: Tabela SKUPINE_VPRASANJ: Slika 37: Podrobnosti preslikave za tabelo ANKETE Tabela VPRASANJA: Slika 38: Podrobnosti preslikave za tabelo SKUPINE_VPRASANJ Tabela PODVPRASANJA: Slika 39: Podrobnosti preslikave za tabelo VPRASANJA Tabela ODDAJA: V primeru navadno oddanih podatkov. Slika 40: Podrobnosti preslikave za tabelo PODVPRASANJA Stran 45 od 65

46 Slika 41: Podrobnosti preslikave za tabelo ODDAJA (navadno oddani) Tabela ODDAJA: V primeru paketno oddanih podatkov: Slika 42: Podrobnosti preslikave za tabelo ODDAJA (paketno oddani) Tabela ODGOVORI: Opomba: Imena stolpcev za vrednost1, vrednost2, vrednost30 so v Limesurvey dinamična. Sestavljena so iz identifikatorja ankete, skupine vprašanj, vprašanja in oznake podvprašanja. Slika 43: Podrobnosti preslikave za tabelo ODGOVORI Razlaga tabel Podatkovni model baze OBI predstavlja spodnji diagram. Stran 46 od 65

47 Slika 44: Podatkovni model baze OBI V njem se nahajajo sledeče tabele: 1 ANKETE: V tabeli so podani nekateri splošni podatki o anketi. Razlaga stolpcev: id: Enolični identifikator ankete (prepisan iz Limesurvey) naslov: Naslov ankete lastnik_username: Uporabniško ime uporabnika, ki je izdelal anketo v Limesurvey. lastnik_ime: Ime in priimek uporabnika, ki je izdelal anketo v Limesurvey. lastnik_ Elektronski naslov uporabnika, ki je izdelal anketo v Limesurvey. admin_ime: Ime in priimek uporabnika, ki je skrbnik te ankete. admin_ Elektronski naslov uporabnika, ki je skrbnik te ankete. dat_zacetka: Datum začetka objave ankete v Limesurvey. dat_poteka: Datum poteka objave ankete v Limesurvey. anonimna: Oznaka, ali je anketa anonimna (vrednost D ali N). xsdshema: Predpisana xsd shema za paketno oddajo ankete (če obstaja, sicer je polje prazno). transformacija_uspesna: Oznaka, ali je bil prepis podatkov iz baze Limesurvey v bazo OBI uspešno izveden (vrednost D ali N). 2 SKUPINE_VPRASANJ: V tabeli so navedene skupine vprašanj posamezne ankete. Razlaga stolpcev: id_skupine: Stran 47 od 65

48 Enolični identifikator skupine vprašanj (prepisan iz Limesurvey). id_ankete: Polje se navezuje (foreign key) na polje»id_ankete«v tabeli»ankete«. naziv: Naziv (ime) skupine vprašanj. opis: Opis, kaj predstavlja ta skupina vprašanj. vrstni_red: Zaporedna številka vrstnega reda prikaza te skupine vprašanj v anketi (začne se z 1, izjemoma z 0). 3 VPRASANJA: V tabeli so navedena vprašanja posamezne ankete. Razlaga stolpcev: id_vprasanja Enolični identifikator vprašanja (prepisan iz Limesurvey). id_skupine: Polje se navezuje (foreign key) na identifikator nadrejene skupine vprašanj (polje»id_skupine«v tabeli»skupine_vprasanj«). tip: Oznaka tipa vprašanja (glej šifrant Tabela 5). koda: Oznaka vprašanja vprasanje: Besedilo vprašanja vrstni_red: Zaporedna številka vrstnega reda prikaza tega vprašanja v pripadajoči skupini vprašanj (začne se z 1, izjemoma z 0). 4 PODVPRASANJA: V tabeli so navedena podvprašanja posamezne ankete. Razlaga stolpcev: id_podvprasanja: Enolični identifikator podvprašanja (prepisan iz Limesurvey). id_vprasanja: Polje se navezuje (foreign key) na identifikator nadrejenega vprašanja (polje»id_ vprasanja«v tabeli»vprasanja«). koda: Oznaka podvprašanja (enolična znotraj posameznega vprašanja). vprasanje: Besedilo vprašanja vrstni_red: Zaporedna številka vrstnega reda prikaza tega podvprašanja v pripadajočem vprašanju (začne se z 1, izjemoma z 0). os: Os, na kateri se prikazuje podvprašanje. Primer je tabelarični prikaz vprašanja, kjer so nekatera podvprašanja navedena v glavi vrstic (os ima vrednost 0), druga pa v glavi stolpcev (os ima vrednost 1) 5 ODDAJA: V tabeli so navedene oddaje odgovorov posamezne ankete. Združene so paketne in navadne oddaje. Razlaga stolpcev: id_oddaje: Enolični identifikator oddaje (se ustvari samodejno ob vsakem prepisovanju podatkov). id_ankete: Polje se navezuje (foreign key) na polje»id_ankete«v tabeli»ankete«. zap_st: Identifikator oddaje (zaporedna številka oddaje) v Limesurvey. Paketno oddani imajo svoje številčenje, ki je ločeno od navadno oddanih. cas_oddaje: Čas oddaje odgovorov ankete. Stran 48 od 65

49 status: Status oddaje odgovorov ankete. ime_anketiranca: Ime in priimek anketiranca, ki je oddal odgovore ankete. Če je anketa anonimna, je polje prazno. _anketiranca: Elektronski naslov anketiranca, ki je oddal odgovore ankete. Če je anketa anonimna, je polje prazno. izvajalec_bpi: BPI številka izvajalca zdravstvene dejavnosti, za katerega so bili oddani odgovori (le za paketno oddane). izvajalec_naziv: Naziv izvajalca zdravstvene dejavnosti, za katerega so bili oddani odgovori (le za paketno oddane). je_paketno: Oznaka, ali gre za paketno oddajo. Vrednost D pomeni paketno oddajo, vrednost N pa navadno oddajo. XML: Vsebina oddanih odgovorov v XML obliki. 6 ODGOVORI V tabeli so navedeni odgovori posamezne oddaje. Trenutno se v njej nahajajo le odgovori za navadne oddaje (paketne pa ne). Razlaga stolpcev: id_odgovora: Enolični identifikator odgovora (se ustvari samodejno ob vsakem prepisovanju podatkov). id_oddaje: Polje se navezuje (foreign key) na identifikator nadrejene oddaje (polje»id_oddaje«v tabeli»oddaja«). id_vprasanja: Polje se navezuje (foreign key) na identifikator nadrejenega vprašanja (polje»id_ vprasanja«v tabeli»vprasanja«). id_podvprasanja: Polje se navezuje (foreign key) na identifikator nadrejenega podvprašanja (polje»id_podvprasanja«v tabeli»podvprasanja«). Če posamezno vprašanje nima podvprašanj, je polje prazno (ima vrednost NULL). vrednost1: Vrednost odgovora prvega stolpca za to podvprašanje. Če posamezno vprašanje nima podvprašanj, je v tem polju navedena vrednost edinega odgovora. vrednost2: Vrednost odgovora drugega stolpca za to podvprašanje. Če posamezno vprašanje nima podvprašanj ali ima samo eno podvprašanje, je v tem polju navedena vrednost komentarja. vrednost3: Vrednost odgovora 3. stolpca za to podvprašanje (če obstaja, sicer je vrednost NULL). vrednost30: Vrednost odgovora 30. stolpca za to podvprašanje (če obstaja, sicer je vrednost NULL) Razlaga pogledov (view) V podatkovni bazi so pripravljeni že nekateri pogledi (view) za lažjo obdelavo podatkov. 1 VsiOdgovori Pogled predstavlja seznam odgovorov ankete skupaj s podatki o vprašanjih in oddaji. Razlaga stolpcev: stolpec1: Vrednost odgovora prvega stolpca za posamezno vrstico (podvprašanje). Če to vprašanje nima podvprašanj (vrstic), je v tem polju navedena vrednost edinega odgovora. ime_stolpca1: Stran 49 od 65

50 Ime prvega stolpca v tabeli. Če posamezno vprašanje nima stolpcev (ni v obliki tabele), je v tem polju navedena prazna vrednost (NULL). stolpec2 Vrednost odgovora drugega stolpca za posamezno vrstico (podvprašanje). Če to vprašanje nima podvprašanj ali ima samo eno podvprašanje, je v tem polju navedena vrednost komentarja. ime_stolpca2: Ime drugega stolpca v tabeli. Če posamezno vprašanje nima stolpcev (ni v obliki tabele), je v tem polju navedena prazna vrednost (NULL). Stolpec30 Vrednost odgovora tridesetega stolpca za posamezno vrstico (podvprašanje). (če obstaja, sicer je vrednost NULL). ime_stolpca2: Ime tridesetega stolpca v tabeli. Če posamezno vprašanje nima 30. stolpca ali pa nima stolpcev sploh (ni v obliki tabele), je v tem polju navedena prazna vrednost (NULL). id_vprasanja Enolični identifikator posameznega vprašanja. id_odgovora Enolični identifikator posameznega odgovora. vrstica_ime Ime vrstice v tabeli oz. vprašanju. Če posamezno vprašanje nima vrstic, je v tem polju navedena prazna vrednost (NULL). vrstica_zapored Zaporedna številka vrstice znotraj tega vprašanja. Če posamezno vprašanje nima vrstic, je tem polju navedena prazna vrednost (NULL). vpras_zapored Zaporedna številka vprašanja znotraj iste skupine vprašanja. skupina_zapored Zaporedna številka skupine vprašanj v anketi. vpras_oznaka Kratka oznaka (koda) posameznega vprašanja vpras_besedilo Besedilo posameznega vprašanja vpras_tip Oznaka tipa vprašanja. Za podrobnosti si poglej poglavje»šifrant tipov vprašanj«. id_ankete Enolični identifikator ankete id_oddaje Enolični identifikator oddaje podatkov. RowNum Zaporedna številka zapisa Šifrant tipov vprašanj Za pomoč spodaj navajamo še šifrant tipov vprašanj (Tabela 5). Razlaga stolpcev: Tip vprašanja: Oznaka tipa vprašanja (kot je navedena v tabeli»vprasanja«v polju»tip«) Opis: Opis vprašanja (kot se prikaže v aplikaciji Limesurvey, ko izbiramo tip vprašanja) Št. podvprašanj: število vrstic v tabeli»odgovori«št. vrednosti: število izpolnjenih stolpcev vrednost1, vrednost2,.. v tabeli»odgovori«opis vrednosti: opis, kakšne vrednosti se nahajajo v stolpcih vrednost1, vrednost2, TIP VPRAŠANJA OPIS ŠT. PODVPRAŠANJ ŠT. VREDNOSTI OPIS VREDNOSTI Stran 50 od 65

51 TIP VPRAŠANJA OPIS ŠT. PODVPRAŠANJ ŠT. VREDNOSTI OPIS VREDNOSTI Vprašanja z eno izbiro 5 5-stopenjska lestvica 1 1 število 1-5 L Seznam (izbirni gumb) 1 1 besedilo! Seznam(izbirni 1 1 besedilo seznam) O Seznam s 1 2 besedilo/besedilo komentarjem Maskirana vprašanja Y Da/Ne 1 1 da, ne D Datum/Čas 1 1 Datum npr :00 Nalaganje datoteke / (se ne prenaša) / (se ne / (se ne prenaša) prenaša) R Razvrščanje št. možnih 1 Števila od 1-št.polj odgovorov G Spol 1 1 ženski, moški K Več številskih odgovorov št. vrstic 1 Števila v decimalni obliki: npr N Številski vnos 1 1 Število v decimalni obliki: Vprašanja z besedilom T Dolgo besedilo 1 1 besedilo S Kratko besedilo 1 1 besedilo U Ogromno besedilo 1 1 besedilo Q Polja Več kratkih besedilnih vnosov št. vrstic 1 besedilo 1 Dvojna velikost polja št. vrstic 2 besedilo/besedilo F Polje št. vrstic 1 besedilo B Polje (10 izbir) št. vrstic 1 število 1-10 A Polje (5 izbir) št. vrstic 1 število 1-5 ; Polje (Besedila) št. vrstic št.stolpcev besedilo C Polje št. vrstic 1 da, ne, neodločen (da/ne/neodločen) E Polje (povečanje/enako/zma št. vrstic 1 povečanje, enako, zmanjšanje njšanje) : Polje (številke) št. vrstic št.stolpcev cela števila H Polje po stolpcih št. vrstic 1 besedilo Vprašanja z več izbirami M Več možnosti št. vrstic 1 da P Več možnosti s komentarjem št. vrstic 2 da/besedilo Tabela 5: Šifrant tipov vprašanj Stran 51 od 65

52 18 Vključitev storitev ezz, erecept, enaročanje V ogrodje zvem smo v obliki portletov vključili rešitve erecept, enaročanje in ezz. Pri tem smo zajeli funkcionalnosti za rešitve: erecept: Pregled predpisanih in izdanih zdravil ter dnevnik v pogledov. enaročanje: Pregled izdanih napotnic, naročil ter pregled čakalnih dob. ezz: Pregled odpustnih pisem ter omejitev dostopa do podatkov, ki jih določi pacient. Vgrajena je tudi možnost naročanja uporabnika na obvestila povezana z erecepti ter enaročanjem. Vsi prikazani podatki storitev ezdravja so prikazani glede na trenutno prijavljenega uporabnika. Vpogled v podatke drugih uporabnikov ni mogoč Integracija erecept V okviru integracije erecepta je izveden prikaz dveh storitev: pregled seznama ereceptov ter pregled seznama vpogledov v erecepte Pregled seznama ereceptov Portlet omogoča pregled seznama ereceptov. Ob odprtju strani se privzeto v seznamu prikažejo erecepti zadnjega meseca (privzeti filter). Po seznamu iščemo, tako da v polje Iskanje vpišemo časovno obdobje od do (datum je možno izbrati iz koledarčka), za katerega želimo izpisati seznam receptov. Seznam zadetkov lahko dodatno omejimo po statusa recepta, ki ga izberemo iz izbirnega seznama možnih statusov. Podrobnosti recepta si pogledamo tako, da kliknemo na»+«pred izbranim receptom ali s klikom na šifro predpisanega zdravila. Izpišejo se nam podrobni podatki recepta, kot so šifra izdanega zdravila, datum izdaje recepta, tip recepta, zdravnik, ki je recept izdal,. Podrobnosti recepta zapremo s klikom na»-«pred izbranim receptom ali s klikom na šifro predpisanega zdravila. Slika 45: Prikaz seznama ereceptov Dnevnik vpogledov v erecepte Portlet omogoča iskanje v podatke vpogleda v uporabnikove erecepte. Vpogledi se lahko zgodijo ob določenih dogodkih med obravnavo pacienta. Stran 52 od 65

53 Ob odprtju strani se privzeto v seznamu prikažejo podatki dnevnika vpogledov zadnjega meseca (privzeti filter). Po seznamu iščemo, tako da v polje Iskanje vpišemo časovno obdobje od do (datum je možno izbrati iz koledarčka), za katerega želimo izpisati seznam vpogledov v recepte. Seznam zadetkov lahko omejimo po izvedeni operaciji, ki ga izberemo iz izbirnega seznama možnih operacij. I Slika 46: Pregled vpogledov v erecepe Tehnična specifikacija integracije storitev erecept V aplikacijo zvem je preko integracije s spletnimi storitvami vključena tudi funkcionalnost storitve E- Recept. Vključena sta dva vidika funkcionalnosti, izpis predpisov (receptov) in izpis dnevnika vpogledov. Obe funkcionalnosti sta dosegljivi znotraj glavnega menija Moje E-zdravje, podmeni E- Recept, kjer sta ločeni v zavihke Recepti in Dnevnik vpogledov v e-recept. Integracija je v obeh primerih izvedena s pomočjo knjižnice Apache CXF, odjemalska koda se nahaja v modulu zvem-services, v podmodulih e-prescription (za recepte) in e-prescription-audit (za dnevnik vpogledov) Seznam ereceptov Za funkcionalnost Recepti je v aplikaciji zvem generirana odjemalska koda za storitev na naslovu (testno okolje). Za pridobivanje podatkov o receptih se kliče metoda spletne storitve customquery, kateri se poda zahtevek sestavljen iz KZZID prijavljenega uporabnika (polje ZZZSId), začetnega datuma (polje DatumPredpisaOd), končnega datuma predpisa(polje DatumPredpisaDo) in končnega datuma izdaje (polje DatumIzdajeDo). Zadnjima dvema poljema se nastavi enaka vrednost, pridobljena iz vnosnega polja Do filtra v vmesniku spletne aplikacije zvem. Iz vmesnika se pobere tudi vrednost za polje DatumPredpisaOd, medtem ko se ZZZSId prebere iz prijavljenega uporabnika. Zahtevku na spletno storitev se poleg zgoraj omenjenih polj nastavi v glavo (soap:header) še SAML žeton Varnostne sheme Ministrstva za zdravje (VS), ki je pridobljen iz klica spletne storitve VS. Odjemalska koda za spletne storitve VS se nahaja v ločenem modulu vsclient. Odjemalec spletne storitve E-recept se generira v javanskem razredu ZvemWSFactory ta skonstruira odjemalca iz privzetih nastavitev, ki pa jih je možno z nastavitvijo sistemskih lastnosti prilagoditi. Te nastavitve so: endpoint.cas.zvem.truststorepath lokacija truststore datoteke endpoint.cas.zvem.truststoretype tip truststore datoteke (privzeta vrednost»jks«) endpoint.cas.zvem.truststorepassword - geslo truststore datoteke Stran 53 od 65

54 endpoint.zvem.erecept - lokacija WSDL storitve e-recept (privzeta vrednost» Dnevnik vpogledov v erecept Za funkcionalnost Recepti je v aplikaciji zvem generirana odjemalska koda za storitev na naslovu (testno okolje). Za pridobivanje podatkov o receptih se kliče metoda spletne storitve queryauditlogforpatient, kateri se poda KZZID prijavljenega uporabnika. Zahtevku na spletno storitev se poleg zgoraj omenjenih polj nastavi v glavo (soap:header) še SAML žeton Varnostne sheme Ministrstva za zdravje (VS), ki je pridobljen iz klica spletne storitve VS. Odjemalska koda za spletne storitve VS se nahaja v ločenem modulu vsclient. Odjemalec spletne storitve E-recept se generira v javanskem razredu AuditZvemWsFactory ta skonstruira odjemalca iz privzetih nastavitev, ki pa jih je možno z nastavitvijo sistemskih lastnosti prilagoditi. Te nastavitve so enake kot za storitev e-recept, razlikuje se le sama lokacija storitve: endpoint.cas.zvem.truststorepath lokacija truststore datoteke endpoint.cas.zvem.truststoretype tip truststore datoteke (privzeta vrednost»jks«) endpoint.cas.zvem.truststorepassword - geslo truststore datoteke endpoint.zvem.erecept.audit - lokacija WSDL storitve e-recept (privzeta vrednost» /eprescription-ws/auditlogqueryservice?wsdl«) Ker storitev ne omogoča filtriranja na viru, se filtriranje po datumu izvede po pridobitvi podatkov s spletne storitve Integracija enaročanje V okviru integracije enaročanja je izveden prikaz treh storitev: pregled čakalnih dob, pregled seznama enapotnic ter pregled seznama enaročil Pregled čakalnih dob Portlet omogoča iskanje čakalnih dob. Iskanje čakalnih dob lahko izvajamo s pomočjo izbire zdravstvene storitve ter stopnje nujnosti. Pri obeh lahko zapise izbiramo s pomočjo iskalnika. Seznam dobljenih zadetkov lahko še dodatno omejimo po regiji, ki jo izberemo iz izbirnega seznama možnih regij. Rezultati iskanja so razvrščeni po pravilu: Imajo prost sprejem, Imajo prost termin za naročanje, Sprejemajo naročila v internem čakalnem seznamu, Naraščajoče po datumu termina. Podrobnosti posameznega termina v seznamu zadetkov iskanja si pogledamo tako, da kliknemo na»+«pred izbranim terminom, ali s klikom na podatek o ustanovi. Izpišejo se nam podrobni podatki termina, kot so naslov ustanove, kontaktni podatki, podrobnejše informacije glede razpoložljivega termina, informacija o delovnem času, lokaciji izvajanja zdravstvene storitve in povezava do spletne strani, kjer lahko pacient dobi več informacij ter podatek o zadnji posodobitvi. Zdravstvena ustanova lahko za vsako storitev iz šifranta VZS dostavi prilagojene kontaktne podatke ustanove oz. posameznega mesta izvajanja. Če ustanova ne dostavi prilagojenih kontaktnih podatkov, se prikažejo podatki od sedeža zdravstvene ustanove. Podrobnosti zapremo s klikom na»-«pred izbrano vrstico, ali s klikom na podatek o ustanovi. Stran 54 od 65

55 Slika 47: Prikaz pregleda čakalnih dob Prikaz seznama enapotnic Portlet omogoča iskanje enapotnic prijavljenega uporabnika. Ob odprtju strani se privzeto v seznamu prikažejo e-napotnice zadnjega meseca (privzeti filter). Po seznamu iščemo, tako da v polje Iskanje vpišemo datum od (datum je možno izbrati iz koledarčka), za katerega želimo izpisati seznam napotnic. Lahko se omejimo tudi tako, da zahtevamo prikaz samo izkoriščenih napotnic.seznam dobljenih zadetkov lahko dodatno omejimo po vrsti storitve, ki jo izberemo iz izbirnega seznama možnih storitev. Podrobnosti napotnice si pogledamo tako, da kliknemo na povezavo Podrobno v prvem stolpcu seznama. Povezava nas usmeri na portal e-naročanje, v katerem si lahko ogledamo podrobnosti napotnice, izvedemo rezervacijo termina ter naročanja. Naslov preusmeritve se sestavi iz nastavitve zvem.znet.enarocanje.url.public ter kzzid-jem prijavljenega uporabnika in številke napotnice. Slika 48: Prikaz seznama enapotnic Stran 55 od 65

56 Prikaz seznama enaročil Portlet omogoča iskanje enaročil prijavljenega uporabnika. Ob odprtju strani se privzeto v seznamu prikažejo naročila od današnjega dne naprej (privzeti filter). Po seznamu iščemo, tako da v polje Iskanje vpišemo datum od (datum je možno izbrati iz koledarčka), za katerega želimo izpisati seznam naročil. Seznam dobljenih zadetkov lahko dodatno omejimo po vrsti storitve, ki jo izberemo iz izbirnega seznama možnih storitev. Podrobnosti naročila si pogledamo tako, da kliknemo na povezavo Podrobno v prvem stolpcu seznama. Povezava nas usmeri na portal e-naročanje, v katerem si lahko ogledamo podrobnosti naročila, izvedemo odjavo ter v primeru odjave podamo opravičilo. Naslov preusmeritve se sestavi iz nastavitve zvem.znet.enarocanje.url.public ter kzzid-jem prijavljenega uporabnika in številke napotnice. Slika 49: Prikaz seznama enaročil Tehnična specifikacija integracije storitev enaročanje V aplikacijo zvem je preko integracije s spletnimi storitvami vključena tudi funkcionalnost storitve E- Naročanje. Vključene so funkcionalnosti: pregled čakalnih vrst, izpis napotnic in izpis naročil. Vse funkcionalnosti so dosegljive znotraj glavnega menija Moje E-zdravje, podmeni E-Naročanje, kjer so ločene v zavihke Pregled čakalnih dob, Seznam napotnic in Seznam naročil. Odjemalska koda se nahaja v modulu zvem-portlet, v podmodulu patient/eappointments Skupna logika Za izvedbo poizvedbe (pridobitev podatkov) je v aplikaciji zvem izdelana koda v razredu SOAPUtil. Pri izdelavi SOAP zahteve se v glavo (soap:header/securitytoken) še SAML žeton Varnostne sheme Ministrstva za zdravje (VS), ki je pridobljen iz klica spletne storitve VS. Odjemalska koda za spletne storitve VS se nahaja v ločenem modulu vsclient. Pri tem se uporabi nastavitev zvem.service.url.enarocanje. Za povezavo preko https protokola se nastavijo tudi sistemske nastavitve javax.net.ssl in sicer: truststore nastavitev endpoint.cas.zvem.truststorepath, trustsstorepassword nastavitev endpoint.cas.zvem.truststorepassword in trustsstoretype nastavitev endpoint.cas.zvem.truststoretype. Stran 56 od 65

57 Odjemalec spletne storitve E-recept se generira v javanskem razredu ZvemWSFactory ta skonstruira odjemalca iz privzetih nastavitev, ki pa jih je možno z nastavitvijo sistemskih lastnosti prilagoditi. Te nastavitve so: endpoint.cas.zvem.truststorepath lokacija truststore datoteke endpoint.cas.zvem.truststoretype tip truststore datoteke (privzeta vrednost»jks«) endpoint.cas.zvem.truststorepassword - geslo truststore datoteke Pregled čakalnih dob Za pridobitev podatkov se izvede klic spletne storitve enaročanje, metoda GetReferralList, kateri se poda zahtevek (vhodni parametri) sestavljen iz: parameter MedicalProcedureCode oznaka zdravstvene storitve, ki jo je izbral uporabnik v vmesniku spletne aplikacije zvem, parameter UrgencyTypeCode oznaka nujnosti, ki jo je izbral uporabnik v vmesniku spletne aplikacije zvem, parameter RegionCode oznaka regije, ki jo je izbral uporabnik v vmesniku spletne aplikacije zvem (parameter se poda le, če uporabnike ni izbral možnosti Vse). V primeru, ko je uporabnik izbral eno izmed regij (ni možnost Vse), se po prejemu podatkov izvede tudi filtriranje po oznaki regije Izpis napotnic Za pridobitev podatkov se izvede klic spletne storitve enaročanje, metoda FreeSlotForProcedure, kateri se poda zahtevek (vhodni parametri) sestavljen iz: parameter PatientInsuranceIdentifier KZZID prijavljenega uporabnika (polje ZZZSId), parameter DatetimeFrom datum Od, ki ga je določil uporabnik v vmesniku spletne aplikacije zvem, parameter DatetimeTo trenutni sistemski datum, parameter Statuses oznake statusov 1, 2 in 3, če je uporabnik v vmesniku spletne aplikacije zvem izbral možnost Prikaži izkoriščene napotnice. Vsi prejeti podatki se prikažejo v spletni aplikaciji (ni dodatnega filtriranja) Izpis naročil Za pridobitev podatkov se izvede klic spletne storitve enaročanje, metoda GetAppointmentsForPatient, kateri se poda zahtevek (vhodni parametri) sestavljen iz: parameter PatientInsuranceIdentifier KZZID prijavljenega uporabnika (polje ZZZSId), parameter FetchAdmittedAppointments vedno se poda vrednost true. Po prejemu podatkov se izvede filtriranje glede na podatek AppointmentDateTime. Uporabijo se le zapisi kjer je datum večji ali enak datumu Od, ki ga je določil uporabnik v vmesniku spletne aplikacije zvem Integracija ezz V okviru integracije EZZ je omogočen ogled vsebin, do katerih dostopimo preko IH adapterja: Odpustna pisma: nestrukturiran oblika podatkov. Izjave o zasebnosti (omejitev dostopa do podatkov). Ambulantni izvidi. Privzeto se ob dostopu do strani prikaže seznam zadnjih 10 najdenih dokumentov. Po potrebi lahko prenesemo še ostale s klikom na povezavo»naloži več«. Omogočeno je tudi iskanje in filtriranje med zadetki oz. prenesenimi podatki, ki se nahajajo v seznamu. Posamezen dokument si lahko preko gumba»prenesi«shranimo na osebni računalnik. S pomočjo gumba»predogled«dokument odpremo za ogled. V desnem zgornjem kotu tega okna sta gumba»tiskaj«, ki omogoča tiskanje dokumenta, in»prenesi«, ki omogoča prenos dokumenta na osebni računalnik uporabnika. Stran 57 od 65

58 Slika 50: Prikaz seznama dokumentov Tehnična specifikacija integracije storitev EZZ (integracija IHMZ) Del funkcionalnosti aplikacije zvem je izpis medicinskih dokumentov prijavljenega uporabnika (pacient) iz interoperabilne hrbtenice ministrstva za zdravje (IHMZ). Integracija je izvedena preko XDS (Cross-enterprise Document Service) odjemalca na zalednem strežniku, ki prejete dokumente pretvori v FHIR vire in jih preko FHIR REST vmesnika streže portalu. Izvorna koda XDS odjemalca je v modulu xds znotraj podprojekta backbone, REST vmesnik pa je v modulu rest-interface. Poleg XDS odjemalca je pomembna še integracija z Audit Trail and Node Authentication(ATNA) strežnikom IHMZ. ATNA strežnik beleži dostope do dokumentov na IHMZ tja se zabeleži vsak dostop s strani portala. Izvorna koda odjemalca je v modulu atna znotraj podprojekta backbone. Funkcionalnost je na portalu dosegljiva preko glavnega menija Moje E-zdravje, podmeni Dokumenti. Na prvo zahtevo se izvede klic na IHMZ, ki populira podatkovno bazo z metapodatki, vsak naslednji klic poišče samo nove dokumente in doda njihove metapodatke. Sami dokumenti se preko posredniškega elementa strežejo iz IHMZ Podrobnosti in nastavitve backbone strežnik XDS odjemalec za IHMZ se skonstruira na osnovi naslednjih nastavitev, ki jih je možno spremeniti z nastavljanjem sistemskih lastnosti (lastnosti se berejo v javanskem razredu IhApiConstants): ihadapter.service.wsdl.url privzeta vrednost: testno okolje MZ: ihadapter.service.url privzeta vrednost: testno okolje MZ: ihadapter.client.keystore.path privzeta vrednost: null testno okolje MZ: /opt/cert/clientkeystorezvemwstest ihadapter.client.keystore.password privzeta vrednost: null testno okolje MZ: ******** Stran 58 od 65

59 Poleg same lokacije spletne storitve sta za rabo XDS vmesnika na IHMZ potrebna še dva ključa, ki se ju prav tako nastavi preko sistemskih lastnosti: ihadapter.api privzeta vrednost: xy testno okolje MZ: xy ihadapter.bpi.id.key privzeta vrednost: xxx testno okolje MZ: xxx ATNA odjemalec za avtentikacijo na IHMZ uporablja iste podatke kot XDS odjemalec torej vrednosti sistemskih lastnosti ihadapter.api in ihadapter.bpi.id.key, v svojih nastavitvah pa vključuje še nastavitev lokacije ATNA vmesnika: ihadapter.service.audit.url privzeta vrednost: testno okolje MZ: produkcijsko okolje MZ: Podrobnosti in nastavitve portalski strežnik Za delovanje integracije z IHMZ je potrebno ustrezno nastaviti tudi FHIR odjemalca na portalskem strežniku. Tudi tega se nastavlja preko sistemskih lastnosti in sicer z nastavitvijo: vitaly.fhir.server.base - vrednost je oblike [BACKBONE_SERVER_HOSTNAME: BACKBONE_SERVER_HOSTNAME]/fhir/rest Na portalu zvem se prikazujejo samo trije tipi dokumentov iz IHMZ, gre za odpustna pisma, izjave o zasebnosti in ambulantni izvidi (kode dokumentov , , ). Poleg beleženja dostopov do dokumentov, ki se izvaja na IHMZ na strežniku ATNA, se beleži dostope do funkcionalnosti tudi na strani samega portala. Za beleženje dostopov se uporablja strežnik Piwik, kamor se poleg splošnih analitičnih podatkov, posebej beležijo (kot dogodki) tudi dostopi do posameznih povezanih funkcionalnosti. V primeru dokumentov gre za spodnji klic: piwikutil.logevent("ezz-dokumenti", "Ogled dokumentov","", "", themedisplay.getuser().getscreenname(), url); Poleg kategorije in imena dogodka, se beleži tudi uporabniško ime prijavljenega uporabnika in naslov na katerem je dostopal do dokumentov Naročanje na obveščanje ter obveščanje V sklopu portala zvem je možno spreminjati nastavitve obveščanja za prijavljenega uporabnika. Gre za obvestila, ki jih pošiljajo povezani sistemi (enaročanje), ali pa jih v imenu povezanih sistemov pošilja portal zvem (erecept). V ta namen je v portalu pripravljen vmesnik, kjer je možno spreminjati te nastavitve funkcionalnost je dosegljiva skozi glavni meni Moje E-zdravje, podmeni Pregled. Stran 59 od 65

60 Slika 51: Naročanje na obvestila urejanje profila uporabnika Funkcionalnost vključuje dve komponenti. V primeru enaročanja, se spremembe nastavitev na strani portala zvem sporoči sistemu enaročanje, ker ta sistem sam izvaja obveščanja. Spremembo se sporoči čez klic spletne storitve, katere odjemalska koda se nahaja v modulu e-subscription. Integracija je izvedena s pomočjo knjižnice Apache CXF. Drugi del funkcionalnosti je sistem obveščanja, ki je namenjen rabi iz sistema erecept (oziroma potencialno še za druge povezane sisteme, ki sami ne izvajajo obveščanja). Funkcionalnost je ločena na portalski del, kjer je vmesnik s katerim uporabniki spreminjajo nastavitve in administracijski vmesnik za upravljanje s sistemom, ter REST vmesnik na backbone strežniku, ki ga povezani sistemi (erecept) uporabljajo da preverijo status prijav in potem sistemu pošljejo obvestila za prijavljene uporabnike Integracija z enaročanjem Za funkcionalnost sporočanja sprememb za obveščanja je v aplikaciji zvem generirana odjemalska koda za storitev na naslovu smx (testno okolje). Za spremembe nastavitev se kliče metoda spletne storitve updatepatientcontact, kateri se poda zahtevek skladen s spodnjo shemo: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" <xs:element name="contactdetail"> <xs:complextype> <xs:sequence> <xs:element minoccurs="1" maxoccurs="1" name="contacttype" type="xs:string" /> <xs:element minoccurs="1" maxoccurs="1" name="value" type="xs:string" /> </xs:sequence> </xs:complextype> </xs:element> <xs:element name="contacts"> <xs:complextype> <xs:sequence> Stran 60 od 65

61 <xs:element minoccurs="1" maxoccurs="unbounded" ref="contactdetail"/> </xs:sequence> </xs:complextype> </xs:element> <xs:element name="updatepatientcontactrequest" > <xs:complextype> <xs:sequence> <xs:element minoccurs="1" maxoccurs="1" name="patientidentifier"> <xs:simpletype> <xs:restriction base="xs:string"> <xs:length value="9"/> </xs:restriction> </xs:simpletype> </xs:element> <xs:element minoccurs="1" maxoccurs="1" name="enablesms" type="xs:boolean" /> <xs:element minoccurs="1" maxoccurs="1" name="enable " type="xs:boolean" /> <xs:element minoccurs="1" maxoccurs="1" ref="contacts"/> </xs:sequence> </xs:complextype> </xs:element> </xs:schema> V polje PatientIdentifier se nastavi KZZID prijavljenega uporabnika, v seznamu Contacts se pošljejo shranjeni kontaktni podatki in v poljih Enable in EnableSMS se pošlje podatek o tem ali je vklopljeno obveščanje po ustreznem kanalu. Zahtevku na spletno storitev se poleg zgoraj omenjenih polj nastavi v glavo (soap:header) še SAML žeton Varnostne sheme Ministrstva za zdravje (VS) za sistem enaročanje, ki je pridobljen iz klica spletne storitve VS. Odjemalska koda za spletne storitve VS se nahaja v ločenem modulu vsclient. Odjemalec spletne storitve enaročanje se generira v javanskem razredu SubscriptionZvemWsFactory ta skonstruira odjemalca iz privzetih nastavitev, ki pa jih je možno z nastavitvijo sistemskih lastnosti prilagoditi. Te nastavitve so enake kot nastavitve za storitve e-recept, razlikuje se le sama lokacija storitve: endpoint.cas.zvem.truststorepath lokacija truststore datoteke endpoint.cas.zvem.truststoretype tip truststore datoteke (privzeta vrednost»jks«) endpoint.cas.zvem.truststorepassword - geslo truststore datoteke zvem.znet.service.url.enarocanje - lokacija WSDL storitve e-recept (privzeta vrednost» cepublic.asmx«) Storitev za obveščanje Storitev za obveščanje je sestavljena iz dveh delov: REST vmesnika za zunanje sisteme(erecept), ki v sistem za obveščanje pošiljajo obvestila. Ta vmesnik se nahaja na backbone strežniku, izvorna koda pa je v modulu zvem-util. vmesnika za upravljanje z obveščanjem za uporabnika in vmesnika za administracijo v CMS modulu, ki se nahajata na portalskem strežniku izvorna koda se nahaja v modulu zvemportlets. Stran 61 od 65

62 REST vmesnik je opisan v spodnji sliki: Primer klica na prvo metodo je spodaj metoda vrne seznam uporabnikov prijavljenih na obveščanje za sistem za katerega je bila metoda poklicana (parameter systemid): GET [BACKBONE_SERVER_HOSTNAME:BACKBONE_SERVER_PORT]/zvemutil/rest/messaging/subscription?systemId=E-Recept Odgovor: { "daysbeforeprescriptionexpiration": 3, "subscriptionlist": [{ "kzzid": " ", "eventtype": "Mail" }, { "kzzid": " ", "eventtype": "Sms" }, { "kzzid": " ", Stran 62 od 65

63 } }, { }, { }, { }, { }, { }, { }, { }, { }] "eventtype": "Sms" "kzzid": " ", "eventtype": "Mail" "kzzid": " ", "eventtype": "Mail" "kzzid": " ", "eventtype": "Sms" "kzzid": " ", "eventtype": "Sms" "kzzid": " ", "eventtype": "Mail" "kzzid": " ", "eventtype": "Sms" "kzzid": " ", "eventtype": "Mail" "kzzid": " ", "eventtype": "Sms" Druga metoda je namenjena dodajanju obvestil v sistem : POST [BACKBONE_SERVER_HOSTNAME:BACKBONE_SERVER_PORT]/zvemutil/rest/messaging/event Body: { "systemcode": "ERECEPT", "eventtype": "Potek listine", "subtype": "Beli recept", "metadata": [ { "key": "datumpreteka", "value": " " }, { "key": "datumizdaje", "value": " " }, { "key": "stevilka", "value": " " } ], Stran 63 od 65

64 "kzzid": " " } Drugi del funkcionalnosti je v CMS vmesniku portalske aplikacije dostopen v meniju Vsebina, podmeni ZVEM Notifications: V tem vmesniku se tipe in podtipe obvestil (spodnji dve tabeli in pripadajoča obrazca), iz katerih se nato v zgornjem obrazcu sestavi obvestilo. Obvestilu se nastavi pošiljatelj, naslov, izbere se sistem, tip dogodka in podtip dogodka in predloga. Predloge se v obliki.ftl (FreeMarker) datotek naloži v DMS sistema Liferay, v mapo Templates mapa se lahko spremeni, vendar je potem potrebno nastaviti sistemsko lastnost notification.templates.folderid (privzeta vrednost je id mape Templates). Predloge se naloži v obliki DMS dokumenta tipa Templates. Predloge se ob kreiranju sporočila dinamično populirajo s podatki prejetimi na spletno storitev. Primer predloge je spodaj: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" " <html xmlns=" <head> </head> <body bgcolor="#f5f5f5" style="background: #f5f5f5; margin: 0; padding: 0; font-family: 'Nimbus', 'Helvetica Neue', 'Helvetica', Helvetica, Arial, sans-serif;"> <table style="width: 100%; background: white" bgcolor="white"> <tr> <td></td> <td style="display:block!important;max-width:600px!important;margin:0 auto!important;clear:both!important;"> <div style="padding:15px; max-width:600px; margin:0 auto; display:block;"> <table bgcolor="white" style="width: 100%; background: white"> <tr> Stran 64 od 65