FHIR Extensions Pack
5.3.0-ballot-tc1 - (September 2025 Ballot) International flag

FHIR Extensions Pack, published by HL7 International / FHIR Infrastructure. This guide is not an authorized publication; it is the continuous build for version 5.3.0-ballot-tc1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-extensions/ and changes regularly. See the Directory of published versions

Extension: Value Filter

Official URL: http://hl7.org/fhir/StructureDefinition/cqf-valueFilter Version: 5.3.0-ballot-tc1
Standards status: Trial-use Maturity Level: 3 Responsible: HL7 International / Clinical Decision Support Computable Name: ValueFilter
Other Identifiers: OID:2.16.840.1.113883.4.642.5.1588

Allows additional value-based filters to be specified as part of a data requirement.

Context of Use

This extension may be used on the following element(s)

Usage info

Usages:

  • This Extension is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Changes since version 5.2.0:

  • The data elements list has changed

    • Formal Views of Extension Content

    Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

    This structure is derived from Extension

    Summary

    Complex Extension: Allows additional value-based filters to be specified as part of a data requirement.

    • path: string: An Extension
    • searchParam: string: An Extension
    • comparator: code: An Extension
    • value: boolean, string, integer, Quantity, Ratio, Range: An Extension

    Maturity: 3

    This structure is derived from Extension

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..* Extension Extension
    ... Slices for extension Content/Rules for all slices
    .... extension:path 0..1 Extension Extension
    ..... url 1..1 uri "path"
    ..... value[x] 0..1 string Value of extension
    .... extension:searchParam 0..1 Extension Extension
    ..... url 1..1 uri "searchParam"
    ..... value[x] 0..1 string Value of extension
    .... extension:comparator 1..1 Extension Extension
    ..... url 1..1 uri "comparator"
    ..... value[x] 0..1 code Value of extension
    Binding: ValueFilterComparator (required): The comparator operator to use
    .... extension:value 0..1 Extension Extension
    ..... url 1..1 uri "value"
    ..... value[x] 0..1 Value of extension
    ...... valueBoolean boolean
    ...... valueString string
    ...... valueInteger integer
    ...... valueQuantity Quantity
    ...... valueRatio Ratio
    ...... valueRange Range
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/cqf-valueFilter"
    ... value[x] 0..0 Value of extension

    doco Documentation for this format
    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..* Extension Extension
    ... id 0..1 id Unique id for inter-element referencing
    ... Slices for extension 1..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    .... extension:path 0..1 Extension Extension
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    ..... url 1..1 uri "path"
    ..... value[x] 0..1 string Value of extension
    .... extension:searchParam 0..1 Extension Extension
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    ..... url 1..1 uri "searchParam"
    ..... value[x] 0..1 string Value of extension
    .... extension:comparator 1..1 Extension Extension
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    ..... url 1..1 uri "comparator"
    ..... value[x] 0..1 code Value of extension
    Binding: ValueFilterComparator (required): The comparator operator to use
    .... extension:value 0..1 Extension Extension
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    ..... url 1..1 uri "value"
    ..... value[x] 0..1 Value of extension
    ...... valueBoolean boolean
    ...... valueString string
    ...... valueInteger integer
    ...... valueQuantity Quantity
    ...... valueRatio Ratio
    ...... valueRange Range
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/cqf-valueFilter"

    doco Documentation for this format

    This structure is derived from Extension

    Summary

    Complex Extension: Allows additional value-based filters to be specified as part of a data requirement.

    • path: string: An Extension
    • searchParam: string: An Extension
    • comparator: code: An Extension
    • value: boolean, string, integer, Quantity, Ratio, Range: An Extension

    Maturity: 3

    Differential View

    This structure is derived from Extension

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..* Extension Extension
    ... Slices for extension Content/Rules for all slices
    .... extension:path 0..1 Extension Extension
    ..... url 1..1 uri "path"
    ..... value[x] 0..1 string Value of extension
    .... extension:searchParam 0..1 Extension Extension
    ..... url 1..1 uri "searchParam"
    ..... value[x] 0..1 string Value of extension
    .... extension:comparator 1..1 Extension Extension
    ..... url 1..1 uri "comparator"
    ..... value[x] 0..1 code Value of extension
    Binding: ValueFilterComparator (required): The comparator operator to use
    .... extension:value 0..1 Extension Extension
    ..... url 1..1 uri "value"
    ..... value[x] 0..1 Value of extension
    ...... valueBoolean boolean
    ...... valueString string
    ...... valueInteger integer
    ...... valueQuantity Quantity
    ...... valueRatio Ratio
    ...... valueRange Range
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/cqf-valueFilter"
    ... value[x] 0..0 Value of extension

    doco Documentation for this format

    Snapshot View

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..* Extension Extension
    ... id 0..1 id Unique id for inter-element referencing
    ... Slices for extension 1..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    .... extension:path 0..1 Extension Extension
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    ..... url 1..1 uri "path"
    ..... value[x] 0..1 string Value of extension
    .... extension:searchParam 0..1 Extension Extension
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    ..... url 1..1 uri "searchParam"
    ..... value[x] 0..1 string Value of extension
    .... extension:comparator 1..1 Extension Extension
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    ..... url 1..1 uri "comparator"
    ..... value[x] 0..1 code Value of extension
    Binding: ValueFilterComparator (required): The comparator operator to use
    .... extension:value 0..1 Extension Extension
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    ..... url 1..1 uri "value"
    ..... value[x] 0..1 Value of extension
    ...... valueBoolean boolean
    ...... valueString string
    ...... valueInteger integer
    ...... valueQuantity Quantity
    ...... valueRatio Ratio
    ...... valueRange Range
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/cqf-valueFilter"

    doco Documentation for this format

     

    Other representations of profile: CSV, Excel, Schematron

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    Extension.extension:comparator.​value[x] Base required Value Filter Comparator 📍5.3.0-ballot-tc1 This IG

    Constraints

    Id Grade Path(s) Description Expression
    ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
    ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

    R4B

    The extension is unchanged in R4B

    R4

    The extension is unchanged in R4

    R3

    The extension is unchanged in R3

    Search Parameters for this Extension

    (none found)