FHIR Patient erőforrás magyarázata: azonosítók, nevek, demográfiai adatok és kapcsolatok, érvényes példával

Rövid válasz: A Patient az a FHIR erőforrás, amely az ellátást igénybe vevő személyt írja le: adminisztratív szempontból, hogy ki ő, nem pedig azt, hogy mi a baja. Tartalmaz azonosítókat (orvosi nyilvántartási számok, nemzeti azonosítók), neveket, telekommunikációs elérhetőségeket, adminisztratív nemet, születési dátumot, címet, családi állapotot, kommunikációs (nyelvi) információkat, egy háziorvost, egy gondozó szervezetet és hivatkozásokat más, ugyanazon személyhez tartozó Patient rekordokra. Minden Observation, Condition, Encounter vagy MedicationStatement erőforrás a subject vagy patient mezőn keresztül hivatkozik rá. A klinikai tények soha nem a Patient erőforrásban élnek; azokban az erőforrásokban élnek, amelyek rá hivatkoznak.

Érvényes FHIR R4 példa

Egy érvényes FHIR R4 beteg (Patient) erőforrásnak csak a resourceType mezőre van szüksége, de a gyakorlatban legalább egy azonosítót tartalmaz rendszerrel (system) és értékkel (value), egy nevet vezetéknévvel (family) és keresztnévvel (given), nemi beállítást (administrative gender) és születési dátumot. Az alábbi példa az IPS betegprofilra is hivatkozik a meta.profile mezőben, és hozzáadja a kapcsolattartási adatokat, lakcímet, preferált nyelvet, háziorvost és a kezelő szervezetet.

{
  "resourceType": "Patient",
  "id": "example",
  "meta": {"profile": ["http://hl7.org/fhir/uv/ips/StructureDefinition/Patient-uv-ips"]},
  "identifier": [{
    "use": "usual",
    "type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v2-0203", "code": "MR"}]},
    "system": "https://hospital.example.org/mrn",
    "value": "MRN-00012345"
  }],
  "active": true,
  "name": [{"use": "official", "family": "Doe", "given": ["Jane", "Marie"], "prefix": ["Ms"]}],
  "telecom": [{"system": "email", "value": "[email protected]", "use": "home"}],
  "gender": "female",
  "birthDate": "1980-05-23",
  "address": [{"use": "home", "line": ["12 High Street"], "city": "Leeds", "postalCode": "LS1 4AB", "country": "GB"}],
  "communication": [{"language": {"coding": [{"system": "urn:ietf:bcp:47", "code": "en-GB"}]}, "preferred": true}],
  "generalPractitioner": [{"reference": "Practitioner/gp-42"}],
  "managingOrganization": {"reference": "Organization/hospital"}
}

Az elemek, amelyek számítanak

Az interoperabilitás szempontjából a legfontosabb beteg (Patient) mezők az azonosító (identifier, rendszerrel, értékkel és típussal), a név (name, használattal, vezetéknévvel és keresztnévvel), a nemi beállítás (administrative gender), a születési dátum (birthDate), az elhunyt státusz (deceased), az aktív státusz (active), a kapcsolattartási adatok (contact) és a kapcsolat (link). Az azonosítók és a nevek rendszerek közötti egyezést segítik, a nemi beállítás és a születési dátum adminisztratív tények, a kapcsolat (link) pedig azt rögzíti, hogyan kapcsolt össze egy fő betegnyilvántartó rendszer egy személy több rekordját.

• identifier egy lista, amelynek mindegyike tartalmaz egy system-et (ki adta ki) és egy value-t. Az type megmondja, hogy milyen típusú: MR orvosi nyilvántartási szám, NI nemzeti azonosító, PPN útlevél, SS társadalombiztosítási szám, az HL7 0203 táblázatából. Egy betegnek általában több azonosítója van; egy kórház MRN-je és egy nemzeti azonosító is érvényes, és a rendszerek ezek alapján egyeznek.
• name szintén egy lista, amely tartalmaz egy use-t: official, usual, nickname, maiden, old. A family egyetlen sztring; a given egy lista. A szkriptek, átírások és a névsorrend az ország implementációs útmutatójára van bízva.
• gender az adminisztratív nem, négy értékkel: male, female, other, unknown. Ez az, amit a rekord tartalmaz, és az egyezéshez és az űrlapokhoz használják. A klinikai nem, a nemi identitás és a névmások az extender-ekben vagy az Observations-ben szerepelnek, amelyeket a FHIR R5 és a Gender Harmony projekt formalizált.
• birthDate egy dátum, opcionálisan csak év, vagy év-hónap, ha a pontos dátum ismeretlen. A patient-birthTime extender hozzáadja az időt az újszülöttekhez.
• deceased[x] egy logikai érték vagy egy dátum-idő. Az active false érték azt jelöli, hogy egy rekordot már nem szabad használni (duplikált, áthelyezett), anélkül, hogy törölnék.
• contact olyan személyek listája, akikkel fel kell venni a kapcsolatot (közeli hozzátartozó, gyám), kapcsolati kóddal; ezek nem maguk Patient erőforrások. Egy szülő, aki szintén beteg, egy RelatedPerson, amely mindkettőre hivatkozik.
• link olyan Patient rekordokat kapcsol össze, amelyek ugyanazt a személyt jelentik: replaced-by és replaces egy egyesítés után, refer a hiteles rekordra, seealso egy másik rendszerben lévő rekordra. Így fejezi ki a master patient index a döntéseit FHIR-ben; lásd Betegegyeztetés.

Amit a nemzeti profilok hozzáadnak

A nemzeti és nemzetközi FHIR profilok a lazán definiált alap beteg (Patient) erőforrást használhatóvá teszik azáltal, hogy bizonyos mezőket kötelezővé tesznek, és országspecifikus kiegészítéseket (extensions) adnak hozzá. Az US Core profil megköveteli az azonosítót, a nevet és a nemi beállítást, valamint kiegészíti a rasszra, etnikumra és születési nemre vonatkozó információkkal; az IPS betegprofil megköveteli a nevet, a nemi beállítást és a születési dátumot; a nemzeti profilok pedig meghatározzák az azonosító rendszereket és a címformátumokat.

Az alap erőforrás szinte mindent opcionálissá tesz. A profilok teszik használhatóvá:

Egy határon átutazó rekordnak meg kell felelnie mindkét oldalon a profilnak, ami a gyakorlatban azt jelenti, hogy magában foglalja mind a nemzeti azonosítót, mind egy MRN-t, egy teljes hivatalos nevet és egy teljes születési dátumot. Lásd FHIR implementációs útmutatók.

Műveletek, amelyeket használni fog

A beteg (Patient) erőforrással leggyakrabban használt FHIR műveletek az azonosító vagy a demográfiai adatok alapján történő keresés (GET /Patient azonosító, vezetéknév vagy születési dátum paraméterekkel), a $everything művelet, amely visszaküldi a beteget és minden rá hivatkozó erőforrást, valamint a $match, amely a szerver egyező algoritmusát kérdezi le valószínűsíthető duplikátumokról. Az R5-ös FHIR verzióban egy $merge művelet szabványosítása van folyamatban.

• GET /Patient?identifier=https://hospital.example.org/mrn|MRN-00012345 azonosító alapján keres egy beteget; ?family=doe&birthdate=1980-05-23 demográfiai adatok alapján.
• GET /Patient/{id}/$everything visszaadja a beteget és minden rá hivatkozó erőforrást, lapozva, ami egy teljes rekord exportálásának módja.
• $match (ahol támogatott) a szerver illesztési algoritmusát kérdezi valószínűsíthető duplikátumokról; a $merge szabványosítása R5-ben történik.

Hibák, amelyek tönkreteszik a betegrekordokat

A FHIR beteg (Patient) rekordokat leggyakrabban roncsoló hibák közé tartozik, ha a nemzeti azonosítót az erőforrás azonosítója (resource id) helyett az azonosító (identifier) mezőbe tárolják, elhagyják az azonosító rendszerét (identifier.system), így különböző kórházak értékei ütköznek, a teljes nevet egyetlen szövegként tárolják a vezetéknév és keresztnév részek nélkül, az adminisztratív nemet használják a klinikai nem helyett, valamint egy egyesített rekordot szerkesztenek ahelyett, hogy összekapcsolnák és inaktiválnák azt.

• A nemzeti azonosító beillesztése az id mezőbe. Az erőforrás id a szerveré, és importáláskor változhat; az azonosítók az identifier mezőbe tartoznak.
• Egyetlen name mező minden tartalommal a text mezőben, és family/given nélkül, így a vezetéknevek szerinti keresések sikertelenek.
• A gender mező klinikai nemre használva, vagy unknown-ra állítva, mert az űrlapon nem volt mező.
• Hiányzó identifier.system, így két kórház MRN-1 értékei ütköznek.
• Egy Patient erőforrás helyben történő szerkesztése egy egyesítés után, ahelyett, hogy összekapcsolnák és deaktiválnák.

Az Anpheros-ban

Az Anpheros minden személyt, a számlatulajdonost és minden családi profilt egy FHIR beteg (Patient) erőforrásként jelenít meg az Anpheros Platformon, és minden rekord, amelyet egy klinika az API-n keresztül hozzáad, erre a betegre (Patient) hivatkozik. A klinikai azonosítók további azonosítókként kerülnek tárolásra a klinika saját rendszerével, és a személy által megadott demográfiai adatok adminisztratív adatok maradnak, amelyekből semmilyen klinikai következtetés nem vonható le.

Amikor egy klinika megadja a saját azonosítóját, az egy további identifierként kerül tárolásra a klinika rendszerével, így ugyanaz a személy mindkét oldalról megtalálható. A személy által az alkalmazásban megadott demográfiai adatok a usual névnek és adminisztratív adatoknak felelnek meg; a rekord soha nem von le semmilyen klinikai következtetést ezekből.

Kapcsolódó oldalak

• Betegegyeztetés és a master patient index
• FHIR implementációs útmutatók
• FHIR Encounter magyarázata
• FHIR Condition magyarázata
• FHIR keresés magyarázata
• Patient példa a fejlesztői oldalon

Források

• HL7 FHIR R4: Patient
• HL7 FHIR R4: Patient $everything
• HL7 Terminology: identifier type codes (v2-0203)
• HL7 US Core: Patient profile
• HL7 IPS: Patient profile

Gyakori kérdések

A Patient ugyanaz, mint a Person FHIR-ben?

Nem. A Person egy adminisztratív erőforrás, amely ugyanazt az embert köti össze különböző szerepekben (itt Patient, ott Practitioner, máshol RelatedPerson). A klinikai erőforrások a Patient-re hivatkoznak, soha nem a Person-re.

Hová kerülnek az allergiák és a betegségek?

Az AllergyIntolerance és a Condition erőforrásokba, amelyek a Patient-re hivatkoznak. A Patient maga csak adminisztratív adatokat tartalmaz.

Hogyan rögzíthetek egy névtelen újszülöttet?

Egy névvel, amelynek a use értéke temporary vagy üres, egy birthDate mezővel, amely tartalmazza a patient-birthTime extenert, és egy link-kel az anya rekordjához a RelatedPerson vagy a patient-mothersMaidenName extenderen keresztül, ahogy a nemzeti profilok előírják.

Megosztható egy Patient erőforrás két kórház között?

Minden rendszer fenntartja a saját Patient erőforrását a saját id-jával; megosztják az azonosítókat (egy nemzeti azonosító), és összekapcsolhatják a rekordokat. A rendszerek közötti egyeztetés a master patient index feladata, nem az erőforrásé.

Anpheros Platform

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 sandbox létrehozásaOlvasd el a fejlesztői útmutatókat →

Ingyenes · 30 szintetikus beteg · kártya nélkül

Szerző:

Az Anpheros csapata

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 →