CDS Hooks ismertetése: hookok, kártyák, előzetes lekérdezés

Rövid válasz: A CDS Hooks egy HL7 szabvány, amely lehetővé teszi, hogy egy elektronikus egészségügyi nyilvántartás (EHR) külső klinikai döntéstámogató szolgáltatást hívjon meg a klinikus munkafolyamatának meghatározott pontjain (hookok): betegdokumentum megnyitása (patient-view), rendelés kiválasztása (order-select), rendelések aláírása (order-sign), vizit indítása vagy befejezése. Az EHR elküldi a kontextust és opcionálisan előre betöltött FHIR adatokat; a szolgáltatás másodperceken belül válaszol kártyákkal: rövid információkkal, figyelmeztetésekkel vagy javaslatokkal, valamint hivatkozásokkal, amelyek elindíthatnak egy SMART on FHIR alkalmazást. A klinikus az EHR-ben marad; az intelligencia azon kívül él.

A három lépés

A CDS Hooks három lépésben működik. Először a felfedezés: az EHR lekéri a GET /cds-services parancsot, és megtudja, melyik hook-ra melyik szolgáltatás válaszol, és mely FHIR adatokat szeretne előre lekérni. Másodszor a hook hívása: egy munkafolyamat-esemény, például egy rendelés aláírása során az EHR elküldi a kontextust és az előre lekérte erőforrásokat a szolgáltatásnak. Harmadszor a válasz: a szolgáltatás kártyákat ad vissza, amelyeket az EHR megjelenít.

1. Felderítés. Az EHR lekéri a GET https://cds.example.org/cds-services címet, és megkapja a szolgáltatások listáját, mindegyikhez megadva a hookot, amelyre válaszol, és az FHIR lekérdezéseket, amelyeket előre szeretne betölteni:

{
  "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. A hook hívása. Amikor a klinikus aláírja a rendeléseket, az EHR POST kérést küld a /cds-services/renal-dosing címre:

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

Ha valami, amire a szolgáltatásnak szüksége van, nem volt előre betöltve, akkor maga is lekérdezheti az EHR FHIR szerverét a fhirAuthorization-ban található, rövid élettartamú token segítségével.

3. A válasz. Kártyák, és a 2.0 verzióban rendszereszközök is:

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

A summary 140 karakterre korlátozódik; az indicator info, warning vagy critical; a source kötelező, hogy a klinikus tudja, ki beszél. A suggestions konkrét módosításokat javasolhat (létrehozás, frissítés vagy törlés egy piszkozat erőforrásból), amelyeket a klinikus egy kattintással elfogadhat; az links smart típusú hivatkozásai kontextusban nyitnak meg egy SMART alkalmazást. Az EHR a kártyákat a saját stílusában jeleníti meg; a szolgáltatás soha nem rajzol saját felhasználói felületet az EHR-en belül.

A 2.0 verzió újdonságai

A CDS Hooks 2.0 verziója, amelyet 2022-ben adtak ki, tartalmaz egy visszajelzési végpontot, amelyen keresztül az EHR jelenti, hogy egy kártyát elfogadtak-e, okkal felülbíráltak-e vagy figyelmen kívül hagytak-e; systemActions, amelyeket az EHR kérés nélkül alkalmaz az alacsony kockázatú karbantartáshoz; a fhirAuthorization.subject mezőt; és világosabb selectionBehavior szabályokat (at-most-one vagy any) a javaslatokhoz.

2022-ben jelent meg: egy visszajelzési végpont (POST /cds-services/{id}/feedback), amelyen keresztül az EHR jelenti, hogy egy kártyát elfogadtak, felülbíráltak (okok megadásával) vagy figyelmen kívül hagytak; systemActions, amelyek olyan módosítások, amelyeket az EHR kérdezés nélkül alkalmaz, alacsony kockázatú karbantartási feladatokra szánva, mint például egy kódolt ok hozzáadása; fhirAuthorization.subject; és egyértelműbb szabályok a javaslatok selectionBehavior (at-most-one vagy any) beállítására.

Mi egy szolgáltatás, és mi nem

A CDS Hooks szolgáltatás egy olyan szoftver, amely elemzi a munkafolyamat kontextusát és információkat ad vissza kártyák formájában; ez önmagában nem orvostechnikai eszköz. Az, hogy az orvostechnikai eszközökre vonatkozó szabályok érvényesek-e az EU-ban és az USA-ban, a tartalomtól függ: egy klinikus emlékeztetése arra, hogy létezik egy laboratóriumi érték, információ; míg egy betegspecifikus dózisajánlás szabályozott döntéstámogatás.

A CDS szolgáltatás egy olyan szoftver, amely kontextust olvas és információt ad vissza. Az, hogy orvostechnikai eszköznek minősül-e, attól függ, mit tartalmaznak a kártyák: egy emlékeztető, hogy létezik egy laborérték, információ; egy dózisajánlás egy konkrét beteg számára döntéstámogatás, amely az EU-ban és az USA-ban az orvostechnikai eszközökre vonatkozó szabályozás alá esik. Lásd: Az egészségügyi alkalmazás orvostechnikai eszköz?. A szabvány semleges; a tartalom nem.

A jelenleg definiált hookok: patient-view, order-select, order-sign, order-dispatch, encounter-start, encounter-discharge, appointment-book, egy nyilvános katalógussal, ahol új hookokat javasolhatnak.

Kapcsolat a SMART on FHIR-rel

A CDS Hooks és a SMART on FHIR kiegészítik egymást. A SMART on FHIR elindít egy alkalmazást, amely átveszi a képernyő egy részét, és a felhasználó engedélyével lekérdezi a FHIR szervert; a CDS Hooks a háttérben fut, és kártyákat jelenít meg az EHR saját felületén. Egy kártya tartalmazhat SMART indító linket, ha több mint egy kártyára van szükség.

A SMART on FHIR egy alkalmazást indít el, amely átveszi a képernyő egy részét, és a felhasználó engedélyével kommunikál a FHIR szerverrel. A CDS Hooks a háttérben fut és kártyákat ad vissza; egy kártya magában foglalhat egy SMART indító hivatkozást, ha több mint egy kártyára van szükség. A legtöbb döntéstámogató termék mindkettőt használja: a hookokat az ösztönzéshez, a SMART alkalmazást a részletekhez.

Hol illeszkedik be az Anpheros

Az Anpheros nem kínál CDS Hooks szolgáltatást, és nem ad ki klinikai ajánlásokat. Az FHIR rekordja, a beteg beleegyezésével, lehet az az adat, amelyet egy kórház saját döntéstámogató szolgáltatása olvas (gyógyszerek, allergiák, legutóbbi eredmények), ugyanazon az FHIR API-n keresztül, amelyet egy hook szolgáltatás használna. Lásd: Beteg beleegyezési platform.

Kapcsolódó oldalak

Források

Gyakori kérdések

A CDS Hooks része a FHIR-nek?

Ez egy különálló HL7 specifikáció, amely az adatait FHIR formátumban használja: az előre betöltés és a kontextus FHIR erőforrásokat tartalmaz, az engedélyezés pedig újra felhasználja a SMART on FHIR tokeneket. Az HL7 a FHIR mellett teszi közzé, nem a FHIR specifikáción belül.

Milyen gyorsan kell válaszolnia egy CDS szolgáltatásnak?

A specifikáció nem határoz meg számot, de az EHR-ek néhány másodperces időtúllépést alkalmaznak, és elvetik a késő válaszokat, mert a klinikus vár. Az előre betöltés pontosan azért létezik, hogy a szolgáltatás ne töltse ezt az időt lekérdezéssel.

Módosíthat egy CDS szolgáltatás a rendelésen?

Csak javaslatot téve, amelyet a klinikus elfogad, vagy a 2.0 verzióban a systemActions révén, amelyeket az EHR automatikusan alkalmazni fog az adott szolgáltatásra. A szolgáltatás egy hook során soha nem ír önállóan az EHR FHIR szerverére.

Használ egy betegalkalmazás CDS Hooks-ot?

Nem. A CDS Hooks a klinikusoknak szánt EHR munkafolyamatokhoz készült. A betegalkalmazások közvetlenül használják a FHIR API-t és a SMART on FHIR-t a bejelentkezéshez.

Anpheros Platform

Próbálja ki ingyen a sandboxban

Az első FHIR-hívás 5 perc alatt. Egy HL7 FHIR R4 API, amely tartalmazza a beteg beleegyezését: próbáld ki a sandboxban, majd csatlakoztasd saját alkalmazásodat vagy klinikai rendszeredet.

Ingyenes sandbox létrehozása Olvasd el a fejlesztői útmutatókat →

Ingyenes · 30 szintetikus beteg · kártya nélkül

Ez az útmutató tájékoztató jellegű, és nem helyettesíti az orvosi tanácsot. Az egészségeddel kapcsolatos döntésekhez beszélj az orvosoddal. Vészhelyzetben hívja a helyi segélyhívó számot (Európában 112).

Szerző:

Az Anpheros csapata

Az Anpheros egy olyan egészségügyi nyilvántartást épít, amelyet a beteg irányít, és megoszthat bármelyik klinikával, egy EU-ban működő HL7 FHIR R4 platformon. Ezek az útmutatók segítenek megérteni és rendszerezni az egészségügyi adataidat; nem helyettesítik az orvosodat.

Tudj meg többet az Anpherosról →