description: 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.
package_name: hl7.fhir.r4b.examples
derivation: specialization
name: Goal
type: Goal
elements:
  description:
    isModifier: false
    short: Code or text describing goal
    type: CodeableConcept
    mustSupport: false
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/clinical-findings'}
    isSummary: true
    index: 5
  category:
    isModifier: false
    short: E.g. Treatment, dietary, behavioral, etc.
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/goal-category'}
    isSummary: true
    index: 3
  addresses:
    isModifier: false
    short: Issues addressed by this goal
    refers: ['http://hl7.org/fhir/StructureDefinition/Condition', 'http://hl7.org/fhir/StructureDefinition/MedicationStatement', 'http://hl7.org/fhir/StructureDefinition/NutritionOrder', 'http://hl7.org/fhir/StructureDefinition/Observation', 'http://hl7.org/fhir/StructureDefinition/RiskAssessment', 'http://hl7.org/fhir/StructureDefinition/ServiceRequest']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 29
  expressedBy:
    isModifier: false
    short: Who's responsible for creating Goal?
    refers: ['http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 28
  startDate: {isModifier: false, short: When goal pursuit begins, type: date, mustSupport: false, choiceOf: start, isSummary: true, index: 9}
  start:
    isModifier: false
    short: When goal pursuit begins
    mustSupport: false
    choices: [startDate, startCodeableConcept]
    isSummary: true
    index: 8
  achievementStatus:
    isModifier: false
    short: in-progress | improving | worsening | no-change | achieved | sustaining | not-achieved | no-progress | not-attainable
    type: CodeableConcept
    mustSupport: false
    binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/goal-achievement'}
    isSummary: true
    index: 2
  statusReason: {isModifier: false, short: Reason for current status, type: string, mustSupport: false, isSummary: false, index: 27}
  note: {isModifier: false, short: Comments about the goal, type: Annotation, mustSupport: false, array: true, isSummary: false, index: 30}
  startCodeableConcept: {isModifier: false, short: When goal pursuit begins, type: CodeableConcept, mustSupport: false, choiceOf: start, isSummary: true, index: 10}
  priority:
    isModifier: false
    short: high-priority | medium-priority | low-priority
    type: CodeableConcept
    mustSupport: false
    binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/goal-priority'}
    isSummary: true
    index: 4
  outcomeCode:
    isModifier: false
    short: What result was achieved regarding the goal?
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/clinical-findings'}
    isSummary: false
    index: 31
  identifier: {isModifier: false, short: External Ids for this goal, type: Identifier, mustSupport: false, array: true, isSummary: false, index: 0}
  statusDate: {isModifier: false, short: When goal status took effect, type: date, mustSupport: false, isSummary: true, index: 26}
  target:
    constraint:
      gol-1: {human: Goal.target.measure is required if Goal.target.detail is populated, source: 'http://hl7.org/fhir/StructureDefinition/Goal', severity: error, expression: (detail.exists() and measure.exists()) or detail.exists().not()}
    isModifier: false
    short: Target outcome for the goal
    index: 11
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      detailRange: {isModifier: false, short: The target value to be achieved, type: Range, mustSupport: false, choiceOf: detail, isSummary: true, index: 16}
      detailQuantity: {isModifier: false, short: The target value to be achieved, type: Quantity, mustSupport: false, choiceOf: detail, isSummary: true, index: 15}
      detailInteger: {isModifier: false, short: The target value to be achieved, type: integer, mustSupport: false, choiceOf: detail, isSummary: true, index: 20}
      detailString: {isModifier: false, short: The target value to be achieved, type: string, mustSupport: false, choiceOf: detail, isSummary: true, index: 18}
      measure:
        isModifier: false
        short: The parameter whose value is being tracked
        type: CodeableConcept
        mustSupport: false
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/observation-codes'}
        isSummary: true
        index: 12
      due:
        isModifier: false
        short: Reach goal on or before
        mustSupport: false
        choices: [dueDate, dueDuration]
        isSummary: true
        index: 23
      detailRatio: {isModifier: false, short: The target value to be achieved, type: Ratio, mustSupport: false, choiceOf: detail, isSummary: true, index: 21}
      detailCodeableConcept: {isModifier: false, short: The target value to be achieved, type: CodeableConcept, mustSupport: false, choiceOf: detail, isSummary: true, index: 17}
      dueDate: {isModifier: false, short: Reach goal on or before, type: date, mustSupport: false, choiceOf: due, isSummary: true, index: 24}
      detailBoolean: {isModifier: false, short: The target value to be achieved, type: boolean, mustSupport: false, choiceOf: detail, isSummary: true, index: 19}
      dueDuration: {isModifier: false, short: Reach goal on or before, type: Duration, mustSupport: false, choiceOf: due, isSummary: true, index: 25}
      detail:
        isModifier: false
        short: The target value to be achieved
        mustSupport: false
        choices: [detailQuantity, detailRange, detailCodeableConcept, detailString, detailBoolean, detailInteger, detailRatio]
        isSummary: true
        index: 14
    isSummary: false
  outcomeReference:
    isModifier: false
    short: Observation that resulted from goal
    refers: ['http://hl7.org/fhir/StructureDefinition/Observation']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 32
  subject:
    isModifier: false
    short: Who this goal is intended for
    refers: ['http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 6
  lifecycleStatus:
    isModifier: true
    short: proposed | planned | accepted | active | on-hold | completed | cancelled | entered-in-error | rejected
    index: 1
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/goal-status|4.3.0'}
    isModifierReason: 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
    isSummary: true
package_version: 4.3.0
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Goal
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.3.0
required: [lifecycleStatus, subject, description]