diff --git a/docs/hooks/patient-view.md b/docs/hooks/patient-view.md index 1bc3f6f3..2f254f6a 100644 --- a/docs/hooks/patient-view.md +++ b/docs/hooks/patient-view.md @@ -12,7 +12,9 @@ The user has just opened a patient's record. ## Context -The patient whose record was opened, including their encounter, if applicable. +The patient whose record was opened, including their encounter, if applicable. + +The FHIR resources, referenced by ids in `context`, SHOULD be available to the CDS service. If supported by the CDS Client, the CDS service may request these resources through prefetch. Alternatively or additionally the CDS Client may provide a `fhirserver` in the request for RESTful access. Support for both `prefetch` and `fhirServer` are optional. As such, CDS Service implementers need to be aware that CDS Clients may not support this behavior. Field | Optionality | Prefetch Token | Type | Description ----- | -------- | ---- | ---- | ---- @@ -20,6 +22,8 @@ Field | Optionality | Prefetch Token | Type | Description `patientId` | REQUIRED | Yes | *string* | The FHIR `Patient.id` of the current patient in context `encounterId` | OPTIONAL | Yes | *string* | The FHIR `Encounter.id` of the current encounter in context +The `patient-view` hook allows a CDS Service to provide guidance based on information acquired using a prefetch template and the FHIR server. A variety of factors could cause this information to become outdated. Stale clinical data could result in a risk to patient safety. For information on patient safety issues see [Security & Safety](../../specification/1.0/#security-and-safety). + ### Examples ```json