Rövid válasz: a terminológiai szerver egy FHIR szerver, amely a kódokra specializálódott. Tárolja a CodeSystemeket (SNOMED CT, LOINC, ICD-10, UCUM, a HL7 saját táblázatai), a ValueSeteket (nevesített részhalmazok egy adott célra: életjel kódok, allergén anyagok) és a ConceptMapeket (fordítások rendszerek között), és szabványos műveleteken keresztül válaszol: $lookup (mit jelent ez a kód?), $validate-code (megengedett itt ez a kód?), $expand (listázza a kódokat ebben a értékkészletben, opcionálisan szűrve szöveg alapján), $translate (mi ez a kód abban a másik rendszerben?) és $subsumes (az A egyfajta B?). Az alkalmazások ezt hívják a terminológiák másolatait szállító rendszerek helyett, amelyek nagyok, licenckötelesek és évente többször frissülnek.
Az erőforrások
A FHIR terminológiai szerver három erőforrással dolgozik. A CodeSystem kanonikus URL és verzió alapján deklarál egy kódrendszert, annak fogalmaival vagy egy megjegyzéssel, hogy a tartalom máshol található; a ValueSet egy céltudatos kód-alhalmazt határoz meg összeállítási szabályokon és egy opcionális, kiszámított bővítésen keresztül; a ConceptMap rendszerek közötti forrás-cél kapcsolatokat rögzít, minden megfeleltetéshez egy ekvivalenciával.
- A CodeSystem a kanonikus URL (
http://snomed.info/sct,http://loinc.org,http://hl7.org/fhir/sid/icd-10), a verzió és vagy a fogalmak, vagy egy kijelentés alapján deklarálja a rendszert, hogy a tartalom máshol található (content: not-presentlicencköteles rendszerek esetén). - A ValueSet rendelkezik egy
compose(szabályok: az összes kód egy rendszerből, specifikus kódok, vagy egy szűrő, mint például a 404684003 Klinikai lelet leszármazottai) és, amikor kiszámításra kerül, egyexpansion(a tényleges lista). A profilokban lévő kötések értékkészletekre mutatnak; lásd FHIR profilok és kiterjesztések. - A ConceptMap forrás → cél kapcsolatokat tartalmaz egy ekvivalenciával (
equivalent,wider,narrower,inexact,unmatched) és opcionális függőségekkel, olyan leképezésekhez, mint a SNOMED CT-től az ICD-10-ig, vagy egy laboratórium helyi kódjaitól a LOINC-ig.
A műveletek, kérésekkel
A FHIR terminológiai szerver öt szabványos műveletre válaszol: a $lookup egy kód jelentését adja vissza, a $validate-code ellenőrzi, hogy egy kód egy rendszerhez vagy értékkészlethez tartozik-e, az $expand felsorolja az értékhalmazban lévő kódokat, opcionálisan szöveggel szűrve, a $translate egy ConceptMap-en keresztül egy kódot egy másik rendszerre konvertál, és a $subsumes teszteli, hogy egy fogalom egy másik fogalom fajtája-e.
$lookup: egy kód részletei.
GET /CodeSystem/$lookup?system=http://loinc.org&code=4548-4
Egy Parameters erőforrást ad vissza a display ("Hemoglobin A1c/Hemoglobin.total in Blood"), más nyelveken szereplő megnevezésekkel és tulajdonságokkal (LOINC esetén a hat tengely; SNOMED CT esetén a szülők és a meghatározó kapcsolatok).
$validate-code: benne van-e a kód a rendszerben, vagy az értékkészletben?
GET /ValueSet/$validate-code?url=http://hl7.org/fhir/ValueSet/observation-vitalsignresult&system=http://loinc.org&code=8480-6
result: true értéket ad vissza a kijelzővel, vagy false értéket egy üzenettel. Az erőforrásokat érvényesítő szerverek ezt minden kötött elemhez meghívják.
$expand: az értékkészlet kódjai, szöveges szűréssel a keresőmezők számára.
GET /ValueSet/$expand?url=http://hl7.org/fhir/ValueSet/condition-code&filter=diabetes&count=20
A ValueSet-et adja vissza egy expansion.contains listával: kód, rendszer, kijelző. Így működik az EHR diagnózis keresése a SNOMED CT ellenében anélkül, hogy 360 000 fogalmat helyben tárolna.
$translate: rendszerhatáron átkelés.
GET /ConceptMap/$translate?url=https://lab.example.org/ConceptMap/local-to-loinc&system=https://lab.example.org/codes&code=GLU&targetsystem=http://loinc.org
A találatokat adja vissza az ekvivalenciájukkal. Ugyanaz a művelet szolgálja a SNOMED CT → ICD-10 leképezéseket, ahol a szerver tárolja őket.
$subsumes: hierarchia kérdések.
GET /CodeSystem/$subsumes?system=http://snomed.info/sct&codeA=73211009&codeB=44054006
Válaszol a subsumes (a cukorbetegség az 2-es típusú cukorbetegség őse), subsumed-by, equivalent vagy not-subsumed kérdésekre. A döntéstámogatás arra használja, hogy megkérdezze: ez az állapot valamilyen cukorbetegség-e? anélkül, hogy minden altípust felsorolna.
A válaszok Parameters erőforrások: nevesített részek listája, nem egy egyszerű objektum, ami meglepi az első alkalommal hívókat.
Szerverek, amelyekkel találkozni fog
A gyakorlatban leggyakrabban előforduló terminológiai szerverek: a tx.fhir.org, az HL7 nyilvános referenciaszervere, amelyet a validátoruk használ; az Ontoserver a CSIRO-tól, egy kereskedelmi szerver, amely több nemzeti program mögött áll; a Snowstorm a SNOMED International-tól, nyílt forráskódú és SNOMED CT natív; általános FHIR szerverek, mint a HAPI FHIR és a Firely Server terminológiai műveletekkel; valamint az egészségügyi ügynökségek által működtetett nemzeti szerverek.
| Szerver | Ki | Megjegyzések |
|---|---|---|
| tx.fhir.org | HL7 (referencia) | Nyilvános, a HL7 érvényesítő és IG kiadó használja; LOINC, SNOMED CT (ahol licencköteles), HL7 táblázatok, UCUM. Nem gyártási forgalomra |
| Ontoserver | CSIRO (Ausztrália) | Kereskedelmi; nemzeti programok használják (Ausztrália, Egyesült Királyság NHS Ontology Server, Hollandia, Belgium); teljes SNOMED CT ECL lekérdezésekkel |
| Snowstorm | SNOMED International | Nyílt forráskódú; SNOMED CT natív FHIR API-val; az hivatalos böngészőt működteti |
| HAPI FHIR, Firely Server, Microsoft/Google/AWS FHIR szolgáltatások | Szállítók | Általános FHIR szerverek terminológiai műveletekkel; töltse be a kódrendszereket maga |
| Nemzeti szerverek | Egészségügyi minisztériumok és ügynökségek | Gyakran Ontoserver vagy Snowstorm a nemzeti kiadással és helyi értékkészletekkel |
A tartalom a nehéz rész: a SNOMED CT licencet igényel a tagországokon kívül, a LOINC elfogadja a feltételeit, az ICD-10 nemzeti változatai saját terjesztéssel rendelkeznek. Egy szerver megadja a műveleteket; a tartalmat továbbra is legálisan kell beszereznie és betöltenie.
Hogyan használják az alkalmazások
Az alkalmazások terminológiai szervert használnak a kódok és egységek érvényesítésére íráskor, a keresőmezők $expand művelettel történő működtetésére szövegszűrővel és értékkészlettel, a hivatalos nevek $lookup művelettel történő megjelenítésére, a helyi kódok LOINC vagy SNOMED CT-ről ICD-10-re történő $translate művelettel történő megfeleltetésére, valamint a hierarchiák feletti érveléshez a $subsumes és a SNOMED CT Expression Constraint Language segítségével.
- Validálás íráskor: utasítson el egy Observation-t, amelynek LOINC kódja nem létezik, vagy a mértékegysége nem UCUM, egy üzenettel, amely megnevezi a problémát.
- Keresőmezők:
$expandfilterparaméterrel diagnózis, eljárás és gyógyszer kiválasztókhoz, egy értékkészlet hatókörében, így a klinikusok csak releváns fogalmakat látnak. - Megjelenítés:
$lookupa hivatalos név és a fordítások megjelenítéséhez ahelyett, hogy elavuló kijelző sztringeket tárolna. - Leképezés:
$translatea helyi laboratóriumi kódok LOINC-ra történő átalakításához importáláskor (hogyan kell leképezni a helyi labor kódokat a LOINC-ra) vagy SNOMED CT-ből ICD-10-re jelentéshez (SNOMED CT vs ICD-10). - Következtetés:
$subsumesés a SNOMED Expression Constraint Language (ECL, az Ontoserver és a Snowstorm által támogatott$expandszűrőkön keresztül) a kohorszok és szabályok hierarchia alapján történő meghatározásához.
Gyorsítótárazzon agresszíven (a terminológia évente kétszer változik, nem naponta kétszer), rögzítse a verziókat a gyártásban, és tekintse a szerver kimaradását degradált érvényesítésnek, nem pedig okként minden írás elutasítására.
Az Anpherosban
Az Anpheros Platform érvényesíti az észrevételeknél elfogadott LOINC kódokat és UCUM mértékegységeket, valamint a gyógyszerek ATC kódjait a szállított terminológia (egy LOINC részhalmaz és a WHO ATC index) ellenében, és dokumentálja a terminológiai API-ját a fejlesztői weboldalon. A teljes SNOMED CT vagy ICD-10 böngészéshez a hivatalos böngészőkre mutat, ahelyett, hogy licencelt tartalmat terjesztene újra.
Kapcsolódó oldalak
- FHIR profilok és kiterjesztések magyarázata
- Hogyan kell leképezni a helyi labor kódokat a LOINC-ra
- SNOMED CT vs ICD-10
- CodeableConcept és Coding a FHIR-ben
- UCUM mértékegységek laboreredményekben
- Orvosi terminológiai API (fejlesztői weboldal)
Források
- HL7 FHIR R4: Terminológiai szerver
- HL7 FHIR R4: ValueSet $expand
- HL7 FHIR R4: ConceptMap $translate
- HL7 FHIR R4: CodeSystem $lookup
- HL7 terminológiai szerver tx.fhir.org
- Snowstorm (SNOMED International, GitHub)
- Ontoserver (CSIRO)
Gyakori kérdések
Szükségem van terminológiai szerverre a FHIR használatához?
Nem, egy kis rendszerhez, fix kódszettel. Amint nagy rendszerekből származó kódokat érvényesít, klinikai keresést kínál, vagy rendszerek között fordít, egy terminológiai szerver megkíméli Önt a terminológiák szállításától és frissítésétől.
Használhatom a tx.fhir.org-ot gyártásban?
Nem. Ez az HL7 referenc szervere az érvényesítő eszközök és tesztelés céljából, szolgáltatási garanciák nélkül és bizonyos tartalmakra vonatkozó licenckorlátozásokkal. Futtasson sajátot, vagy használjon nemzeti vagy kereskedelmi szervert.
Mi az az ECL?
A SNOMED CT Expression Constraint Language, egy lekérdezési szintaxis fogalomhalmazokhoz (például << 73211009 a cukorbetegség és minden altípusa esetén). Az ezt támogató szerverek elfogadják az ECL-t a ValueSet szűrőkben és a $expand műveletben.
Honnan tudom, hogy egy szerver melyik SNOMED CT verzióval rendelkezik?
Kérdezze meg a CodeSystem-t (GET /CodeSystem?url=http://snomed.info/sct) és olvassa el a verzióját, amely kódolja a kiadást és a kiadás dátumát (például http://snomed.info/sct/900000000000207008/version/20260301). Rögzítse a kéréseiben, amikor az eredményeknek reprodukálhatónak kell lenniük.
Próbálja ki ingyen a sandboxban
Az első FHIR-hívás 5 perc alatt. Egy HL7 FHIR R4 API, amely tartalmazza a beteg beleegyezését: próbáld ki a sandboxban, majd csatlakoztasd saját alkalmazásodat vagy klinikai rendszeredet.
Ingyenes · 30 szintetikus beteg · kártya nélkül
Az Anpheros egy olyan egészségügyi nyilvántartást épít, amelyet a beteg irányít, és megoszthat bármelyik klinikával, egy EU-ban működő HL7 FHIR R4 platformon. Ezek az útmutatók segítenek megérteni és rendszerezni az egészségügyi adataidat; nem helyettesítik az orvosodat.
Tudj meg többet az Anpherosról →