US Quality Core Implementation Guide
0.1.0 - cibuild United States of America flag

US Quality Core Implementation Guide, published by ASTP. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/FHIR/us-quality-core/ and changes regularly. See the Directory of published versions

Resource Profile: US Quality Core BodyStructure

Official URL: http://fhir.org/guides/astp/us-quality-core/StructureDefinition/us-quality-core-bodystructure Version: 0.1.0
Active as of 2026-03-31 Computable Name: USQualityCoreBodyStructure

Profile of BodyStructure for decision support/quality metrics. Defines the core set of elements and extensions for quality rule and measure authors.

Usage

See the patterns page for implementation and usage patterns.

Examples

BodyStructure Example - identifying a specific tumor or lesion

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... active ?!Σ 1..1 boolean Whether this record is in active use
... locationQualifier 0..* CodeableConcept Body site modifier
Binding: BodystructureLocationQualifier (preferred): Concepts modifying the anatomic location
... patient Σ 1..1 Reference(US Quality Core Patient) Who this is about

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
BodyStructure.location Base preferred SNOMED CT Body Structures 📦4.0.1 FHIR Std.
BodyStructure.locationQualifier Base preferred Bodystructure Location Qualifier 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error BodyStructure If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error BodyStructure If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error BodyStructure If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error BodyStructure If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice BodyStructure A resource should have narrative for robust management text.`div`.exists()
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()

This structure is derived from BodyStructure

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
... active 1..1 boolean Whether this record is in active use
... location 1..1 CodeableConcept Body site
Binding: SNOMEDCTBodyStructures (preferred)
... locationQualifier 0..* CodeableConcept Body site modifier
Binding: BodystructureLocationQualifier (preferred): Concepts modifying the anatomic location

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
BodyStructure.location Base preferred SNOMED CT Body Structures 📦4.0.1 FHIR Std.
BodyStructure.locationQualifier Base preferred Bodystructure Location Qualifier 📦4.0.1 FHIR Std.
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier Bodystructure identifier
... active ?!Σ 1..1 boolean Whether this record is in active use
... morphology Σ 0..1 CodeableConcept Kind of Structure
Binding: SNOMEDCTMorphologicAbnormalities (example): Codes describing anatomic morphology.
... location Σ 1..1 CodeableConcept Body site
Binding: SNOMEDCTBodyStructures (preferred)
... locationQualifier 0..* CodeableConcept Body site modifier
Binding: BodystructureLocationQualifier (preferred): Concepts modifying the anatomic location
... description Σ 0..1 string Text description
... image 0..* Attachment Attached images
... patient Σ 1..1 Reference(US Quality Core Patient) Who this is about

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
BodyStructure.language Base preferred Common Languages 📍4.0.1 FHIR Std.
BodyStructure.morphology Base example SNOMED CT Morphologic Abnormalities 📍4.0.1 FHIR Std.
BodyStructure.location Base preferred SNOMED CT Body Structures 📦4.0.1 FHIR Std.
BodyStructure.locationQualifier Base preferred Bodystructure Location Qualifier 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error BodyStructure If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error BodyStructure If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error BodyStructure If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error BodyStructure If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice BodyStructure A resource should have narrative for robust management text.`div`.exists()
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()

This structure is derived from BodyStructure

Summary

Mandatory: 2 elements

Structures

This structure refers to these other structures:

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... active ?!Σ 1..1 boolean Whether this record is in active use
... locationQualifier 0..* CodeableConcept Body site modifier
Binding: BodystructureLocationQualifier (preferred): Concepts modifying the anatomic location
... patient Σ 1..1 Reference(US Quality Core Patient) Who this is about

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
BodyStructure.location Base preferred SNOMED CT Body Structures 📦4.0.1 FHIR Std.
BodyStructure.locationQualifier Base preferred Bodystructure Location Qualifier 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error BodyStructure If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error BodyStructure If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error BodyStructure If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error BodyStructure If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice BodyStructure A resource should have narrative for robust management text.`div`.exists()
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()

Differential View

This structure is derived from BodyStructure

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
... active 1..1 boolean Whether this record is in active use
... location 1..1 CodeableConcept Body site
Binding: SNOMEDCTBodyStructures (preferred)
... locationQualifier 0..* CodeableConcept Body site modifier
Binding: BodystructureLocationQualifier (preferred): Concepts modifying the anatomic location

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
BodyStructure.location Base preferred SNOMED CT Body Structures 📦4.0.1 FHIR Std.
BodyStructure.locationQualifier Base preferred Bodystructure Location Qualifier 📦4.0.1 FHIR Std.

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier Bodystructure identifier
... active ?!Σ 1..1 boolean Whether this record is in active use
... morphology Σ 0..1 CodeableConcept Kind of Structure
Binding: SNOMEDCTMorphologicAbnormalities (example): Codes describing anatomic morphology.
... location Σ 1..1 CodeableConcept Body site
Binding: SNOMEDCTBodyStructures (preferred)
... locationQualifier 0..* CodeableConcept Body site modifier
Binding: BodystructureLocationQualifier (preferred): Concepts modifying the anatomic location
... description Σ 0..1 string Text description
... image 0..* Attachment Attached images
... patient Σ 1..1 Reference(US Quality Core Patient) Who this is about

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
BodyStructure.language Base preferred Common Languages 📍4.0.1 FHIR Std.
BodyStructure.morphology Base example SNOMED CT Morphologic Abnormalities 📍4.0.1 FHIR Std.
BodyStructure.location Base preferred SNOMED CT Body Structures 📦4.0.1 FHIR Std.
BodyStructure.locationQualifier Base preferred Bodystructure Location Qualifier 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error BodyStructure If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error BodyStructure If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error BodyStructure If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error BodyStructure If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice BodyStructure A resource should have narrative for robust management text.`div`.exists()
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()

This structure is derived from BodyStructure

Summary

Mandatory: 2 elements

Structures

This structure refers to these other structures:

 

Other representations of profile: CSV, Excel, Schematron