Krátká odpověď: CDS Hooks je standard HL7, který umožňuje EHR (elektronické zdravotní záznamy) volat externí službu podpory klinického rozhodování v definovaných okamžicích (hooky) v pracovním postupu klinika: otevření karty pacienta (patient-view), výběr žádanky (order-select), podepisování žádanky (order-sign), zahájení nebo ukončení návštěvy. EHR odešle kontext a volitelně přednačtená data FHIR; služba odpoví během několika sekund kartami: krátkými informacemi, varováními nebo návrhy a odkazy, které mohou spustit aplikaci SMART on FHIR. Klinik se zůstává v EHR; inteligence žije mimo něj.
Tři kroky
CDS Hooks funguje ve třech krocích. Nejprve objevování: EHR načte GET /cds-services a zjistí, na které háčky jednotlivé služby reagují a jaká FHIR data si má přednačíst. Druhý krok, volání háčku: při události v pracovním postupu, jako je například podepsání objednávky, EHR odešle kontext a přednačtené zdroje službě pomocí POST. Třetí krok, odpověď: služba vrátí karty, které EHR zobrazí.
1. Zjišťování. EHR načte GET https://cds.example.org/cds-services a obdrží seznam služeb, z nichž každá obsahuje hook, na který reaguje, a FHIR dotazy, které by si přála přednačíst:
{
"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. Volání hooku. Když klinik podepisuje žádanky, EHR odešle POST na /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"}}}]}
}
}
Pokud něco, co služba potřebuje, nebylo přednačteno, může si sama dotázat FHIR server EHR pomocí krátkodobého tokenu v fhirAuthorization.
3. Odpověď. Karty a ve verzi 2.0 také systémové akce:
{
"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 je omezen na 140 znaků; indicator je info, warning nebo critical; source je povinný, aby klinik věděl, kdo mluví. suggestions mohou navrhovat konkrétní změny (vytvoření, aktualizace nebo smazání konceptu zdroje), které klinik přijme jedním kliknutím; links typu smart otevřou aplikaci SMART v kontextu. EHR vykresluje karty ve svém vlastním stylu; služba nikdy nekreslí vlastní uživatelské rozhraní uvnitř EHR.
Novinky ve verzi 2.0
CDS Hooks verze 2.0, publikovaná v roce 2022, přidala koncový bod pro zpětnou vazbu, prostřednictvím kterého EHR hlásí, zda byla karta přijata, zamítnuta s uvedením důvodů nebo ignorována; systemActions, změny, které EHR provádí bez dotazování, pro nízkorizikovou údržbu; pole fhirAuthorization.subject; a jasnější pravidla selectionBehavior (at-most-one nebo any) pro návrhy.
Publikováno v roce 2022: koncový bod zpětné vazby (POST /cds-services/{id}/feedback), prostřednictvím kterého EHR hlásí, zda byla karta přijata, přepsána (s důvody) nebo ignorována; systemActions, změny, které EHR provede bez dotazu, určené pro nízkorizikovou údržbu, jako je přidání kódovaného důvodu; fhirAuthorization.subject; a jasnější pravidla pro selectionBehavior (at-most-one nebo any) pro návrhy.
Co služba je a co není
Služba CDS Hooks je software, který čte kontext pracovního postupu a vrací informace ve formě karet; automaticky se nejedná o zdravotnický prostředek. Zda se pravidla pro zdravotnické prostředky v EU a USA použijí, závisí na obsahu: připomenutí lékaři, že existuje laboratorní hodnota, jsou informace, zatímco doporučení dávkování specifické pro pacienta je regulovaná podpora rozhodování.
Služba CDS je software, který čte kontext a vrací informace. Zda se jedná o zdravotnický prostředek, závisí na tom, co karty říkají: připomenutí, že existuje laboratorní hodnota, jsou informace; doporučení dávkování pro konkrétního pacienta je podpora rozhodování, která spadá pod pravidla pro zdravotnické prostředky v EU a USA. Viz Je zdravotnická aplikace zdravotnickým prostředkem?. Standard je neutrální; obsah nikoli.
Dnes definované hooky: patient-view, order-select, order-sign, order-dispatch, encounter-start, encounter-discharge, appointment-book, s veřejným katalogem, kde jsou navrhovány nové hooky.
Vztah k SMART on FHIR
CDS Hooks a SMART on FHIR se vzájemně doplňují. SMART on FHIR spustí aplikaci, která převezme část obrazovky a s autorizací uživatele se dotáže FHIR serveru; CDS Hooks běží na pozadí a vrací karty do vlastního rozhraní EHR. Karta může obsahovat odkaz na spuštění SMART, pokud je potřeba více než jen karta.
SMART on FHIR spouští aplikaci, která převezme část obrazovky a komunikuje s FHIR serverem s autorizací uživatele. CDS Hooks běží na pozadí a vrací karty; karta může nést odkaz na spuštění SMART, pokud je potřeba více než jen karta. Většina produktů pro podporu rozhodování využívá obojí: hooky pro pobídku, aplikaci SMART pro detaily.
Kde Anpheros zapadá
Anpheros nenabízí službu CDS Hooks a neposkytuje klinická doporučení. Jeho záznam FHIR, se souhlasem pacienta, může být daty, která čte vlastní služba podpory rozhodování nemocnice (léky, alergie, nedávné výsledky), prostřednictvím stejného FHIR API, které by používala služba hook. Viz Platforma pro souhlas pacienta.
Související stránky
- Vysvětlení FHIR Subscriptions
- Je zdravotnická aplikace zdravotnickým prostředkem? EU MDR Pravidlo 11
- Platforma pro souhlas pacienta
- Vysvětlení vyhledávání FHIR
- Backend SMART on FHIR (pro vývojáře)
- Standardy zdravotnické interoperability: mapa
- Vysvětlení SMART App Launch
Zdroje
- Specifikace HL7 CDS Hooks 2.0
- CDS Hooks: katalog hooků
- HL7 SMART App Launch
- HL7 FHIR R4: MedicationRequest
Časté otázky
Je CDS Hooks součástí FHIR?
Jedná se o samostatnou specifikaci HL7, která pro svá data používá FHIR: přednačtení a kontext přenáší zdroje FHIR a autorizace znovu používá tokeny SMART on FHIR. Je publikována HL7 vedle FHIR, nikoli uvnitř specifikace FHIR.
Jak rychle musí služba CDS odpovědět?
Specifikace nestanovuje číslo, ale EHR uplatňují časové limity několika sekund a zahazují pozdní odpovědi, protože klinik čeká. Přednačtení existuje právě proto, aby služba netrávila tento čas dotazováním.
Může služba CDS změnit žádanku?
Pouze navržením návrhu, který klinik přijme, nebo ve verzi 2.0 prostřednictvím systémových akcí, které EHR souhlasil s automatickým použitím pro danou službu. Služba se během hooku sama nepíše na FHIR server EHR.
Používá klientská aplikace CDS Hooks?
Ne. CDS Hooks je navržen pro pracovní postupy EHR zaměřené na kliniky. Klientské aplikace používají FHIR API přímo a SMART on FHIR pro přihlášení.
Vyzkoušejte zdarma v sandboxu
První volání FHIR za 5 minut. API standardu HL7 FHIR R4 s integrovaným souhlasem pacienta: vyzkoušejte si ho v sandboxu a poté propojte svou vlastní aplikaci nebo klinický systém.
Zdarma · 30 syntetických pacientů · bez karty
Anpheros vytváří zdravotní záznamy, které pacient ovládá a může sdílet s jakoukoli klinikou, na platformě HL7 FHIR R4 se sídlem v EU. Tyto průvodce vám pomohou porozumět vašemu zdraví a uspořádat si ho; nenahrazují vašeho lékaře.
O Anpheros →