Proposed Hooks

Template

Please use the following template for proposing new hooks:

---

hook-name-expressed-as-noun-verb

Purpose: (Describe what this hook is for, when it occurs in a user's workflow, and what it returns.)

Contextual data: (Describe the set of contextual data required for this hook)

{
  "name": "context",
  "resource": {Example of contextual data}
}

---

Catalog of proposals

---

admit-discharge-transfer-create

Purpose: This hook informs an external CDS service that the user is preparing to ADT (admit, transfer or discharge).

Contextual data: Required Patient, ADT event is being initiated

{
  "name": "context",
  "resource": {Example of contextual data}
}

---

careplan-create

Purpose: Inform an external CDS service that the user is in the process of creating a new care plan for the patient and solicit feedback about this patient.

Contextual data: None required beyond default context.

lab-report-view

Purpose: This hook informs an external CDS service that a user has elected to view a lab report.

Contextual data: A Relative Resource Link to the Diagnostic Report the user would like to view

{
  "name": "context",
  "resource": DiagnosticReport/123
}

chief-complaint-create

Purpose: This hook informs an external CDS service that a user has created or updated a chief-complaint.

Contextual data: Required Patient, Chief complaint

{
  "name": "context",
  "resource": {Example of contextual data}
}

---

code-view

Purpose: This hook is for displaying information to the user about a code that is selected, whether they just selected it, or whether someone else already has. One kind of use is as a debugging tool in format viewers/middleware, but the output should be useful for end users in applications who would find it useful to see more information about a code. The output should be whatever information is deemed pertinent for this code

Contextual data:

{
  "name": "context",
  "resource": {
    "resourceType" : "Parameters",
    "parameter" [{
      "name" : "code",
      "value..." : {} // either a Coding or a CodeableConcept
    }]
  }
}

---

discharge-view

Purpose: This hook is for interacting with systems and applications at the time of discharge of a patient from a hospital or at time of generation of an after visit summary. This could be used to retrieve education materials (e.g., related to problems, procedures, medications) to aid in transitions of care and to enable the patient to better care for themselves.

Contextual data: Could be just about anything. Clinical might include MedicationOrders, Procedures, Conditions (problems). Could also be resources from other categories.

{
  "name": "context",
  "resource": {Example of contextual data}
}

---

identifier-view

Purpose: This hook is for displaying information to the user about an identifier that is selected, whether they just selected it, or whether someone else already has. One kind of use is as a debugging tool in format viewers/middleware, but the output should be useful for end users in applications who would find it useful to see more information about an identifier. The output should be whatever information is deemed pertinent for the identifier - typically, a human description of the system, and any information that is available at the type

Contextual data:

{
  "name": "context",
  "resource": {
    "resourceType" : "Parameters",
    "parameter" [{
      "name" : "identifier",
      "valueIdentifier" : { ... }
    }]
  }
}

---

patient-problem-list-update

Purpose: This hook informs an external CDS service that a user has created or updated a patient problem list.

Contextual data: Required Patient, Problems List (conditions)

{
  "name": "context",
  "resource": {Example of contextual data}
}

---

triage-update

Purpose: This hook informs an external CDS service that a user has created or updated triage status.

Contextual data: Required Patient

{
  "name": "context",
  "resource": {Example of contextual data}
}

---