Medication Scheme Implementation Guide
1.0.0 - trial-use Estonia flag

Medication Scheme Implementation Guide, published by TEHIK. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/TEHIK-EE/ig-ee-medication-scheme/ and changes regularly. See the Directory of published versions

OperationDefinition: Return confirmed medication scheme printout

Official URL: https://fhir.ee/OperationDefinition/MedicationStatement-printout Version: 1.0.0
Standards status: Trial-use Maturity Level: 1 Computable Name: Confirmed Medication Scheme printout

The printout operation is used to get current confirmed medication scheme as an html document for printing.

URL: [base]/MedicationStatement/$printout

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INsubjecttype1..1Patient

Patsiendi MPI viide - kelle ravimiskeemi printvaadet päritakse

INlanguage0..1string

Keel milles soovitakse ravimiskeemi kuvada. Nt 'et' või 'en' vaikimisi väärtus on 'et'.

OUTreturn1..1Binary

Operatsiooni väljundiks on alati Binary, mille sisuks on UTF-8 formaadis base64 kodeeritud html dokument.

Notes:

Ravimiskeemi printvaate pärimine

Ravimiskeemi printvaate operatsioon tagastab kasutajale html renderduse kinnitatud ravimiskeemist.

URL: GET [base]/MedicationStatement/$printout?subject=Patient/12345&language=et

Päring töötab valiidse Charon v2 tokeniga. Päringu parameetris olev "subject" ja charon tokeni päringusse pandud "patient" peavad olema samad. Kohustuslik header "x-context-id" - kasutatakse audit logikirje tekitamisel. Sobib näiteks sesssiooni ID.

DEV näidispäring

curl -k -L 'https://10.0.13.90/r1/ee-dev/GOV/70009770/uptis/fis-service/fhir/MedicationStatement/$printout?subject=Patient/7231&language=et' \
-H 'X-Road-Client: ee-dev/GOV/70009770/tjt' \
-H 'x-context-id: my-context' \
-H 'Authorization: Bearer xxx'

Reeglid

Patsiendi ravimiskeemi printvaate pärimiseks mõeldud operatsioon koosneb järgnevatest tegevusest:

Kinnitatud ravimiskeemi pärimine

Siin küsitakse täpselt sama ravimiskeem, mida tagastatakse ka kinnitatud ravimiskeemi päringus

Ravimiskeemi printvaate loomine

Kinnitatud ravimiskeemi andmed muundatakse printvaate jaoks sobilikule kujule ja jaotatakse kolmeks:

  1. Vajadusel ravimid (ravikuuri tüüp 'v')
  2. Regulaarsed ravimid (ravikuuri tüüp 'p')
  3. Ajutised ravimid (ravikuuri tüüp ''f' ja ravim väljastatud viimase 180 päeva jooksul, konfigureeritav läbi configmapi TEMPORARY_MEDICATION_PERIOD_DAYS env väärtuse) Kasutades thymeleafi template'i, pannakse kokku ravimiskeemi dokument, mis on ehitatud Terviseportaali nõuete kohaselt patsiendile andmiseks.

Ravimiskeemi tagastamine

Saadud html dokument kodeeritakse base64 kodeeringuga UTF-8 formaadis ning tagastatakse kasutajale. Edasised toimingud dokumendi printimiseks on kasutajate teha.

Soovituslikult kuvada html dokument implementeeriva rakenduse sees - hetkel ei tagastata fondi infot html-ga ning "Roboto" font on vaja implementeerival rakendusel ise kaasa anda.

Näited

Näidispäring patsiendi viitega

Ravimiskeemi printvaate pärimine:

GET /MedicationStatement/$printout?subject=Patient/140959&language=et

Näidisvastus

Ravimiskeemi printvaate näidisvastus:

{
  	"resourceType": "Binary",
  	"contentType": "text/html",
	"data": "Base64EncodedString"
}

Printvaate näidis