Validation Results for FHIRPath

Generated Tue Jul 28 15:45:43 AEST 2026, FHIR version 4.0.1 for hl7.fhirpath#3.0.0 (canonical = http://hl7.org/fhirpath (history)). See Errors Only & IP

Quality Checks

Publisher Version: IG Publisher Version: v2.2.11

Publication Code: fhirpath . PackageId = hl7.fhirpath, Canonical = http://hl7.org/fhirpath

Realm Check for HL7:

Error: realms in canonical and package id are different: hl7 vs hl7.org

Language Info: Stated Languages: n/a. IG Resource Lang: en. 1 of 5 (20%) of resources have a language. Population Policy: NONE

Publication Request:

package-id hl7.fhirpath

version 3.0.0

path http://hl7.org/fhirpath/STU3

Pub-Mode milestone

status trial-use

Release-Label STU 3

Sequence (Group) R2 (current: 'R2', others = 'R1','R3')

desc First milestone STU release of FHIRPath since normative publication, containing implementer feedback and additional functions and capabilities, as well as clarifications and corrections throughout. Additions have been clearly marked as STU.

descmd

First milestone STU release of FHIRPath since normative publication, containing implementer feedback and additional functions and capabilities, as well as clarifications and corrections throughout. Additions have been clearly marked as STU.

Highlights include:

Added new functions: coalesce(), sort(), repeatAll(), defineVariable(), matchesFull(), indexOf(), lastIndexOf(), comparable(), pathname()
Added aggregate functions: sum(), min(), max(), avg()
Added date/time component extraction functions: yearOf(), monthOf(), dayOf(), hourOf(), minuteOf(), secondOf(), millisecondOf(), timezoneOffsetOf(), dateOf(), timeOf()
Added boundary and precision functions: lowBoundary(), highBoundary(), precision()
Added support for Long (integer64) type with required L suffix
Added constructor syntax support for type instantiation
Added date/time subtraction operations
Added combine() function with preserveOrder parameter
Added case-sensitivity options to regex functions
Clarified singleton evaluation rules and function behavior for multi-item collections
Clarified iteration context and scoped function behavior
Clarified iif() delayed argument evaluation semantics
Clarified date/time arithmetic edge cases (overflow, fractions, subtraction)
Clarified quantity unit handling and UCUM conformance
Clarified equality semantics for collections
Clarified rounding behavior for negative numbers
Improved conversion documentation and toString() representations
Defined calendar duration units code system
Corrected numerous examples throughout
Updated implementation references
Added authors and contributors list
Typographical corrections throughout
Documentation source format changed from asciidoc to markdown
Simplified reflection capabilities - removed element information returned from type()
Added many new examples for functions that did not previously have examples

see Change Notes for more details and related issue numbers.

RelatedIgs (None Found)

Proposed path for this milestone publication should usually be canonical with either sequence or version appended
The sequence 'R3' has already been closed with a current publication, and a new sequence 'R3' started - is going back to 'R2' really what's intended?

Supressed Messages: 2 Suppressed Issues

Dependency Checks:

Package	Version	FHIR	Canonical	Web Base	Comment
hl7.fhirpath	3.0.0	R4	http://hl7.org/fhirpath		HL7 Packages must have an id that starts with hl7.cda., hl7.fhir., hl7.v2., hl7.xprod., or hl7.ehrs.
hl7.terminology.r4	7.3.0 M	R4	http://terminology.hl7.org	http://terminology.hl7.org/7.3.0
hl7.fhir.uv.extensions.r4	5.3.0 M	R4	http://hl7.org/fhir/extensions	http://hl7.org/fhir/extensions/5.3.0
hl7.terminology.r4	7.1.0 O	R4	http://terminology.hl7.org	http://terminology.hl7.org/7.1.0	Latest Release is 7.3.0
hl7.fhir.uv.extensions.r4	5.2.0 O	R4	http://hl7.org/fhir/extensions	http://hl7.org/fhir/extensions/5.2.0	Latest Release is 5.3.0
hl7.fhir.uv.extensions.r4	5.3.0 M	R4	http://hl7.org/fhir/extensions	http://hl7.org/fhir/extensions/5.3.0	(as above)
hl7.fhir.uv.tools.r4	1.1.2 M	R4	http://hl7.org/fhir/tools	http://hl7.org/fhir/tools/1.1.2	Internal Dependency

Templates: hl7.fhirpath.template#0.0.1 -> fhir2.base.template#current

Related IGs: n/a

Dependent IGs: no references

Global Profiles: (none declared)

Terminology Server(s): https://tx.fhir.org/r4 (details)

HTA Analysis: no Non-HL7 references found

R5 Dependencies: (none)

Draft Dependencies:

hl7.fhir.r4.core#4.0.1: GuideParameterCode (16 uses), Shareable ValueSet (1 uses)

Modifier Extensions: (none)

Previous Version Comparison: Comparison with version 3.0.0-ballot

IPA Comparison: n/a

IPS Comparison: n/a

Validation Flags: On: autoLoad; Off: hintAboutNonMustSupport, anyExtensionsAllowed, checkAggregation, showReferenceMessages, noExperimentalContent, displayWarnings

Summary: errors = 2, warn = 0, info = 1, broken links = 0, pinned = n/a.

Filename	Errors	Warnings	Hints
Build Errors	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/images	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/images/ansi-approved	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/images/fhirpath	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/images/modelinfo	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/images/tests	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/images/treestructure	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/images/v2-class-model	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/includes/menu	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/pages/appendices	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/pages/changes	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/pages/grammar	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/pages/index	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/pages/tests	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/resources/binary-grammar	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/resources/binary-modelinfoschema	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/resources/codesystem-calendar-units	1	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/resources/ig	0	0	1
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/input/resources/valueset-calendar-units	1	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/temp/pages/_includes/artifacts	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/template/config	0	0	0
/tmp/ig-builds/hl7.fhirpath#3.0.0-milestone/template/config/_config	0	0	0

n/a Show Validation Information

input/images Show Validation Information (0)

✓

input/images/ansi-approved.gif Show Validation Information (0)

✓

input/images/fhirpath.g4 Show Validation Information (0)

✓

input/images/modelinfo.xsd Show Validation Information (0)

✓

input/images/tests.zip Show Validation Information (0)

✓

input/images/treestructure.png Show Validation Information (0)

✓

input/images/v2-class-model.png Show Validation Information (0)

✓

input/includes/menu.xml Show Validation Information (0)

✓

input/pages/appendices.md Show Validation Information (0)

✓

input/pages/changes.md Show Validation Information (0)

✓

input/pages/grammar.md Show Validation Information (0)

✓

input/pages/index.md Show Validation Information (0)

✓

input/pages/tests.md Show Validation Information (0)

✓

input/resources/binary-grammar.json Show Validation Information (1)

✓

input/resources/binary-modelinfoschema.json Show Validation Information (1)

✓

input/resources/codesystem-calendar-units.xml Show Validation Information (1)

Path

Severity

Message

Validating

Resource

error

The resource CodeSystem/calendar-units must have an OID assigned to cater for possible use with OID based terminology systems e.g. CDA usage (OIDs are easy to assign - see https://build.fhir.org/ig/FHIR/fhir-tools-ig/CodeSystem-ig-parameters.html#ig-parameters-auto-oid-root)

input/resources/ig.xml Show Validation Information (1)

Path

Severity

Message

Validating

Resource

information

The resource ImplementationGuide/hl7.fhirpath could usefully have an OID assigned (OIDs are easy to assign - see https://build.fhir.org/ig/FHIR/fhir-tools-ig/CodeSystem-ig-parameters.html#ig-parameters-auto-oid-root)

input/resources/valueset-calendar-units.xml Show Validation Information (1)

Path

Severity

Message

Validating

Resource

error

The resource ValueSet/calendar-units must have an OID assigned to cater for possible use with OID based terminology systems e.g. CDA usage (OIDs are easy to assign - see https://build.fhir.org/ig/FHIR/fhir-tools-ig/CodeSystem-ig-parameters.html#ig-parameters-auto-oid-root)

temp/pages/_includes/artifacts.xml Show Validation Information (0)

✓

template/config Show Validation Information (0)

✓

template/config/_config.yml Show Validation Information (0)

✓

Suppressed Messages (Warnings, hints, broken links)

The TSMG has approved this code system as an exemption from moving to THO on 7th May 2026. This code system is appropriately defined in the FHIRPath specification as it is similar to a required code binding in FHIR. https://confluence.hl7.org/spaces/TSMG/pages/453915259/2026-05-07+TSMG+Agenda+and+Minutes

INFORMATION: CodeSystem/calendar-units: CodeSystem: Most code systems defined in HL7 IGs will need to move to THO later during the process. Consider giving this code system a THO URL now (See https://confluence.hl7.org/display/TSMG/Terminology+Play+Book, and/or talk to TSMG) (1 uses)

This specification pre-dates the conformance clause marking functionality, it may be added in a future publication

INFORMATION: en/index.html: The html source contains the word 'SHALL' but it is not in a text phrase marked as a conformance clause: 'This specification uses the conformance verbs SHALL, MUST, SHOULD, and MAY as defined in RFC 2119. Unlike RFC 2119, however, this specification allows that different applications might not be able to interoperate because of how they use optional features. In particular:' (1 uses)

Errors sorted by type