SDOH Clinical Care, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 3.0.0-draft built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-sdoh-clinicalcare/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Goal | Version: 3.0.0-draft | |||
| Standards status: Trial-use Active as of 2025-10-27 | Maturity Level: 2 | Computable Name: SDOHCCGoal | ||
Profile for goals that address Social Determinants of Health (SDOH).
SDOHCC Goal is generally intended to represent a goal established to address an identified social risk or need (e.g., SDOHCC Condition, SDOHCC Observation Screening Response, SDOHCC Observation Assessment). An SDOHCC ServiceRequest and SDOHCC Procedure can pertain to an SDOHCC Goal. See the Data Modeling Framework for more detail on the relationships between SDOHCC Goal and the other profiles in this IG.
Goal.description has a binding to US Core Goal Codes (extensible). Goal.description also has additional bindings to SDOH domain-specific value sets (e.g., for Food Insecurity) which are determined by the value selected for Goal.category. When Goal.category is a value from SDOHCC ValueSet SDOH Category (e.g., food-insecurity), Goal.description SHALL be selected from the corresponding domain-specific value set found in Additional Bindings (i.e. Food Insecurity Goals). If more than one value is selected from SDOHCC ValueSet SDOH Category (e.g., food-insecurity and financial-insecurity) for Goal.category, then Goal.description SHALL be selected from at least one of the corresponding domain-specific value sets found in Additional Bindings (e.g. Food Insecurity Goals).
Of note, Gravity Project is continuously developing terminology for new SDOH domains. Sometimes, a new SDOH domain may already be represented by a category code in SDOHCC ValueSet SDOH Category, but a domain-specific value set may not yet be available in VSAC. In this case, the Additional Binding for the new SDOH domain/category is the default binding for the profile element. Additionally, sometimes a domain-specific value set for a new domain is available in VSAC but does not yet include all standardized codes identified during the domain’s terminology development cycle. In this case, the value set’s “Description” tab in VSAC will state, “In progress”. Additional information related to Gravity value sets is provided on the Social Risk Terminology Value Sets page on the Gravity Project Confluence site.
Additionally, some SDOH domains may not yet be represented in SDOHCC ValueSet SDOH Category. In this case, Goal.category: sdoh-category-unspecified can be used so that the Goal instance can still be categorized as SDOH-related. If desired, Goal.category.text can also be used to further specify the domain. For example, at the time of publication of this IG, “disability-status” is not yet included in SDOHCC ValueSet SDOH Category. In this case, Goal.category: sdoh-category-unspecified can be used along with Goal.category.text: Disability Status. For Goal.category: sdoh-category-unspecified, there will not be domain-specific value sets and Additional Bindings for Goal.description will designate the default binding to US Core Goal Codes (extensible).
For more information on the correlation between Goal.category and the domain-specific value sets in Additional Bindings for Goal.description, see Gravity Project Value Sets.
Usages:
You can also check for usages in the FHIR IG Statistics
Description Differentials, Snapshots, and other representations.
| Name | Flags | Card. | Type | Description & Constraints Filter:   |
|---|---|---|---|---|
  Goal |
0..* | USCoreGoalProfile(7.0.0) | Describes the intended SDOH-related objective(s) for a patient. This profile also complies with the profile US Core Goal Profile (3.1.1) | |
  implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
 modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored |
| lifecycleStatus |
?!SΣ | 1..1 | code | proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected Binding: GoalLifecycleStatus (required) |
 achievementStatus |
SΣ | 0..1 | CodeableConcept | in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable Binding: GoalAchievementStatus (preferred): Indicates the progression, or lack thereof, towards the goal against the target. |
  Slices for category |
Σ | 0..* | CodeableConcept | E.g. Treatment, dietary, behavioral, etc. Slice: Unordered, Open by value:$this Binding: GoalCategory (example): Codes for grouping and sorting goals. |
   category:SDOHCC |
SΣ | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. |
| description |
SΣ | 1..1 | CodeableConcept | Code or text describing goal Binding: USCoreGoalCodes (7.0.0) (extensible): Codes providing the details of a particular goal. In many systems, only the text element will be used. |
 subject |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who this goal is intended for |
 start[x] |
SΣ | 0..1 | When goal pursuit begins Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal. | |
| startDate |
date S | |||
 startCodeableConcept |
CodeableConcept | |||
| target |
SC | 0..* | BackboneElement | Target outcome for the goal Constraints: gol-1 |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| measure |
ΣC | 0..1 | CodeableConcept | The parameter whose value is being tracked Binding: LOINCCodes (preferred): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level. |
 due[x] |
SΣ | 0..1 | Reach goal on or before | |
 dueDate |
date S | |||
| dueDuration |
Duration | |||
| statusDate |
Σ | 0..1 | date | When goal status took effect |
| Slices for addresses |
0..* | Reference(Condition | Observation | RiskAssessment) | Issues addressed by this goal Slice: Unordered, Open by profile:resolve() | |
| addresses:SupportedAddresses |
S | 0..* | Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Issues addressed by this goal |
| outcomeCode |
0..* | CodeableConcept | What result was achieved regarding the goal? Binding: USCoreGoalCodes (7.0.0) (preferred): The result of the goal; e.g., "Food security", "Has access to a car ". | |
| Slices for outcomeReference |
0..* | Reference(Observation) | Observation that resulted from goal Slice: Unordered, Open by profile:resolve() | |
| outcomeReference:SupportedOutcomeReference |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Observation that resulted from goal |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Goal.lifecycleStatus | Base | required | GoalLifecycleStatus | 📦4.0.1 | FHIR Std. |
| Goal.achievementStatus | Base | preferred | Goal achievement status | 📦4.0.1 | FHIR Std. |
| Goal.category | Base | example | Goal category | 📦4.0.1 | FHIR Std. |
| Goal.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-draft | This IG |
| Goal.description | Base | extensible | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Goal.start[x] | Base | example | Goal start event | 📦4.0.1 | FHIR Std. |
| Goal.target.measure | Base | preferred | LOINC Codes | 📦4.0.1 | FHIR Std. |
| Goal.outcomeCode | Base | preferred | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Goal | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Goal | 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 | Goal | 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 | Goal | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Goal | 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()
|
| gol-1 | error | Goal.target | Goal.target.measure is required if Goal.target.detail is populated |
(detail.exists() and measure.exists()) or detail.exists().not()
|
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Goal |
0..* | USCoreGoalProfile(7.0.0) | Describes the intended SDOH-related objective(s) for a patient. This profile also complies with the profile US Core Goal Profile (3.1.1) | |
 achievementStatus |
S | 0..1 | CodeableConcept | in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable |
| Slices for category |
0..* | CodeableConcept | E.g. Treatment, dietary, behavioral, etc. Slice: Unordered, Open by value:$this | |
| category:SDOHCC |
S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. |
| description |
1..1 | CodeableConcept | Code or text describing goal Binding: USCoreGoalCodes (7.0.0) (extensible): Codes providing the details of a particular goal. In many systems, only the text element will be used. | |
| subject |
1..1 | Reference(US Core Patient Profile(7.0.0)) | Who this goal is intended for | |
| target |
||||
| measure |
0..1 | CodeableConcept | The parameter whose value is being tracked Binding: LOINCCodes (preferred): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level. | |
| statusDate |
0..1 | date | When goal status took effect | |
| Slices for addresses |
0..* | Reference(Condition | Observation | RiskAssessment) | Issues addressed by this goal Slice: Unordered, Open by profile:resolve() | |
| addresses:SupportedAddresses |
S | 0..* | Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Issues addressed by this goal |
| outcomeCode |
0..* | CodeableConcept | What result was achieved regarding the goal? Binding: USCoreGoalCodes (7.0.0) (preferred): The result of the goal; e.g., "Food security", "Has access to a car ". | |
| Slices for outcomeReference |
0..* | Reference(Observation) | Observation that resulted from goal Slice: Unordered, Open by profile:resolve() | |
| outcomeReference:SupportedOutcomeReference |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Observation that resulted from goal |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Goal.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-draft | This IG |
| Goal.description | Base | extensible | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Goal.target.measure | Base | preferred | LOINC Codes | 📦4.0.1 | FHIR Std. |
| Goal.outcomeCode | Base | preferred | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Goal |
0..* | USCoreGoalProfile(7.0.0) | Describes the intended SDOH-related objective(s) for a patient. This profile also complies with the profile US Core Goal Profile (3.1.1) | |||||
| 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 | ||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
| 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 | External Ids for this goal | |||||
| lifecycleStatus |
?!SΣ | 1..1 | code | proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected Binding: GoalLifecycleStatus (required) | ||||
| achievementStatus |
SΣ | 0..1 | CodeableConcept | in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable Binding: GoalAchievementStatus (preferred): Indicates the progression, or lack thereof, towards the goal against the target. | ||||
| Slices for category |
Σ | 0..* | CodeableConcept | E.g. Treatment, dietary, behavioral, etc. Slice: Unordered, Open by value:$this Binding: GoalCategory (example): Codes for grouping and sorting goals. | ||||
| category:SDOHCC |
SΣ | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | ||||
| priority |
Σ | 0..1 | CodeableConcept | high-priority | medium-priority | low-priority Binding: GoalPriority (preferred): The level of importance associated with a goal. | ||||
| description |
SΣ | 1..1 | CodeableConcept | Code or text describing goal Binding: USCoreGoalCodes (7.0.0) (extensible): Codes providing the details of a particular goal. In many systems, only the text element will be used. | ||||
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who this goal is intended for | ||||
| start[x] |
SΣ | 0..1 | When goal pursuit begins Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal. | |||||
| startDate |
date S | |||||||
| startCodeableConcept |
CodeableConcept | |||||||
| target |
SC | 0..* | BackboneElement | Target outcome for the goal Constraints: gol-1 | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
| measure |
ΣC | 0..1 | CodeableConcept | The parameter whose value is being tracked Binding: LOINCCodes (preferred): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level. | ||||
| detail[x] |
ΣC | 0..1 | The target value to be achieved Binding Description: (example): Codes to identify the target value of the focus to be achieved to signify the fulfillment of the goal. | |||||
| detailQuantity |
Quantity | |||||||
| detailRange |
Range | |||||||
| detailCodeableConcept |
CodeableConcept | |||||||
| detailString |
string | |||||||
| detailBoolean |
boolean | |||||||
| detailInteger |
integer | |||||||
| detailRatio |
Ratio | |||||||
| due[x] |
SΣ | 0..1 | Reach goal on or before | |||||
| dueDate |
date S | |||||||
| dueDuration |
Duration | |||||||
| statusDate |
Σ | 0..1 | date | When goal status took effect | ||||
| statusReason |
0..1 | string | Reason for current status | |||||
| expressedBy |
Σ | 0..1 | Reference(Patient | Practitioner | PractitionerRole | RelatedPerson) | Who's responsible for creating Goal? | ||||
| Slices for addresses |
0..* | Reference(Condition | Observation | RiskAssessment) | Issues addressed by this goal Slice: Unordered, Open by profile:resolve() | |||||
| addresses:SupportedAddresses |
S | 0..* | Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Issues addressed by this goal | ||||
| note |
0..* | Annotation | Comments about the goal | |||||
| outcomeCode |
0..* | CodeableConcept | What result was achieved regarding the goal? Binding: USCoreGoalCodes (7.0.0) (preferred): The result of the goal; e.g., "Food security", "Has access to a car ". | |||||
| Slices for outcomeReference |
0..* | Reference(Observation) | Observation that resulted from goal Slice: Unordered, Open by profile:resolve() | |||||
| outcomeReference:SupportedOutcomeReference |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Observation that resulted from goal | ||||
| Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Goal.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std. |
| Goal.lifecycleStatus | Base | required | GoalLifecycleStatus | 📦4.0.1 | FHIR Std. |
| Goal.achievementStatus | Base | preferred | Goal achievement status | 📦4.0.1 | FHIR Std. |
| Goal.category | Base | example | Goal category | 📦4.0.1 | FHIR Std. |
| Goal.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-draft | This IG |
| Goal.priority | Base | preferred | Goal priority | 📦4.0.1 | FHIR Std. |
| Goal.description | Base | extensible | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Goal.start[x] | Base | example | Goal start event | 📦4.0.1 | FHIR Std. |
| Goal.target.measure | Base | preferred | LOINC Codes | 📦4.0.1 | FHIR Std. |
| Goal.target.detail[x] | Base | example | Not Stated | Unknown | |
| Goal.outcomeCode | Base | preferred | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Goal | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Goal | 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 | Goal | 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 | Goal | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Goal | 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()
|
| gol-1 | error | Goal.target | Goal.target.measure is required if Goal.target.detail is populated |
(detail.exists() and measure.exists()) or detail.exists().not()
|
Summary
Must-Support: 4 elements
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Maturity: 2
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Goal |
0..* | USCoreGoalProfile(7.0.0) | Describes the intended SDOH-related objective(s) for a patient. This profile also complies with the profile US Core Goal Profile (3.1.1) | |
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored |
| lifecycleStatus |
?!SΣ | 1..1 | code | proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected Binding: GoalLifecycleStatus (required) |
| achievementStatus |
SΣ | 0..1 | CodeableConcept | in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable Binding: GoalAchievementStatus (preferred): Indicates the progression, or lack thereof, towards the goal against the target. |
| Slices for category |
Σ | 0..* | CodeableConcept | E.g. Treatment, dietary, behavioral, etc. Slice: Unordered, Open by value:$this Binding: GoalCategory (example): Codes for grouping and sorting goals. |
| category:SDOHCC |
SΣ | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. |
| description |
SΣ | 1..1 | CodeableConcept | Code or text describing goal Binding: USCoreGoalCodes (7.0.0) (extensible): Codes providing the details of a particular goal. In many systems, only the text element will be used. |
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who this goal is intended for |
| start[x] |
SΣ | 0..1 | When goal pursuit begins Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal. | |
| startDate |
date S | |||
| startCodeableConcept |
CodeableConcept | |||
| target |
SC | 0..* | BackboneElement | Target outcome for the goal Constraints: gol-1 |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| measure |
ΣC | 0..1 | CodeableConcept | The parameter whose value is being tracked Binding: LOINCCodes (preferred): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level. |
| due[x] |
SΣ | 0..1 | Reach goal on or before | |
| dueDate |
date S | |||
| dueDuration |
Duration | |||
| statusDate |
Σ | 0..1 | date | When goal status took effect |
| Slices for addresses |
0..* | Reference(Condition | Observation | RiskAssessment) | Issues addressed by this goal Slice: Unordered, Open by profile:resolve() | |
| addresses:SupportedAddresses |
S | 0..* | Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Issues addressed by this goal |
| outcomeCode |
0..* | CodeableConcept | What result was achieved regarding the goal? Binding: USCoreGoalCodes (7.0.0) (preferred): The result of the goal; e.g., "Food security", "Has access to a car ". | |
| Slices for outcomeReference |
0..* | Reference(Observation) | Observation that resulted from goal Slice: Unordered, Open by profile:resolve() | |
| outcomeReference:SupportedOutcomeReference |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Observation that resulted from goal |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Goal.lifecycleStatus | Base | required | GoalLifecycleStatus | 📦4.0.1 | FHIR Std. |
| Goal.achievementStatus | Base | preferred | Goal achievement status | 📦4.0.1 | FHIR Std. |
| Goal.category | Base | example | Goal category | 📦4.0.1 | FHIR Std. |
| Goal.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-draft | This IG |
| Goal.description | Base | extensible | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Goal.start[x] | Base | example | Goal start event | 📦4.0.1 | FHIR Std. |
| Goal.target.measure | Base | preferred | LOINC Codes | 📦4.0.1 | FHIR Std. |
| Goal.outcomeCode | Base | preferred | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Goal | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Goal | 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 | Goal | 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 | Goal | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Goal | 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()
|
| gol-1 | error | Goal.target | Goal.target.measure is required if Goal.target.detail is populated |
(detail.exists() and measure.exists()) or detail.exists().not()
|
Differential View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Goal |
0..* | USCoreGoalProfile(7.0.0) | Describes the intended SDOH-related objective(s) for a patient. This profile also complies with the profile US Core Goal Profile (3.1.1) | |
| achievementStatus |
S | 0..1 | CodeableConcept | in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable |
| Slices for category |
0..* | CodeableConcept | E.g. Treatment, dietary, behavioral, etc. Slice: Unordered, Open by value:$this | |
| category:SDOHCC |
S | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. |
| description |
1..1 | CodeableConcept | Code or text describing goal Binding: USCoreGoalCodes (7.0.0) (extensible): Codes providing the details of a particular goal. In many systems, only the text element will be used. | |
| subject |
1..1 | Reference(US Core Patient Profile(7.0.0)) | Who this goal is intended for | |
| target |
||||
| measure |
0..1 | CodeableConcept | The parameter whose value is being tracked Binding: LOINCCodes (preferred): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level. | |
| statusDate |
0..1 | date | When goal status took effect | |
| Slices for addresses |
0..* | Reference(Condition | Observation | RiskAssessment) | Issues addressed by this goal Slice: Unordered, Open by profile:resolve() | |
| addresses:SupportedAddresses |
S | 0..* | Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Issues addressed by this goal |
| outcomeCode |
0..* | CodeableConcept | What result was achieved regarding the goal? Binding: USCoreGoalCodes (7.0.0) (preferred): The result of the goal; e.g., "Food security", "Has access to a car ". | |
| Slices for outcomeReference |
0..* | Reference(Observation) | Observation that resulted from goal Slice: Unordered, Open by profile:resolve() | |
| outcomeReference:SupportedOutcomeReference |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Observation that resulted from goal |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Goal.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-draft | This IG |
| Goal.description | Base | extensible | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Goal.target.measure | Base | preferred | LOINC Codes | 📦4.0.1 | FHIR Std. |
| Goal.outcomeCode | Base | preferred | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
Snapshot ViewView
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Goal |
0..* | USCoreGoalProfile(7.0.0) | Describes the intended SDOH-related objective(s) for a patient. This profile also complies with the profile US Core Goal Profile (3.1.1) | |||||
| 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 | ||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
| 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 | External Ids for this goal | |||||
| lifecycleStatus |
?!SΣ | 1..1 | code | proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected Binding: GoalLifecycleStatus (required) | ||||
| achievementStatus |
SΣ | 0..1 | CodeableConcept | in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable Binding: GoalAchievementStatus (preferred): Indicates the progression, or lack thereof, towards the goal against the target. | ||||
| Slices for category |
Σ | 0..* | CodeableConcept | E.g. Treatment, dietary, behavioral, etc. Slice: Unordered, Open by value:$this Binding: GoalCategory (example): Codes for grouping and sorting goals. | ||||
| category:SDOHCC |
SΣ | 0..* | CodeableConcept | e.g., food-insecurity | transportation-insecurity Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories. | ||||
| priority |
Σ | 0..1 | CodeableConcept | high-priority | medium-priority | low-priority Binding: GoalPriority (preferred): The level of importance associated with a goal. | ||||
| description |
SΣ | 1..1 | CodeableConcept | Code or text describing goal Binding: USCoreGoalCodes (7.0.0) (extensible): Codes providing the details of a particular goal. In many systems, only the text element will be used. | ||||
| subject |
SΣ | 1..1 | Reference(US Core Patient Profile(7.0.0)) | Who this goal is intended for | ||||
| start[x] |
SΣ | 0..1 | When goal pursuit begins Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal. | |||||
| startDate |
date S | |||||||
| startCodeableConcept |
CodeableConcept | |||||||
| target |
SC | 0..* | BackboneElement | Target outcome for the goal Constraints: gol-1 | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
| measure |
ΣC | 0..1 | CodeableConcept | The parameter whose value is being tracked Binding: LOINCCodes (preferred): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level. | ||||
| detail[x] |
ΣC | 0..1 | The target value to be achieved Binding Description: (example): Codes to identify the target value of the focus to be achieved to signify the fulfillment of the goal. | |||||
| detailQuantity |
Quantity | |||||||
| detailRange |
Range | |||||||
| detailCodeableConcept |
CodeableConcept | |||||||
| detailString |
string | |||||||
| detailBoolean |
boolean | |||||||
| detailInteger |
integer | |||||||
| detailRatio |
Ratio | |||||||
| due[x] |
SΣ | 0..1 | Reach goal on or before | |||||
| dueDate |
date S | |||||||
| dueDuration |
Duration | |||||||
| statusDate |
Σ | 0..1 | date | When goal status took effect | ||||
| statusReason |
0..1 | string | Reason for current status | |||||
| expressedBy |
Σ | 0..1 | Reference(Patient | Practitioner | PractitionerRole | RelatedPerson) | Who's responsible for creating Goal? | ||||
| Slices for addresses |
0..* | Reference(Condition | Observation | RiskAssessment) | Issues addressed by this goal Slice: Unordered, Open by profile:resolve() | |||||
| addresses:SupportedAddresses |
S | 0..* | Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Issues addressed by this goal | ||||
| note |
0..* | Annotation | Comments about the goal | |||||
| outcomeCode |
0..* | CodeableConcept | What result was achieved regarding the goal? Binding: USCoreGoalCodes (7.0.0) (preferred): The result of the goal; e.g., "Food security", "Has access to a car ". | |||||
| Slices for outcomeReference |
0..* | Reference(Observation) | Observation that resulted from goal Slice: Unordered, Open by profile:resolve() | |||||
| outcomeReference:SupportedOutcomeReference |
S | 0..* | Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment) | Observation that resulted from goal | ||||
| Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Goal.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std. |
| Goal.lifecycleStatus | Base | required | GoalLifecycleStatus | 📦4.0.1 | FHIR Std. |
| Goal.achievementStatus | Base | preferred | Goal achievement status | 📦4.0.1 | FHIR Std. |
| Goal.category | Base | example | Goal category | 📦4.0.1 | FHIR Std. |
| Goal.category:SDOHCC | Base | required | SDOHCC ValueSet SDOH Category | 📦3.0.0-draft | This IG |
| Goal.priority | Base | preferred | Goal priority | 📦4.0.1 | FHIR Std. |
| Goal.description | Base | extensible | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Goal.start[x] | Base | example | Goal start event | 📦4.0.1 | FHIR Std. |
| Goal.target.measure | Base | preferred | LOINC Codes | 📦4.0.1 | FHIR Std. |
| Goal.target.detail[x] | Base | example | Not Stated | Unknown | |
| Goal.outcomeCode | Base | preferred | US Core Goal Codes | 📍7.0.0 | US Core v7.0 |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Goal | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Goal | 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 | Goal | 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 | Goal | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Goal | 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()
|
| gol-1 | error | Goal.target | Goal.target.measure is required if Goal.target.detail is populated |
(detail.exists() and measure.exists()) or detail.exists().not()
|
Summary
Must-Support: 4 elements
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Maturity: 2
Other representations of profile: CSV, Excel, Schematron
IG © 2021+ HL7 International / Patient Care.
Package hl7.fhir.us.sdoh-clinicalcare#3.0.0-draft based on FHIR 4.0.1.
Generated 2025-10-27
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change
