Terminoloogia kasutamine

Terminoloogiale viitamine juurutusjuhendites

TEHIKu FHIR juurutusjuhendites (edaspidi IG ehk implementation guide) reeglina loendeid, koodisüsteeme ning vastendusi ei avaldata.

Koodisüsteemid, loendid, vastendused luuakse andmekirjelduskeskkonnas ja avaldatakse TEHIKu terminoloogiaserveris. Terminoloogiaserver on osa HL7 FHIR terminoloogia ökosüsteemist, mis võimaldab seda muuhulgas kasutada IG Publisheri tarkvara automaatsetes workflowdes.

Kui IG-s on andmeelement seotud kindla loendiga, nimetatakse vastav loend .binding elemendis loendi URL-ina. IG Publisher tarkvara abil IG koostamisel tehakse päring TEHIKu terminoloogiaserverisse ning loendi sisu kasutatakse näidisandmete valideerimisel ning loendi renderdamise info saamiseks. Kui loendil on täidetud extension “web-source”, kasutab IG seal toodud URLi loendi lingina ning kasutaja viiakse loendi AKK vaatesse. Kui loendil vastav extension puudub, kasutatakse FHIR endpointi URLi ning kasutaja viiakse loendi Ontoserveri vaatesse.

IGs kasutusel olevad koodisüsteemid ja vastendused ei ole reeglina IG-s kuvatud ning nende nähtavale toomiseks tuleks lisada lingid käsitsi. Koodisüsteeme, isegi kui neid ei ole IG-s mainitud, kasutatakse näidisandmete kuvamiseks. Loendite expansion toimub TEHIKu terminoloogiaserveris.

Test-terminoloogiaserveri kasutamine FHIR IG autobuildiga ei ole võimalik. Vajadusel saab test-terminoloogiaserveri märkida eelistatud terminoloogiaserveriks lokaalses masinas, eeldusel, et masin on võimeline test-terminoloogiaserverisse päringuid tegema (VPN-piirang).

Terminoloogia migreerimine teenuste FHIRile üleminekul

  • Vanade andmete kuvamisel eelistatakse kuvada andmed selle kodeeringuga, milles nad on originaalis sisestatud.
  • Kui vanad andmed võetakse kasutusele uues sõnumis, on vajalik tagada andmete vastavus hetkel kehtivatele valideerimisnõuetele (st, kehtetud koodid on tarvis asendada kehtivate vastetega).
  • Kui kasutusel on sama koodisüsteem, kuid erinev versioon, on üleminek reeglina võimalik, vaadates kehtetu mõiste property’t replacedByCode. Kui ka see on kehtetu, tuleks liikuda ahelat pidi kehtiva koodini. Property replacedByCode viitab, et asendav mõiste on samas koodisüsteemis.
  • Kui terve koodisüsteem on kasutuselt eemaldatud ning see on täiel määral asendatud teise sama kasutusalaga koodisüsteemiga, siis tuleks jälgida kehtetus koodisüsteemis koodidele lisatud propertyt “replacedByCoding”, mille väärtuseks on samatähenduslik mõiste uues koodisüsteemis. Property replacedByCoding viitab, et asendav mõiste on teises koodisüsteemis. Teatud aja jooksul võib juhtuda, et asendav mõiste teises koodisüsteemis on samuti muutunud kehtetuks - sel juhul tuleks leida asendav mõiste eelmises punktis kirjeldatud loogikat järgides.
  • ConceptMapi olemasolu tagab $translate operatsiooni töötamise terminoloogiaserveris. ConceptMap peab olema selles suunas, mis pidi on vaja andmeid teisendada (sh vajadusel eraldi ConceptMapid mõlema suuna jaoks). ConceptMap on parim lahendus juhtudel, kui vastendus kehtib pigem loendite kui koodisüsteemide vahel või on tarvis liikuda uuelt koodisüsteemilt vanale.
Viimati uuendatud 12.03.2026