# Terminology FHIR - Quality Measure Implementation Guide v2.0.0-ballot

## Measure: Terminology FHIR (Experimental) 

 
This example illustrates the use of risk adjustment variables within a measure represented as a FHIR eCQM 

* Metadata: Title
  * ?: Terminology FHIR
* Metadata: Version
  * ?: 1.0.0
* Metadata: Identifier
  * ?: Terminology_FHIR
* Metadata: Identifier
  * ?: urn:oid:2.16.840.1.113883.4.642.40.61.29.19
* Metadata: Effective Period
  * ?: 2018-01-01 through 2018-12-31
* Metadata: Approval Date
  * ?: 2019-03-08
* Metadata: Last Review Date
  * ?: 2019-03-08
* Metadata: Experimental
  * ?: true
* Metadata: Jurisdiction
  * ?: 001 from[http://unstats.un.org/unsd/methods/m49/m49.htm](http://unstats.un.org/unsd/methods/m49/m49.htm)
* Metadata: Topic
  * ?: Health Quality Measure Document
* Metadata: Steward (Publisher)
  * ?: HL7 International / Clinical Quality Information
* Metadata: Description
  * ?: This example illustrates the use of risk adjustment variables within a measure represented as a FHIR eCQM
* Metadata: Measure Basis
  * ?: Encounter
* Metadata: Measure Scoring
  * ?: Cohort
* Metadata: Improvement Notation
  * ?: Decreased score indicates improvement
* Metadata: Measure Type
  * ?: process from[http://terminology.hl7.org/CodeSystem/measure-type](http://terminology.hl7.org/7.1.0/CodeSystem-measure-type.html)
* Metadata: Measure Group (Rate) (ID: primary)
* Metadata: Measure Logic
* Metadata: Primary Library
  * ?: [Terminology Library](Library-Terminology.md)
* Metadata: Contents
  * ?: **[Population Criteria](#population-criteria)****[Logic Definitions](#definitions)****[Terminology](#terminology)****[Dependencies](#dependencies)****[Data Requirements](#data-requirements)****[Parameters](#parameters)**
* Metadata:  Population Criteria
* Metadata: Measure Group (Rate) (ID: primary)
* Metadata:  Logic Definitions
* Metadata: Logic Definition
  * ?: **Library Name:**Terminology
* Metadata:  ````define "Inpatient Encounter": ["Encounter": type in "Encounter Inpatient SNOMEDCT Value Set"] E where E.status = 'finished'````
* Metadata: Logic Definition
  * ?: **Library Name:**Terminology
* Metadata:  ````define "Initial Population": "Inpatient Encounter"````
* Metadata: Logic Definition
  * ?: **Library Name:**FHIRHelpers
* Metadata:  ````define function ToString(value EncounterStatus): value.value````
* Metadata:  Terminology
* Metadata: Value Set
  * ?: **Description**: Value set Encounter Inpatient SNOMEDCT Value Set**Resource**:[http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.666.5.307|20260210](https://vsac.nlm.nih.gov/valueset/2.16.840.1.113883.3.666.5.307|20260210/expansion)**Canonical URL**:http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.666.5.307|20260210
* Metadata:  Dependencies
* Metadata: Dependency
  * ?: **Description**: FHIR model information**Resource**:[http://hl7.org/fhir/uv/cql/Library/FHIR-ModelInfo|4.0.1](http://hl7.org/fhir/uv/cql/STU2/Library-FHIR-ModelInfo.html)**Canonical URL**:http://hl7.org/fhir/uv/cql/Library/FHIR-ModelInfo|4.0.1
* Metadata: Dependency
  * ?: **Description**: Library FHIRHelpers**Resource**:[http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1](http://hl7.org/fhir/uv/cql/STU2/Library-FHIRHelpers.html)**Canonical URL**:http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1
* Metadata:  Data Requirements
* Metadata: Data Requirement
  * ?: **Type**: Encounter**Profile(s)**:[Encounter](http://hl7.org/fhir/R4/encounter.html)**Must Support Elements**: type, status**Code Filter(s)**:**Path**: type**ValueSet**:[http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.666.5.307|20260210](https://vsac.nlm.nih.gov/valueset/2.16.840.1.113883.3.666.5.307|20260210/expansion)
* Metadata:  Parameters
* Metadata: 
  * ?: 
| | | | | |
| :--- | :--- | :--- | :--- | :--- |
| **Name** | **Use** | **Card.** | **Type** | **Documentation** |
| Initial Population | Out | 0..* | Encounter |  |

* Metadata: Generated using version 0.5.4 of the sample-content-ig Liquid templates



## Resource Content

```json
{
  "resourceType" : "Measure",
  "id" : "Terminology-FHIR",
  "meta" : {
    "profile" : ["http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-cohortmeasure",
    "http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-computablemeasure",
    "http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-computablemeasure"]
  },
  "contained" : [{
    "resourceType" : "Library",
    "id" : "effective-data-requirements",
    "extension" : [{
      "extension" : [{
        "url" : "libraryName",
        "valueString" : "Terminology"
      },
      {
        "url" : "name",
        "valueString" : "Inpatient Encounter"
      },
      {
        "url" : "statement",
        "valueString" : "define \"Inpatient Encounter\":\n  [\"Encounter\": type in \"Encounter Inpatient SNOMEDCT Value Set\"] E\n    where E.status = 'finished'"
      },
      {
        "url" : "displaySequence",
        "valueInteger" : 0
      }],
      "url" : "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
    },
    {
      "extension" : [{
        "url" : "libraryName",
        "valueString" : "Terminology"
      },
      {
        "url" : "name",
        "valueString" : "Initial Population"
      },
      {
        "url" : "statement",
        "valueString" : "define \"Initial Population\":\n  \"Inpatient Encounter\""
      },
      {
        "url" : "displaySequence",
        "valueInteger" : 1
      }],
      "url" : "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
    },
    {
      "extension" : [{
        "url" : "libraryName",
        "valueString" : "FHIRHelpers"
      },
      {
        "url" : "name",
        "valueString" : "ToString"
      },
      {
        "url" : "statement",
        "valueString" : "define function ToString(value EncounterStatus): value.value"
      },
      {
        "url" : "displaySequence",
        "valueInteger" : 2
      }],
      "url" : "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
    }],
    "name" : "EffectiveDataRequirements",
    "status" : "active",
    "type" : {
      "coding" : [{
        "system" : "http://terminology.hl7.org/CodeSystem/library-type",
        "code" : "module-definition"
      }]
    },
    "relatedArtifact" : [{
      "type" : "depends-on",
      "display" : "FHIR model information",
      "resource" : "http://hl7.org/fhir/uv/cql/Library/FHIR-ModelInfo|4.0.1"
    },
    {
      "type" : "depends-on",
      "display" : "Library FHIRHelpers",
      "resource" : "http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1"
    },
    {
      "type" : "depends-on",
      "display" : "Value set Encounter Inpatient SNOMEDCT Value Set",
      "resource" : "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.666.5.307|20260210"
    }],
    "parameter" : [{
      "name" : "Initial Population",
      "use" : "out",
      "min" : 0,
      "max" : "*",
      "type" : "Encounter"
    }],
    "dataRequirement" : [{
      "type" : "Encounter",
      "profile" : ["http://hl7.org/fhir/StructureDefinition/Encounter"],
      "mustSupport" : ["type", "status"],
      "codeFilter" : [{
        "path" : "type",
        "valueSet" : "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.666.5.307|20260210"
      }]
    }]
  }],
  "extension" : [{
    "url" : "http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-populationBasis",
    "valueCode" : "Encounter"
  },
  {
    "url" : "http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-effectiveDataRequirements",
    "valueCanonical" : "#effective-data-requirements"
  }],
  "url" : "http://hl7.org/fhir/uv/cqm/Measure/Terminology-FHIR",
  "identifier" : [{
    "use" : "official",
    "system" : "http://example.org/fhir/cqi/ecqm/Measure/Identifier/exm",
    "value" : "Terminology_FHIR"
  },
  {
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.40.61.29.19"
  }],
  "version" : "1.0.0",
  "name" : "Terminology_FHIR",
  "title" : "Terminology FHIR",
  "status" : "active",
  "experimental" : true,
  "date" : "2025-08-13",
  "publisher" : "HL7 International / Clinical Quality Information",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/cqi"
    }]
  }],
  "description" : "This example illustrates the use of risk adjustment variables within a measure represented as a FHIR eCQM",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001"
    }]
  }],
  "approvalDate" : "2019-03-08",
  "lastReviewDate" : "2019-03-08",
  "effectivePeriod" : {
    "start" : "2018-01-01",
    "end" : "2018-12-31"
  },
  "topic" : [{
    "coding" : [{
      "system" : "http://loinc.org",
      "code" : "57024-2",
      "display" : "Health Quality Measure Document"
    }]
  }],
  "library" : ["http://hl7.org/fhir/uv/cqm/Library/Terminology"],
  "scoring" : {
    "coding" : [{
      "system" : "http://terminology.hl7.org/CodeSystem/measure-scoring",
      "code" : "cohort",
      "display" : "Cohort"
    }]
  },
  "type" : [{
    "coding" : [{
      "system" : "http://terminology.hl7.org/CodeSystem/measure-type",
      "code" : "process"
    }]
  }],
  "improvementNotation" : {
    "coding" : [{
      "system" : "http://terminology.hl7.org/CodeSystem/measure-improvement-notation",
      "code" : "decrease",
      "display" : "Decreased score indicates improvement"
    }]
  },
  "group" : [{
    "id" : "group-1",
    "extension" : [{
      "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-Measure.group.linkId",
      "valueString" : "primary"
    }],
    "population" : [{
      "extension" : [{
        "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-Measure.group.population.linkId",
        "valueString" : "primary-terminology-initial-population"
      }],
      "code" : {
        "coding" : [{
          "system" : "http://terminology.hl7.org/CodeSystem/measure-population",
          "code" : "initial-population",
          "display" : "Initial Population"
        }]
      },
      "criteria" : {
        "language" : "text/cql-identifier",
        "expression" : "Initial Population"
      }
    }]
  }]
}

```
