SDOH Clinical Care
2.3.0-draft - STU 2.3 Draft United States of America flag

SDOH Clinical Care, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 2.3.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

Resource Profile: SDOHCCGoal - Detailed Descriptions

Page standards status: Trial-use Maturity Level: 2

Definitions for the SDOHCC-Goal resource profile.

Guidance on how to interpret the contents of this table can be found here

0. Goal
Definition

For representation of SDOH goals.


Describes the intended objective(s) for a patient, group or organization care, for example, weight loss, restoring an activity of daily living, obtaining herd immunity via immunization, meeting a process improvement objective, etc.

ShortDescribes the intended SDOH-related objective(s) for a patient.Describes the intended objective(s) for a patient, group or organization
Comments

Many of the SDOHCC profiles reference one another. One flow supported by this IG is that QuestionnaireResponses result in Observations that can be used as evidence for Conditions that can lead to Goals, ServiceRequests and Procedures. However, alternatives paths are also possible.


Goal can be achieving a particular change or merely maintaining a current state or even slowing a decline.

Control0..*
Is Modifierfalse
Must Supportfalse
Summaryfalse
Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-3: 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: 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: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
dom-6: A resource should have narrative for robust management (text.`div`.exists())
2. Goal.implicitRules
Definition

A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

ShortA set of rules under which this content was created
Comments

Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

Control0..1
Typeuri
Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. Goal.modifierExtension
Definition

May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

ShortExtensions that cannot be ignored
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
Summaryfalse
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Alternate Namesextensions, user content
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
6. Goal.lifecycleStatus
Definition

The state of the goal throughout its lifecycle.

Shortproposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
Comments

This element is labeled as a modifier because the lifecycleStatus contains codes that mark the resource as not currently valid.

Control1..1
BindingThe codes SHALL be taken from GoalLifecycleStatushttp://hl7.org/fhir/ValueSet/goal-status|4.0.1
(required to http://hl7.org/fhir/ValueSet/goal-status)
Typecode
Is Modifiertrue because This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Must Supporttrue
Summarytrue
Requirements

Allows knowing whether goal needs to be further tracked.

Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
8. Goal.achievementStatus
Definition

Describes the progression, or lack thereof, towards the goal against the target.

Shortin-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable
Control0..1
BindingThe codes SHOULD be taken from GoalAchievementStatushttp://hl7.org/fhir/ValueSet/goal-achievement
(preferred to http://hl7.org/fhir/ValueSet/goal-achievement)

Indicates the progression, or lack thereof, towards the goal against the target.

TypeCodeableConcept
Is Modifierfalse
Must Supporttrue
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
10. Goal.category
Definition

Indicates a category the goal falls within.

ShortE.g. Treatment, dietary, behavioral, etc.
Control0..*
BindingFor example codes, see GoalCategoryhttp://hl7.org/fhir/ValueSet/goal-category
(example to http://hl7.org/fhir/ValueSet/goal-category)

Codes for grouping and sorting goals.

TypeCodeableConcept
Is Modifierfalse
Summarytrue
Requirements

Allows goals to be filtered and sorted.

Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
SlicingThis element introduces a set of slices on Goal.category. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ $this
  • 12. Goal.category:SDOHCC
    Slice NameSDOHCC
    Definition

    An SDOH category assigned to the goal.


    Indicates a category the goal falls within.

    Shorte.g., food-insecurity | transportation-insecurityE.g. Treatment, dietary, behavioral, etc.
    Control0..*
    BindingThe codes SHALL be taken from For example codes, see SDOHCC ValueSet SDOH Categoryhttp://hl7.org/fhir/ValueSet/goal-category
    (required to http://hl7.org/fhir/us/sdoh-clinicalcare/ValueSet/SDOHCC-ValueSetSDOHCategory)

    Codes for high-level SDOH categories.


    Codes for grouping and sorting goals.

    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Requirements

    Codes from this value set can be used to assign one or more SDOH categories (e.g., food-insecurity, transportation-insecurity, etc.) to a goal. It is recommended that SDOH category codes be used to facilitate searching for SDOH-related goals.


    Allows goals to be filtered and sorted.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    14. Goal.description
    Definition

    Human-readable and/or coded description of a specific desired objective of care, such as "control blood pressure" or "negotiate an obstacle course" or "dance with child at wedding".

    ShortCode or text describing goal
    Comments

    If no code is available, use CodeableConcept.text.


    If no code is available, use CodeableConcept.text.

    Control1..1
    BindingUnless not suitable, these codes SHALL be taken from For example codes, see USCoreGoalCodes (7.0.0)http://hl7.org/fhir/ValueSet/clinical-findings
    (extensible to http://hl7.org/fhir/us/core/ValueSet/us-core-goal-description|7.0.0)

    Codes providing the details of a particular goal. In many systems, only the text element will be used.


    Codes providing the details of a particular goal. This will generally be system or implementation guide-specific. In many systems, only the text element will be used.

    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Requirements

    Without a description of what's trying to be achieved, element has no purpose.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    16. Goal.subject
    Definition

    Identifies the patient for whom the goal is being established.


    Identifies the patient, group or organization for whom the goal is being established.

    ShortWho this goal is intended for
    Control1..1
    TypeReference(US Core Patient Profile, Patient, Group, Organization)
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Requirements

    Subject is optional to support annonymized reporting.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    18. Goal.start[x]
    Definition

    The date or event after which the goal should begin being pursued.

    ShortWhen goal pursuit begins
    Control0..1
    BindingFor example codes, see GoalStartEventhttp://hl7.org/fhir/ValueSet/goal-start-event
    (example to http://hl7.org/fhir/ValueSet/goal-start-event)

    Codes describing events that can trigger the initiation of a goal.

    TypeChoice of: date, CodeableConcept
    [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Must Support Typesdate
    Summarytrue
    Requirements

    Goals can be established prior to there being an intention to start pursuing them; e.g. Goals for post-surgical recovery established prior to surgery.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    20. Goal.target
    Definition

    Indicates what should be done by when.

    ShortTarget outcome for the goal
    Comments

    When multiple targets are present for a single goal instance, all targets must be met for the overall goal to be met.

    Control0..*
    This element is affected by the following invariants: gol-1
    TypeBackboneElement
    Is Modifierfalse
    Must Supporttrue
    Summaryfalse
    Requirements

    Allows the progress of the goal to be monitored against an observation or due date. Target is 0..* to support Observations with multiple components, such as blood pressure goals with both a systolic and diastolic target.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    gol-1: Goal.target.measure is required if Goal.target.detail is populated ((detail.exists() and measure.exists()) or detail.exists().not())
    gol-1: Goal.target.measure is required if Goal.target.detail is populated ((detail.exists() and measure.exists()) or detail.exists().not())
    22. Goal.target.modifierExtension
    Definition

    May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

    Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

    ShortExtensions that cannot be ignored even if unrecognized
    Comments

    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

    Control0..*
    TypeExtension
    Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
    Summarytrue
    Requirements

    Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

    Alternate Namesextensions, user content, modifiers
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    24. Goal.target.measure
    Definition

    The parameter whose value is being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level.

    ShortThe parameter whose value is being tracked
    Control0..1
    This element is affected by the following invariants: gol-1
    BindingThe codes SHOULD be taken from For example codes, see LOINCCodeshttp://hl7.org/fhir/ValueSet/observation-codes
    (preferred to http://hl7.org/fhir/ValueSet/observation-codes)

    Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level.

    TypeCodeableConcept
    Is Modifierfalse
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    26. Goal.target.due[x]
    Definition

    Indicates either the date or the duration after start by which the goal should be met.

    ShortReach goal on or before
    Control0..1
    TypeChoice of: date, Duration
    [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Must Support Typesdate
    Summarytrue
    Requirements

    Identifies when the goal should be evaluated.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    28. Goal.statusDate
    Definition

    Identifies when the current status. I.e. When initially created, when achieved, when cancelled, etc.

    ShortWhen goal status took effect
    Comments

    To see the date for past statuses, query history.

    The Goal Resource does not clearly specify whether Goal.statusDate applies to Goal.achievementStatus or to Goal.lifecycleStatus. For consistent use in the SDOH context, it is recommended that Goal.statusDate be synchronized with Goal.achievementStatus.


    To see the date for past statuses, query history.

    Control0..1
    Typedate
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    30. Goal.addresses
    Definition

    The identified conditions and other health record elements that are intended to be addressed by the goal.

    ShortIssues addressed by this goal
    Control0..*
    TypeReference(Condition, Observation, RiskAssessment, MedicationStatement, NutritionOrder, ServiceRequest)
    Is Modifierfalse
    Summaryfalse
    Requirements

    Allows specific goals to explicitly linked to the concerns they're dealing with - makes the goal more understandable.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    SlicingThis element introduces a set of slices on Goal.addresses. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • profile @ resolve()
    • 32. Goal.addresses:SupportedAddresses
      Slice NameSupportedAddresses
      Definition

      The identified conditions and other health record elements that are intended to be addressed by the goal.

      ShortIssues addressed by this goal
      Control0..*
      TypeReference(SDOHCC Condition, SDOHCC Observation Screening Response, SDOHCC Observation Assessment, Condition, Observation, MedicationStatement, NutritionOrder, ServiceRequest, RiskAssessment)
      Is Modifierfalse
      Must Supporttrue
      Must Support TypesNo must-support rules about the choice of types/profiles
      Summaryfalse
      Requirements

      When a goal addresses SDOH screening response observations generated from a survey/questionnaire, SDOH assessment observations, or SDOH conditions, Goal.addresses should reference instances that comply with the SDOHCC Observation Screening Response, SDOHCC Condition, or SDOHCC Observation Assessment profiles. However, references to other instance types are also possible.


      Allows specific goals to explicitly linked to the concerns they're dealing with - makes the goal more understandable.

      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      34. Goal.outcomeCode
      Definition

      Identifies the change (or lack of change) at the point when the status of the goal is assessed.

      ShortWhat result was achieved regarding the goal?
      Comments

      Note that this should not duplicate the goal status.

      Information represented by Goal.outcomeCode may overlap significantly with information represented by Goal.outcomeReference. Multiple approaches to representing the same information may negatively impact interoperability. Therefore, where there is significant overlap in information provided by Goal.outcomeCode and Goal.outcomeReference, it is recommended that Goal.outcomeReference should be used to provide details of goal outcomes.


      Note that this should not duplicate the goal status.

      Control0..*
      BindingThe codes SHOULD be taken from For example codes, see USCoreGoalCodes (7.0.0)http://hl7.org/fhir/ValueSet/clinical-findings
      (preferred to http://hl7.org/fhir/us/core/ValueSet/us-core-goal-description|7.0.0)

      The result of the goal; e.g., "Food security", "Has access to a car ".


      The result of the goal; e.g. "25% increase in shoulder mobility", "Anxiety reduced to moderate levels". "15 kg weight loss sustained over 6 months".

      TypeCodeableConcept
      Is Modifierfalse
      Summaryfalse
      Requirements

      Outcome tracking is a key aspect of care planning.

      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      36. Goal.outcomeReference
      Definition

      Details of what's changed (or not changed).

      ShortObservation that resulted from goal
      Comments

      The goal outcome is independent of the outcome of the related activities. For example, if the Goal is to achieve a target body weight of 150 lb and a care plan activity is defined to diet, then the care plan’s activity outcome could be calories consumed whereas goal outcome is an observation for the actual body weight measured.

      Additionally, see comments for Goal.outcomeCode.


      The goal outcome is independent of the outcome of the related activities. For example, if the Goal is to achieve a target body weight of 150 lb and a care plan activity is defined to diet, then the care plan’s activity outcome could be calories consumed whereas goal outcome is an observation for the actual body weight measured.

      Control0..*
      TypeReference(Observation)
      Is Modifierfalse
      Summaryfalse
      Requirements

      Outcome tracking is a key aspect of care planning.

      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      SlicingThis element introduces a set of slices on Goal.outcomeReference. The slices areUnordered and Open, and can be differentiated using the following discriminators:
      • profile @ resolve()
      • 38. Goal.outcomeReference:SupportedOutcomeReference
        Slice NameSupportedOutcomeReference
        Definition

        Details of what's changed (or not changed).

        ShortObservation that resulted from goal
        Comments

        The goal outcome is independent of the outcome of the related activities. For example, if the Goal is to achieve a target body weight of 150 lb and a care plan activity is defined to diet, then the care plan’s activity outcome could be calories consumed whereas goal outcome is an observation for the actual body weight measured.

        Control0..*
        TypeReference(SDOHCC Observation Screening Response, SDOHCC Observation Assessment, Observation)
        Is Modifierfalse
        Must Supporttrue
        Must Support TypesNo must-support rules about the choice of types/profiles
        Summaryfalse
        Requirements

        When a goal outcome can be represented by SDOH screening response observations or SDOH assessment observations, Goal.outcome should reference instances that comply with the SDOHCC Observation Screening Response or SDOHCC Observation Assessment profiles. However, references to other instance types are also possible.


        Outcome tracking is a key aspect of care planning.

        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))