PUBLITSEERIMISKESKUS

Kasutusjuhend

1

Dokumendi ajalugu

Ver. nr. Ver. kuup Autor Muudatuste kirjeldus

1 13.04.2008 Esmane versioon

2 15.01.2016 Maris Kuusik Täiendatud ja parandatud versioon

Sisukord

1 Dokumendi eesmärk ....................................................................................................................... 2

2 Publitseerimiskeskuse tutvustus ..................................................................................................... 2

3 Publitseerimiskeskuse eesmärk ...................................................................................................... 2

3.1 Muudatuste teavitus ............................................................................................................... 4

4 Publitseerimiskeskuse struktuur ..................................................................................................... 4

4.1 Klassifikaatorid ja loendid........................................................................................................ 5

4.1.1 Klassifikaatorite ja loendite versioneerimine .................................................................. 5

4.2 Juhendid ja abimaterjalid ........................................................................................................ 6

4.2.1 Juhendite ja abimaterjalide versioneerimine .................................................................. 6

4.3 Meditsiinidokumentide (andmekvaliteedi ja Schematron) kontrollid .................................... 7

4.3.1 Meditsiinidokumentide andmekontrollide versioneerimine .......................................... 7

4.4 OID keskus ............................................................................................................................... 8

4.5 Standardikogumikud ............................................................................................................... 9

4.5.1 Standardikogumike versioneerimine ............................................................................ 10

4.5.2 Standardikogumikus sisalduvate dokumentide kirjeldus .............................................. 10

2

1 Dokumendi eesmärk

Käesoleva dokumendi eesmärk on anda ülevaade Eesti E-tervise Sihtasutuse (ETSA)

publitseerimiskeskuse eesmärgist ja ülesehitusest.

2 Publitseerimiskeskuse tutvustus

Publitseerimiskeskus on loodud tervise infosüsteemis kasutusel olevate:

meditsiinidokumentide standardite

standarditega seotud XSL ja CSS failide

standardite XML näidisdokumentide

standardites kasutatud HL7 V3 XSD failide ja nende Eesti laienduste

interaktsioonisõnumite ja nende XML näidete

meditsiinidokumentide andmekontrollide

juhendite ja õppematerjalide

tsentraalseks halduseks ja avalikult kättesaadavaks tegemiseks ehk publitseerimiseks.

Publitseerimiskeskuses asub ka Eesti tervishoiuvaldkonna ISO OID1-ide registreerimise keskus.

Lisaks asuvad publitseerimiskeskuses viited klassifikaatoritele, mille sisu ei halda ETSA (nt LOINC), kuid mida kasutatakse TIS-i standardiseeritud meditsiinidokumentides.

3 Publitseerimiskeskuse eesmärk

Tulenevalt „Tervishoiuteenuste korraldamise seadusest“ (TTKS) § 42 lg 1, on tervishoiuteenuse osutamise dokumenteerimisel kohustuslik kasutada riigi infosüsteemi klassifikaatoreid, loendeid, aadressiandmeid ja tervise infosüsteemi standardeid https://www.riigiteataja.ee/akt/122122014006#para4b2, mille andmekoosseisud kinnitatakse sotsiaalministri määrusega „Tervise infosüsteemi edastatavate dokumentide andmekoosseisud ning nende säilitamise tingimused ja kord“ https://www.riigiteataja.ee/akt/114042015011#para2.

Viidatud õigusaktidest tulenevalt on tervishoiu teenuse osutajatele (TTO-d) kohustuslik, tervishoiuteenuste osutamise kohta kokkuvõtlike dokumentide (epikriisid, saatekirjad, saatekirja vastuseks antavad dokumendid jm) koostamine ja saatmine TIS-i, kus teistel TTO-del on võimalik neid dokumente patsiendipõhiselt pärida. Seetõttu on publitseerimiskeskuse peamiseks ülesandeks igal ajahetkel tagada TTO-dele ajakohased andmed TIS standarditest ning nendes sisalduvatest klassifikaatoritest ja loenditest.

1 ISO OID (Object Identifier) süsteem võimaldab registreerida erinevad objektid kordumatute identifitseeritavate numbritena ning süsteemi kasutamine on eelduseks HL7 v3 CDA (Health Level 7 version 3 Clinical Document Architecture) standardile vastavate digitaalsete meditsiinidokumentide kasutuselevõtuks.

3

Publitseerimiskeskus on avalikult kättesaadav veebiaadressil http://pub.e-tervis.ee

Joonis 1 Publitseerimiskeskuse avaleht

Alternatiivne ja lihtsaim viis hetkel kehtivate TIS standardite, juhendite ja klassifikaatoriteni jõudmiseks, on aga liikuda ETSA kodulehehelt http://www.etervis.ee/index.php/et/ alloleval pildil (Joonis 2) kollasega viidatud alamjaotise – „PUBLITSEERIMISKESKUS“ kaudu.

4

Joonis 2 Eesti E-tervise SA koduleht

3.1 Muudatuste teavitus

Vastavalt uute klassifikaatorite, loendite ja standardite muutmisele ja olemasolevate parandustele, viiakse publitseerimiskeskuses sisse muudatusi. Klassifikaatorite ja loendite ning juhendite publitseeritud muudatustest teada saamiseks on võimalik kasutada RSS infovoogu, mille võib tellida vastavat tuge omavate programmide abil. Lisaks RSS infovoole toimub loendite ja klassifikaatorite muudatustest teavitamine ka e-posti vahendusel. Standardikogumikes ja selles sisalduvates standardites tehtavatest muudatustest on teavitusi võimalik edastada ja saada vaid e-posti vahendusel.

4 Publitseerimiskeskuse struktuur

Publitseerimiskeskuses hallatavad andmevarad on jaotatud struktuurselt järgnevatesse kaustadesse (Joonis 1):

„classifications” – loendid ja klassifikaatorid;

„manuals” – juhendid ja dokumentatsioon;

„devstandard“ – arendatav standard NB! AEGUNUD;

„drstandard“ – digiregistratuuri standard NB! EI OLE KASUTUSEL;

„ekoolitus“ – koolitusmaterjalid NB! AEGUNUD;

„manuals“ – juhendid ja abimaterjalid;

„mdstandard“ – meditsiinidokumentide standardid NB! AEGUNUD, v.a Meditsiinidokumentide

kontrollid (andmekvaliteedi ja Schematron kontrollid);

„OID keskus” – Eesti E-tervise SA OID haldus;

„standards“ – tervise infosüsteemi pilootkasutuse standard NB! AEGUNUD;

5

„standards2“ – jaguneb alamkaustadeks „Schema“, mis sisaldab standardites kasutatud HL7

V3 XSD faile ning „Standards“, mis sisaldab TIS standardikogumike versioone sh hetkel

kehtivat.

4.1 Klassifikaatorid ja loendid

Kõik klassifikaatorid ja loendid on leitavad kaustast „classifications“, lingilt http://pub.e-tervis.ee/classifications tähestikulises järjekorras (Joonis 3).

Joonis 3 Klassifikaatorite ja loendite alamjaotis

Klikkides huvipakkuva klassifikaatori või loendi nimetusel, avaneb vaade selle erinevatest versioonidest (Joonis 4). Iga versiooni juures on märgitud staatus „Publitseeritud“ või „Aegunud/ebasoovitav“. TIS standardite kasutamisel tuleb TTO infosüsteemides alati kasutada viimast ehk „Publitseeritud“ versiooni, tagamaks TIS-i saadetavate dokumentide koosseisus ajakohased andmed.

4.1.1 Klassifikaatorite ja loendite versioneerimine

Klassifikaatoreid ja loendeid versioneeritakse vastavalt vajadusele ning nende avaldamine ei ole alati kooskõlas standardikogumiku avaldamisega.

Klassifikaatorite ja loendite versioneerimisel kehtivad järgnevad reeglid:

iga muudatus klassifikaatoris või loendis tekitab uue versiooni (ka kirjavea parandus);

igal koodi real on määratud selle kehtima hakkamise, muutmise, kehtetuks tunnistamise kuupäev;

6

uutes versioonides on ka kehtetud koodid koos kehtetuks tunnistamise kuupäevaga.

NB! Vanemate versioonide korral ei pruugi olla jälgitud loetletud põhimõtteid.

Iga klassifikaatori või loendi juurest leiab ka viite selgitusfailile, mis sisaldab informatsiooni selle kohta, mille alusel ja kelle poolt loend loodi, millal loendit viimati uuendati, loendiga seotud mõistete definitsioonid ning kasutamise kirjeldus. Lisaks leiab viite klassifikaatorit või loendit identifitseerivale OID-le.

NB! Rahvusvahelised klassifikaatorid (LOINC, ATC, SNOMED, jm) ei pruugi olla rahvusvahelise OID-iga seotud kuna ETSA ei ole rahvusvaheliste OID-ide haldaja. Nimetatud juhul viidatakse OID-ile ainult standardi dokumendis, kus seda klassifikaatorit kastutakse.

Joonis 4 Klassifikaator „Voodiprofiilid“

Klikates veerus „Versiooni nimi“ oleval versiooninumbril leiab vastava klassifikaatori .xls ja .csv formaadis, mida on võimalik allalaadida ja kopeerida TTO infosüsteemi.

4.2 Juhendid ja abimaterjalid

Kehtivad TIS dokumendi standardite ja portaalide lõppkasutajate juhendid ning muud abimaterjalid on leitavad kaustast „manuals“, lingilt http://pub.etervis.ee/manuals/

4.2.1 Juhendite ja abimaterjalide versioneerimine

Iga uue dokumendi standardi või selle versiooni avaldamisega avaldatakse publitseerimiskeskuses ka sellele standardile või versioonile vastava numbriga juhend.

7

Näiteks: käesoleva juhendi koostamise hetkel on kehtiv ambulatoorse epikriisi standard versioon 7.0, millele vastab ambulatoorse epikriisi täitmise juhend versioon 7.0.

Joonis 5 Ambulatoorse epikriisi täitmise juhendid

Üldjuhul versioneeritakse ka teisi juhendeid ja abimaterjale ning uuemate versioonide staatus on alati märgitud „Publitseeritud“.

4.3 Meditsiinidokumentide (andmekvaliteedi ja Schematron) kontrollid

Meditsiinidokumentide andmekontrollid (Joonis 6) on leitavad kaustast „mdstandard“ või lingilt

http://pub.e-tervis.ee/mdstandard/Meditsiinidokumentide%20kontrollid

4.3.1 Meditsiinidokumentide andmekontrollide versioneerimine

Uute andmekontrollireeglite lisandumisel või olemasolevate parandamisel avaldatakse sellest reeglikogumikust uus versioon. Kehtiv andmekontrollide kogumiku versioon on alati märgitud staatuses „Publitseeritud“.

8

Joonis 6 Meditsiinidokumentide kontrollide alamjaotis

4.4 OID keskus

ISO OID-e kasutatakse HL7 sõnumites sisalduvate loendite ja kodeerimissüsteemide täpseks rahvusvaheliseks tuvastamiseks. ISO OID süsteem on aktsepteeritud ja kasutatud HL7 standardit haldava organisatsiooni (www.hl7.org) poolt. Iga OID on unikaalne, määrates üheselt nt riigi, asutuse, tehnilise seadme vm identifitseeritava objekti.

Eesti E-tervise SA OID on 1.3.6.1.4.1.28284 ning ETSA, kui selle OID haru haldaja jagab TIS-ga liidestunutele selles harus alamOID-e. Iga TTO haldab talle määratud harus oma objekte ning neile ei kehti piiranguid selles osas, mitu haru nende nn juurOID-st hargneb või kui kaugele need ulatuvad. Kõik registreeritud OID-id on aga lõplikud, mistõttu 1.3.6.1.4.1.28284 ei saa tähendada ka tulevikus muud kui ETSA-t.

OID keskus (Joonis 7) on leitav lingilt http://pub.e-tervis.ee/oids.py

9

Joonis 7 Publitseerimiskeskuse OID keskus

4.5 Standardikogumikud

Standardikogumik on kõikide TIS dokumendi ja interaktsioonisõnumi standardite ning nendega seotud stiililehtede ja XML näidissõnumite kogumik. Standardikogumikud on leitavad kaustas „/standards2/Standards„ (Joonis 8) või lingilt http://pub.e-tervis.ee/standards2/Standards

10

Joonis 8 Standardikogumikud

4.5.1 Standardikogumike versioneerimine

Käesoleva juhendi koostamise hetkel, tulenevalt publitseerimiskeskuse tehnilise lahenduse eripärast, on üheaegselt kehtivad kaks standardikogumikku:

Standardikogumik versioon 5.1 (Staatus: Aegunud/ebasoovitav), mis on nö TIS standardite hetkel kehtiv põhikogumik;

Standardikogumik versioon 5.2 (Staatus: Publitseeritud), mis sisaldab põhikogumikus 5.1 olevaid dokumente, milles on viimase publitseerimise järgselt tehtud pisiparandusi.

Üldjuhul kehtib aga reegel, et põhikogumik suureneb täisversiooni võrra (1.0 2.0, 3.0, jne), parandustega kogumikud avaldatakse täisversiooni vaheversioonidena (3.1, 3.2, 3.3, jne) ning korraga kehtib üks versioon, mille staatus on „Publitseeritud“.

NB! Minevikus kehtinud standardeid publitseerimiskeskusest ei eemaldata.

Kehtib hea tava, et uusi standardikogumike versioone ei avaldata sagedamini kui 2 korda aastas ning TTO-del on võimalus rakendada uut standardit ühe aasta jooksul alates selle avaldamisest. (NB! tähtaeg võib vahel sõltuda õigusruumis toodud rakendussätetest.)

4.5.2 Standardikogumikus sisalduvate dokumentide kirjeldus

Klikates standardikogumiku kausta „standards“ veerus „Versiooni nimi“ asuval numbril, avaneb vaade selles kogumikus sisalduvatele dokumentidele (Joonis 9), mis on TIS projektide põhiselt (täpsustused allpool) eristatavad dokumendi nime ees oleva eesliitega.

11

Joonis 9 Standardikogumik 5.1

Digiloo projekti dokumentide ja interaktsioonisõnumite standardid algavad eesliitega DL/ST Näiteks:

o Ambulatoorse epikriisi standard – DL/ST_Ambulatoorne epikriis.doc o Uuringute päring – DL/ST_Dokumendi valjavotte paring (uuringud).doc

ning neile vastavad näidisdokumendid (CDA) ja -sõnumid algavad prefiksiga DL/XML. Näiteks:

o DL/XML/CDA_Ambulatoorne.xml o DL/XML/RCMR_IN000029UV01_Find_Document_Metadata_Query_uuringud.xml

Digiregistratuuri projekti standardid (sh saatekirja ja saatekirja vastuse standardid) algavad prefiksiga DR/DOC Näiteks:

o Saatekirja vastuse standard – DR/DOC/DR-KI-6 Vastus saatekirjale.doc o Dokumentide päringud ja päringute vastused – DR/DOC/DR-KI-3 Dokumentide

paringud ja vastused.doc ning neile vastavad näidisdokumendid ja -sõnumid algavad prefiksiga DR/XML Näiteks:

o Saatekirja vastuse näidisdokument – DR/XML/DR Saatekiri/Vastus saatekirjale.xml o Saatekirja vastuste nimekirja päring – DR/XML/Dokumentide paringud ja

vastused/RCMR_IN000029UV - Saatekirja vastuste nimekirja paring.xml

12

o Saatekirja nimekirja päringu vastus – DR/XML/Dokumentide paringud ja vastused/RCMR_IN000030UV - Saatekirja nimekirja paringu vastus.xml

Kiirabikaardi standardid algavad prefiksiga DL/KK. Näiteks:

o Kiirabikaardi mallid – DL/KK_Kiirabikaardi mallid.doc o Kiirabikaardi sõnumite mallid – DL/KK_Sonumite_mallid.doc o Kiirabibrigaadi päringu standard –

Kiirabibrigaadi päringDL/KK_Kiirabibrigaadi_paring.doc

ning neile vastavad näidisdokumendid ja -sõnumid algavad prefiksiga

o Kiirabikaardi näidisdokument – DL/XML/CDA_Kiirabikaart.xml o Kiirabibrigaadi päringu näidissõnum –

KK/XML/Registrid_PRPA_IN202305UV02_Kiirabibrigaadi_paring.xml

NB! Erinevalt digiloo standarditest ei ole Kiirabikaardi puhul kasutusel dokumendi standardit, selle asemel on kasutusel Kiirabikaardi mallid.doc.

TIS dokumentide ja interaktsioonisõnumite standardid

Standardi dokumendis (nt ST_Ambulatoorne epikriis.doc) on kirjas selles standardis kasutatavate mallide loetelu, reeglid ja kordsused. Kõik mallid asuvad omakorda eraldi dokumendis, vastavalt DL/DL_Mallid.doc ja DR/DR-KI2 HL7 v3 Mallid.doc.

Avaldatud dokumendistandardi versioonid suurenevad alati täisarvu võrra ning nende versiooninumbrid ei kattu standardikogumiku versiooninumbriga. Näiteks on standardikogumiku v5.2 all avaldatud Ambulatoorse epikriisi standard v7.0 ning Statsionaarse epikriisi standard v6.0.

Standardikogumikus asub ka standardite EA mudel DL/DL_standardite_EAmudel.zip, mille kasutamiseks tuleb see eelnevalt lahti pakkida.

Stiililehed

Kõik dokumentidega seotud stiililehed asuvad samuti vastava standardikogumiku all ning algavad prefiksiga XSL.

Näide:

XSL/vastusSaatekirjale.xsl