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.r5.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: 6
  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/MedicationRequest', 'http://hl7.org/fhir/StructureDefinition/MedicationUsage', '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: 30
  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: 29
  startDate: {short: When goal pursuit begins, type: date, choiceOf: start, isSummary: true, index: 10}
  start:
    short: When goal pursuit begins
    choices: [startDate, startCodeableConcept]
    isSummary: true
    index: 9
  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
  continuous: {short: 'After meeting the goal, ongoing activity is needed to sustain the goal objective', type: boolean, index: 4}
  statusReason: {type: string, short: Reason for current status, index: 28}
  outcome:
    short: What result was achieved regarding the goal?
    type: CodeableReference
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/clinical-findings'}
    index: 32
  note: {short: Comments about the goal, type: Annotation, array: true, index: 31}
  startCodeableConcept: {short: When goal pursuit begins, type: CodeableConcept, choiceOf: start, isSummary: true, index: 11}
  priority:
    short: high-priority | medium-priority | low-priority
    type: CodeableConcept
    binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/goal-priority'}
    isSummary: true
    index: 5
  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: 27}
  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: 12
    elements:
      detailRange: {short: The target value to be achieved, type: Range, choiceOf: detail, isSummary: true, index: 17}
      detailQuantity: {short: The target value to be achieved, type: Quantity, choiceOf: detail, isSummary: true, index: 16}
      detailInteger: {short: The target value to be achieved, type: integer, choiceOf: detail, isSummary: true, index: 21}
      detailString: {short: The target value to be achieved, type: string, choiceOf: detail, isSummary: true, index: 19}
      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: 13
      due:
        short: Reach goal on or before
        choices: [dueDate, dueDuration]
        isSummary: true
        index: 24
      detailRatio: {short: The target value to be achieved, type: Ratio, choiceOf: detail, isSummary: true, index: 22}
      detailCodeableConcept: {short: The target value to be achieved, type: CodeableConcept, choiceOf: detail, isSummary: true, index: 18}
      dueDate: {short: Reach goal on or before, type: date, choiceOf: due, isSummary: true, index: 25}
      detailBoolean: {short: The target value to be achieved, type: boolean, choiceOf: detail, isSummary: true, index: 20}
      dueDuration: {short: Reach goal on or before, type: Duration, choiceOf: due, isSummary: true, index: 26}
      detail:
        short: The target value to be achieved
        choices: [detailQuantity, detailRange, detailCodeableConcept, detailString, detailBoolean, detailInteger, detailRatio]
        isSummary: true
        index: 15
  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: 7
  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.2.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
    index: 1
package_version: 4.2.0
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Goal
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.2.0
required: [lifecycleStatus, subject, description]