Generated from smart-base/L4/skills/smart-l4/apply-decision-support.md — do not edit here.

✎ Edit this page’s source

Apply decision support

Skill id: apply-decision-support · Package: authoring-who-smart-guidelines · Task Task_Apply of act-on-decision-support.bpmn (Process_ActOnDecisionSupport), lane point-of-care-system.

Performed by a system. It computes guidance; it never acts on it. Only the health worker’s decision, carried out by activate-accepted-guidance, changes the client’s record.

The operation is FHIR PlanDefinition/$apply as HL7 CPG-on-FHIR profiles it: a DAK’s decision tables (L2 DMN) are published at L3 as PlanDefinitions with CQL libraries, and $apply evaluates one for one subject. A CDS service reached through CDS Hooks 2.0 returns the same proposal as cards whose suggestions carry the resources.

Input and output

The contract is input.schema.json and output.schema.json.

  • In: the planDefinition canonical, the subject, and optionally the encounter, the practitioner and the data (a Bundle) to evaluate against when the record is not on the server.
  • Out: the requestGroup (RequestGroup or RequestOrchestration), each action’s resource with status: draft and intent: proposal, and the cards when the guidance came through CDS Hooks.

Success criteria

  • Nothing is written to the client’s record: every created request is a draft proposal, held with the RequestGroup.
  • Every action carries the PlanDefinition action it came from, and its documentation or card detail says why, so the health worker can judge it without opening anything else.
  • No applicable action is an empty RequestGroup, not an error, and the process ends without asking the health worker anything.

Input and output contracts

What this skill takes and gives, as a class diagram drawn from its JSON Schema contracts by the schemas viewer’s own renderer. Each box links to its definition; each type to its specification.

input [1..1]output [1..1]subject [1..1]encounter [0..1]practitioner [0..1]data [0..1]cards [0..*]apply-decision-support«skill»apply-decision-supportinput : ApplyDecisionSupportInput [1..1]output : ApplyDecisionSupportOutput [1..1]ApplyDecisionSupportInput«json-schema»ApplyDecisionSupportInputplanDefinition : string [1..1]subject : ApplyDecisionSupportInput.subject [1..1]encounter : ApplyDecisionSupportInput.encounter [0..1]practitioner : ApplyDecisionSupportInput.practitioner [0..1]data : ApplyDecisionSupportInput.data [0..1]ApplyDecisionSupportInput.subject«json-schema»ApplyDecisionSupportInput.subjectreference : string [0..1]display : string [0..1]ApplyDecisionSupportInput.encounter«json-schema»ApplyDecisionSupportInput.encounterreference : string [0..1]display : string [0..1]ApplyDecisionSupportInput.practitioner«json-schema»ApplyDecisionSupportInput.practitionerreference : string [0..1]display : string [0..1]ApplyDecisionSupportInput.data«json-schema»ApplyDecisionSupportInput.dataresourceType : "Bundle" [1..1]ApplyDecisionSupportOutput«json-schema»ApplyDecisionSupportOutputrequestGroup : object | object [0..1]cards : ApplyDecisionSupportOutput.cards[] [0..*]ApplyDecisionSupportOutput.cards«json-schema»ApplyDecisionSupportOutput.cardsuuid : string [0..1]summary : string [1..1]detail : string [0..1]indicator : "info" | "warning" | "critical" [1..1]source : object [1..1]suggestions : unknown[] [0..*]

Processes that run this skill

processstep(s) that name it
Act on decision-support guidanceApply the PlanDefinition

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev