Ο πόρος FHIR Patient: αναγνωριστικά, ονόματα, δημογραφικά στοιχεία και σύνδεσμοι, με έγκυρο παράδειγμα

Σύντομη απάντηση: Ο Patient (Ασθενής) είναι ο πόρος FHIR που περιγράφει ένα άτομο που λαμβάνει φροντίδα: ποιο είναι διοικητικά, όχι τι τον απασχολεί. Περιέχει αναγνωριστικά (αριθμούς ιατρικού φακέλου, εθνικές ταυτότητες), ονόματα, στοιχεία επικοινωνίας telecom, διοικητικό φύλο, ημερομηνία γέννησης, διεύθυνση, οικογενειακή κατάσταση, επικοινωνία (γλώσσες), έναν γενικό ιατρό, έναν οργανισμό διαχείρισης και συνδέσμους προς άλλους πόρους Patient για το ίδιο άτομο. Κάθε Observation, Condition, Encounter ή MedicationStatement τον αναφέρει μέσω του subject ή patient. Κλινικά γεγονότα δεν βρίσκονται ποτέ στον Patient. βρίσκονται στους πόρους που τον αναφέρουν.

Ένα έγκυρο παράδειγμα FHIR R4

Ένας έγκυρος πόρος FHIR R4 Patient χρειάζεται μόνο το resourceType, αλλά στην πράξη περιέχει τουλάχιστον ένα αναγνωριστικό (identifier) με σύστημα (system) και τιμή (value), ένα όνομα (name) με μέρη οικογένειας (family) και δοθέντα (given), ένα διοικητικό φύλο (administrativeGender) και ημερομηνία γέννησης (birthDate). Το παρακάτω παράδειγμα δηλώνει επίσης το προφίλ IPS Patient στο meta.profile και προσθέτει στοιχεία επικοινωνίας (telecom), διεύθυνση (address), προτιμώμενη γλώσσα (preferredLanguage), γενικό ιατρό (generalPractitioner) και οργανισμό διαχείρισης (managingOrganisation).

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

Τα στοιχεία που έχουν σημασία

Τα στοιχεία Patient που έχουν μεγαλύτερη σημασία για τη διαλειτουργικότητα είναι το αναγνωριστικό (identifier με system, value και type), το όνομα (name με use, family και given), το διοικητικό φύλο (administrativeGender), η ημερομηνία γέννησης (birthDate), η κατάσταση θανάτου (deceased), η κατάσταση ενεργού εγγραφής (active), τα στοιχεία επικοινωνίας (contact) και η σύνδεση (link). Τα αναγνωριστικά και τα ονόματα καθοδηγούν την αντιστοίχιση μεταξύ συστημάτων, το φύλο και η ημερομηνία γέννησης είναι διοικητικά γεγονότα, και η σύνδεση (link) καταγράφει πώς ένας κεντρικός δείκτης ασθενών συνέδεσε διπλότυπες εγγραφές ενός ατόμου.

• identifier είναι μια λίστα, καθεμία με system (ποιος το εξέδωσε) και value. Ο type λέει τι είδους είναι: MR αριθμός ιατρικού φακέλου, NI εθνικό αναγνωριστικό, PPN διαβατήριο, SS αριθμός κοινωνικής ασφάλισης, από τον πίνακα 0203 της HL7. Ένας ασθενής συνήθως έχει αρκετά. Ο αριθμός ιατρικού φακέλου ενός νοσοκομείου και μια εθνική ταυτότητα είναι και τα δύο έγκυρα, και τα συστήματα τα αντιστοιχίζουν.
• name είναι επίσης μια λίστα με use: official, usual, nickname, maiden, old. Το family είναι μια συμβολοσειρά. το given είναι μια λίστα. Τα σενάρια, οι μεταγραφές και η σειρά των ονομάτων αφήνονται στον οδηγό υλοποίησης της χώρας.
• gender είναι το διοικητικό φύλο με τέσσερις τιμές: male, female, other, unknown. Είναι αυτό που λέει ο φάκελος, που χρησιμοποιείται για αντιστοίχιση και φόρμες. Το κλινικό φύλο, η ταυτότητα φύλου και οι αντωνυμίες πηγαίνουν σε επεκτάσεις ή Observations, τα οποία το FHIR R5 και το έργο Gender Harmony έχουν τυποποιήσει.
• birthDate είναι μια ημερομηνία, προαιρετικά μόνο έτος ή έτος-μήνας όταν η ακριβής ημερομηνία είναι άγνωστη. Μια επέκταση patient-birthTime προσθέτει την ώρα για νεογέννητα.
• deceased[x] είναι μια boolean ή μια ημερομηνία-ώρα. Το active false επισημαίνει έναν φάκελο που δεν πρέπει πλέον να χρησιμοποιείται (διπλότυπο, μετακινήθηκε), χωρίς να διαγράφεται.
• contact παραθέτει άτομα για επικοινωνία (επόμενος συγγενής, κηδεμόνας), με κωδικό σχέσης. δεν είναι οι ίδιοι πόροι Patient. Ένας γονέας που είναι επίσης ασθενής είναι ένα RelatedPerson που αναφέρεται και στα δύο.
• link συνδέει πόρους Patient που είναι το ίδιο άτομο: replaced-by και replaces μετά από συγχώνευση, refer στον έγκυρο πόρο, seealso για έναν πόρο σε άλλο σύστημα. Έτσι εκφράζει ο δείκτης κύριου ασθενούς τις αποφάσεις του σε FHIR. δείτε Αντιστοίχιση ασθενών.

Τι προσθέτουν τα εθνικά προφίλ

Τα εθνικά και διεθνή προφίλ FHIR μετατρέπουν τον χαλαρά ορισμένο βασικό πόρο Patient σε κάτι χρησιμοποιήσιμο, καθιστώντας ορισμένα στοιχεία υποχρεωτικά και προσθέτοντας επεκτάσεις ειδικές για κάθε χώρα. Το US Core απαιτεί αναγνωριστικό (identifier), όνομα (name) και φύλο (gender) και προσθέτει επεκτάσεις για φυλή (race), εθνικότητα (ethnicity) και φύλο κατά τη γέννηση (birthSex). Το προφίλ IPS Patient απαιτεί όνομα (name), φύλο (gender) και ημερομηνία γέννησης (birthDate). Τα εθνικά προφίλ ορίζουν συστήματα αναγνωριστικών (identifier systems) και μορφές διευθύνσεων (address formats).

Ο βασικός πόρος καθιστά σχεδόν τα πάντα προαιρετικά. Τα προφίλ τα καθιστούν χρήσιμα:

Ένας φάκελος που θα διασχίσει σύνορα πρέπει να πληροί το προφίλ από κάθε πλευρά, πράγμα που στην πράξη σημαίνει να φέρει τόσο την εθνική ταυτότητα όσο και έναν MRN, ένα πλήρες επίσημο όνομα και μια πλήρη ημερομηνία γέννησης. Δείτε Οδηγούς υλοποίησης FHIR.

Λειτουργίες που θα χρησιμοποιήσετε

Οι λειτουργίες FHIR που χρησιμοποιούνται περισσότερο με τον Patient είναι η αναζήτηση με βάση το αναγνωριστικό (identifier) ή τα δημογραφικά στοιχεία (demographics) (GET /Patient με παραμέτρους identifier, family ή birthdate), η λειτουργία $everything, η οποία επιστρέφει τον ασθενή και κάθε πόρο που τον αναφέρει, και η $match, η οποία ζητά από τον αλγόριθμο αντιστοίχισης του διακομιστή πιθανά διπλότυπα. Μια λειτουργία $merge τυποποιείται στο FHIR R5.

• GET /Patient?identifier=https://hospital.example.org/mrn|MRN-00012345 βρίσκει έναν ασθενή με αναγνωριστικό. ?family=doe&birthdate=1980-05-23 με δημογραφικά στοιχεία.
• GET /Patient/{id}/$everything επιστρέφει τον ασθενή και κάθε πόρο που τον αναφέρει, σε σελίδες, που είναι ο τρόπος εξαγωγής ενός πλήρους φακέλου.
• $match (όπου υποστηρίζεται) ζητά από τον αλγόριθμο αντιστοίχισης του διακομιστή για πιθανά διπλότυπα. το $merge τυποποιείται στο R5.

Λάθη που καταστρέφουν τους φακέλους ασθενών

Τα λάθη που συχνότερα καταστρέφουν τους φακέλους FHIR Patient είναι η αποθήκευση ενός εθνικού αναγνωριστικού στο resource id αντί για το identifier, η παράλειψη του identifier.system ώστε τιμές από διαφορετικά νοσοκομεία να συγκρούονται, η τοποθέτηση ολόκληρου του ονόματος στο text χωρίς μέρη οικογένειας (family) και δοθέντα (given), η χρήση του διοικητικού φύλου (administrativeGender) για το κλινικό φύλο (clinical sex), και η επεξεργασία μιας συγχωνευμένης εγγραφής επί τόπου αντί για τη σύνδεσή της και την απενεργοποίησή της.

• Τοποθέτηση της εθνικής ταυτότητας στο id. Το id του πόρου ανήκει στον διακομιστή και μπορεί να αλλάξει κατά την εισαγωγή. τα αναγνωριστικά ανήκουν στο identifier.
• Ένα name με τα πάντα στο text και χωρίς family/given, ώστε οι αναζητήσεις με επώνυμο να αποτυγχάνουν.
• Το gender χρησιμοποιείται για κλινικό φύλο, ή ορίζεται σε unknown επειδή η φόρμα δεν είχε πεδίο.
• Έλλειψη identifier.system, ώστε οι τιμές MRN-1 δύο νοσοκομείων να συγκρούονται.
• Επεξεργασία ενός Patient επί τόπου όταν συνέβη συγχώνευση, αντί για σύνδεση και απενεργοποίηση.

Στην Anpheros

Η Anpheros αναπαριστά κάθε άτομο, τον κάτοχο του λογαριασμού και κάθε προφίλ οικογένειας, ως πόρο FHIR Patient στην Πλατφόρμα Anpheros, και κάθε εγγραφή που προσθέτει μια κλινική μέσω του API αναφέρεται σε αυτόν τον Patient. Τα αναγνωριστικά της κλινικής διατηρούνται ως επιπλέον αναγνωριστικά με το δικό της σύστημα, και τα δημογραφικά στοιχεία που εισάγει ένα άτομο παραμένουν διοικητικά δεδομένα από τα οποία δεν συνάγεται τίποτα κλινικό.

Όταν μια κλινική στέλνει το δικό της αναγνωριστικό, αποθηκεύεται ως επιπλέον identifier με το σύστημα της κλινικής, ώστε το ίδιο άτομο να μπορεί να βρεθεί από οποιαδήποτε πλευρά. Τα δημογραφικά στοιχεία που εισήγαγε το άτομο στην εφαρμογή είναι το usual όνομα και διοικητικά δεδομένα. Η εγγραφή δεν συνάγει ποτέ τίποτα κλινικό από αυτά.

Σχετικές σελίδες

• Αντιστοίχιση ασθενών και ο δείκτης κύριου ασθενούς
• Οδηγοί υλοποίησης FHIR
• FHIR Encounter εξηγείται
• FHIR Condition εξηγείται
• Αναζήτηση FHIR εξηγείται
• Παράδειγμα Patient στον ιστότοπο προγραμματιστών

Πηγές

• HL7 FHIR R4: Patient
• HL7 FHIR R4: Patient $everything
• Ορολογία HL7: κωδικοί τύπου αναγνωριστικού (v2-0203)
• HL7 US Core: Προφίλ Patient
• HL7 IPS: Προφίλ Patient

Συχνές ερωτήσεις

Είναι ο Patient ίδιος με το Person στο FHIR;

Όχι. Το Person είναι ένας διοικητικός πόρος που συνδέει το ίδιο ανθρώπινο ον σε διάφορους ρόλους (ένας Patient εδώ, ένας Practitioner εκεί, ένας RelatedPerson αλλού). Οι κλινικοί πόροι αναφέρονται στον Patient, ποτέ στο Person.

Πού πηγαίνουν οι αλλεργίες και οι καταστάσεις;

Στους πόρους AllergyIntolerance και Condition που αναφέρονται στον Patient. Ο Patient από μόνος του περιέχει μόνο διοικητικά δεδομένα.

Πώς καταγράφω ένα νεογέννητο χωρίς όνομα;

Με ένα όνομα του οποίου η χρήση είναι temporary ή κενή, μια birthDate με την επέκταση patient-birthTime, και έναν link στον φάκελο της μητέρας μέσω RelatedPerson ή την επέκταση patient-mothersMaidenName, όπως ορίζουν τα εθνικά προφίλ.

Μπορεί ένας πόρος Patient να μοιράζεται από δύο νοσοκομεία;

Κάθε σύστημα διατηρεί τον δικό του πόρο Patient με το δικό του id. μοιράζονται αναγνωριστικά (μια εθνική ταυτότητα) και μπορεί να συνδέουν τους φακέλους. Η αντιστοίχιση μεταξύ συστημάτων είναι δουλειά ενός δείκτη κύριου ασθενούς, όχι του πόρου.

Anpheros Platform

Δοκιμάστε δωρεάν στο sandbox

Η πρώτη σας κλήση FHIR σε 5 λεπτά. Ένα API HL7 FHIR R4 με τη συγκατάθεση του ασθενούς ενσωματωμένη: δοκιμάστε το στο sandbox, στη συνέχεια συνδέστε τη δική σας εφαρμογή ή σύστημα κλινικής.

Δημιουργία δωρεάν sandboxΔιαβάστε τους οδηγούς προγραμματιστών →

Δωρεάν · 30 συνθετικοί ασθενείς · χωρίς κάρτα

Συντάχθηκε από

Η ομάδα του Anpheros

Το Anpheros δημιουργεί ένα ιατρικό αρχείο που ελέγχει ο ασθενής και μπορεί να μοιραστεί με οποιαδήποτε κλινική, σε πλατφόρμα HL7 FHIR R4, με έδρα την ΕΕ. Αυτοί οι οδηγοί σάς βοηθούν να κατανοήσετε και να οργανώσετε την υγεία σας· δεν αντικαθιστούν τον γιατρό σας.

Σχετικά με το Anpheros →