SDOH Clinical Care
1.1.0 - STU 2 ballot

This page is part of the SDOH Clinical Care for Multiple Domains (v1.1.0: STU 2 Ballot 1) based on FHIR R4. The current version which supercedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions

Resource Profile: SDOHCC Goal

Defining URL:http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Goal
Version:1.1.0
Name:SDOHCCGoal
Title:SDOHCC Goal
Status:Draft as of 12/14/20 4:01 AM
Definition:

Profile for goals that address Social Determinants of Health (SDOH).

Publisher:HL7 International - Patient Care WG
Source Resource:XML / JSON / Turtle

The official URL for this profile is:

http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Goal

Formal Views of Profile Content

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

This structure is derived from USCoreGoalProfile

Summary

Mandatory: 1 element
Must-Support: 4 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element Goal.category is sliced based on the value of value:$this
  • The element Goal.addresses is sliced based on the value of profile:resolve()
  • The element Goal.outcomeReference is sliced based on the value of profile:resolve()

This structure is derived from USCoreGoalProfile

NameFlagsCard.TypeDescription & Constraintsdoco
.. Goal 0..*USCoreGoalProfileDescribes the intended SDOH-related objective(s) for a patient.
... achievementStatus S1..1CodeableConceptin-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable
... Slices for category 0..*CodeableConceptE.g. Treatment, dietary, behavioral, etc.
Slice: Unordered, Open by value:$this
.... category:SDOH S0..*CodeableConcepte.g., food-insecurity | transportation-insecurity
Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.

... description 1..1CodeableConceptCode or text describing goal
Binding: SDOHCC ValueSet LOINC SNOMEDCT (preferred): Codes providing the details of a particular goal. In many systems, only the text element will be used.

... target
.... measure 0..1CodeableConceptThe parameter whose value is being tracked
Binding: LOINCCodes (preferred)
... statusDate 0..1dateWhen 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 S0..*Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Issues addressed by this goal
... outcomeCode 0..*CodeableConceptWhat result was achieved regarding the goal?
Binding: SDOHCC ValueSet LOINC SNOMEDCT (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 S0..*Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Observation that resulted from goal

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Goal 0..*USCoreGoalProfileDescribes the intended SDOH-related objective(s) for a patient.
... id Σ0..1stringLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier 0..*IdentifierExternal Ids for this goal
... lifecycleStatus ?!SΣ1..1codeproposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
Binding: GoalLifecycleStatus (required)
... achievementStatus SΣ1..1CodeableConceptin-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..*CodeableConceptE.g. Treatment, dietary, behavioral, etc.
Slice: Unordered, Open by value:$this
Binding: GoalCategory (example): Codes for grouping and sorting goals.


.... category:SDOH SΣ0..*CodeableConcepte.g., food-insecurity | transportation-insecurity
Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.


... priority Σ0..1CodeableConcepthigh-priority | medium-priority | low-priority
Binding: GoalPriority (preferred): The level of importance associated with a goal.

... description SΣ1..1CodeableConceptCode or text describing goal
Binding: SDOHCC ValueSet LOINC SNOMEDCT (preferred): Codes providing the details of a particular goal. In many systems, only the text element will be used.

... subject SΣ1..1Reference(US Core Patient Profile)Who this goal is intended for
... start[x] Σ0..1When goal pursuit begins
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal.

.... startDatedate
.... startCodeableConceptCodeableConcept
... target SI0..*BackboneElementTarget outcome for the goal
.... 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
.... measure ΣI0..1CodeableConceptThe parameter whose value is being tracked
Binding: LOINCCodes (preferred)
.... detail[x] ΣI0..1The target value to be achieved
Binding: (unbound) (example): Codes to identify the target value of the focus to be achieved to signify the fulfillment of the goal.

..... detailQuantityQuantity
..... detailRangeRange
..... detailCodeableConceptCodeableConcept
..... detailStringstring
..... detailBooleanboolean
..... detailIntegerinteger
..... detailRatioRatio
.... due[x] SΣ0..1Reach goal on or before
..... dueDatedate S
..... dueDurationDuration
... statusDate Σ0..1dateWhen goal status took effect
... statusReason 0..1stringReason for current status
... expressedBy Σ0..1Reference(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 S0..*Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Issues addressed by this goal
... note 0..*AnnotationComments about the goal
... outcomeCode 0..*CodeableConceptWhat result was achieved regarding the goal?
Binding: SDOHCC ValueSet LOINC SNOMEDCT (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 S0..*Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Observation that resulted from goal

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Goal 0..*USCoreGoalProfileDescribes the intended SDOH-related objective(s) for a patient.
... lifecycleStatus ?!Σ1..1codeproposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
Binding: GoalLifecycleStatus (required)
... achievementStatus Σ1..1CodeableConceptin-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.

... category:SDOH Σ0..*CodeableConcepte.g., food-insecurity | transportation-insecurity
Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.


... subject Σ1..1Reference(US Core Patient Profile)Who this goal is intended for
... target I0..*BackboneElementTarget outcome for the goal
.... due[x] Σ0..1Reach goal on or before
..... dueDatedate
... addresses:SupportedAddresses 0..*Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Issues addressed by this goal
... outcomeReference:SupportedOutcomeReference 0..*Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Observation that resulted from goal

doco Documentation for this format

This structure is derived from USCoreGoalProfile

Summary

Mandatory: 1 element
Must-Support: 4 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element Goal.category is sliced based on the value of value:$this
  • The element Goal.addresses is sliced based on the value of profile:resolve()
  • The element Goal.outcomeReference is sliced based on the value of profile:resolve()

Differential View

This structure is derived from USCoreGoalProfile

NameFlagsCard.TypeDescription & Constraintsdoco
.. Goal 0..*USCoreGoalProfileDescribes the intended SDOH-related objective(s) for a patient.
... achievementStatus S1..1CodeableConceptin-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable
... Slices for category 0..*CodeableConceptE.g. Treatment, dietary, behavioral, etc.
Slice: Unordered, Open by value:$this
.... category:SDOH S0..*CodeableConcepte.g., food-insecurity | transportation-insecurity
Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.

... description 1..1CodeableConceptCode or text describing goal
Binding: SDOHCC ValueSet LOINC SNOMEDCT (preferred): Codes providing the details of a particular goal. In many systems, only the text element will be used.

... target
.... measure 0..1CodeableConceptThe parameter whose value is being tracked
Binding: LOINCCodes (preferred)
... statusDate 0..1dateWhen 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 S0..*Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Issues addressed by this goal
... outcomeCode 0..*CodeableConceptWhat result was achieved regarding the goal?
Binding: SDOHCC ValueSet LOINC SNOMEDCT (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 S0..*Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Observation that resulted from goal

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Goal 0..*USCoreGoalProfileDescribes the intended SDOH-related objective(s) for a patient.
... id Σ0..1stringLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier 0..*IdentifierExternal Ids for this goal
... lifecycleStatus ?!SΣ1..1codeproposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
Binding: GoalLifecycleStatus (required)
... achievementStatus SΣ1..1CodeableConceptin-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..*CodeableConceptE.g. Treatment, dietary, behavioral, etc.
Slice: Unordered, Open by value:$this
Binding: GoalCategory (example): Codes for grouping and sorting goals.


.... category:SDOH SΣ0..*CodeableConcepte.g., food-insecurity | transportation-insecurity
Binding: SDOHCC ValueSet SDOH Category (required): Codes for high-level SDOH categories.


... priority Σ0..1CodeableConcepthigh-priority | medium-priority | low-priority
Binding: GoalPriority (preferred): The level of importance associated with a goal.

... description SΣ1..1CodeableConceptCode or text describing goal
Binding: SDOHCC ValueSet LOINC SNOMEDCT (preferred): Codes providing the details of a particular goal. In many systems, only the text element will be used.

... subject SΣ1..1Reference(US Core Patient Profile)Who this goal is intended for
... start[x] Σ0..1When goal pursuit begins
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal.

.... startDatedate
.... startCodeableConceptCodeableConcept
... target SI0..*BackboneElementTarget outcome for the goal
.... 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
.... measure ΣI0..1CodeableConceptThe parameter whose value is being tracked
Binding: LOINCCodes (preferred)
.... detail[x] ΣI0..1The target value to be achieved
Binding: (unbound) (example): Codes to identify the target value of the focus to be achieved to signify the fulfillment of the goal.

..... detailQuantityQuantity
..... detailRangeRange
..... detailCodeableConceptCodeableConcept
..... detailStringstring
..... detailBooleanboolean
..... detailIntegerinteger
..... detailRatioRatio
.... due[x] SΣ0..1Reach goal on or before
..... dueDatedate S
..... dueDurationDuration
... statusDate Σ0..1dateWhen goal status took effect
... statusReason 0..1stringReason for current status
... expressedBy Σ0..1Reference(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 S0..*Reference(SDOHCC Condition | SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Issues addressed by this goal
... note 0..*AnnotationComments about the goal
... outcomeCode 0..*CodeableConceptWhat result was achieved regarding the goal?
Binding: SDOHCC ValueSet LOINC SNOMEDCT (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 S0..*Reference(SDOHCC Observation Screening Response | SDOHCC Observation Assessment)Observation that resulted from goal

doco Documentation for this format

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

PathConformanceValueSet
Goal.languagepreferredCommonLanguages
Max Binding: AllLanguages
Goal.lifecycleStatusrequiredGoalLifecycleStatus
Goal.achievementStatuspreferredGoalAchievementStatus
Goal.categoryexampleGoalCategory
Goal.category:SDOHrequiredSDOHCCValueSetSDOHCategory
Goal.prioritypreferredGoalPriority
Goal.descriptionpreferredSDOHCCValueSetLOINCSNOMEDCT
Goal.start[x]exampleGoalStartEvent
Goal.target.measurepreferredLOINCCodes
Goal.target.detail[x]example
Goal.outcomeCodepreferredSDOHCCValueSetLOINCSNOMEDCT

Constraints

IdPathDetailsRequirements
dom-2GoalIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3GoalIf 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-4GoalIf 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-5GoalIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6GoalA resource should have narrative for robust management
: text.`div`.exists()
ele-1Goal.metaAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.implicitRulesAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.languageAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.textAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Goal.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Goal.modifierExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Goal.modifierExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Goal.identifierAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.lifecycleStatusAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.achievementStatusAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.categoryAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.category:SDOHAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.priorityAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.descriptionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.subjectAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.start[x]All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.targetAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
gol-1Goal.targetGoal.target.measure is required if Goal.target.detail is populated
: (detail.exists() and measure.exists()) or detail.exists().not()
ele-1Goal.target.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Goal.target.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Goal.target.modifierExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Goal.target.modifierExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Goal.target.measureAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.target.detail[x]All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.target.due[x]All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.statusDateAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.statusReasonAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.expressedByAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.addressesAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.addresses:SupportedAddressesAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.noteAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.outcomeCodeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.outcomeReferenceAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Goal.outcomeReference:SupportedOutcomeReferenceAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())