Canonical Resource Management Infrastructure Implementation Guide, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 1.1.0-cibuild built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/crmi-ig/ and changes regularly. See the Directory of published versions
Draft as of 2023-03-13 |
<Measure xmlns="http://hl7.org/fhir">
<id value="shareable-example"/>
<meta>
<profile
value="http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-shareablemeasure"/>
</meta>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Measure shareable-example</b></p><a name="shareable-example"> </a><a name="hcshareable-example"> </a><a name="shareable-example-en-US"> </a><p><b>CRMI Software System</b>: <a href="Device-cqf-tooling.html">Device: type = Tooling</a></p><p><b>CRMI Effective Data Requirements</b>: <a href="#hcshareable-example/effective-data-requirements">effective-data-requirements</a></p><blockquote><p><b>Definition Term</b></p><ul><li>term: First Trimester</li><li>definition: </li></ul></blockquote><div><p>The first trimester is considered before 12 weeks of gestation</p>
</div><p><b>url</b>: <a href="Measure-shareable-example.html">Measure ANC.IND.01 Percentage of pregnant women with first ANC contact in the first trimester (Shareable Example)</a></p><p><b>identifier</b>: <a href="http://terminology.hl7.org/5.5.0/NamingSystem-uri.html" title="As defined by RFC 3986 (http://www.ietf.org/rfc/rfc3986.txt)(with many schemes defined in many RFCs). For OIDs and UUIDs, use the URN form (urn:oid:(note: lowercase) and urn:uuid:). See http://www.ietf.org/rfc/rfc3001.txt and http://www.ietf.org/rfc/rfc4122.txt
This oid is used as an identifier II.root to indicate the the extension is an absolute URI (technically, an IRI). Typically, this is used for OIDs and GUIDs. Note that when this OID is used with OIDs and GUIDs, the II.extension should start with urn:oid or urn:uuid:
Note that this OID is created to aid with interconversion between CDA and FHIR - FHIR uses urn:ietf:rfc:3986 as equivalent to this OID. URIs as identifiers appear more commonly in FHIR.
This OID may also be used in CD.codeSystem.">Uniform Resource Identifier (URI)</a>/urn:oid:2.16.840.1.113883.4.642.40.38.29.2</p><p><b>version</b>: 1.1.0-cibuild</p><p><b>name</b>: ANCIND01Shareabale</p><p><b>title</b>: ANC.IND.01 Percentage of pregnant women with first ANC contact in the first trimester (Shareable Example)</p><p><b>status</b>: Draft</p><p><b>experimental</b>: true</p><p><b>date</b>: 2023-03-13 22:32:10-0600</p><p><b>publisher</b>: HL7 International / Clinical Decision Support</p><p><b>contact</b>: <a href="http://www.hl7.org/Special/committees/dss">http://www.hl7.org/Special/committees/dss</a></p><p><b>description</b>: </p><div><p>Percentage of pregnant women with first ANC contact in the first trimester (before 12 weeks of gestation)</p>
</div><p><b>jurisdiction</b>: <span title="Codes:{http://unstats.un.org/unsd/methods/m49/m49.htm 001}">World</span></p><p><b>library</b>: <a href="Library-ANCCohort.html">ANC Cohort</a></p><p><b>scoring</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-scoring proportion}">Proportion</span></p><p><b>type</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-type process}">Process</span></p><p><b>improvementNotation</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-improvement-notation increase}">Increased score indicates improvement</span></p><blockquote><p><b>group</b></p><blockquote><p><b>id</b></p>group-1</blockquote><blockquote><p><b>population</b></p><blockquote><p><b>id</b></p>initial-population</blockquote><p><b>code</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-population initial-population}">Initial Population</span></p><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>text/cql-identifier</td><td>Initial Population</td></tr></table></blockquote><blockquote><p><b>population</b></p><blockquote><p><b>id</b></p>denominator</blockquote><p><b>code</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-population denominator}">Denominator</span></p><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>text/cql-identifier</td><td>Denominator</td></tr></table></blockquote><blockquote><p><b>population</b></p><blockquote><p><b>id</b></p>numerator</blockquote><p><b>code</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-population numerator}">Numerator</span></p><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>text/cql-identifier</td><td>Numerator</td></tr></table></blockquote><blockquote><p><b>stratifier</b></p><blockquote><p><b>id</b></p>by-age</blockquote><p><b>code</b>: <span title="Codes:">Age</span></p><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>text/cql-identifier</td><td>Age Stratifier</td></tr></table></blockquote><blockquote><p><b>stratifier</b></p><blockquote><p><b>id</b></p>by-education-level</blockquote><p><b>code</b>: <span title="Codes:">Education Level</span></p><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>text/cql-identifier</td><td>Education Level Stratifier</td></tr></table></blockquote></blockquote></div>
</text>
<contained>
<Library>
<id value="effective-data-requirements"/>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-directReferenceCode">
<valueCoding>
<system
value="http://example.org/CodeSystem/iso-8601-derived-periods"/>
<code value="P10Y--P14Y"/>
<display value="10-14 years"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-directReferenceCode">
<valueCoding>
<system
value="http://example.org/CodeSystem/iso-8601-derived-periods"/>
<code value="P15Y--P19Y"/>
<display value="15-19 years"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-directReferenceCode">
<valueCoding>
<system
value="http://example.org/CodeSystem/iso-8601-derived-periods"/>
<code value="P20Y--P9999Y"/>
<display value="20+ years"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCBaseDataElements"/>
</extension>
<extension url="name">
<valueString value="Antenatal care contact"/>
</extension>
<extension url="statement">
<valueString
value="define "Antenatal care contact":
["Encounter": type in BCx."Antenatal care contact"]"/>
</extension>
<extension url="displaySequence">
<valueInteger value="0"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCIND01"/>
</extension>
<extension url="name">
<valueString value="First antenatal care contact"/>
</extension>
<extension url="statement">
<valueString
value="define "First antenatal care contact":
BaseData."Antenatal care contact" C
where C.reasonCode in Cx."First Antenatal Care Contact Choices""/>
</extension>
<extension url="displaySequence">
<valueInteger value="1"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCContactDataElements"/>
</extension>
<extension url="name">
<valueString value="Gestational age"/>
</extension>
<extension url="statement">
<valueString
value="/*
@dataElement: ANC.B6.DE17 Gestational age
@activity: ANC.B6 Profile
@description: Gestational age in weeks and/or days depending on the source of gestational age
*/
define "Gestational age":
WC.MostRecent(
[Observation: Cx."Gestational age"] O
where O.status in { 'final', 'amended', 'corrected' }
and Coalesce(WC.ModifierExtension(O, 'who-notDone').value, false) is false
and Last(Split(O.encounter.reference, '/')) = Last(Split(encounter, '/'))
).value as FHIR.Quantity"/>
</extension>
<extension url="displaySequence">
<valueInteger value="2"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCIND01"/>
</extension>
<extension url="name">
<valueString value="Numerator"/>
</extension>
<extension url="statement">
<valueString
value="/*
Numerator: Number of pregnant women who had their first ANC contact before 12 weeks (facility level)
Numerator Computation: Count of women whose gestational age <= 12 weeks at the time of first contact
*/
define Numerator:
exists (
"First antenatal care contact" C
where C.period starts during "Measurement Period"
and ContactData."Gestational age" <= 12 weeks
)"/>
</extension>
<extension url="displaySequence">
<valueInteger value="3"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCStratifiers"/>
</extension>
<extension url="name">
<valueString value="By Age"/>
</extension>
<extension url="statement">
<valueString
value="/*
By Patient Age as of the start of the Measurement Period
Age (10-14, 15-19, 20+)
*/
define "By Age":
case
when AgeInYearsAt(start of "Measurement Period") in Interval[10, 14] then "P10Y--P14Y"
when AgeInYearsAt(start of "Measurement Period") in Interval[15, 19] then "P15Y--P19Y"
when AgeInYearsAt(start of "Measurement Period") >= 20 then "P20Y--P9999Y"
else null
end"/>
</extension>
<extension url="displaySequence">
<valueInteger value="4"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCIND01"/>
</extension>
<extension url="name">
<valueString value="Age Stratifier"/>
</extension>
<extension url="statement">
<valueString
value="/*
Disaggregation: Age (10-14, 15-19, 20+)
*/
define "Age Stratifier":
Stratifiers."By Age""/>
</extension>
<extension url="displaySequence">
<valueInteger value="5"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCIND01"/>
</extension>
<extension url="name">
<valueString value="Denominator"/>
</extension>
<extension url="statement">
<valueString
value="/*
Denominator: Total number of antenatal clients with a first contact
Denominator Computation: Count of all women who had first contact within the last reporting period
*/
define Denominator:
exists (
"First antenatal care contact" C
where C.period starts during "Measurement Period"
)"/>
</extension>
<extension url="displaySequence">
<valueInteger value="6"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCStratifiers"/>
</extension>
<extension url="name">
<valueString value="By Education Level"/>
</extension>
<extension url="statement">
<valueString
value="/*
By Patient Education Level (none, don't know, primary, secondary, higher)
*/
define "By Education Level":
Patient.extension E
where E.url = 'http://fhir.org/guides/who/anc-cds/StructureDefinition/educationlevel'
return E.value as CodeableConcept"/>
</extension>
<extension url="displaySequence">
<valueInteger value="7"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCIND01"/>
</extension>
<extension url="name">
<valueString value="Education Level Stratifier"/>
</extension>
<extension url="statement">
<valueString
value="/*
Disaggregation: Education Level (none, don't know, primary, secondary, higher)
*/
define "Education Level Stratifier":
Stratifiers."By Education Level""/>
</extension>
<extension url="displaySequence">
<valueInteger value="8"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCBaseDataElements"/>
</extension>
<extension url="name">
<valueString value="Antenatal care case"/>
</extension>
<extension url="statement">
<valueString
value="/*
define "Pregnant":
"Pregnancy" is not null
or "Pregnancy status" in BCx."Pregnancy status - pregnant"
define "Pregnancy status":
FHIRHelpers.ToConcept(
Last(
[Observation: BCx."Pregnancy status"] O
where O.status = 'final'
sort by FHIRHelpers.ToDateTime(effective as FHIR.dateTime)
).value
)
*/
define "Antenatal care case":
["EpisodeOfCare": type in BCx."Antenatal care case"]"/>
</extension>
<extension url="displaySequence">
<valueInteger value="9"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition">
<extension url="libraryName">
<valueString value="ANCIND01"/>
</extension>
<extension url="name">
<valueString value="Initial Population"/>
</extension>
<extension url="statement">
<valueString
value="/*
Initial population: Antenatal clients
*/
define "Initial Population":
exists (BaseData."Antenatal care case")"/>
</extension>
<extension url="displaySequence">
<valueInteger value="10"/>
</extension>
</extension>
<status value="active"/>
<type>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/library-type"/>
<code value="module-definition"/>
</coding>
</type>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library ANCCohort"/>
<resource value="http://hl7.org/fhir/uv/crmi/Library/ANCCohort"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library FHIRHelpers"/>
<resource
value="http://fhir.org/guides/cqf/common/Library/FHIRHelpers|4.0.1"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Example Code system ISO-8601-Derived Periods"/>
<resource
value="http://example.org/CodeSystem/iso-8601-derived-periods"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Value set Antenatal care contact"/>
<resource
value="http://fhir.org/guides/who/anc-cds/ValueSet/antenatal-care-contact"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Value set First Antenatal Care Contact Choices"/>
<resource
value="http://fhir.org/guides/who/anc-cds/ValueSet/anc-b5-de2"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Value set Gestational age"/>
<resource
value="http://fhir.org/guides/who/anc-cds/ValueSet/anc-b6-de17"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Value set Antenatal care case"/>
<resource
value="http://fhir.org/guides/who/anc-cds/ValueSet/antenatal-care-case"/>
</relatedArtifact>
<parameter>
<name value="Measurement Period"/>
<use value="in"/>
<min value="0"/>
<max value="1"/>
<type value="Period"/>
</parameter>
<parameter>
<name value="encounter"/>
<use value="in"/>
<min value="0"/>
<max value="1"/>
<type value="string"/>
</parameter>
<parameter>
<name value="Numerator"/>
<use value="out"/>
<min value="0"/>
<max value="1"/>
<type value="boolean"/>
</parameter>
<parameter>
<name value="Age Stratifier"/>
<use value="out"/>
<min value="0"/>
<max value="1"/>
<type value="Coding"/>
</parameter>
<parameter>
<name value="Denominator"/>
<use value="out"/>
<min value="0"/>
<max value="1"/>
<type value="boolean"/>
</parameter>
<parameter>
<name value="Education Level Stratifier"/>
<use value="out"/>
<min value="0"/>
<max value="*"/>
<type value="CodeableConcept"/>
</parameter>
<parameter>
<name value="Initial Population"/>
<use value="out"/>
<min value="0"/>
<max value="1"/>
<type value="boolean"/>
</parameter>
<dataRequirement>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-isSelective">
<valueBoolean value="true"/>
</extension>
<type value="Encounter"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Encounter"/>
<mustSupport value="type"/>
<mustSupport value="reasonCode"/>
<mustSupport value="period"/>
<codeFilter>
<path value="type"/>
<valueSet
value="http://fhir.org/guides/who/anc-cds/ValueSet/antenatal-care-contact"/>
</codeFilter>
</dataRequirement>
<dataRequirement>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-isSelective">
<valueBoolean value="true"/>
</extension>
<type value="Observation"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Observation"/>
<mustSupport value="code"/>
<mustSupport value="status"/>
<mustSupport value="encounter"/>
<mustSupport value="encounter.reference"/>
<codeFilter>
<path value="code"/>
<valueSet
value="http://fhir.org/guides/who/anc-cds/ValueSet/anc-b6-de17"/>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="Patient"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Patient"/>
<mustSupport value="url"/>
<mustSupport value="value"/>
</dataRequirement>
<dataRequirement>
<type value="EpisodeOfCare"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/EpisodeOfCare"/>
<mustSupport value="type"/>
<codeFilter>
<path value="type"/>
<valueSet
value="http://fhir.org/guides/who/anc-cds/ValueSet/antenatal-care-case"/>
</codeFilter>
</dataRequirement>
</Library>
</contained>
<extension
url="http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-softwaresystem">
<valueReference>🔗
<reference value="Device/cqf-tooling"/>
</valueReference>
</extension>
<extension
url="http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-effectiveDataRequirements" id="effective-data-requirements">
<valueCanonical value="#effective-data-requirements"/>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/cqf-definitionTerm">
<extension url="term">
<valueString value="First Trimester"/>
</extension>
<extension url="definition">
<valueMarkdown
value="The first trimester is considered before 12 weeks of gestation"/>
</extension>
</extension>
<url value="http://hl7.org/fhir/uv/crmi/Measure/shareable-example"/>
<identifier>
<system value="urn:ietf:rfc:3986"/>
<value value="urn:oid:2.16.840.1.113883.4.642.40.38.29.2"/>
</identifier>
<version value="1.1.0-cibuild"/>
<name value="ANCIND01Shareabale"/>
<title
value="ANC.IND.01 Percentage of pregnant women with first ANC contact in the first trimester (Shareable Example)"/>
<status value="draft"/>
<experimental value="true"/>
<date value="2023-03-13T22:32:10-06:00"/>
<publisher value="HL7 International / Clinical Decision Support"/>
<contact>
<telecom>
<system value="url"/>
<value value="http://www.hl7.org/Special/committees/dss"/>
</telecom>
</contact>
<description
value="Percentage of pregnant women with first ANC contact in the first trimester (before 12 weeks of gestation)"/>
<jurisdiction>
<coding>
<system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
<code value="001"/>
<display value="World"/>
</coding>
</jurisdiction>
<library value="http://hl7.org/fhir/uv/crmi/Library/ANCCohort"/>
<scoring>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/measure-scoring"/>
<code value="proportion"/>
</coding>
</scoring>
<type>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/measure-type"/>
<code value="process"/>
</coding>
</type>
<improvementNotation>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/measure-improvement-notation"/>
<code value="increase"/>
</coding>
</improvementNotation>
<group id="group-1">
<population id="initial-population">
<code>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/measure-population"/>
<code value="initial-population"/>
</coding>
</code>
<criteria>
<language value="text/cql-identifier"/>
<expression value="Initial Population"/>
</criteria>
</population>
<population id="denominator">
<code>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/measure-population"/>
<code value="denominator"/>
</coding>
</code>
<criteria>
<language value="text/cql-identifier"/>
<expression value="Denominator"/>
</criteria>
</population>
<population id="numerator">
<code>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/measure-population"/>
<code value="numerator"/>
</coding>
</code>
<criteria>
<language value="text/cql-identifier"/>
<expression value="Numerator"/>
</criteria>
</population>
<stratifier id="by-age">
<code>
<text value="Age"/>
</code>
<criteria>
<language value="text/cql-identifier"/>
<expression value="Age Stratifier"/>
</criteria>
</stratifier>
<stratifier id="by-education-level">
<code>
<text value="Education Level"/>
</code>
<criteria>
<language value="text/cql-identifier"/>
<expression value="Education Level Stratifier"/>
</criteria>
</stratifier>
</group>
</Measure>