Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
HL7 v2 και FHIR για κλινικά dashboards
Από ένα μήνυμα εργαστηρίου HL7 v2 ORU^R01 σε ένα πλακίδιο dashboard: FHIR Observations με εύρη και σημαίες, υπογεγραμμένα webhooks, χωρίς διπλότυπα — και γιατί αυτό δεν είναι παρακολούθηση στο κρεβάτι του ασθενούς.
Ένα κλινικό dashboard χρειάζεται αποτελέσματα ως δομημένα, κωδικοποιημένα δεδομένα τη στιγμή που αναφέρονται — τεστ, τιμή, μονάδα, εύρος αναφοράς και σημαία — όχι PDF που πρέπει να διαβάσει. Τα εργαστήρια εξακολουθούν να στέλνουν τα περισσότερα αποτελέσματα ως μηνύματα HL7 v2 ORU^R01, ενώ τα dashboards είναι ευκολότερο να κατασκευαστούν σε FHIR R4 Observations. Το Anpheros βρίσκεται ανάμεσα στα δύο: ένα εργαστηριακό σύστημα δημοσιεύει το μήνυμα HL7 v2 (ή μια αναφορά CSV ή JSON) μέσω HTTPS, κάθε αποτέλεσμα γίνεται ένα FHIR Observation με τον κωδικό του (LOINC όταν το στέλνει το εργαστήριο), την τιμή και το εύρος αναφοράς του, και ένα υπογεγραμμένο webhook ενημερώνει το dashboard σας ότι έφτασαν νέα αποτελέσματα.
- Laboratory systemSends an HL7 v2 ORU^R01 message or a CSV report
- Lab connectorPOST /v1/patients/{id}/labs/import over HTTPS
- FHIR ObservationsLOINC code, value, unit, reference range, H/L flag
- Signed webhookresource.created reaches your server, retried on failure
- Your dashboardReads the new results and updates the tile
Τι λαμβάνει ο πίνακας ελέγχου
Κάθε τμήμα OBX του μηνύματος γίνεται μία Εργαστηριακή Παρατήρηση (Observation):
| Πεδίο HL7 v2 OBX | FHIR R4 Observation | Στον πίνακα ελέγχου |
|---|---|---|
| OBX-3 κωδικός εξέτασης | code (LOINC όταν τον στέλνει το εργαστήριο· ένας τοπικός κωδικός διατηρείται ως κωδικός του εργαστηρίου) |
Όνομα εξέτασης· το LOINC το καθιστά συγκρίσιμο μεταξύ εργαστηρίων |
| OBX-5 τιμή, OBX-6 μονάδα | valueQuantity (μονάδα UCUM) |
Ο αριθμός και η μονάδα του |
| OBX-7 εύρος αναφοράς | referenceRange |
Το φυσιολογικό εύρος |
| OBX-8 σημαία ανωμαλίας | interpretation (H, L, …) |
Η κόκκινη ή μπλε σημαία |
| OBX-14 χρόνος | effectiveDateTime |
Πότε λήφθηκε το δείγμα |
Εισαγωγή μηνύματος και αντίδραση σε αυτό
Στείλτε το μήνυμα για έναν ασθενή που δημιουργήσατε (ή για τον οποίο έχετε άδεια):
import { readFile } from 'node:fs/promises';
import { Anpheros, apiKey } from '@anpheros/sdk';
const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) }); // a sandbox key, sk_test_…
const message = await readFile('oru_r01.hl7', 'utf8');
const result = await anpheros.labs.importHl7(patientId, message, { sourceSystem: 'lab-lis' });
console.log(result); // created, skipped and unmapped counts
Στη συνέχεια, αφήστε την πλατφόρμα να καλέσει το backend του dashboard σας αντί να το ελέγχει περιοδικά:
await anpheros.webhooks.create('https://dashboard.example.org/anpheros/hook', { events: ['resource.created'] });
Κάθε παράδοση είναι υπογεγραμμένη (επαληθεύστε την με το verifyWebhookSignature από το SDK) και επαναλαμβάνεται εάν ο διακομιστής σας δεν απαντήσει. Το συμβάν φέρει τον τύπο πόρου, το αναγνωριστικό και τον ασθενή. διαβάστε τις νέες Παρατηρήσεις και ανανεώστε την κάρτα. Τα επαναποστελλόμενα μηνύματα παραλείπονται, έτσι ένα εργαστήριο που επαναμεταδίδει σε περίπτωση διακοπής δεν δημιουργεί διπλότυπες γραμμές στην οθόνη.
Επιλογή HL7 v2 ή FHIR για κάθε σύνδεση
| Σύνδεση | Χρήση | Γιατί |
|---|---|---|
| Εργαστήριο → επίπεδο δεδομένων | HL7 v2 ORU^R01 (ή CSV/JSON) | Αυτό που ήδη εκπέμπουν τα συστήματα εργαστηρίου· καμία αλλαγή από την πλευρά τους |
| Επίπεδο δεδομένων → ταμπλό | FHIR R4 Observation + webhooks | Κωδικοποιημένο, εκδομένο JSON που μπορεί να διαβάσει απευθείας το front end σας |
| Ταμπλό → άλλες εφαρμογές | FHIR R4, με τη συγκατάθεση του ασθενούς | Ένα πρότυπο για κάθε καταναλωτή |
Τι δεν είναι
- Όχι ροή από μόνιτορ ασθενούς. Το Anpheros δέχεται εργαστηριακές αναφορές μέσω HTTPS. Δεν λαμβάνει συνεχείς κυματομορφές ή ροές συσκευών από μόνιτορ εντατικής θεραπείας, και δεν είναι σύστημα συναγερμού: οι ειδοποιήσεις που επηρεάζουν τη φροντίδα απαιτούν πιστοποιημένο κλινικό σύστημα.
- Όχι μηχανή διεπαφής MLLP. Τα μηνύματα φτάνουν μέσω HTTPS. εάν το εργαστήριό σας μιλάει μόνο MLLP μέσω TCP, μια μηχανή διεπαφής μπροστά τα προωθεί.
- Ένας τύπος μηνύματος HL7 v2. Γίνονται αποδεκτά εργαστηριακά αποτελέσματα ORU^R01. παραγγελίες (ORM/OML) και μηνύματα ADT δεν γίνονται δεκτά.
Συχνές Ερωτήσεις
Μπορεί ένα dashboard να διαβάσει απευθείας αποτελέσματα εργαστηρίου HL7 v2;
Μπορεί, αλλά κάθε dashboard χρειάζεται τότε τον δικό του parser HL7 v2, αντιστοίχιση κωδικών και αφαίρεση διπλοτύπων. Η μετατροπή μία φορά σε FHIR R4 Observations με κωδικούς LOINC δίνει σε κάθε οθόνη τα ίδια καθαρά δεδομένα.
Πόσο γρήγορα φτάνουν τα εισαγόμενα αποτελέσματα στο dashboard;
Το αίτημα εισαγωγής επιστρέφει όταν οι Observations αποθηκευτούν, και ταυτόχρονα τίθεται σε ουρά ένα resource.created webhook για καθεμία από αυτές. Η παράδοση επαναλαμβάνεται εάν το endpoint σας δεν είναι διαθέσιμο.
Πώς επισημαίνονται τα μη φυσιολογικά αποτελέσματα;
Το OBX-8 γίνεται το interpretation της Observation (για παράδειγμα H ή L) και το OBX-7 το referenceRange της, ώστε το dashboard να μπορεί να εμφανίζει τόσο την επισήμανση όσο και το φυσιολογικό εύρος.
Υποστηρίζει το Anpheros την παρακολούθηση ΜΕΘ;
Όχι. Αποθηκεύει εργαστηριακά και κλινικά αποτελέσματα και ειδοποιεί τα συστήματά σας για νέα δεδομένα· η συνεχής παρακολούθηση στο κρεβάτι και οι κλινικοί συναγερμοί παραμένουν με πιστοποιημένες ιατρικές συσκευές.
Σχετικά
- API αποτελεσμάτων εργαστηρίου: HL7 v2, FHIR και LOINC
- Πώς να εισαγάγετε αποτελέσματα εργαστηρίου σε ένα αρχείο FHIR
- Συνδετήρας εργαστηρίου: η αναφορά του τελικού σημείου
- FHIR vs HL7 v2: πρακτικές διαφορές
- Απομακρυσμένη παρακολούθηση ασθενών με FHIR
- Webhooks
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card