eRadiologija

Sadržaj

Uvod

Kako bi se omogućila razmjena radioloških nalaza i pristup medicinskim snimkama kroz sustav CEZIH, usluga eRadiologija uvodi dva nova klinička dokumenta koja matična aplikacija korisnika šalje u Podsustav 1 kao odvojene elektronički potpisane dokumente FHIR:

  1. Radiološki nalaz (Nalaz) — strukturirani radiološki nalaz s PDF prilogom.
  2. Manifest o medicinskim snimkama (Manifest) — metapodataci o medicinskim snimkama nastali tijekom dijagnostičke pretrage.

Oba dokumenta pripremaju se i šalju prema pravilima opisanim u ovom dokumentu te objavljenim na platformi Simplifier:

Preduvjeti okoline

Dokument je namijenjen tehničkim implementatorima. Pretpostavlja se poznavanje normi HL7 FHIR R4, DICOM, DICOMweb te integracijskih profila IHE navedenih na platformi Simplifier.

Prije integracije matična aplikacija korisnika treba osigurati sljedeće preduvjete:

Napomena: namjerno se izbjegava propuštanje drugih servisa DICOMweb, poput QUIDO-RS ili STOW-RS, zato što sustav CEZIH nastupa samo kako read-only sustav i least priviledge sustav prema sustavima PACS.

Ispravan sadržaj metapodataka u zaglavlju DICOM medicinske snimke

Kako bi se svaki dokument Radiološki nalaz i pripadajući Manifest ispravno povezali s pripadajućim medicinskim snimkama te potpuno uklonila mogućnost povezivanja snimki s pogrešnim pacijentom u sustavima eKarton i Portal zdravlja, matične aplikacije trebaju:

  1. Slijediti definirani radni tok slanja kliničkog dokumenta kako je objavljeno na platformi Simplifier.
  2. Ispravno unijeti sljedeće metapodatke pacijenta i postupka u zaglavlje medicinske snimke DICOM:
    • Ime i prezime (Patient's Name),
    • Datum rođenja (Patient's Birth Date),
    • Spol (Patient's Sex),
    • Datum postupka (Study Date),
    • Broj postupka (Accession Number).

Identifikator pacijenta MBO u zaglavlju DICOM

Ukoliko je moguće i ukoliko nije već unesen, preporučuje se da se u polje zaglavlja DICOM Other Patient IDs Sequence (0010,1002) unese (ili nadoda ako polje već sadrži neki podatak) identifikator MBO (Matični broj osiguranika), definiran kao jedinstveni identifikator za identifikaciju pacijenata i zdravstvenih djelatnika.

Podatak bi trebao biti definiran kao sekvenca na sljedeći način:

Slanja kliničkih dokumenata

Slanje radiološkog kliničkog dokumenta (i Nalaza i Manifesta) slijedi isti krovni proces kao i svi klinički dokumenti u sustavu CEZIH kako je opisano na platformi Simplifier.

Napomena: Nalaz i Manifest šalju se kao dva odvojena dokumenta, svaki sa svojim jedinstvenim identifikatorom i svojom HR::ITI-65 transakcijom.

Radiološki nalaz

Radiološki nalaz je elektronički potpisani klinički dokument FHIR. Slanje, zamjena, storniranje, pretraga i dohvat Nalaza provode se krovnim procesom opisanim na platformi Simplifier i transakcijama HR::ITI-65, HR::ITI-67 i ITI-68. Radiološki nalaz temelji se na europskim specifikaciji EU Imaging Report R4 i hrvatskoj ekstenziji profila IHE MHD.

Struktura dokumenta definirana je HR profilima:

  1. HRDiagnosticReportEuImaging i
  2. HRCompositionEuImaging

objavljenim na platformi Simplifier.

Napomena: ukoliko je Nalaz odgovor na eUputnicu, navodi se identifikator uputnice; na temelju te veze sustav CEZIH po potrebi ažurira stanje procesa eUputnice.

Manifest o medicinskim snimkama

Manifest je zaseban klinički dokument koji nosi metapodatke o medicinskim snimkama dijangostičke pretrage (ImagingStudy) i lokaciju snimki (Endpoint) kako bi se omogućili pretraga i dohvat snimki. Slanje, zamjena, storniranje, pretraga i dohvat Manifesta provode se krovnim procesom opisanim na platformi Simplifier i transakcijama HR::ITI-65, HR::ITI-67 i ITI-68. Svakoj ustanovi tj. sustavu PACS unutar ustanove se dodjeljuje resurs Endpoint. Manifest se temelji na profilu IHE MADO (Manifest-based Access to DICOM Objects).

Struktura dokumenta definirana je HR profilima:

  1. HRImagingStudyEuImaging 12 i
  2. HRCompositionEuImaging 13

objavljenim na platformi Simplifier.

Napomena: Manifest se priprema i šalje kao samostalan dokument s vlastitim jedinstvenim identifikatorom i vlastitom HR::ITI-65 transakcijom, neovisno o Nalazu (prije, poslije ili bez Nalaza).

Priprema manifesta

Manifest pripremaju matične aplikacije na osnovu podataka iz sustava PACS o snimljenoj dijagnostičkoj pretrazi.

Moguće su dvije uloge:

Postupak koji provodi pošiljatelj Manifesta:

  1. Dohvaćaju se metapodaci o medicinskim snimkama iz sustava PACS. Za dohvat se koriste postojeći standardni mehanizmi za upit nad sustavom PACS (primjerice DICOMweb transakcija QIDO-RS ili DIMSE transakcija C-FIND). Izbor mehanizma ovisi o mogućnostima izvornog sustava.
  2. Iz dohvaćenih metapodataka oblikuje se resurs ImagingStudy (identifikatori studije, serija i instanci, modaliteti, Accession Number) te se uz njega prilaže Endpoint resurs s dodijeljenim identifikatorom organizacije kako bi se omogućio kasniji dohvat snimki.
  3. Iz dohvaćenih metapodataka oblikuje se Manifest, koji se elektronički potpisuje i šalje kao zaseban dokument transakcijom HR::ITI-65.

diagram-1

Slika 1. Priprema manifesta

Dohvat medicinske snimke

Dohvat medicinskih snimki (instanci DICOM) iz lokalnog sustava PACS putem infrastrukture sustava CEZIH ostvaruje se transakcijom Cross-Community WADO-RS Retrieve RAD-160 integracijskog profila IHE XC-WADO. Zahtjev se upućuje komponenti EHE Imaging Gateway, koja ga dalje prosljeđuje lokalnom sustavu PACS transakcijom WADO-RS Retrieve RAD-107. Za sustave PACS koji podržavaju samo WADO-URI isti mehanizam omogućuje dohvat tako da gateway prema sustavu PACS umjesto transakcije RAD-107 šalje WADO-URI zahtjev.

Preduvjet za dohvat snimke je prethodno dohvaćen Manifest. Manifest (resursi ImagingStudy i Endpoint) sadrži sve identifikatore i lokacijske podatke potrebne za pripremu zahtjeva RAD-160, prema sljedećem postupku:

  1. Pretražuje se i dohvaća Manifest transakcijama HR::ITI-67 i ITI-68.
  2. Iz resursa ImagingStudy čitaju se identifikatori studije, serije i instance.
  3. Iz resursa Endpoint čita se identifikator lokacije (RetrieveLocationUID) kojim gateway određuje s kojeg lokalnog sustava PACS dohvaća snimke.
  4. Oblikuje se zahtjev HTTP RAD-160 prema EHE Imaging Gatewayu te se dohvaća snimka.

diagram-2 Slika 2. Dohvat medicinske snimke

Podaci iz Manifesta potrebni za dohvat

Zahtjev RAD-160 upućuje se na mrežnu adresu komponente EHE Imaging Gateway, a ne na mrežnu adresu pojedinog sustava PACS. Iz dohvaćenog Manifesta izvlače se sljedeće vrijednosti:

Podatak Izvor u Manifestu (FHIR) Uloga u zahtjevu RAD-160
Study Instance UID ImagingStudy.identifier studies/{StudyInstanceUID}
Series Instance UID ImagingStudy.series.uid series/{SeriesInstanceUID}
SOP Instance UID ImagingStudy.series.instance.uid instances/{SOPInstanceUID}
RetrieveLocationUID Endpoint ekstenzija MadoRetrieveLocationUIDExtension RetrieveLocationUID/{…} u <location> dijelu i parametru upita; određuje s kojeg lokalnog sustava PACS gateway dohvaća snimke
homeCommunityId konfiguracija za hrvatsku zajednicu (dodjeljuje sustav CEZIH) homeCommunityId/{…} u <location> dijelu i parametru upita

Napomena: Konačna vrijednost homeCommunityId za hrvatsku zajednicu: <TBD> — bit će definirana i objavljena uz tehničku konfiguraciju okoline Podsustava 1.

Priprema zahtjeva XC-WADO RAD-160

Zahtjev RAD-160 „Get Instances Request" je transakcija Retrieve servisa DICOM Studies putem HTTP-a (WADO-RS). URI se sastoji od pet komponenti [14].

Zaglavlje Accept određuje format odgovora. Za izvorni binarni format DICOM koristi se:

Accept: multipart/related; type=application/dicom

Dohvat jedne instance DICOM

Dohvat jedne instance DICOM oblikuje se tako da <resource> sadrži sve tri razine — studiju, seriju i instancu:

GET https://<endpoint>/homeCommunityId/<homeCommunityId>/RetrieveLocationUID/<RetrieveLocationUID>/studies/<StudyInstanceUID>/series/<SeriesInstanceUID>/instances/<SOPInstanceUID>
Accept: multipart/related; type=application/dicom

Primjer (adresa je fiksna adresa EHE Imaging Gatewaya, a identifikatori studije/serije/instance i RetrieveLocationUID dolaze iz Manifesta):

GET https://ehe-imaging-gw.cezih.hr/homeCommunityId/<TBD-HR>/RetrieveLocationUID/213.323245.462.63.56/studies/1.2.392.200140.2.1.1.1.2.799008771.2076.1519721309.448/series/1.2.392.200140.2.1.1.1.3.799008771.2076.1519721309.449/instances/1.2.392.200140.2.1.1.1.4.799008771.2076.1519721320.457
Accept: multipart/related; type=application/dicom

Odgovor je tijelo tipa multipart/related koje sadrži traženu instancu DICOM u izvornom binarnom formatu. Komponenta EHE Imaging Gateway prosljeđuje zahtjev lokalnom sustavu PACS (transakcija RAD-107 / WADO-RS) te vraća snimku. Matična aplikacija korisnika mora slijediti preusmjeravanja HTTP (301/302/303/307).

Dohvat serije, studije i prikazanih (rendered) instanci

Isti oblik URI-ja koristi se i za ostale opsege dohvata (ako ih izvorišni PACS podržava); mijenja se samo <resource> dio, dok <protocol>, <endpoint>, <location> i obvezni query parametri (homeCommunityId, RetrieveLocationUID) ostaju nepromijenjeni. Format <resource> dijela za sve razine (studija, serija, instanca, okviri) definiran je specifikacijom WADO-RS Retrieve odnosno transakcijom RAD-107.

Otvaranje preglednika medicinskih snimki

Ovaj slučaj korištenja pretpostavlja već ostvarenu integraciju sa sustavom eKarton kako je opisano na drugom mjestu.

Nakon dohvaćanja radiološkog nalaza, vanjski sustav korisniku omogućuje pristup pripadnim medicinskim snimkama tako da ga dovede na prikaz tog nalaza u sustavu eKarton. Na stranici nalaza korisniku je dostupan link na medicinske snimke; klikom na taj link eKarton otvara preglednik EHE Medical Imaging Viewer s pripadajućom studijom DICOM.

Mehanizam je isti kao kod postojeće integracije matičnih aplikacija sa sustavom eKarton: vanjski sustav sam oblikuje duboki link (deep link) i otvara odgovarajuću sekciju eKartona — u ovom slučaju prikaz radiološkog nalaza.

Postupak je sljedeći:

  1. Vanjski sustav oblikuje eKarton deep-link na prikaz radiološkog nalaza (stranica nalaza, vidi Oblikovanje poziva) i otvara ga korisniku.
  2. eKarton prikazuje radiološki nalaz s dostupnim linkom na medicinske snimke.
  3. Korisnik klikne link na snimke, nakon čega eKarton otvara preglednik EHE Medical Imaging Viewer i prikazuje studiju DICOM.

diagram-3

Slika 3. Otvaranje preglednika medicinskih snimki

Oblikovanje poziva

Preglednik se otvara istom tehnikom deep-linka kojom se u sustavu eKarton otvara bilo koji specijalistički nalaz — ne uvodi se nikakav novi mehanizam. Vanjski sustav oblikuje poziv na stranicu nalaza eKartona, a korisnik s prikaza nalaza otvara medicinske snimke.

Stranica nalaza poziva se na adresi:

https://<host>/eKarton/MedicalRecordJoinedPlace?z=<base64 kodirani parametri>

Svi parametri grupiraju se u jedan niz ime=vrijednost parova (odvojenih s &), koji se potom kodira BASE64 koderom i pridružuje URL-u kao vrijednost parametra z.

Parametar Opis Obavezan
mbo matični broj pacijenta da
specialRemarkId jedinstveni identifikator nalaza (radiološkog nalaza) opcionalno
dataType izvor nalaza: HOSP (bolnica) ili SKZZ (primarna zaštita) opcionalno
institution_code matični broj ustanove da
activity_code šifra djelatnosti da
proff_code šifra zdravstvenog djelatnika (HZJZ, 7 znamenki) da

Primjer — niz parametara prije kodiranja (sintetički podaci):

mbo=384210696&specialRemarkId=cleo8r05d000008mg3xmv1kf1&dataType=HOSP&institution_code=12345678&activity_code=1120000&proff_code=1234567

Nakon BASE64 kodiranja i pridruživanja parametru z, poziv izgleda ovako:

https://<host>/eKarton/MedicalRecordJoinedPlace?z=bWJvPTM4NDIxMDY5NiZzcGVjaWFsUmVtYXJrSWQ9Y2xlbzhyMDVkMDAwMDA4bWczeG12MWtmMSZkYXRhVHlwZT1IT1NQJmluc3RpdHV0aW9uX2NvZGU9MTIzNDU2NzgmYWN0aXZpdHlfY29kZT0xMTIwMDAwJnByb2ZmX2NvZGU9MTIzNDU2Nw

Adresa <host> ovisi o okolini (certifikacijska odnosno produkcijska) i preuzima se iz tehničke konfiguracije okoline.

Sigurnost i autorizacija

Za slanje, zamjenu i storniranje kliničkih dokumenata potrebno je koristiti sljedeće sigurnosne mehanizme:

Korisničke uloge

Krajnji korisnik koji šalje, mijenja ili stornira dokument (HR::ITI-65) mora imati odgovarajuću ulogu. Za registraciju dokumenta u registru i repozitoriju dokumenata, zamjenu dokumenta novom verzijom i storniranje dokumenta [ITI-65] krajnji korisnik mora imati definiranu odgovarajuću ulogu. Uloge koje mogu registrirati dokumente se razlikuju ovisno o tipu dokumenta:

Za pretraživanje dokumenta u registru i repozitoriju dokumenata [ITI-67] i dohvat/pregled medcinskih snimki krajnji korisnik mora imati jednu od sljedećih uloga:

Pristup sustava CEZIH sustavu PACS

Mehanizmi kojima sustav PACS autenticira krajnje korisnike ili integracijske sustave ustanove (primjerice LDAP, Active Directory, OIDC, korisničko ime i zaporka ili pristup kroz RIS/BIS i HL7 sustave) odnose se na korisnike i lokalne sustave, a ne na pristup iz nacionalne razine. Pri dohvatu snimki CEZIH ne nastupa kao pojedini korisnik, nego kao integracijski sustav sa servisnim identitetom. Krajnji korisnik (građanin ili zdravstveni djelatnik) autentificira se u nacionalnom sustavu (NIAS, Portal zdravlja ili druga CEZIH usluga), a CEZIH potom pristupa sustavu PACS u njegovo ime kao autentificirani i autorizirani sustav.

Preporučeni model autentikacije sustava je mTLS klijentskim certifikatom (CEZIH koristi certifikat izdan od strane FINA RDC), a autorizacije dodjela namjenske servisne uloge putem mehanizma OAuth 2.0 Client Credentials. Sustav PACS ne mora održavati korisničke račune za krajnje korisnike izvan ustanove, već sustavu CEZIH kao integracijskom sustavu dodjeljuje pravo pristupa DICOMweb servisu WADO-RS, u skladu s načelom najmanjih privilegija (least privilege).

Ukoliko sustav PACS ne podržava navedene mehanizme, s CEZIH-om se usuglašava ekvivalentan model kontrole pristupa sustav-prema-sustavu koji pruža jednakovrijednu razinu autentikacije i autorizacije servisnog identiteta, uz zadržavanje načela najmanjih privilegija.

Usklađenost s europskim modelom (EHDS)

eRadiologija je oblikovana tako da istovremeno zadovoljava hrvatske (CEZIH) i europske (EHDS / MyHealth@EU) zahtjeve za razmjenu radioloških podataka. Dva hrvatska klinička dokumenta — Nalaz i Manifest — slijede podjelu definiranu u europskom logičkom informacijskom modelu za medicinske snimke (EHDS Logical Information Models) 19.

Europski model dijeli slikovni izvještaj na dva zasebna logička modela: Imaging Report Document (zaglavlje, tijelo i prilozi nalaza) i Imaging Study / Manifest (metapodaci o DICOM studiji — serije, instance i lokacije za dohvat snimki). Isti model objavljen je i kao dva zasebna FHIR implementacijska vodiča: Imaging Report te Imaging Manifest (koji se temelji na profilu IHE MADO 17). Hrvatski Nalaz i Manifest preslikavaju tu podjelu jedan na jedan.

Hrvatski dokument (CEZIH) Europski model (EHDS) 19 FHIR profil / IG
Nalaz (radiološki nalaz + PDF) EHDS Imaging Report (Header / Body / Attachments) HRDiagnosticReportEuImaging + HRCompositionEuImaging, temeljeni na EU Imaging Report R4
Manifest (metapodaci o snimkama + lokacija) EHDS Imaging Study / Manifest („Dicom Study Metadata") HRImagingStudyEuImaging + HRCompositionEuImaging, temeljeni na EU Imaging Manifest / IHE MADO

Time su zadovoljena oba sloja usklađenosti:

Napomena: Razdvajanje Nalaza i Manifesta u dva neovisno registrirana dokumenta (svaki s vlastitim identifikatorom i vlastitom HR::ITI-65 transakcijom) odgovara europskoj podjeli na Imaging Report i Imaging Study/Manifest te omogućuje da Manifest nastane i bude poslan neovisno o Nalazu (prije, poslije ili bez njega).

Reference

# Naziv Poveznica
1 Razmjena kliničkih dokumenata (krovni proces) poveznica
2 Slanje kliničkih dokumenata u CEZIH poveznica
3 Hrvatska ekstenzija IHE MHD profila poveznica
4 HL7 FHIR R4 poveznica
5 DICOM standard poveznica
6 DICOMweb poveznica
7 HR::ITI-65 (hrvatska prilagodba ITI-65) poveznica
8 HR::ITI-67 (hrvatska prilagodba ITI-67) poveznica
9 IHE MHD ITI-68 (Retrieve Document) poveznica
10 HR profil — HRDiagnosticReportEuImaging (Radiološki nalaz) poveznica
11 HR profil — HRCompositionEuImaging (zaglavlje kliničkog dokumenta) poveznica
12 HR profil — HRImagingStudyEuImaging (slikovna pretraga u Manifestu) poveznica
13 HR profil — HRImagingStudyEuImaging (Manifest) poveznica
14 IHE XC-WADO — Cross-Community Web-based Image Access (RAD-160), Rev 1.2 TI (2025-09-10) poveznica
15 IHE Radiology Technical Framework, Vol. 1, Rev 22.0 (2024-06-25) poveznica
16 DICOMweb — Retrieve (WADO-RS i WADO-URI) poveznica
17 IHE MADO — Mobile Access to Documents for Imaging poveznica
18 HL7 Europe Imaging R4 — Implementation Guide poveznica
19 EHDS Logical Information Models — Medical Images (xt-EHR) poveznica