Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Αντιστοίχιση HL7 v2 σε FHIR
Αντιστοίχιση τμήματος-σε-πόρο και πεδίου OBX-ανά-πεδίο από HL7 v2 ORU^R01 σε FHIR R4, οι παγίδες που καταστρέφουν τις ενσωματώσεις, και ένας μετατροπέας που καλείτε μέσω HTTPS.
Η αντιστοίχιση HL7 v2 σε FHIR σημαίνει τη μετατροπή κάθε τμήματος ενός μηνύματος v2 με διαχωριστικά σωλήνα σε πόρους FHIR R4: PID σε Patient, OBR σε DiagnosticReport (ή ServiceRequest), κάθε OBX σε Observation, με κωδικούς, μονάδες, εύρη και χρόνους που μεταφέρονται πεδίο ανά πεδίο. Η HL7 δημοσιεύει έναν επίσημο Οδηγό υλοποίησης V2-to-FHIR με χάρτες εννοιών για τα κοινά τμήματα. Αυτή η σελίδα παρέχει την πρακτική αντιστοίχιση για εργαστηριακά αποτελέσματα (ORU^R01), τις παγίδες που καταστρέφουν πραγματικές ενσωματώσεις και έναν μετατροπέα που μπορείτε να καλέσετε μέσω HTTPS: τον εργαστηριακό σύνδεσμο Anpheros.
- MSHSeparators, message type, message id → MessageHeader or provenance
- PIDPatient identity → Patient (or, in Anpheros, the patient in the URL)
- OBRThe order and report → DiagnosticReport, report id and date
- OBXOne result each → Observation with LOINC, value, range, flag
- FHIR recordCoded, versioned resources your apps can read
Τμήμα σε πόρο
| Τμήμα HL7 v2 | Τι μεταφέρει | Πόρος FHIR R4 | Στον σύνδεσμο εργαστηρίου Anpheros |
|---|---|---|---|
| MSH | Διαχωριστές, σύστημα αποστολής, τύπος μηνύματος, αναγνωριστικό μηνύματος | MessageHeader (ή provenance) |
Διαχωριστές διαβάζονται από το MSH· ο τύπος ελέγχεται για ORU^R01· το αναγνωριστικό μηνύματος διατηρείται για ιχνηλασιμότητα |
| PID | Αναγνωριστικά ασθενούς, όνομα, ημερομηνία γέννησης, φύλο | Patient |
Δεν χρησιμοποιείται: ο ασθενής είναι αυτός στην διεύθυνση URL του αιτήματος, επομένως ένα μήνυμα δεν μπορεί να εγγραφεί στο λάθος αρχείο |
| PV1 | Επίσκεψη | Encounter |
Δεν χρησιμοποιείται |
| ORC / OBR | Παραγγελία και αναφορά: αναγνωριστικό filler/placer, ημερομηνία | ServiceRequest, DiagnosticReport |
Το OBR-3 (ή OBR-2) είναι το αναγνωριστικό αναφοράς, το OBR-7 η προεπιλεγμένη ημερομηνία |
| OBX | Ένα αποτέλεσμα | Observation |
Μια παρατήρηση εργαστηρίου ανά OBX |
| NTE | Σημείωση ελεύθερου κειμένου | Observation.note |
Δεν χρησιμοποιείται |
Πεδίο OBX ανά πεδίο
| Πεδίο OBX | Στοιχείο FHIR Observation | Σημειώσεις |
|---|---|---|
| OBX-2 τύπος τιμής (NM, SN, ST, CWE) | επιλογή του value[x] |
τα NM και SN γίνονται valueQuantity· το κείμενο παραμένει κείμενο |
OBX-3 αναγνωριστικό code^text^system |
code.coding |
το LN στο OBX-3.3 σημαίνει LOINC· άλλα συστήματα είναι ο τοπικός κωδικός του εργαστηρίου |
| OBX-5 τιμή, OBX-6 μονάδα | valueQuantity.value, .unit / .code (UCUM) |
τα <5 και 6,4 πρέπει να αναλυθούν σκόπιμα |
| OBX-7 εύρος αναφοράς | referenceRange.low / .high |
3.5-5.1, <200, >40 |
| OBX-8 σημαία ανωμαλίας | interpretation |
H, L, HH, LL, A, N |
| OBX-11 κατάσταση αποτελέσματος | status |
F → τελικό, C → τροποποιημένο, P → προκαταρκτικό, I → καταχωρημένο |
| OBX-14 χρόνος παρατήρησης | effectiveDateTime |
οι χρόνοι v2 συχνά δεν έχουν ζώνη ώρας· το FHIR απαιτεί μία |
Μετατροπή ενός μηνύματος με ένα αίτημα
curl -X POST "https://platform.anpheros.com/v1/patients/$PID/labs/import" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: x-application/hl7-v2+er7" \
-H "Idempotency-Key: $(uuidgen)" \
--data-binary @oru_r01.hl7
Η απάντηση παραθέτει πόσες Παρατηρήσεις (Observations) δημιουργήθηκαν, πόσες παραλείφθηκαν ως ήδη εισαχθείσες, ποιοι δείκτες δεν μπόρεσαν να αντιστοιχιστούν και τις νέες Παρατηρήσεις με τους κωδικούς τους. Κάθε μία λαμβάνει ένα σταθερό αναγνωριστικό (identifier) που προέρχεται από την αναφορά, το τεστ, την ώρα και την τιμή, έτσι ώστε ένα εργαστήριο που ξαναστέλνει το ίδιο μήνυμα να μην δημιουργεί διπλότυπα.
Παγίδες που καταστρέφουν πραγματικές ενσωματώσεις
- Ζώνες ώρας. Το
20261002074500δεν έχει μετατόπιση· αποφασίστε ρητά τη ζώνη του αποστολέα. - Τοπικοί κωδικοί. Διατηρήστε τον δικό κωδικό του εργαστηρίου όταν δεν υπάρχει LOINC· ποτέ μην τον παραλείπετε.
- Επαναποστολές. Χωρίς σταθερό αναγνωριστικό ανά αποτέλεσμα, οι επαναδοκιμές γίνονται διπλότυπα.
- Διορθώσεις. Το OBX-11
Cείναι μια διόρθωση· αποφασίστε αν αντικαθιστά ή προσθέτει, και σημειώστε το παλιό αποτέλεσμα. - Μη αριθμητικές τιμές. Τα
positive,<5,6,4χρειάζονται ρητούς κανόνες, όχι εικασία.
Τι δεν κάνει ο σύνδεσμος
Δέχεται εργαστηριακά αποτελέσματα ORU^R01 μέσω HTTPS. Δεν λαμβάνει μηνύματα ADT ή εντολών, δεν επικοινωνεί μέσω MLLP πάνω από TCP (μπορεί να προωθήσει μια μηχανή διασύνδεσης μπροστά), δεν δημιουργεί DiagnosticReport και δεν αντιστοιχίζει ασθενείς από το PID.
Συχνές Ερωτήσεις
Πώς γίνεται η αντιστοίχιση του HL7 v2 με το FHIR;
Τμήμα προς τμήμα: PID σε Patient, PV1 σε Encounter, ORC/OBR σε ServiceRequest και DiagnosticReport, OBX σε Observation, NTE σε notes. Ο οδηγός υλοποίησης V2-to-FHIR του HL7 ορίζει τις αντιστοιχίσεις εννοιών σε επίπεδο πεδίου.
Υπάρχει μετατροπέας HL7 v2 σε FHIR;
Ναι. Μηχανές διασύνδεσης και βιβλιοθήκες ανοιχτού κώδικα μετατρέπουν μηνύματα· για εργαστηριακά αποτελέσματα, ο σύνδεσμος εργαστηρίου Anpheros μετατρέπει ένα μήνυμα ORU^R01 σε FHIR R4 Observations με ένα αίτημα HTTPS και τα αποθηκεύει στο αρχείο του ασθενούς.
Ποιονς τύπους μηνυμάτων HL7 v2 δέχεται ο Anpheros;
ORU^R01 εργαστηριακά αποτελέσματα. Ένα μήνυμα άλλου τύπου λαμβάνει προειδοποίηση, και μόνο τα τμήματα OBX του διαβάζονται· τα μηνύματα ADT, order και άλλα δεν υποστηρίζονται.
Πώς αναπαρίστανται οι σημαίες ανωμαλίας του HL7 v2 στο FHIR;
Το OBX-8 γίνεται Observation.interpretation χρησιμοποιώντας τους κωδικούς HL7 ObservationInterpretation (H, L, HH, LL, A, N).
Σχετικά
- API αποτελεσμάτων εργαστηρίου: HL7 v2, FHIR και LOINC
- FHIR vs HL7 v2: πρακτικές διαφορές
- Πώς να εισαγάγετε αποτελέσματα εργαστηρίου σε ένα αρχείο FHIR
- HL7 v2 και FHIR για κλινικούς πίνακες ελέγχου
- Συνδέτης εργαστηρίου
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card