SDOH Clinical Care
2.0.0 - STU 2 US

This page is part of the SDOH Clinical Care for Multiple Domains (v2.0.0: STU 2) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Resource Profile: SDOHCC Observation Race OMB

Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-ObservationRaceOMB Version: 2.0.0
Draft as of 2022-11-21 Computable Name: SDOHCCObservationRaceOMB

Profile for race observations that use Office of Management and Budget (OMB) race category codes and CDC race codes. This profile is intended for draft use only. The Cross-Group Projects work group granted a variance to US Core on 06/23/2022 - Jira ticket FHIR-37582. For further details on this profile see Draft Specifications for Personal Characteristics.

Usage:

Formal Views of Profile Content

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

This structure is derived from SDOHCCObservationPersonalCharacteristic

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*SDOHCCObservationPersonalCharacteristicRace observation
SDOH-Race-1: Must have either a dataAbsentReason or at least one of the defined race components but not both
... code 1..1CodeableConceptType of observation (code / type)
Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
... value[x] 0..0
... dataAbsentReason SC0..1CodeableConceptWhy the result is missing
Binding: SDOHCC ValueSet Observation DataAbsentReason (required)
... Slices for component C0..*BackboneElementComponent results
Slice: Unordered, Open by pattern:code, type:value, value:value
.... component:RaceDescription S0..1BackboneElementComponent results
..... code S1..1CodeableConceptType of component observation (code / type)
Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] S1..1stringActual component result
..... dataAbsentReason 0..0
..... interpretation 0..0
..... referenceRange 0..0
.... component:Race S0..5BackboneElementComponent results
..... code S1..1CodeableConceptType of component observation (code / type)
Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] S1..1CodeableConceptRace category codes
Binding: Race Category Excluding Nulls (required): Codes for the five OMB race categories

..... dataAbsentReason 0..0
..... interpretation 0..0
..... referenceRange 0..0
.... component:DetailedRace 0..*BackboneElementComponent results
..... code S1..1CodeableConceptType of component observation (code / type)
Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] S1..1CodeableConceptDetailed race codes
Binding: Detailed Race (required): CDC race codes that further specify the 5 OMB race category codes

..... dataAbsentReason 0..0
..... interpretation 0..0
..... referenceRange 0..0

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Observation.dataAbsentReasonrequiredSDOHCCValueSetObservationDataAbsentReason
Observation.methodextensibleSDOHCCValueSetObservationMethod
Observation.component:Race.value[x]requiredRace Category Excluding Nulls
Observation.component:DetailedRace.value[x]requiredDetailedRace

Constraints

IdGradePath(s)DetailsRequirements
SDOH-Race-1errorObservationMust have either a dataAbsentReason or at least one of the defined race components but not both
: dataAbsentReason.exists() xor component.where(code.coding.where(system='http://loinc.org' and code='72826-1')).exists()
NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*SDOHCCObservationPersonalCharacteristicRace observation
SDOH-Race-1: Must have either a dataAbsentReason or at least one of the defined race components but not both
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... OtherSubject SC0..1Reference(Patient | Group | Device | Location | Organization | Procedure | Practitioner | Medication | Substance | BiologicallyDerivedProduct)Extension
URL: http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject"
.... value[x] 1..1Reference(US Core Practitioner Profile)Value of extension
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... Slices for category 1..*CodeableConceptClassification of type of observation
Slice: Unordered, Open by value:$this
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.


.... category:PersonalCharacteristic S1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/us/sdoh-clinicalcare/CodeSystem/SDOHCC-CodeSystemTemporaryCodes
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: personal-characteristic
... code SΣ1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (preferred)
Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
... subject SΣC0..1Reference(US Core Patient Profile)Who and/or what the observation is about
... focus ΣC0..1Reference(RelatedPerson)What the observation is about, when it is not about the subject of record
... performer SΣC0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)Who is responsible for the observation
... dataAbsentReason SC0..1CodeableConceptWhy the result is missing
Binding: SDOHCC ValueSet Observation DataAbsentReason (required)
... method S1..1CodeableConceptHow it was done
Binding: SDOHCC ValueSet Observation Method (extensible): Methods for personal characteristic observations.

... derivedFrom SΣC0..*Reference(DocumentReference | QuestionnaireResponse | Observation)Related measurements the observation is made from
... Slices for component ΣC0..*BackboneElementComponent results
Slice: Unordered, Open by pattern:code, type:value, value:value
.... component:All Slices Content/Rules for all slices
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code Σ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.

.... component:RaceDescription SΣ0..1BackboneElementComponent results
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] SΣ1..1stringActual component result
.... component:Race SΣ0..5BackboneElementComponent results
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] SΣ1..1CodeableConceptRace category codes
Binding: Race Category Excluding Nulls (required): Codes for the five OMB race categories

.... component:DetailedRace Σ0..*BackboneElementComponent results
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] SΣ1..1CodeableConceptDetailed race codes
Binding: Detailed Race (required): CDC race codes that further specify the 5 OMB race category codes


doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Observation.statusrequiredSDOHCCValueSetObservationStatus
Observation.categorypreferredObservationCategoryCodes
Observation.category:PersonalCharacteristicpreferredPattern: personal-characteristic
Observation.codepreferredPattern: LOINC code 72826-1
Observation.dataAbsentReasonrequiredSDOHCCValueSetObservationDataAbsentReason
Observation.methodextensibleSDOHCCValueSetObservationMethod
Observation.component.codeexampleLOINCCodes (a valid code from LOINC)
Observation.component:RaceDescription.codeexamplePattern: LOINC code 72826-1
Observation.component:Race.codeexamplePattern: LOINC code 72826-1
Observation.component:Race.value[x]requiredRace Category Excluding Nulls
Observation.component:DetailedRace.codeexamplePattern: LOINC code 72826-1
Observation.component:DetailedRace.value[x]requiredDetailedRace

Constraints

IdGradePath(s)DetailsRequirements
SDOH-Obs-1errorObservationEither subject or extension-Observation.subject must exist but not both
: subject.exists() xor extension('http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject').exists()
SDOH-Obs-2errorObservationFocus is only allowed if subject is present
: focus.exists() implies subject.exists()
SDOH-Obs-3errorObservationMust have either performer or derivedFrom
: performer.exists() or derivedFrom.exists()
SDOH-Race-1errorObservationMust have either a dataAbsentReason or at least one of the defined race components but not both
: dataAbsentReason.exists() xor component.where(code.coding.where(system='http://loinc.org' and code='72826-1')).exists()
dom-2errorObservationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorObservationIf 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-4errorObservationIf 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-5errorObservationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceObservationA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
obs-6errorObservationdataAbsentReason SHALL only be present if Observation.value[x] is not present
: dataAbsentReason.empty() or value.empty()
obs-7errorObservationIf Observation.code is the same as an Observation.component.code then the value element associated with the code SHALL NOT be present
: value.empty() or component.code.where(coding.intersect(%resource.code.coding).exists()).empty()
NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*SDOHCCObservationPersonalCharacteristicRace observation
SDOH-Race-1: Must have either a dataAbsentReason or at least one of the defined race components but not both
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... OtherSubject SC0..1Reference(Patient | Group | Device | Location | Organization | Procedure | Practitioner | Medication | Substance | BiologicallyDerivedProduct)Extension
URL: http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject"
.... value[x] 1..1Reference(US Core Practitioner Profile)Value of extension
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierBusiness Identifier for observation
... basedOn Σ0..*Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)Fulfills plan, proposal or order
... partOf Σ0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)Part of referenced event
... status ?!SΣ1..1codefinal | corrected | entered-in-error | unknown
Binding: SDOHCC ValueSet Observation Status (required)
... Slices for category 1..*CodeableConceptClassification of type of observation
Slice: Unordered, Open by value:$this
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.


.... category:PersonalCharacteristic S1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
..... id0..1idUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... id0..1idUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/us/sdoh-clinicalcare/CodeSystem/SDOHCC-CodeSystemTemporaryCodes
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: personal-characteristic
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... text0..1stringPlain text representation of the concept
... code SΣ1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (preferred)
Required Pattern: At least the following
.... id0..1idUnique id for inter-element referencing
.... extension0..*ExtensionAdditional content defined by implementations
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... id0..1idUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
..... version0..1stringVersion of the system - if relevant
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... display0..1stringRepresentation defined by the system
..... userSelected0..1booleanIf this coding was chosen directly by the user
.... text0..1stringPlain text representation of the concept
... subject SΣC0..1Reference(US Core Patient Profile)Who and/or what the observation is about
... focus ΣC0..1Reference(RelatedPerson)What the observation is about, when it is not about the subject of record
... encounter Σ0..1Reference(Encounter)Healthcare event during which this observation is made
... effective[x] Σ0..1Clinically relevant time/time-period for observation
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
... issued Σ0..1instantDate/Time this version was made available
... performer SΣC0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)Who is responsible for the observation
... dataAbsentReason SC0..1CodeableConceptWhy the result is missing
Binding: SDOHCC ValueSet Observation DataAbsentReason (required)
... note 0..*AnnotationComments about the observation
... method S1..1CodeableConceptHow it was done
Binding: SDOHCC ValueSet Observation Method (extensible): Methods for personal characteristic observations.

... device 0..1Reference(Device | DeviceMetric)(Measurement) Device
... hasMember Σ0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)Related resource that belongs to the Observation group
... derivedFrom SΣC0..*Reference(DocumentReference | QuestionnaireResponse | Observation)Related measurements the observation is made from
... Slices for component ΣC0..*BackboneElementComponent results
Slice: Unordered, Open by pattern:code, type:value, value:value
.... component:All Slices Content/Rules for all slices
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code Σ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.

..... value[x] Σ0..1Actual component result
...... valueQuantityQuantity
...... valueCodeableConceptCodeableConcept
...... valueStringstring
...... valueBooleanboolean
...... valueIntegerinteger
...... valueRangeRange
...... valueRatioRatio
...... valueSampledDataSampledData
...... valueTimetime
...... valueDateTimedateTime
...... valuePeriodPeriod
..... dataAbsentReason C0..1CodeableConceptWhy the component result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

..... interpretation 0..*CodeableConceptHigh, low, normal, etc.
Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.


..... referenceRange 0..*See referenceRange (Observation)Provides guide for interpretation of component result
.... component:RaceDescription SΣ0..1BackboneElementComponent results
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... id0..1idUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..1idUnique id for inter-element referencing
....... extension0..*ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... version0..1stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
....... display0..1stringRepresentation defined by the system
....... userSelected0..1booleanIf this coding was chosen directly by the user
...... text0..1stringPlain text representation of the concept
..... value[x] SΣ1..1stringActual component result
.... component:Race SΣ0..5BackboneElementComponent results
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... id0..1idUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..1idUnique id for inter-element referencing
....... extension0..*ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... version0..1stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
....... display0..1stringRepresentation defined by the system
....... userSelected0..1booleanIf this coding was chosen directly by the user
...... text0..1stringPlain text representation of the concept
..... value[x] SΣ1..1CodeableConceptRace category codes
Binding: Race Category Excluding Nulls (required): Codes for the five OMB race categories

.... component:DetailedRace Σ0..*BackboneElementComponent results
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... id0..1idUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..1idUnique id for inter-element referencing
....... extension0..*ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... version0..1stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
....... display0..1stringRepresentation defined by the system
....... userSelected0..1booleanIf this coding was chosen directly by the user
...... text0..1stringPlain text representation of the concept
..... value[x] SΣ1..1CodeableConceptDetailed race codes
Binding: Detailed Race (required): CDC race codes that further specify the 5 OMB race category codes


doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Observation.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Observation.statusrequiredSDOHCCValueSetObservationStatus
Observation.categorypreferredObservationCategoryCodes
Observation.category:PersonalCharacteristicpreferredPattern: personal-characteristic
Observation.codepreferredPattern: LOINC code 72826-1
Observation.dataAbsentReasonrequiredSDOHCCValueSetObservationDataAbsentReason
Observation.methodextensibleSDOHCCValueSetObservationMethod
Observation.referenceRange.typepreferredObservationReferenceRangeMeaningCodes
Observation.referenceRange.appliesToexampleObservationReferenceRangeAppliesToCodes
Observation.component.codeexampleLOINCCodes (a valid code from LOINC)
Observation.component.dataAbsentReasonextensibleDataAbsentReason
Observation.component.interpretationextensibleObservationInterpretationCodes
Observation.component:RaceDescription.codeexamplePattern: LOINC code 72826-1
Observation.component:Race.codeexamplePattern: LOINC code 72826-1
Observation.component:Race.value[x]requiredRace Category Excluding Nulls
Observation.component:DetailedRace.codeexamplePattern: LOINC code 72826-1
Observation.component:DetailedRace.value[x]requiredDetailedRace

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

This structure is derived from SDOHCCObservationPersonalCharacteristic

Summary

Mandatory: 1 element (3 nested mandatory elements)
Must-Support: 10 elements
Prohibited: 10 elements

Slices

This structure defines the following Slices:

  • The element Observation.component is sliced based on the values of pattern:code, type:value, value:value

Differential View

This structure is derived from SDOHCCObservationPersonalCharacteristic

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*SDOHCCObservationPersonalCharacteristicRace observation
SDOH-Race-1: Must have either a dataAbsentReason or at least one of the defined race components but not both
... code 1..1CodeableConceptType of observation (code / type)
Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
... value[x] 0..0
... dataAbsentReason SC0..1CodeableConceptWhy the result is missing
Binding: SDOHCC ValueSet Observation DataAbsentReason (required)
... Slices for component C0..*BackboneElementComponent results
Slice: Unordered, Open by pattern:code, type:value, value:value
.... component:RaceDescription S0..1BackboneElementComponent results
..... code S1..1CodeableConceptType of component observation (code / type)
Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] S1..1stringActual component result
..... dataAbsentReason 0..0
..... interpretation 0..0
..... referenceRange 0..0
.... component:Race S0..5BackboneElementComponent results
..... code S1..1CodeableConceptType of component observation (code / type)
Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] S1..1CodeableConceptRace category codes
Binding: Race Category Excluding Nulls (required): Codes for the five OMB race categories

..... dataAbsentReason 0..0
..... interpretation 0..0
..... referenceRange 0..0
.... component:DetailedRace 0..*BackboneElementComponent results
..... code S1..1CodeableConceptType of component observation (code / type)
Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] S1..1CodeableConceptDetailed race codes
Binding: Detailed Race (required): CDC race codes that further specify the 5 OMB race category codes

..... dataAbsentReason 0..0
..... interpretation 0..0
..... referenceRange 0..0

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Observation.dataAbsentReasonrequiredSDOHCCValueSetObservationDataAbsentReason
Observation.methodextensibleSDOHCCValueSetObservationMethod
Observation.component:Race.value[x]requiredRace Category Excluding Nulls
Observation.component:DetailedRace.value[x]requiredDetailedRace

Constraints

IdGradePath(s)DetailsRequirements
SDOH-Race-1errorObservationMust have either a dataAbsentReason or at least one of the defined race components but not both
: dataAbsentReason.exists() xor component.where(code.coding.where(system='http://loinc.org' and code='72826-1')).exists()

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*SDOHCCObservationPersonalCharacteristicRace observation
SDOH-Race-1: Must have either a dataAbsentReason or at least one of the defined race components but not both
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... OtherSubject SC0..1Reference(Patient | Group | Device | Location | Organization | Procedure | Practitioner | Medication | Substance | BiologicallyDerivedProduct)Extension
URL: http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject"
.... value[x] 1..1Reference(US Core Practitioner Profile)Value of extension
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... Slices for category 1..*CodeableConceptClassification of type of observation
Slice: Unordered, Open by value:$this
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.


.... category:PersonalCharacteristic S1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/us/sdoh-clinicalcare/CodeSystem/SDOHCC-CodeSystemTemporaryCodes
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: personal-characteristic
... code SΣ1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (preferred)
Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
... subject SΣC0..1Reference(US Core Patient Profile)Who and/or what the observation is about
... focus ΣC0..1Reference(RelatedPerson)What the observation is about, when it is not about the subject of record
... performer SΣC0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)Who is responsible for the observation
... dataAbsentReason SC0..1CodeableConceptWhy the result is missing
Binding: SDOHCC ValueSet Observation DataAbsentReason (required)
... method S1..1CodeableConceptHow it was done
Binding: SDOHCC ValueSet Observation Method (extensible): Methods for personal characteristic observations.

... derivedFrom SΣC0..*Reference(DocumentReference | QuestionnaireResponse | Observation)Related measurements the observation is made from
... Slices for component ΣC0..*BackboneElementComponent results
Slice: Unordered, Open by pattern:code, type:value, value:value
.... component:All Slices Content/Rules for all slices
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code Σ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.

.... component:RaceDescription SΣ0..1BackboneElementComponent results
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] SΣ1..1stringActual component result
.... component:Race SΣ0..5BackboneElementComponent results
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] SΣ1..1CodeableConceptRace category codes
Binding: Race Category Excluding Nulls (required): Codes for the five OMB race categories

.... component:DetailedRace Σ0..*BackboneElementComponent results
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... value[x] SΣ1..1CodeableConceptDetailed race codes
Binding: Detailed Race (required): CDC race codes that further specify the 5 OMB race category codes


doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Observation.statusrequiredSDOHCCValueSetObservationStatus
Observation.categorypreferredObservationCategoryCodes
Observation.category:PersonalCharacteristicpreferredPattern: personal-characteristic
Observation.codepreferredPattern: LOINC code 72826-1
Observation.dataAbsentReasonrequiredSDOHCCValueSetObservationDataAbsentReason
Observation.methodextensibleSDOHCCValueSetObservationMethod
Observation.component.codeexampleLOINCCodes (a valid code from LOINC)
Observation.component:RaceDescription.codeexamplePattern: LOINC code 72826-1
Observation.component:Race.codeexamplePattern: LOINC code 72826-1
Observation.component:Race.value[x]requiredRace Category Excluding Nulls
Observation.component:DetailedRace.codeexamplePattern: LOINC code 72826-1
Observation.component:DetailedRace.value[x]requiredDetailedRace

Constraints

IdGradePath(s)DetailsRequirements
SDOH-Obs-1errorObservationEither subject or extension-Observation.subject must exist but not both
: subject.exists() xor extension('http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject').exists()
SDOH-Obs-2errorObservationFocus is only allowed if subject is present
: focus.exists() implies subject.exists()
SDOH-Obs-3errorObservationMust have either performer or derivedFrom
: performer.exists() or derivedFrom.exists()
SDOH-Race-1errorObservationMust have either a dataAbsentReason or at least one of the defined race components but not both
: dataAbsentReason.exists() xor component.where(code.coding.where(system='http://loinc.org' and code='72826-1')).exists()
dom-2errorObservationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorObservationIf 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-4errorObservationIf 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-5errorObservationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceObservationA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
obs-6errorObservationdataAbsentReason SHALL only be present if Observation.value[x] is not present
: dataAbsentReason.empty() or value.empty()
obs-7errorObservationIf Observation.code is the same as an Observation.component.code then the value element associated with the code SHALL NOT be present
: value.empty() or component.code.where(coding.intersect(%resource.code.coding).exists()).empty()

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C0..*SDOHCCObservationPersonalCharacteristicRace observation
SDOH-Race-1: Must have either a dataAbsentReason or at least one of the defined race components but not both
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... OtherSubject SC0..1Reference(Patient | Group | Device | Location | Organization | Procedure | Practitioner | Medication | Substance | BiologicallyDerivedProduct)Extension
URL: http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.subject"
.... value[x] 1..1Reference(US Core Practitioner Profile)Value of extension
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierBusiness Identifier for observation
... basedOn Σ0..*Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)Fulfills plan, proposal or order
... partOf Σ0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)Part of referenced event
... status ?!SΣ1..1codefinal | corrected | entered-in-error | unknown
Binding: SDOHCC ValueSet Observation Status (required)
... Slices for category 1..*CodeableConceptClassification of type of observation
Slice: Unordered, Open by value:$this
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.


.... category:PersonalCharacteristic S1..1CodeableConceptClassification of type of observation
Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.



Required Pattern: At least the following
..... id0..1idUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
...... id0..1idUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/us/sdoh-clinicalcare/CodeSystem/SDOHCC-CodeSystemTemporaryCodes
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: personal-characteristic
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... text0..1stringPlain text representation of the concept
... code SΣ1..1CodeableConceptType of observation (code / type)
Binding: LOINCCodes (preferred)
Required Pattern: At least the following
.... id0..1idUnique id for inter-element referencing
.... extension0..*ExtensionAdditional content defined by implementations
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... id0..1idUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
..... version0..1stringVersion of the system - if relevant
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
..... display0..1stringRepresentation defined by the system
..... userSelected0..1booleanIf this coding was chosen directly by the user
.... text0..1stringPlain text representation of the concept
... subject SΣC0..1Reference(US Core Patient Profile)Who and/or what the observation is about
... focus ΣC0..1Reference(RelatedPerson)What the observation is about, when it is not about the subject of record
... encounter Σ0..1Reference(Encounter)Healthcare event during which this observation is made
... effective[x] Σ0..1Clinically relevant time/time-period for observation
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
... issued Σ0..1instantDate/Time this version was made available
... performer SΣC0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)Who is responsible for the observation
... dataAbsentReason SC0..1CodeableConceptWhy the result is missing
Binding: SDOHCC ValueSet Observation DataAbsentReason (required)
... note 0..*AnnotationComments about the observation
... method S1..1CodeableConceptHow it was done
Binding: SDOHCC ValueSet Observation Method (extensible): Methods for personal characteristic observations.

... device 0..1Reference(Device | DeviceMetric)(Measurement) Device
... hasMember Σ0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)Related resource that belongs to the Observation group
... derivedFrom SΣC0..*Reference(DocumentReference | QuestionnaireResponse | Observation)Related measurements the observation is made from
... Slices for component ΣC0..*BackboneElementComponent results
Slice: Unordered, Open by pattern:code, type:value, value:value
.... component:All Slices Content/Rules for all slices
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code Σ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.

..... value[x] Σ0..1Actual component result
...... valueQuantityQuantity
...... valueCodeableConceptCodeableConcept
...... valueStringstring
...... valueBooleanboolean
...... valueIntegerinteger
...... valueRangeRange
...... valueRatioRatio
...... valueSampledDataSampledData
...... valueTimetime
...... valueDateTimedateTime
...... valuePeriodPeriod
..... dataAbsentReason C0..1CodeableConceptWhy the component result is missing
Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.

..... interpretation 0..*CodeableConceptHigh, low, normal, etc.
Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.


..... referenceRange 0..*See referenceRange (Observation)Provides guide for interpretation of component result
.... component:RaceDescription SΣ0..1BackboneElementComponent results
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... id0..1idUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..1idUnique id for inter-element referencing
....... extension0..*ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... version0..1stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
....... display0..1stringRepresentation defined by the system
....... userSelected0..1booleanIf this coding was chosen directly by the user
...... text0..1stringPlain text representation of the concept
..... value[x] SΣ1..1stringActual component result
.... component:Race SΣ0..5BackboneElementComponent results
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... id0..1idUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..1idUnique id for inter-element referencing
....... extension0..*ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... version0..1stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
....... display0..1stringRepresentation defined by the system
....... userSelected0..1booleanIf this coding was chosen directly by the user
...... text0..1stringPlain text representation of the concept
..... value[x] SΣ1..1CodeableConceptRace category codes
Binding: Race Category Excluding Nulls (required): Codes for the five OMB race categories

.... component:DetailedRace Σ0..*BackboneElementComponent results
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code SΣ1..1CodeableConceptType of component observation (code / type)
Binding: LOINCCodes (example): Codes identifying names of simple observations.


Required Pattern: At least the following
...... id0..1idUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..1idUnique id for inter-element referencing
....... extension0..*ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://loinc.org
....... version0..1stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: 72826-1
....... display0..1stringRepresentation defined by the system
....... userSelected0..1booleanIf this coding was chosen directly by the user
...... text0..1stringPlain text representation of the concept
..... value[x] SΣ1..1CodeableConceptDetailed race codes
Binding: Detailed Race (required): CDC race codes that further specify the 5 OMB race category codes


doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Observation.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Observation.statusrequiredSDOHCCValueSetObservationStatus
Observation.categorypreferredObservationCategoryCodes
Observation.category:PersonalCharacteristicpreferredPattern: personal-characteristic
Observation.codepreferredPattern: LOINC code 72826-1
Observation.dataAbsentReasonrequiredSDOHCCValueSetObservationDataAbsentReason
Observation.methodextensibleSDOHCCValueSetObservationMethod
Observation.referenceRange.typepreferredObservationReferenceRangeMeaningCodes
Observation.referenceRange.appliesToexampleObservationReferenceRangeAppliesToCodes
Observation.component.codeexampleLOINCCodes (a valid code from LOINC)
Observation.component.dataAbsentReasonextensibleDataAbsentReason
Observation.component.interpretationextensibleObservationInterpretationCodes
Observation.component:RaceDescription.codeexamplePattern: LOINC code 72826-1
Observation.component:Race.codeexamplePattern: LOINC code 72826-1
Observation.component:Race.value[x]requiredRace Category Excluding Nulls
Observation.component:DetailedRace.codeexamplePattern: LOINC code 72826-1
Observation.component:DetailedRace.value[x]requiredDetailedRace

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

This structure is derived from SDOHCCObservationPersonalCharacteristic

Summary

Mandatory: 1 element (3 nested mandatory elements)
Must-Support: 10 elements
Prohibited: 10 elements

Slices

This structure defines the following Slices:

  • The element Observation.component is sliced based on the values of pattern:code, type:value, value:value

 

Other representations of profile: CSV, Excel, Schematron