Data Exchange For Quality Measures Implementation Guide
1.0.0-ballot - STU 1 Ballot International flag

Data Exchange For Quality Measures Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 1.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-deqm/ and changes regularly. See the Directory of published versions

: Measure - FHIRPath Example

Page standards status: Informative

Raw json | Download

{
  "resourceType" : "Measure",
  "id" : "FHIRPath-example",
  "language" : "en",
  "text" : {
    "status" : "extensions",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n  <table class=\"narrative-table\">\n    <tbody>\n<tr>\n\n<th colspan=\"2\" scope=\"row\" class=\"row-header\">Knowledge Artifact Metadata</th>\n\n</tr>\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Name (machine-readable)</th>\n\n<td class=\"content-container\">FHIRPath-example</td>\n</tr>\n\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Title (human-readable)</th>\n\n<td class=\"content-container\">Example of a Measure using FHIRPath</td>\n</tr>\n\n\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Status</th>\n\n<td class=\"content-container\">Draft</td>\n</tr>\n\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Experimental</th>\n\n<td class=\"content-container\">true</td>\n</tr>\n\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Description</th>\n\n<td class=\"content-container\"><div><p>This measure exemplifies use of FHIRPath expressions in a FHIR Measure</p>\n</div></td>\n</tr>\n\n\n\n\n\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Use Context</th>\n\n<td class=\"content-container\"><span title=\"{http://terminology.hl7.org/CodeSystem/usage-context-type focus}\">Clinical Focus</span> = <span title=\"Codes:{http://snomed.info/sct 840539006}\">COVID-19</span></td>\n</tr>\n\n\n\n\n\n\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Measure Steward</th>\n\n<td class=\"content-container\">HL7 International / Clinical Quality Information</td>\n</tr>\n\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Steward Contact Details</th>\n\n<td class=\"content-container\"><a href=\"http://www.hl7.org/Special/committees/cqi\">http://www.hl7.org/Special/committees/cqi</a></td>\n</tr>\n\n\n\n\n<tr>\n  \n  \n<th scope=\"row\" class=\"row-header\">Documentation</th>\n\n  \n  \n  \n  \n  <td class=\"content-container\">\n    \n    <em>Description</em>: CDC/NHSN COVID-19 Patient Impact &amp; Hospital Capacity Module Home Page\n    \n    <br/>\n    \n    \n    \n    \n    <em>Content URL</em>: <a href=\"https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/acute-care-hospital/covid19/\">https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/acute-care-hospital/covid19/</a>\n    \n    <br/>\n    \n    \n    \n    <em>Document</em>: null @ https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/acute-care-hospital/covid19/\n    \n    \n    \n  </td>\n</tr>\n\n<tr>\n  \n  \n<th scope=\"row\" class=\"row-header\">Documentation</th>\n\n  \n  \n  \n  \n  <td class=\"content-container\">\n    \n    <em>Description</em>: Importing COVID-19 Patient Module Denominator data for Patient Safety Component\n    \n    <br/>\n    \n    \n    \n    \n    <em>Content URL</em>: <a href=\"https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/import-covid19-data-508.pdf\">https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/import-covid19-data-508.pdf</a>\n    \n    <br/>\n    \n    \n    \n    <em>Document</em>: null @ https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/import-covid19-data-508.pdf\n    \n    \n    \n  </td>\n</tr>\n\n<tr>\n  \n  \n<th scope=\"row\" class=\"row-header\">Documentation</th>\n\n  \n  \n  \n  \n  <td class=\"content-container\">\n    \n    <em>Description</em>: Instructions for Completion of the COVID-19 Patient Impact and Hospital Capacity Module Form (CDC 57.130)\n    \n    <br/>\n    \n    \n    \n    \n    <em>Content URL</em>: <a href=\"https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/57.130-toi-508.pdf\">https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/57.130-toi-508.pdf</a>\n    \n    <br/>\n    \n    \n    \n    <em>Document</em>: null @ https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/57.130-toi-508.pdf\n    \n    \n    \n  </td>\n</tr>\n\n<tr>\n  \n  \n<th scope=\"row\" class=\"row-header\">Documentation</th>\n\n  \n  \n  \n  \n  <td class=\"content-container\">\n    \n    <em>Description</em>: CDC/NHSN COVID-19 Reporting CSV File Template\n    \n    <br/>\n    \n    \n    \n    \n    <em>Content URL</em>: <a href=\"https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/covid19-test-csv-import.csv\">https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/covid19-test-csv-import.csv</a>\n    \n    <br/>\n    \n    \n    \n    <em>Document</em>: null @ https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/covid19-test-csv-import.csv\n    \n    \n    \n  </td>\n</tr>\n\n\n\n\n\n\n\n\n\n\n<tr>\n\n<th colspan=\"2\" scope=\"row\" class=\"row-header\">Measure Metadata</th>\n\n</tr>\n\n\n\n\n\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Version Number</th>\n\n<td class=\"content-container\">1.0.0-ballot</td>\n</tr>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n  \n    <tr>\n\n<th colspan=\"2\" scope=\"row\" class=\"row-header\">Measure Population Criteria</th>\n\n</tr>\n  \n  \n  \n  \n    <tr>\n      \n        \n<th scope=\"row\" class=\"row-header\">Mechanical Ventilators</th>\n\n      \n      <td class=\"content-container\">\n        \n        \n          <em>Description</em>:\n          <p style=\"white-space: pre-line\" class=\"tab-one\">Count of all ventilators that can support patient care, whether or not they are presently in use.</p>\n        \n        \n          \n        \n      </td>\n    </tr>\n  \n\n  \n    <tr>\n      \n        \n<th scope=\"row\" class=\"row-header\">Mechanical Ventilators in Use</th>\n\n      \n      <td class=\"content-container\">\n        \n        \n          <em>Description</em>:\n          <p style=\"white-space: pre-line\" class=\"tab-one\">Count of all ventilators in use.</p>\n        \n        \n          \n        \n      </td>\n    </tr>\n  \n\n  \n    <tr>\n      \n        \n<th scope=\"row\" class=\"row-header\">Mechanical Ventilators Available</th>\n\n      \n      <td class=\"content-container\">\n        \n        \n          <em>Description</em>:\n          <p style=\"white-space: pre-line\" class=\"tab-one\">Count of all ventilators not presently in use.</p>\n        \n        \n          \n        \n      </td>\n    </tr>\n  \n\n  \n  \n\n\n\n\n\n\n\n\n\n\n\n\n\n<tr>\n\n<th colspan=\"2\" scope=\"row\" class=\"row-header\">Measure Logic</th>\n\n</tr>\n\n<tr>\n\n<th scope=\"row\" class=\"row-header\">Primary Library</th>\n\n<td class=\"content-container\"><code>http://example.org/fhir/Library/FHIRPath-example</code></td>\n</tr>\n\n\n\n\n<tr>\n  <th colspan=\"2\" scope=\"row\" class=\"row-header\">Generated using version 0.4.6 of the sample-content-ig Liquid templates</th>\n</tr>\n    </tbody>\n  </table>\n</div>"
  },
  "url" : "http://hl7.org/fhir/uv/deqm/Measure/FHIRPath-example",
  "identifier" : [
    {
      "system" : "urn:ietf:rfc:3986",
      "value" : "urn:oid:2.16.840.1.113883.4.642.40.42.29.4"
    }
  ],
  "version" : "1.0.0-ballot",
  "name" : "FHIRPath-example",
  "title" : "Example of a Measure using FHIRPath",
  "status" : "draft",
  "experimental" : true,
  "date" : "2024-05-18T21:25:01+00:00",
  "publisher" : "HL7 International / Clinical Quality Information",
  "contact" : [
    {
      "telecom" : [
        {
          "system" : "url",
          "value" : "http://www.hl7.org/Special/committees/cqi"
        }
      ]
    }
  ],
  "description" : "This measure exemplifies use of FHIRPath expressions in a FHIR Measure",
  "useContext" : [
    {
      "code" : {
        "system" : "http://terminology.hl7.org/CodeSystem/usage-context-type",
        "code" : "focus"
      },
      "valueCodeableConcept" : {
        "coding" : [
          {
            "system" : "http://snomed.info/sct",
            "code" : "840539006",
            "display" : "COVID-19"
          }
        ]
      }
    }
  ],
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code" : "001",
          "display" : "World"
        }
      ]
    }
  ],
  "relatedArtifact" : [
    {
      "type" : "documentation",
      "label" : "NHSN COVID-19 Reporting",
      "display" : "CDC/NHSN COVID-19 Patient Impact & Hospital Capacity Module Home Page",
      "url" : "https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/acute-care-hospital/covid19/",
      "document" : {
        "url" : "https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/acute-care-hospital/covid19/"
      }
    },
    {
      "type" : "documentation",
      "label" : "How to import COVID-19 Summary Data",
      "display" : "Importing COVID-19 Patient Module Denominator data for Patient Safety Component",
      "url" : "https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/import-covid19-data-508.pdf",
      "document" : {
        "url" : "https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/import-covid19-data-508.pdf"
      }
    },
    {
      "type" : "documentation",
      "label" : "Table of Instructions",
      "display" : "Instructions for Completion of the COVID-19 Patient Impact and Hospital Capacity Module Form (CDC 57.130)",
      "url" : "https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/57.130-toi-508.pdf",
      "document" : {
        "url" : "https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/57.130-toi-508.pdf"
      }
    },
    {
      "type" : "documentation",
      "label" : "CSV File Template",
      "display" : "CDC/NHSN COVID-19 Reporting CSV File Template",
      "url" : "https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/covid19-test-csv-import.csv",
      "document" : {
        "url" : "https://web.archive.org/web/20200501215043/https://www.cdc.gov/nhsn/pdfs/covid19/covid19-test-csv-import.csv"
      }
    }
  ],
  "library" : [
    "http://example.org/fhir/Library/FHIRPath-example"
  ],
  "group" : [
    {
      "extension" : [
        {
          "extension" : [
            {
              "url" : "subject",
              "valueCodeableConcept" : {
                "coding" : [
                  {
                    "system" : "http://hl7.org/fhir/resource-types",
                    "code" : "Device"
                  },
                  {
                    "system" : "http://snomed.info/sct",
                    "code" : "257463002",
                    "display" : "Ventilator Outlet"
                  }
                ],
                "text" : "Ventilator capacity"
              }
            },
            {
              "url" : "scoring",
              "valueCodeableConcept" : {
                "coding" : [
                  {
                    "system" : "http://example.org/fhir/",
                    "code" : "capacity"
                  }
                ]
              }
            },
            {
              "url" : "type",
              "valueCodeableConcept" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/measure-type",
                    "code" : "structure"
                  }
                ]
              }
            },
            {
              "url" : "improvementNotation",
              "valueCodeableConcept" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/measure-improvement-notation",
                    "code" : "decrease"
                  }
                ]
              }
            },
            {
              "url" : "rateAggregation",
              "valueString" : "point-in-time"
            }
          ],
          "url" : "http://example.org/fhir/MeasureGroupAttributes"
        }
      ],
      "code" : {
        "coding" : [
          {
            "system" : "http://example.org/fhir/",
            "code" : "Ventilators",
            "display" : "Ventilators"
          }
        ],
        "text" : "Ventilator Reporting"
      },
      "population" : [
        {
          "code" : {
            "coding" : [
              {
                "system" : "http://example.org/fhir/",
                "code" : "numVent",
                "display" : "Mechanical Ventilators"
              },
              {
                "system" : "http://terminology.hl7.org/CodeSystem/measure-population",
                "code" : "denominator"
              }
            ],
            "text" : "Total number of ventilators"
          },
          "description" : "Count of all ventilators that can support patient care, whether or not they are presently in use.",
          "criteria" : {
            "description" : "Computes the total number of ventilators from the previously reported MeasureReport",
            "name" : "NumVent",
            "language" : "text/fhirpath",
            "expression" : "iif(trace('PriorReport exists:', %PriorReport.exists()), %PriorReport.group[3].population[0].count, 0)"
          }
        },
        {
          "code" : {
            "coding" : [
              {
                "system" : "http://example.org/fhir/",
                "code" : "numVentUse",
                "display" : "Mechanical Ventilators in Use"
              },
              {
                "system" : "http://terminology.hl7.org/CodeSystem/measure-population",
                "code" : "numerator"
              }
            ],
            "text" : "Total number of ventilators in use"
          },
          "description" : "Count of all ventilators in use.",
          "criteria" : {
            "description" : "Identifies the number of ventilators in use by counting Patient with an Observation\n or Procedure resource from an appropriate value set indicating ventilator use.",
            "name" : "NumVentUse",
            "language" : "text/fhirpath",
            "expression" : "findAll('Encounter',\n including('subject'),\n with('status').equalTo('in-progress'|'finished'),\n with('date').within(%ReportingPeriod)\n).onServers(%Base)\n.select(entry.resource as Patient)\n.where(\n  iif(\n    whereExists('Observation',\n      with('status').equalTo('registered'|'preliminary'|'final'|'amended'|'corrected'),\n      with('patient').equalTo($this.id),\n      with('verificationStatus').notEqualTo('refuted'|'entered-in-error'),\n      with('date').within(%ReportingPeriod),\n      with('code').in(%VentilatorObservations.url)\n    ).onServers(%Base)\n    true,\n    whereExists('Procedure',\n      with('status').equalTo('in-progress'|'completed'),\n      with('patient').equalTo($this.id),\n      with('date').within(%ReportingPeriod),\n      with('code').in(%VentilatorProcedures.url)\n    ).onServers(%Base)\n  )\n)"
          }
        },
        {
          "code" : {
            "coding" : [
              {
                "system" : "http://example.org/fhir/",
                "code" : "numVentAvail",
                "display" : "Mechanical Ventilators Available"
              },
              {
                "system" : "http://example.org/fhir/",
                "code" : "numerator-complement"
              }
            ],
            "text" : "Total number of ventilators not presently in use."
          },
          "description" : "Count of all ventilators not presently in use.",
          "criteria" : {
            "description" : "Computes the number of ventilators available by substracting the number of ventilators in use\n determined by population 1 from thee total number of ventilators given in population 0",
            "name" : "NumVentAvail",
            "language" : "text/fhirpath",
            "expression" : "%NumVent - %NumVentUse.total.toInteger()"
          }
        }
      ]
    }
  ]
}