Σύντομη απάντηση: Το CDS Hooks είναι ένα πρότυπο HL7 που επιτρέπει σε ένα EHR να καλεί μια εξωτερική υπηρεσία υποστήριξης κλινικών αποφάσεων σε καθορισμένες στιγμές (hooks) στη ροή εργασίας ενός κλινικού: άνοιγμα του φακέλου ενός ασθενούς (patient-view), επιλογή μιας παραγγελίας (order-select), υπογραφή παραγγελιών (order-sign), έναρξη ή λήξη μιας περίθαλψης. Το EHR στέλνει το πλαίσιο και, προαιρετικά, προ-ανακτημένα δεδομένα FHIR. Η υπηρεσία απαντά μέσα σε δευτερόλεπτα με κάρτες: σύντομες πληροφορίες, προειδοποιήσεις ή προτάσεις, και συνδέσμους που μπορούν να εκκινήσουν μια εφαρμογή SMART on FHIR. Ο κλινικός παραμένει στο EHR. η ευφυΐα ζει εκτός αυτού.
Τα τρία βήματα
Το CDS Hooks λειτουργεί σε τρία βήματα. Πρώτον, ανακάλυψη: το Ηλεκτρονικό Φάκελο Υγείας (ΗΦΥ) ανακτά το GET /cds-services και μαθαίνει σε ποιον "hook" απαντά κάθε υπηρεσία και ποια δεδομένα FHIR θέλει να προ-ανακτήσει. Δεύτερον, η κλήση "hook": σε ένα συμβάν ροής εργασίας, όπως η υπογραφή μιας παραγγελίας, το ΗΦΥ στέλνει (POST) το πλαίσιο και τους προ-ανακτηθέντες πόρους στην υπηρεσία. Τρίτον, η απάντηση: η υπηρεσία επιστρέφει κάρτες που το ΗΦΥ εμφανίζει.
1. Ανακάλυψη. Το EHR ανακτά GET https://cds.example.org/cds-services και λαμβάνει τη λίστα των υπηρεσιών, καθεμία με το hook στο οποίο ανταποκρίνεται και τα ερωτήματα FHIR που θα ήθελε να προ-ανακτηθούν:
{
"services": [{
"id": "renal-dosing",
"hook": "order-sign",
"title": "Renal dosing check",
"description": "Flags drug orders whose dose needs review against the latest eGFR.",
"prefetch": {
"patient": "Patient/{{context.patientId}}",
"egfr": "Observation?patient={{context.patientId}}&code=http://loinc.org|98979-8&_sort=-date&_count=1"
}
}]
}
2. Η κλήση hook. Όταν ο κλινικός υπογράφει παραγγελίες, το EHR στέλνει POST στο /cds-services/renal-dosing:
{
"hookInstance": "d1577c69-dfbe-44ad-ba6d-3e05e953b2ea",
"hook": "order-sign",
"fhirServer": "https://ehr.example.org/fhir",
"fhirAuthorization": {"access_token": "…", "token_type": "Bearer", "expires_in": 300, "scope": "patient/*.read", "subject": "renal-dosing"},
"context": {
"userId": "Practitioner/42",
"patientId": "123",
"draftOrders": {"resourceType": "Bundle", "entry": [{"resource": {"resourceType": "MedicationRequest", "id": "draft-1", "status": "draft"}}]}
},
"prefetch": {
"patient": {"resourceType": "Patient", "id": "123"},
"egfr": {"resourceType": "Bundle", "type": "searchset", "entry": [{"resource": {"resourceType": "Observation", "id": "obs-9", "status": "final", "code": {"coding": [{"system": "http://loinc.org", "code": "98979-8"}]}, "valueQuantity": {"value": 38, "unit": "mL/min/1.73m2"}}}]}
}
}
Εάν κάτι που χρειάζεται η υπηρεσία δεν προ-ανακτήθηκε, μπορεί να κάνει ερώτημα στον FHIR server του EHR με το βραχύβιο token στο fhirAuthorization.
3. Η απάντηση. Κάρτες, και στην έκδοση 2.0 επίσης ενέργειες συστήματος:
{
"cards": [{
"uuid": "9a1d2f3e-…",
"summary": "eGFR 38: dose review suggested",
"indicator": "warning",
"detail": "The most recent eGFR (38 mL/min/1.73m², 2026-03-10) is below the threshold in the local renal dosing guidance for this drug.",
"source": {"label": "Hospital renal dosing guidance", "url": "https://intranet.example.org/renal"},
"suggestions": [{"label": "Open renal dosing table", "uuid": "…", "actions": []}],
"links": [{"label": "Dosing calculator", "url": "https://apps.example.org/renal/launch", "type": "smart"}]
}]
}
Η summary περιορίζεται σε 140 χαρακτήρες. ο indicator είναι info, warning ή critical. η source είναι υποχρεωτική, ώστε ο κλινικός να γνωρίζει ποιος μιλάει. Οι suggestions μπορεί να προτείνουν συγκεκριμένες αλλαγές (δημιουργία, ενημέρωση ή διαγραφή ενός προσχεδίου πόρου) που ο κλινικός αποδέχεται με ένα κλικ. οι links τύπου smart ανοίγουν μια εφαρμογή SMART στο πλαίσιο. Το EHR αποδίδει τις κάρτες με το δικό του στυλ. η υπηρεσία δεν σχεδιάζει ποτέ το δικό της UI μέσα στο EHR.
Προσθήκες στην έκδοση 2.0
Η έκδοση 2.0 του CDS Hooks, που δημοσιεύθηκε το 2022, πρόσθεσε ένα τελικό σημείο ανατροφοδότησης μέσω του οποίου το ΗΦΥ αναφέρει εάν μια κάρτα έγινε αποδεκτή, παρακάμφθηκε με αιτιολογίες ή αγνοήθηκε· τα "systemActions", αλλαγές που εφαρμόζει το ΗΦΥ χωρίς να ρωτήσει, για διαχείριση χαμηλού κινδύνου· το πεδίο "fhirAuthorization.subject"· και σαφέστερους κανόνες "selectionBehavior" (το πολύ μία ή οποιαδήποτε) για τις προτάσεις.
Δημοσιεύτηκε το 2022: ένα τελικό σημείο feedback (POST /cds-services/{id}/feedback) μέσω του οποίου το EHR αναφέρει εάν μια κάρτα έγινε αποδεκτή, παρακάμφθηκε (με λόγους) ή αγνοήθηκε. systemActions, αλλαγές που εφαρμόζει το EHR χωρίς να ρωτήσει, προορίζονται για καθαρισμό χαμηλού κινδύνου, όπως η προσθήκη ενός κωδικοποιημένου λόγου. fhirAuthorization.subject. και σαφέστεροι κανόνες για το selectionBehavior (at-most-one ή any) για τις προτάσεις.
Τι είναι και τι δεν είναι μια υπηρεσία
Μια υπηρεσία CDS Hooks είναι λογισμικό που διαβάζει το πλαίσιο της ροής εργασίας και επιστρέφει πληροφορίες ως κάρτες· δεν είναι αυτόματα ιατροτεχνολογικό προϊόν. Το αν ισχύουν οι κανόνες για ιατροτεχνολογικά προϊόντα στην ΕΕ και τις ΗΠΑ εξαρτάται από το περιεχόμενο: η υπενθύμιση σε έναν κλινικό ότι υπάρχει μια εργαστηριακή τιμή είναι πληροφορία, ενώ μια σύσταση δοσολογίας ειδικά για τον ασθενή είναι ρυθμιζόμενη υποστήριξη απόφασης.
Μια υπηρεσία CDS είναι λογισμικό που διαβάζει το πλαίσιο και επιστρέφει πληροφορίες. Εάν είναι ιατρική συσκευή εξαρτάται από το τι λένε οι κάρτες: μια υπενθύμιση ότι υπάρχει μια εργαστηριακή τιμή είναι πληροφορία. μια σύσταση δόσης για έναν συγκεκριμένο ασθενή είναι υποστήριξη αποφάσεων που εμπίπτει στους κανόνες ιατρικών συσκευών στην ΕΕ και στις ΗΠΑ. Δείτε Είναι μια εφαρμογή υγείας ιατρική συσκευή;. Το πρότυπο είναι ουδέτερο. το περιεχόμενο όχι.
Hooks που ορίζονται σήμερα: patient-view, order-select, order-sign, order-dispatch, encounter-start, encounter-discharge, appointment-book, με έναν δημόσιο κατάλογο όπου προτείνονται νέα hooks.
Σχέση με το SMART on FHIR
Το CDS Hooks και το SMART on FHIR συμπληρώνουν το ένα το άλλο. Το SMART on FHIR εκκινεί μια εφαρμογή που αναλαμβάνει μέρος της οθόνης και κάνει ερωτήματα στον διακομιστή FHIR με την άδεια του χρήστη· το CDS Hooks εκτελείται στο παρασκήνιο και επιστρέφει κάρτες στην δική του διεπαφή του ΗΦΥ. Μια κάρτα μπορεί να περιέχει έναν σύνδεσμο εκκίνησης SMART όταν χρειάζεται κάτι παραπάνω από μια κάρτα.
Το SMART on FHIR εκκινεί μια εφαρμογή που αναλαμβάνει μέρος της οθόνης και επικοινωνεί με τον FHIR server με την άδεια του χρήστη. Το CDS Hooks εκτελείται στο παρασκήνιο και επιστρέφει κάρτες. μια κάρτα μπορεί να φέρει έναν σύνδεσμο εκκίνησης SMART όταν χρειάζεται κάτι περισσότερο από μια κάρτα. Τα περισσότερα προϊόντα υποστήριξης αποφάσεων χρησιμοποιούν και τα δύο: hooks για την υπενθύμιση, μια εφαρμογή SMART για τη λεπτομέρεια.
Πού εντάσσεται το Anpheros
Το Anpheros δεν προσφέρει υπηρεσία CDS Hooks και δεν παράγει κλινικές συστάσεις. Το αρχείο FHIR του, με τη συγκατάθεση του ασθενούς, μπορεί να είναι τα δεδομένα που διαβάζει η υπηρεσία υποστήριξης αποφάσεων του νοσοκομείου (φάρμακα, αλλεργίες, πρόσφατα αποτελέσματα), μέσω του ίδιου FHIR API που θα χρησιμοποιούσε μια υπηρεσία hook. Δείτε Πλατφόρμα συναίνεσης ασθενούς.
Σχετικές σελίδες
- Επεξήγηση των FHIR Subscriptions
- Είναι μια εφαρμογή υγείας ιατρική συσκευή; EU MDR Rule 11
- Πλατφόρμα συναίνεσης ασθενούς
- Επεξήγηση αναζήτησης FHIR
- SMART on FHIR backend (developers)
- Πρότυπα διαλειτουργικότητας υγειονομικής περίθαλψης: ο χάρτης
- Επεξήγηση SMART App Launch
Πηγές
- Προδιαγραφή HL7 CDS Hooks 2.0
- CDS Hooks: κατάλογος hooks
- HL7 SMART App Launch
- HL7 FHIR R4: MedicationRequest
Συχνές ερωτήσεις
Είναι το CDS Hooks μέρος του FHIR;
Είναι μια ξεχωριστή προδιαγραφή HL7 που χρησιμοποιεί το FHIR για τα δεδομένα του: το prefetch και το context μεταφέρουν πόρους FHIR, και η εξουσιοδότηση επαναχρησιμοποιεί tokens SMART on FHIR. Δημοσιεύεται από το HL7 παράλληλα με το FHIR, όχι εντός της προδιαγραφής FHIR.
Πόσο γρήγορα πρέπει να απαντά μια υπηρεσία CDS;
Η προδιαγραφή δεν καθορίζει έναν αριθμό, αλλά τα EHR εφαρμόζουν χρονικά όρια λίγων δευτερολέπτων και απορρίπτουν καθυστερημένες απαντήσεις, επειδή ο κλινικός περιμένει. Το prefetch υπάρχει ακριβώς για να μην ξοδεύει η υπηρεσία αυτόν τον χρόνο κάνοντας ερωτήματα.
Μπορεί μια υπηρεσία CDS να αλλάξει την παραγγελία;
Μόνο προτείνοντας μια πρόταση που αποδέχεται ο κλινικός, ή, στην έκδοση 2.0, μέσω systemActions που το EHR έχει συμφωνήσει να εφαρμόζει αυτόματα για αυτήν την υπηρεσία. Η υπηρεσία δεν γράφει ποτέ στον FHIR server του EHR μόνη της κατά τη διάρκεια ενός hook.
Χρησιμοποιεί μια εφαρμογή ασθενούς το CDS Hooks;
Όχι. Το CDS Hooks έχει σχεδιαστεί για ροές εργασίας EHR που απευθύνονται σε κλινικούς. Οι εφαρμογές ασθενών χρησιμοποιούν απευθείας το FHIR API και το SMART on FHIR για τη σύνδεση.
Δοκιμάστε δωρεάν στο sandbox
Η πρώτη σας κλήση FHIR σε 5 λεπτά. Ένα API HL7 FHIR R4 με τη συγκατάθεση του ασθενούς ενσωματωμένη: δοκιμάστε το στο sandbox, στη συνέχεια συνδέστε τη δική σας εφαρμογή ή σύστημα κλινικής.
Δωρεάν · 30 συνθετικοί ασθενείς · χωρίς κάρτα
Το Anpheros δημιουργεί ένα ιατρικό αρχείο που ελέγχει ο ασθενής και μπορεί να μοιραστεί με οποιαδήποτε κλινική, σε πλατφόρμα HL7 FHIR R4, με έδρα την ΕΕ. Αυτοί οι οδηγοί σάς βοηθούν να κατανοήσετε και να οργανώσετε την υγεία σας· δεν αντικαθιστούν τον γιατρό σας.
Σχετικά με το Anpheros →