Skip to content

Workflow Library

The Workflow Library provides decision support logic and analytics in clinical workflows. Authors of digital guidelines develop reports (Measure) and individualized clinical procedures (PlanDefinition) to be run on FHIR Databases. Both assets rely on FHIR Libraries that can be written in Clinical Quality Language or FhirPath. To execute such workflows, this library implements the two major FHIR operations, Measure $Evaluate and Plan Definition $Apply, as well as the lower-level Library $Evaluate operation:

  1. The Measure resource is a reporting-definition tool that supports the evaluation of clinical measures, such as the percentage of patients who received a recommended screening or the number of patients with a specific condition who received appropriate treatment. The output of this operation will be a Report resource, which includes the results of the evaluation. The Report resource will include details about the individual measures that were evaluated, the scores for those measures, and any relevant supporting information. It may also include references to other resources that are relevant to the evaluation, such as observations or procedures that were used to calculate the measure scores. These calculations can be used to assess the performance of a healthcare provider or organization and can help identify areas for improvement.

  2. The PlanDefinition resource describes a plan or protocol for the care of a given patient. This could include a treatment plan for a specific condition, a discharge plan for a hospitalized patient, or a care plan for managing chronic illness. The output of this operation will be a CarePlan resource, which represents the plan that has been tailored and applied to the specific patient or group of patients. The CarePlan resource will include details about the actions that are part of the plan, the timing and frequency of those actions, and any relevant supporting information. It may also include references to other resources that are relevant to the plan, such as observations or procedures that are part of the plan. The Apply operator can be used to determine the specific actions or interventions that should be taken as part of a care plan, based on the patient's current status and other relevant factors. For example, it could be used to determine which medications a patient should be prescribed or to identify any necessary referrals to other healthcare providers.

  3. The Activity Flow is based on the workflow module in FHIR. It is used to create activities for the request resources generated in a CarePlan and take them through the various phases(proposal, plan, order, and perform) of the activity lifecycle.

  4. The Library resource describes a container for clinical knowledge assets. One of these assets is a shareable library of clinical logic, written in Clinical Quality Language (CQL). Users of the Workflow library can call an evaluation operator directly from the Library resource and run individual expressions at will. The output will be Parameters resource with the results of each expression evaluated. This operator should be used when the use case does not fit into a PlanDefinition or a Measure Evaluate.

It's recommended that these 3 types of resources are authored within the scope of a FHIR IG. The IG can then be published online and imported by the Android SDK. To import an IG, Android SDK users must simply copy the required files from the IG package into the assets folder and parse those files using the regular FHIR Parser.

The workflow library is dependent on the Engine library. Operations execute over the dataset saved in the FhirEngine instance.

Future features of the library will provide support for Tasking and other Workflow related requirements

Next steps

Data safety

This library does not collect or share any personal or sensitive user data with any third party libraries or SDKs.