eLab posistemės integracijos dokumentacija
0.3.36 - versija Lithuania flag

eLab posistemės integracijos dokumentacija - Local Development build (v0.3.36) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Nurodymai

Šiame puslapyje yra pateikiami ESBPI IS laboratorinių tyrimų posistemės (ELAB posistemė) HL7 FHIR R5 resursų, skirtų duomenų mainams su HIS/ LIS sistemomis, naudojimo nurodymai. Išsamesnė informacija apie kiekvieną naudojamą FHIR resursą ir jų profilius yra pateikiama resursų ir profilių puslapyje.

Veiklos procesai

Duomenų apsikeitimo modelis

Duomenu mainai

  • Ėminio informacija gali būti sukurta tiek SPĮ, tiek laboratorijoje.

Techniniai realizacijos sprendimai

ELAB posistemė resursų identifikatorius generuoja automatiškai uuid formatu.
Resursų susiejimui vienoje transakcijoje naudojami laikini vidiniai identifikatoriai (urn:uuid).

ELAB posistemės FHIR serverio autentifikacija

ELAB posistemės FHIR serveris naudoja OAuth 1.0 protokolą užklausų autentifikavimui. Plačiau žr. Transakcijos API.

Laiko zonų apdorojimas

FHIR resursuose visi laikų laukai turi būti pateikiami su laiko zonos identifikatoriumi.
Į API pateikiami resursai gali turėti bet kokią laiko zoną.
Grąžinant duomenis iš FHIR serverio, laiko reikšmė pateikiama su UTC laiko zona. Laiko konvertavimas į vietinę laiko zoną atliekamas duomenų gavėjo pusėje.
Atvaizduojant duomenis naudotojams ar generuojant PDF, laikas konvertuojamas į Lietuvos laiko zoną.

E200/a tyrimų užsakymo forma

Apžvalga

E200/a tyrimų užsakymo forma naudojama laboratorinių tyrimų užsakymui, ėminių registravimui ir tyrimų rezultatų pateikimui ELAB posistemėje. Forma susideda iš trijų dalių:

  • E200-U – tyrimo užsakymas,
  • E200-R – ėminio registravimas,
  • E200-Ats – tyrimo atsakymo pateikimas.

Vienoje transakcijoje galima pateikti vieną, dvi arba visas tris formos dalis kartu, laikantis jų pateikimo eiliškumo. Negalima pateikti:

  • E200-R, jei prieš tai nėra pateikta E200-U,
  • E200-Ats, jei prieš tai nėra pateikta E200-U ir E200-R.

Galimi pateikimo variantai:

  • tik E200-U,
  • E200-U ir E200-R,
  • E200-U, E200-R ir E200-Ats,
  • tik E200-R, jei prieš tai buvo pateikta E200-U,
  • E200-R ir E200-Ats, jei prieš tai buvo pateikta E200-U,
  • tik E200-Ats, jei prieš tai buvo pateiktos E200-U ir E200-R.

E200/a dalių pateikimo tvarka aprašyta: Integraciniai scenarijai.
Naudojami FHIR resursai ir jų struktūra aprašyti: Resursai ir profiliai.
Duomenų pateikimo per FHIR API taisyklės aprašytos: Transakcijos API.

Naudojamos tyrimų, ėminių ir panelių nomenklatūros

ELAB posistemėje laboratorinių tyrimų, ėminių ir metodų kodavimui naudojamos Lietuvos medicinos bibliotekos (LMB) nomenklatūros. Naudojamos kodų sistemos aprašytos skyriuje Nomenklatūros ir klasifikatoriai.

FHIR Transackcija

Kiekvieną E200/a dalį paprastai sudaro keli tarpusavyje susiję FHIR resursai, todėl jų pateikimui rekomenduojama naudoti FHIR transakciją. Mažoms pavienių resursų kūrimo ar atnaujinimo operacijoms gali būti naudojama ir FHIR resursų API.
Plačiau:

Apsilankymas (Encounter)

Encounter resursas ELAB posistemėje nėra saugomas. Jis kuriamas ir saugomas ESPBI IS.
Resursų susiejimui naudojamas Encounter ESPBI identifikatorius:

  • sistema: http://esveikata.lt/Identifier/Encounter/ESPBI
  • reikšmė: Encounter resurso identifikatorius ESPBI IS.

Encounter identifikatorius naudojamas susiejant:

  • ServiceRequest,
  • DiagnosticReport,
  • Composition resursus.

Plačiau žr. ESPBI specifikacijoje.

Resursų keitimo/šalinimo veiklos duomenys (Provenance)

Provenance resursas naudojamas informacijai apie atliktą veiksmą ir jo vykdytoją saugoti.
Transakcijos metu Provenance turi būti susietas su visais kuriamais, keičiamais arba šalinamais resursais. Taip pat turi būti nurodytas veiksmą atlikęs specialistas ir vykdomos veiklos tipas.

Plačiau:

Specialisto įdarbinimas įstaigoje

Specialistas ir jo įdarbinimas nurodomi naudojant ESPBI identifikatorius, pateikiamus reference-practitionerEspbiId ir reference-organizationEspbiId plėtiniuose.
Plačiau:

E200-U užsakymas

E200-U nėra atskiras FHIR resursas. Jį sudaro vienas ar daugiau ServiceRequest resursų, susietų bendru užsakymo identifikatoriumi – Requisition.

Plačiau:

Requisition

Visi vienam užsakymui priklausantys ServiceRequest resursai turi turėti tą pačią Requisition reikšmę.
Requisition reikšmė turi būti unikali kiekvienam užsakymui ir generuojama kliento sistemoje uuid formatu.

E200-R ėminio registracija

E200-R dalį sudaro vienas ar daugiau Specimen resursų, registruojančių ėminius, paimtus E200-U užsakymui įvykdyti.
Kiekvienas Specimen turi būti susietas su vienu arba keliais ServiceRequest resursais. Susiejimas nurodomas Specimen.request lauke.

Plačiau:

Ėminį paėmusi įstaiga

Specimen.extension:specimen-performer lauke nurodoma įstaiga, kuri tirs paimtą ėminį. Plačiau:

E200-Ats rezultatų protokolas

E200-Ats dalį sudaro DiagnosticReport resursas ir bent viena panelė arba analitė (Observation). Taip pat kartu galima siųsti Composition resursą.
E200-Ats transakcijų pavyzdžiai pateikti skyriuje E200-Ats pavyzdžiai.

Tyrimo atsakymo protokolas (DiagnosticReport)

DiagnosticReport naudojamas tyrimo atsakymo protokolui pateikti.

Plačiau:

Panelė/analitė (Observation)

Tyrimų rezultatams pateikti naudojami Observation resursai.
Naudojami du Observation profiliai:

  • analitės profilis (lt-observation);
  • panelės profilis (lt-observation-panel).

Plačiau:

E200/a tyrimo protokolas (Composition)

Composition resursas apjungia E200-U, E200-R ir E200-Ats duomenis į vieną dokumentą.
Composition gali būti kuriama tik tada, kai egzistuoja visos trys E200/a dalys.

Plačiau:

FHIR resursų siejimas tarpusavyje

Resursų, kuriuos galima identifikuoti naudojantis ESPBI identifikatoriais, sąrašas: Patient, Practitioner, Organization.
Konkretūs naudojami laukai, identifikatoriai ir plėtiniai aprašyti atitinkamuose profiliuose ir pavyzdžiuose, žr. Resursai ir profiliai.

E200/a tyrimo protokolo PDF

Dokumento pasirašymo ir PDF generavimo taisyklės aprašytos: Dokumentų pasirašymas.