Yleistä hakuoperaatioista

Hakuoperaatiot ovat FHIR RESTful määritysten mukaisia operaatioita (ks. tarkemmin FHIR RESTful API ja Extended Operations on the RESTful API). Hakuoperaatiot eivät tue kaikkia FHIR RESTful API ominaisuuksia, vain tässä soveltamisoppaassa kuvatut ominaisuudet ovat tuettuna.

FHIR versio

Operaatiot ja niissä käytettävät FHIR resurssit noudattavat HL7® FHIR:n ® R4-versiota (FHIR Release 4).

Tuettu formaatti

Operaatioissa tuetaan vain JSON formaattia (HTTP header sekä HTTP pyynnön body-osa ja vastauksen body-osa), FHIR standardin tukemia XML- tai RDF-muotoja ei tueta.

HTTP metodi

Hakuoperaatiot välitetään palvelulle HTTP pyyntönä (request) POST-metodilla.

Kanta-lääkityslistan operaatioiden pyynnöissä välitetään hakuparametrit Parameters (tarkentuu myöhemmin käytetäänkö tätä resurssia vai OperationDefinition resurssia) resurssissa ja vastauksessa palautetaan Bundle resurssi, joka sisältää lääkemääräyksen sisältäviä MedicationRequest resursseja, lääketoimituksen sisältäviä MedicationDispense resursseja sekä Provenance resursseja.

Yksi MedicationRequest resurssi sisältää yhden lääkemääräyksen tietoja, vastauksessa palautuu myös resurssista viittattuja Patient, Medication, PractitionerRole ja Basic resursseja.

Yksi MedicationDispense resurssi sisältää yhden lääketoimituksen tietoja, vastauksessa palautuu myös resurssista viittattuja Medication ja PractitionerRole resursseja.

Lääkkeen tiedot palautuvat Medication ja MedicationKnowledge resursseissa ja lääkkeen määrääjän, lopettajan, käsittelijän ja lääketoimituksen kirjaajan tiedot palautuvat PractitionerRole, Practitioner, Provenance, Organization resursseissa. Basic resursseissa palautuvat uusimipyynnön ja uusimispyynnön vastauksen tiedot sekä lukituksen ja eri varauksien tiedot, vastauksessa palautuu myös resursseista viitattuja Organization resursseja.

MedicationRequest resurssia käytetään myös lääkkeen lopettamismerkinnän esittämiseen ja siitä on profiloitu MedicationListDiscontinuationMedicationRequest -profiili. Yksi MedicationRequest (lopettamismerkintä) resurssi sisältää yhden lopettamismerkinnän tietoja, ja vastauksessa palautuu myös resurssista viitattuja Medication, Patient ja PractitionerRole resursseja.

Viittauksista on kerrottu enemmän Palautuvien resurssien viittaukset osiossa.