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