Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion input/pages/09-b-cqlreference.md
Original file line number Diff line number Diff line change
Expand Up @@ -5976,6 +5976,8 @@ define "EquivalentIsFalse": Concept1 ~ Concept2
> Note: Because code declarations in CQL allow the value of the code to be any valid code from the code system, it is possible to define code declarations that use expressions if the code system supports it (_post-coordinated expressions_ in SNOMED, for example). However, using such features of a code system would effectively require a terminology server in order to fully support the capability, and CQL is not prescriptive about such support, and artifacts that make use of these types of features for code equivalence should come with a warning about implementability.
{: .note-warning}

{: .contains_codesystem}

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is already an anchor here from the header, no need for this change:
https://cql.hl7.org/2025Sep/09-b-cqlreference.html#contains-codesystem

#### Contains (Codesystem)

> The EquivalentContains (`~contains`) operator was introduced in CQL 2.0, and has trial-use status.
Expand Down Expand Up @@ -6020,6 +6022,7 @@ define "CodesystemContainsNullString": "SNOMED:2014" ~contains null as String //
> Note carefully that the use of the string overloads for membership testing in code systems and value sets is potentially problematic and should be used with caution, if at all
{: .note-warning}

{: #in_codesystem}
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is already an anchor here from the header, no need for this change:
https://cql.hl7.org/2025Sep/09-b-cqlreference.html#in-codesystem

#### In (Codesystem)

> The EquivalentIn (`~in`) operator was introduced in CQL 2.0, and has trial-use status. For backwards-compatibility the normative In (`in`) can still be used to test code system membership.
Expand Down Expand Up @@ -6092,7 +6095,6 @@ valueset "Value Set Reference": 'http://example.org/ValueSet/ExampleValueSet'

define TestExpandValueSet: ExpandValueSet("Value Set Reference")
```

#### Contains (Valueset)

> The EquivalentContains (`~contains`) operator was introduced in CQL 2.0, and has trial-use status.
Expand Down Expand Up @@ -6137,6 +6139,7 @@ define "ValuesetContainsNullString": "Acute Pharyngitis" ~contains null as Strin
> Note carefully that the use of the string overloads for membership testing in code systems and value sets is potentially problematic and should be used with caution, if at all
{: .note-warning}


#### In (Valueset)

> The EquivalentIn (`~in`) operator was introduced in CQL 2.0, and has trial-use status. For backwards-compatibility the normative In (`in`) can still be used to test code system membership.
Expand Down
104 changes: 102 additions & 2 deletions input/vocabulary/CodeSystem-cql-language-capabilities.json
Original file line number Diff line number Diff line change
Expand Up @@ -1299,9 +1299,109 @@
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#clinical-operators" }
],
"concept": [
{
"code": "clinical-operators.age",
"display": "Clinical Operators age",
"definition": "The Age operators calculate the age of the patient as of the current date in the precision named in the operator.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#age" }
]
},
{
"code": "clinical-operators.ageat",
"display": "Clinical Operators age at",
"definition": "The AgeAt operators calculate the age of the patient as of a given date and in the precision named in the operator.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#ageat" }
]
},
{
"code": "clinical-operators.calculateage",
"display": "Clinical Operators calculate age",
"definition": "The CalculateAge operators calculate the age of a person born on the given birth date, as of the current date, and in the precision named in the operator.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#calculateage" }
]
},
{
"code": "clinical-operators.calculateageat",
"display": "Clinical Operators Calculate age at",
"definition": "The CalculateAgeAt operators calculate the age of a person born on the given birth date as of the given date, and in the precision named in the operator.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#calculateageat" }
]
},
{
"code": "clinical-operators.contains_codesystem",
"display": "Clinical Operators contains codesystem",
"definition": "The ~contains (Codesystem) operators determine whether or not a given code, or any of a list of codes, is in a particular codesystem. Note that these operators can only be invoked by referencing a defined codesystem or CodeSystem-valued expression.",
"property": [
{ "code": "version", "valueString": "2.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#calculateage" }
]
},
{
"code": "clinical-operators.contains_valueset",
"display": "Clinical Operators contains valueset",
"definition": "The ~contains (Valueset) operators determine whether or not a given code, or any of a list of codes, is in a particular valueset. Note that these operators can only be invoked by referencing a defined valueset or ValueSet-valued expression.",
"property": [
{ "code": "version", "valueString": "2.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html" }
]
},
{
"code": "clinical-operators.equal",
"display": "Clinical Operators equal",
"definition": "The equal (=) operator for Codes and Concepts uses tuple equality semantics. This means that the operator will return true if and only if the values for each element by name are equal.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#equal-3" }
]
},
{
"code": "clinical-operators.equivalent",
"display": "Clinical Operators equivalent",
"definition": "The equivalent (~) operator for Code values returns true if the code and system elements are equivalent. The version and display elements are ignored for the purposes of determining Code equivalence.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#equivalent-3" }
]
},
{
"code": "clinical-operators.in-codesysterm",
"display": "Clinical Operators in (Codesystem)",
"definition": "The in (Codesystem) operators determine whether or not a given code, or any of a list of codes, is in a particular codesystem. Note that these operators can only be invoked by referencing a defined codesystem.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#in-codesystem" }
]
},
{
"code": "clinical-operators.expandvalueset",
"display": "Clinical Operators expand valueset",
"definition": "The ExpandValueSet function returns the current expansion for the given value set.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html#expandvalueset" }
]
},
{
"code": "clinical-operators.in_valueset",
"display": "Clinical Operators in valueset",
"definition": "The in (Valueset) operators determine whether or not a given code, or any of a list of codes, is in a particular valueset. Note that these operators can only be invoked by referencing a defined valueset.",
"property": [
{ "code": "version", "valueString": "1.0" },
{ "code": "reference", "valueString": "https://cql.hl7.org/09-b-cqlreference.html" }
]
}
]
},
{
}, {
"code": "diagnostic-operators",
"display": "Diagnostic Operators",
"definition": "Errors and messaging functions.",
Expand Down