Skip to content

Quality Measure Processing

Jump to bottom
Ivan Baisi edited this page Apr 30, 2024 · 15 revisions

Quality measure processing, part of FHIR's Quality Reporting use case, provides the means for evaluating quality measures.

Usage

  • Build project: mvn package
  • Spin up server: java -jar server/target/cqf-ruler-server-*.war
  • Load resources necessary to run your quality measure (including terminology if you do not have access to a terminology service)

Request Format

{} - required, () - optional

{BASE}/Measure/{measureID}/$evaluate-measure?(patient=patientID | practitioner=practitionerId)&(reportType=patient | reportType=patient-list | reportType=population)&{periodStart=StartDate}&{periodEnd=EndDate}&(source=URL of Terminology provider)&(user=username for provider auth)&(pass=password for provider auth)

Examples

The following example screening measures can be found in the Quality Measure Implementation Guide.

Breast Cancer Screening (EXM125)

For reference: CQL Source

Steps to run:

  1. Load the FHIR Library resource. If you need guidance on how to load resources, refer to the Resource Loading section of this wiki.
  2. Load the FHIR Measure resource.
  3. Load necessary terminology (CodeSystems and ValueSets - may be provided upon request)
  4. Load test data (resources associated with test patients - may be provided upon request)
  5. Run the measure using the request format outlined above. For example the following is a request for a patient-level evaluation:
  • {BASE}/Measure/measure-exm125-FHIR/$evaluate-measure?patient=Patient/example&periodStart=2018-01-01&periodEnd=2018-12-31

TODO: Add link to test in the test suite repository when added

Colorectal Cancer Screening (EXM130)

For reference: CQL Source

Steps to run:

  1. Load the FHIR Library resource. If you need guidance on how to load resources, refer to the Resource Loading section of this wiki.
  2. Load the FHIR Measure resource.
  3. Load necessary terminology (CodeSystems and ValueSets - may be provided upon request)
  4. Load test data (resources associated with test patients - may be provided upon request)
  5. Run the measure using the request format outlined above. For example the following is a request for a practitioner-level (patient-list) evaluation:
  • {BASE}/Measure/measure-exm130-FHIR/$evaluate-measure?practitioner=Practitioner/example&periodStart=2018-01-01&periodEnd=2018-12-31

TODO: Add link to test in the test suite repository when added

Cervical Cancer Screening (EXM124)

For reference: CQL Source

Steps to run:

  1. Load the FHIR Library resource. If you need guidance on how to load resources, refer to the Resource Loading section of this wiki.
  2. Load the FHIR Measure resource.
  3. Load necessary terminology (CodeSystems and ValueSets - may be provided upon request)
  4. Load test data (resources associated with test patients - may be provided upon request)
  5. Run the measure using the request format outlined above. For example the following is a request for a practitioner-level (patient-list) evaluation:
  • {BASE}/Measure/measure-exm124-FHIR/$evaluate-measure?practitioner=Practitioner/example&periodStart=2018-01-01&periodEnd=2018-12-31

TODO: Add link to test in the test suite repository when added

Clone this wiki locally