FHIR zdroj Pacient vysvetlený: identifikátory, mená, demografické údaje a prepojenia, s platným príkladom

Krátka odpoveď: Patient je FHIR zdroj, ktorý opisuje osobu, ktorá prijíma starostlivosť: kto je administratívne, nie čo jej je. Obsahuje identifikátory (čísla lekárskych záznamov, národné ID), mená, telekomunikačné kontakty, administratívne pohlavie, dátum narodenia, adresu, rodinný stav, komunikáciu (jazyky), praktického lekára, riadiacu organizáciu a prepojenia na iné záznamy pacienta pre tú istú osobu. Každá Observation, Condition, Encounter alebo MedicationStatement naň odkazuje cez subject alebo patient. Klinické fakty nikdy nežijú v Patient; žijú v zdrojoch, ktoré naň odkazujú.

Platný FHIR R4 príklad

Platný FHIR R4 Patient zdroj potrebuje iba resourceType, ale v praxi obsahuje aspoň jeden identifikátor so system a value, meno s časťami family a given, administratívne pohlavie a dátum narodenia. Príklad nižšie tiež uvádza profil IPS Patient v meta.profile a pridáva kontaktné údaje (telecom), adresu (address), preferovaný jazyk (preferred language), všeobecného lekára (general practitioner) a spravujúcu organizáciu (managing organisation).

{
  "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"}
}

Dôležité prvky

Prvky Patient, ktoré sú najdôležitejšie pre interoperabilitu, sú: identifikátor (identifier so system, value a type), meno (name so use, family a given), administratívne pohlavie (administrative gender), dátum narodenia (birthDate), či je osoba zosnulá (deceased), či je záznam aktívny (active), kontaktné údaje (contact) a prepojenie (link). Identifikátory a mená riadia párovanie medzi systémami, pohlavie a dátum narodenia sú administratívne fakty a link zaznamenáva, ako hlavný register pacientov prepojil duplicitné záznamy jednej osoby.

• identifier je zoznam, každý s system (kto ho vydal) a value. type hovorí, čo je to za typ: MR číslo lekárskeho záznamu, NI národný identifikátor, PPN pas, SS číslo sociálneho zabezpečenia, z tabuľky HL7 0203. Pacient má zvyčajne niekoľko; MRN nemocnice a národné ID sú platné a systémy ich podľa nich spájajú.
• name je tiež zoznam s use: official, usual, nickname, maiden, old. family je jeden reťazec; given je zoznam. Písma, prepisy a poradie mien sú ponechané na implementačnej príručke krajiny.
• gender je administratívne pohlavie so štyrmi hodnotami: male, female, other, unknown. Je to to, čo záznam uvádza, používa sa na párovanie a formuláre. Klinické pohlavie, rodová identita a zámená idú do rozšírení alebo Observations, ktoré FHIR R5 a projekt Gender Harmony formalizovali.
• birthDate je dátum, voliteľne len rok alebo rok-mesiac, keď presný dátum nie je známy. Rozšírenie patient-birthTime pridáva čas pre novorodencov.
• deceased[x] je booleovská hodnota alebo dátum-čas. active false označuje záznam, ktorý by sa už nemal používať (duplicitný, presunutý), bez jeho vymazania.
• contact uvádza zoznam osôb na kontakt (najbližší príbuzný, opatrovník) s kódom vzťahu; samy osebe nie sú Patient zdroje. Rodič, ktorý je tiež pacientom, je RelatedPerson odkazujúci na oboch.
• link spája Patient záznamy, ktoré sú o tej istej osobe: replaced-by a replaces po zlúčení, refer na autoritatívny záznam, seealso pre záznam v inom systéme. Takto majster pacientsky index vyjadruje svoje rozhodnutia vo FHIR; pozri Zhoda pacientov.

Čo pridávajú národné profily

Národné a medzinárodné FHIR profily premieňajú voľne definovaný základný Patient zdroj na niečo použiteľné tým, že prvky označia ako povinné a pridajú rozšírenia špecifické pre danú krajinu. US Core vyžaduje identifikátor, meno a pohlavie a pridáva rozšírenia pre rasu, etnický pôvod a pohlavie pri narodení; profil IPS Patient vyžaduje meno, pohlavie a dátum narodenia; národné profily definujú systémy identifikátorov a formáty adries.

Základný zdroj robí takmer všetko voliteľným. Profily ho robia použiteľným:

Záznam, ktorý prekročí hranice, musí spĺňať profil na každej strane, čo v praxi znamená niesť národný identifikátor aj MRN, celé oficiálne meno a kompletný dátum narodenia. Pozri FHIR implementačné príručky.

Operácie, ktoré budete používať

FHIR operácie najčastejšie používané s Patient sú vyhľadávanie podľa identifikátora alebo demografických údajov (GET /Patient s parametrami identifier, family alebo birthdate), operácia $everything, ktorá vráti pacienta a všetky zdroje, ktoré na neho odkazujú, a $match, ktorá sa pýta algoritmu párovania servera na pravdepodobné duplikáty. Operácia $merge sa štandardizuje vo FHIR R5.

• GET /Patient?identifier=https://hospital.example.org/mrn|MRN-00012345 vyhľadá pacienta podľa identifikátora; ?family=doe&birthdate=1980-05-23 podľa demografických údajov.
• GET /Patient/{id}/$everything vráti pacienta a všetky zdroje, ktoré na neho odkazujú, stránkované, čo je spôsob, ako sa exportuje celý záznam.
• $match (kde je podporované) sa pýta algoritmu servera na pravdepodobné duplikáty; $merge sa štandardizuje v R5.

Chyby, ktoré poškodzujú záznamy pacientov

Chyby, ktoré najčastejšie poškodzujú FHIR záznamy Patient, sú: ukladanie národného ID do resource id namiesto identifier, vynechanie identifier.system, takže sa hodnoty z rôznych nemocníc zrazia, umiestnenie celého mena do textu bez častí family a given, použitie administratívneho pohlavia pre klinické pohlavie a úprava zlúčeného záznamu na mieste namiesto jeho prepojenia a deaktivácie.

• Uvedenie národného ID do id. id zdroja patrí serveru a môže sa pri importe zmeniť; identifikátory patria do identifier.
• Jedno name so všetkým v text a bez family/given, takže vyhľadávania podľa priezviska zlyhajú.
• gender použitý pre klinické pohlavie, alebo nastavený na unknown, pretože formulár nemal pole.
• Chýbajúci identifier.system, takže hodnoty MRN-1 dvoch nemocníc kolidujú.
• Úprava Patient na mieste, keď došlo k zlúčeniu, namiesto prepojenia a deaktivácie.

V Anpheros

Anpheros reprezentuje každú osobu, držiteľa účtu a každý rodinný profil ako FHIR Patient zdroj na Anpheros Platform, a každý záznam, ktorý klinika pridá cez API, odkazuje na tohto Patient. Identifikátory kliník sú uchovávané ako dodatočné identifikátory s vlastným systémom kliniky a demografické údaje, ktoré osoba zadá, zostávajú administratívnymi údajmi, z ktorých sa nevyvodzujú žiadne klinické informácie.

Keď klinika pošle svoj vlastný identifikátor, uloží sa ako dodatočný identifier so systémom kliniky, takže rovnaká osoba môže byť nájdená z oboch strán. Demografické údaje, ktoré osoba zadala v aplikácii, sú usual meno a administratívne údaje; záznam z nich nikdy nevyvodzuje žiadne klinické informácie.

Súvisiace stránky

• Zhoda pacientov a majster pacientsky index
• FHIR implementačné príručky
• Vysvetlenie FHIR Encounter
• Vysvetlenie FHIR Condition
• Vysvetlenie vyhľadávania FHIR
• Príklad pacienta na vývojárskej stránke

Zdroje

• HL7 FHIR R4: Patient
• HL7 FHIR R4: Patient $everything
• HL7 Terminology: typy kódu identifikátora (v2-0203)
• HL7 US Core: Patient profil
• HL7 IPS: Patient profil

Časté otázky

Je Patient to isté ako Person vo FHIR?

Nie. Person je administratívny zdroj, ktorý spája tú istú ľudskú bytosť naprieč rolami (tu Patient, tam Practitioner, inde RelatedPerson). Klinické zdroje odkazujú na Patient, nikdy na Person.

Kam idú alergie a stavy?

Do zdrojov AllergyIntolerance a Condition, ktoré odkazujú na Patient. Patient sám obsahuje iba administratívne údaje.

Ako zaznamenám novorodenca bez mena?

S menom, ktorého použitie je temporary alebo prázdne, birthDate s rozšírením patient-birthTime a link na záznam matky cez RelatedPerson alebo rozšírenie patient-mothersMaidenName, ako špecifikujú národné profily.

Môže jeden Patient zdroj zdieľať viacero nemocníc?

Každý systém si udržiava svoj vlastný Patient zdroj so svojím vlastným id; zdieľajú identifikátory (národné ID) a môžu prepojiť záznamy. Zhoda naprieč systémami je úlohou majstra pacientskeho indexu, nie samotného zdroja.

Anpheros Platform

Vyskúšajte zadarmo v sandboxe

Prvé volanie FHIR za 5 minút. API podľa štandardu HL7 FHIR R4 s integrovaným súhlasom pacienta: vyskúšajte si ho v sandboxe a potom pripojte svoju vlastnú aplikáciu alebo klinický systém.

Vytvoriť sandbox zadarmoPrečítať návody pre vývojárov →

Zadarmo · 30 syntetických pacientov · bez karty

Napísal

Tím Anpheros

Anpheros vyvíja zdravotný záznam, ktorý pacient ovláda a môže zdieľať s akoukoľvek klinikou, na platforme HL7 FHIR R4, so sídlom v EÚ. Tieto návody vám pomôžu pochopiť a usporiadať si svoje zdravie; nenahrádzajú vášho lekára.

O Anpherose →