2.3.1. Pull notifikacije
Ova metoda preuzimanja notifikacija omogućava periodičko slanje zahtjeva za dohvat notifikacija.
Informacijski sustav šalje zahtjev za dohvat notifikacija za određenu zdravstvenu organizaciju putem za to predviđenog servisa. Ukoliko postoje notifikacije za tu zdravstvenu organizaciju CEZIH vraća jednu ili više notifikacija u odgovoru.
Primjer zahtjeva za dohvat notifikacija
GET https://cezih.hr/API/notificationService/getNotifications?recipient=http://fhir.cezih.hr/specifikacije/identifikatori/HZZO-sifra-zdravstvene-organizacije|1234567&recipient_type=organization&date_from=2022-07-17T00:00:00.000+02:00&date_to=2022-07-19T00:00:00.000+02:00
gdje je
recipient - identifikator primatelja notifikacije za kojeg se žele preuzeti notifikacije. Oblik identifikatora je [tip_identifikatora]|[identifikator] gdje je: tip_identifikatora (obavezno) - url koji definira tip identifikatora identifikator (obavezno) - identifikator
recipient_type - tip primatelja notifikacija koji može biti zdravstvena organizacija (organization), zdravstveni djelatnik (practitioner), medicinski uređaj ili informacijski sustav (device).
date_from (opcionalno) - specificira da se žele preuzeti notifikacije čije je vrijeme kreiranja novije od navedenog datuma. Ukoliko se ne navede ovaj parametar to znaći da će se preuzeti sve poruke koje postoje u CEZIH sustavu. Vrijeme čuvanja notifikacija je konfigurabilno no za sada će biti podešeno na 6 mjeseci. To znaći da se mogu preuzeti notifikacije kreirane do 6 mjeseci od trenutka slanja zahtjeva
date_to (opcionalno) - specificira da se žele preuzeti notifikacije čije je vrijeme kreiranja starije od navedenog datuma. Ukoliko se ne navede ovaj parametar to znaći da će se preuzeti sve notifikacije čije je vrijeme kreiranja starije od vremena slanja zahtjeva
Preporuča se da informacijski sustav sprema vremensku oznaku zadnje preuzete notifikacije. Time će mu biti omogućeno definiranje parametra date_from kako nebi preuzimao notifikacije koje je već preuzeo.
Primjer odgovora ukoliko postoje notifikacije za tu organizaciju
[
{
"uuid": "1fe95e79-e93f-42b0-a7de-aaad58d5cdbe",
"timestamp": "2022-09-15T08:12:03.123+02:00",
"resource": {
.....
},
"status": "ACTIVE",
"recipient": "http://fhir.cezih.hr/specifikacije/identifikatori/HZZO-sifra-zdravstvene-organizacije|1234567",
"recipient_type": "organization",
"intendedRecipients": {
"http://fhir.cezih.hr/specifikacije/identifikatori/HZJZ-broj-zdravstvenog-djelatnika|1234567",
"http://fhir.cezih.hr/specifikacije/identifikatori/HZJZ-broj-zdravstvenog-djelatnika|5555544"
}
},
{
"uuid": "9b4f43e2-d5a3-4ddf-859b-1f245cd12185",
"resource": {
.....
},
"status": "ACTIVE",
"organization": "http://fhir.cezih.hr/specifikacije/identifikatori/HZZO-sifra-zdravstvene-organizacije|1234567",
}
]
gdje je
uuid - jedinstveni identifikator notifikacije
timestamp - vremenska oznaka kreiranja notifikacije
resource - FHIR resurs na koji se odnosi notifikacija. Može biti bilo koji FHIR resurs ili Bundle. Task FHIR resurs se šalje za notifikacije o promjeni stanja procesa. DocumentReference resurs se šalje u slučaju promjena u registraciji, statusu i metapodatcima kliničkih dokumenata. Specifikacija task resursa koji se šalje se nalazi ovdje. Specifikacija DocumentReference resursa se nalazi u sklopu specifikacije nacionalne ekstenizije IHE MHD integracijskog profila.
status - status notifikacije ACTIVE - aktivna, CLOSED - zatvorena
recipient - identifikator primatelja notifikacije. Ovisno o tipu primatelja (recepient_type) može biti zdravstvena organizacija, zdravstveni djelatnik, medicinski uređaj ili informacijski sustav.
recipient_type - tip primatelja notifikacije. Može biti zdravstvena organizacija (organization), zdravstveni djelatnik (practitioner), medicinski uređaj ili informacijski sustav (device)
intendedRecipients - identifikatori osoba unutar zdravstvene organizacije kojima je namijenjena notifikacija
Primjer odgovora u slučaju greške u obradi zahtjeva:
{
"error":{
"errorCode": {
"system": "http://ent.hr/fhir/CodeSystem/message-error-type",
"code": "NOT-1111"
},
"errorDescription": "Nepoznata organizacija"
}
}
Ova specifikacija definira dvije operacije "getNotifications" i changeNotificationState".