FHIR Release 3 (STU) R4 Ballot #1 (Mixed Normative/Trial use)

This page is part of the FHIR Specification (v3.0.2: STU 3). (v3.3.0: R4 Ballot 2). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

9.8 Resource ClinicalImpression - Content

Patient Care Work Group Maturity Level : 0   Draft Compartments : Encounter , Patient , Practitioner

A record of a clinical assessment performed to determine what problem(s) may affect the patient and before planning the treatments or management strategies that are best to manage a patient's condition. Assessments are often 1:1 with a clinical consultation / encounter, but this varies greatly depending on the clinical workflow. This resource is called "ClinicalImpression" "ClinicalImpression" rather than "ClinicalAssessment" "ClinicalAssessment" to avoid confusion with the recording of assessment tools such as Apgar score.

9.8.1 Scope and Usage

Performing a clinical assessment is a fundamental part of a clinician's workflow, performed repeatedly throughout the day. In spite of this - or perhaps, because of it - there is wide variance in how clinical impressions are recorded. Some clinical assessments simply result in an impression recorded as a single text note in the patient 'record' (e.g. "Progress "Progress satisfactory, continue with treatment"), treatment"), while others are associated with careful, detailed record keeping of the evidence gathered and the reasoning leading to a differential diagnosis, and there is a continuum between these. This resource is intended to be used to cover all these use cases.

The assessment is intimately linked to the process of care. It may occur in the context of a care plan, and it very often results in a new (or revised) care plan. Normally. clinical assessments are part of an ongoing process of care, and the patient will be re-assessed repeatedly. For this reason, the clinical impression can explicit reference both care plans (preceeding (preceding and resulting) and reference a previous impression that this impression follows on from.

An impression is a clinical summation of information and/or an opinion formed, which is the outcome of the clinical assessment process. The ClinicalImpression may lead to a statement of a Condition about a patient.

In FHIR, an assessment is typically an instrument or tool used to collect information about a patient.

STU Note: Unlike many other resources, there is little prior art with regard to exchanging records of clinical assessments. For this reason, this resource should be regarded as particularly prone to ongoing revision. In terms of scope and usage, the Patient Care workgroup wishes to draw the attention of reviewers and implementers to the following issues:

  • When is an existing clinical impression revised, rather than a new one created (that references the existing one)? How does that affect the status? what's the interplay between the status of the diagnosis and the status of the impression? (e.g. for a 'provisional' impression, which bit is provisional?)
  • This structure doesn't differentiate between a working and a final diagnosis. Given an answer to the previous question, should it?
  • Further clarify around the relationship between care plan and impression is needed. Both answers to the previous questions and ongoing discussions around revisions to the care plan will influence the design of clinical impression
  • Should prognosis be represented, and if so, how much structure should it have?
  • Should an impression reference other impressions that are related? (how related?)
  • Investigations - the specification needs a good value set for the code for the group, and will be considering the name "investigations" "investigations" further

Feedback is welcome here .

9.8.2 Boundaries and Relationships

There is another related clinical concept often called an "assessment": "assessment": assessment Tools such as Apgar (also known as "Assessment Scales"). "Assessment Scales"). This is not what the ClinicalImpression resource is about; assessment tools such as Apgar are represented as Observations , and Questionnaires may be used to help generate these. Clinical Impressions may refer to these assessment tools as one of the investigations that was performed during the assessment process.

9.8.3 Background and Context

An important background to understanding this resource is the FHIR wiki page for clinical assessment . In particular, the storyboards there drove the design of the resource, and will be the basis for all examples created.

PLANNED CHANGE:

ClinicalImpression is one of the Event resources in the FHIR Workflow specification. As such, it is expected to be adjusted to align with the Event workflow pattern which will involve adding a number of additional data elements and potentially renaming a few elements. Any concerns about performing such alignment are welcome as ballot comments and/or tracker items.

This resource is referenced by condition

9.8.4 Resource Content

Structure

Name Flags Card. Type Description & Constraints doco
. . ClinicalImpression D DomainResource A clinical assessment performed when planning treatments and management strategies for a patient
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier Business identifier
. . . status ?! Σ 1..1 code draft | completed | entered-in-error
ClinicalImpressionStatus ( Required )
. . . code Σ 0..1 CodeableConcept Kind of assessment performed
. . . description Σ 0..1 string Why/how the assessment was performed
. . . subject Σ 1..1 Reference ( Patient | Group ) Patient or group assessed
. . . context Σ 0..1 Reference ( Encounter | EpisodeOfCare ) Encounter or Episode created from
. . . effective[x] Σ 0..1 Time of assessment
. . . . effectiveDateTime dateTime
. . . . effectivePeriod Period
. . . date Σ 0..1 dateTime When the assessment was documented
. . . assessor Σ 0..1 Reference ( Practitioner ) The clinician performing the assessment
. . . previous 0..1 Reference ( ClinicalImpression ) Reference to last assessment
. . . problem Σ 0..* Reference ( Condition | AllergyIntolerance ) Relevant impressions of patient state
. . . investigation 0..* BackboneElement One or more sets of investigations (signs, symptions, symptoms, etc.)
. . . . code 1..1 CodeableConcept A name/code for the set
Investigation Type ( Example )
. . . . item 0..* Reference ( Observation | QuestionnaireResponse | FamilyMemberHistory | DiagnosticReport | RiskAssessment | ImagingStudy | Media ) Record of a specific investigation
. . . protocol 0..* uri Clinical Protocol followed
. . . summary 0..1 string Summary of the assessment
. . . finding 0..* BackboneElement Possible or likely findings and diagnoses
. . . item[x] . itemCodeableConcept 1..1 0..1 CodeableConcept What was found
Condition/Problem/Diagnosis Codes ( Example )
. . . itemCodeableConcept . itemReference CodeableConcept itemReference 0..1 Reference ( Condition | Observation | Media ) What was found
. . . . basis 0..1 string Which investigations support finding
. . . prognosisCodeableConcept 0..* CodeableConcept Estimate of likely outcome
Clinical Impression Prognosis ( Example )
. . . prognosisReference 0..* Reference ( RiskAssessment ) RiskAssessment expressing likely outcome
. . . action 0..* Reference ( ReferralRequest | ProcedureRequest ServiceRequest | Procedure | MedicationRequest | Appointment ) Action taken as part of assessment procedure
. . . note 0..* Annotation Comments made about the ClinicalImpression

doco Documentation for this format

UML Diagram ( Legend )

ClinicalImpression ( DomainResource ) A unique identifier Business identifiers assigned to the this clinical impression that remains consistent regardless of what server by the impression performer or other systems which remain constant as the resource is stored on updated and propagates from server to server identifier : Identifier [0..*] Identifies the workflow status of the assessment (this element modifies the meaning of other elements) status : code [1..1] « The workflow state of a clinical impression. (Strength=Required) ClinicalImpressionStatus ! » Categorizes the type of clinical assessment performed code : CodeableConcept [0..1] A summary of the context and/or cause of the assessment - why / where was it performed, and what patient events/status prompted it description : string [0..1] The patient or group of individuals assessed as part of this record subject : Reference [1..1] « Patient | Group » The encounter or episode of care this impression was created as part of context : Reference [0..1] « Encounter | EpisodeOfCare » The point in time or period over which the subject was assessed effective[x] : Type [0..1] « dateTime | Period » Indicates when the documentation of the assessment was complete date : dateTime [0..1] The clinician performing the assessment assessor : Reference [0..1] « Practitioner » A reference to the last assesment assessment that was conducted bon on this patient. Assessments are often/usually ongoing in nature; a care provider (practitioner or team) will make new assessments on an ongoing basis as new data arises or the patient's conditions changes previous : Reference [0..1] « ClinicalImpression » This a list of the relevant problems/conditions for a patient problem : Reference [0..*] « Condition | AllergyIntolerance » Reference to a specific published clinical protocol that was followed during this assessment, and/or that provides evidence in support of the diagnosis protocol : uri [0..*] A text summary of the investigations and the diagnosis summary : string [0..1] Estimate of likely outcome prognosisCodeableConcept : CodeableConcept [0..*] « Prognosis or outlook findings (Strength=Example) Clinical Impression Prognosis ?? » RiskAssessment expressing likely outcome prognosisReference : Reference [0..*] « RiskAssessment » Action taken as part of assessment procedure action : Reference [0..*] ReferralRequest « ServiceRequest | ProcedureRequest Procedure | Procedure | MedicationRequest | Appointment » Commentary about the impression, typically recorded after the impression itself was made, though supplemental notes by the original author could also appear note : Annotation [0..*] Investigation A name/code for the group ("set") ("set") of investigations. Typically, this will be something like "signs", "symptoms", "clinical", "diagnostic", "signs", "symptoms", "clinical", "diagnostic", but the list is not constrained, and others such groups such as (exposure|family|travel|nutitirional) (exposure|family|travel|nutritional) history may be used code : CodeableConcept [1..1] « A name/code for a set of investigations. (Strength=Example) Investigation Type ?? » A record of a specific investigation that was undertaken item : Reference [0..*] « Observation | QuestionnaireResponse | FamilyMemberHistory | DiagnosticReport | RiskAssessment | ImagingStudy | Media » Finding Specific text, code text or reference code for finding or diagnosis, which may include ruled-out or resolved conditions item[x] itemCodeableConcept : Type [1..1] CodeableConcept | Reference ( Condition | Observation ); [0..1] « Identification of the Condition or diagnosis. (Strength=Example) Condition/Problem/Diagnosis ?? » Specific reference for finding or diagnosis, which may include ruled-out or resolved conditions itemReference : Reference [0..1] « Condition | Observation | Media » Which investigations support finding or diagnosis basis : string [0..1] One or more sets of investigations (signs, symptions, symptoms, etc.). The actual grouping of investigations vary varies greatly depending on the type and context of the assessment. These investigations may include data generated during the assessment process, or data previously generated and recorded that is pertinent to the outcomes investigation [0..*] Specific findings or diagnoses that was considered likely or relevant to ongoing treatment finding [0..*]

XML Template 

<

<ClinicalImpression xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</identifier>
 <

 <identifier><!-- 0..* Identifier Business identifier --></identifier>
 <status value="[code]"/><!-- 1..1 draft | completed | entered-in-error -->

 <code><!-- 0..1 CodeableConcept Kind of assessment performed --></code>
 <

 <description value="[string]"/><!-- 0..1 Why/how the assessment was performed -->

 <subject><!-- 1..1 Reference(Patient|Group) Patient or group assessed --></subject>
 <context><!-- 0..1 Reference(Encounter|EpisodeOfCare) Encounter or Episode created from --></context>
 <effective[x]><!-- 0..1 dateTime|Period Time of assessment --></effective[x]>
 <

 <date value="[dateTime]"/><!-- 0..1 When the assessment was documented -->

 <assessor><!-- 0..1 Reference(Practitioner) The clinician performing the assessment --></assessor>
 <</previous>

 <previous><!-- 0..1 Reference(ClinicalImpression) Reference to last assessment --></previous>

 <problem><!-- 0..* Reference(Condition|AllergyIntolerance) Relevant impressions of patient state --></problem>
 <
  <</code>

 <investigation>  <!-- 0..* One or more sets of investigations (signs, symptoms, etc.) -->
  <code><!-- 1..1 CodeableConcept A name/code for the set --></code>

  <item><!-- 0..* Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|
    </item>

    DiagnosticReport|RiskAssessment|ImagingStudy|Media) Record of a specific investigation --></item>
 </investigation>
 <
 <

 <protocol value="[uri]"/><!-- 0..* Clinical Protocol followed -->
 <summary value="[string]"/><!-- 0..1 Summary of the assessment -->

 <finding>  <!-- 0..* Possible or likely findings and diagnoses -->
  <</item[x]>
  <

  <itemCodeableConcept><!-- 0..1 CodeableConcept What was found --></itemCodeableConcept>
  <itemReference><!-- 0..1 Reference(Condition|Observation|Media) What was found --></itemReference>
  <basis value="[string]"/><!-- 0..1 Which investigations support finding -->

 </finding>
 <prognosisCodeableConcept><!-- 0..* CodeableConcept Estimate of likely outcome --></prognosisCodeableConcept>
 <prognosisReference><!-- 0..* Reference(RiskAssessment) RiskAssessment expressing likely outcome --></prognosisReference>
 <|
   </action>

 <action><!-- 0..* Reference(ServiceRequest|Procedure|MedicationRequest|
   Appointment) Action taken as part of assessment procedure --></action>
 <note><!-- 0..* Annotation Comments made about the ClinicalImpression --></note>
</ClinicalImpression>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "ClinicalImpression",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "
  "

  "identifier" : [{ Identifier }], // Business identifier
  "status" : "<code>", // R!  draft | completed | entered-in-error
  "code" : { CodeableConcept }, // Kind of assessment performed
  "description" : "<string>", // Why/how the assessment was performed
  "subject" : { Reference(Patient|Group) }, // R!  Patient or group assessed
  "context" : { Reference(Encounter|EpisodeOfCare) }, // Encounter or Episode created from

  // effective[x]: Time of assessment. One of these 2:
  ">",
  " },
  "
  "
  "
  "
  "
    "
    "|
    

  "effectiveDateTime" : "<dateTime>",
  "effectivePeriod" : { Period },
  "date" : "<dateTime>", // When the assessment was documented
  "assessor" : { Reference(Practitioner) }, // The clinician performing the assessment
  "previous" : { Reference(ClinicalImpression) }, // Reference to last assessment
  "problem" : [{ Reference(Condition|AllergyIntolerance) }], // Relevant impressions of patient state
  "investigation" : [{ // One or more sets of investigations (signs, symptoms, etc.)
    "code" : { CodeableConcept }, // R!  A name/code for the set
    "item" : [{ Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|
    DiagnosticReport|RiskAssessment|ImagingStudy|Media) }] // Record of a specific investigation
  }],
  "
  "
  "
    
    " },
    " },
    "

  "protocol" : ["<uri>"], // Clinical Protocol followed
  "summary" : "<string>", // Summary of the assessment
  "finding" : [{ // Possible or likely findings and diagnoses
    "itemCodeableConcept" : { CodeableConcept }, // What was found
    "itemReference" : { Reference(Condition|Observation|Media) }, // What was found
    "basis" : "<string>" // Which investigations support finding

  }],
  "
  "
  "|
   
  "

  "prognosisCodeableConcept" : [{ CodeableConcept }], // Estimate of likely outcome
  "prognosisReference" : [{ Reference(RiskAssessment) }], // RiskAssessment expressing likely outcome
  "action" : [{ Reference(ServiceRequest|Procedure|MedicationRequest|
   Appointment) }], // Action taken as part of assessment procedure

  "note" : [{ Annotation }] // Comments made about the ClinicalImpression

}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:ClinicalImpression;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:

  fhir:ClinicalImpression.identifier [ Identifier ], ... ; # 0..* Business identifier

  fhir:ClinicalImpression.status [ code ]; # 1..1 draft | completed | entered-in-error
  fhir:ClinicalImpression.code [ CodeableConcept ]; # 0..1 Kind of assessment performed
  fhir:ClinicalImpression.description [ string ]; # 0..1 Why/how the assessment was performed
  fhir:ClinicalImpression.subject [ Reference(Patient|Group) ]; # 1..1 Patient or group assessed
  fhir:ClinicalImpression.context [ Reference(Encounter|EpisodeOfCare) ]; # 0..1 Encounter or Episode created from
  # ClinicalImpression.effective[x] : 0..1 Time of assessment. One of these 2
    fhir:ClinicalImpression.effectiveDateTime [ dateTime ]
    fhir:ClinicalImpression.effectivePeriod [ Period ]
  fhir:ClinicalImpression.date [ dateTime ]; # 0..1 When the assessment was documented
  fhir:ClinicalImpression.assessor [ Reference(Practitioner) ]; # 0..1 The clinician performing the assessment
  fhir:

  fhir:ClinicalImpression.previous [ Reference(ClinicalImpression) ]; # 0..1 Reference to last assessment

  fhir:ClinicalImpression.problem [ Reference(Condition|AllergyIntolerance) ], ... ; # 0..* Relevant impressions of patient state
  fhir:
    fhir:

  fhir:ClinicalImpression.investigation [ # 0..* One or more sets of investigations (signs, symptoms, etc.)
    fhir:ClinicalImpression.investigation.code [ CodeableConcept ]; # 1..1 A name/code for the set

    fhir:ClinicalImpression.investigation.item [ Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|DiagnosticReport|
  

  RiskAssessment|ImagingStudy|Media) ], ... ; # 0..* Record of a specific investigation
  ], ...;
  fhir:ClinicalImpression.protocol [ uri ], ... ; # 0..* Clinical Protocol followed
  fhir:ClinicalImpression.summary [ string ]; # 0..1 Summary of the assessment
  fhir:ClinicalImpression.finding [ # 0..* Possible or likely findings and diagnoses
    # . One of these 2
      fhir: ]
      fhir:) ]

    fhir:ClinicalImpression.finding.itemCodeableConcept [ CodeableConcept ]; # 0..1 What was found
    fhir:ClinicalImpression.finding.itemReference [ Reference(Condition|Observation|Media) ]; # 0..1 What was found

    fhir:ClinicalImpression.finding.basis [ string ]; # 0..1 Which investigations support finding
  ], ...;
  fhir:ClinicalImpression.prognosisCodeableConcept [ CodeableConcept ], ... ; # 0..* Estimate of likely outcome
  fhir:ClinicalImpression.prognosisReference [ Reference(RiskAssessment) ], ... ; # 0..* RiskAssessment expressing likely outcome
  fhir:

  fhir:ClinicalImpression.action [ Reference(ServiceRequest|Procedure|MedicationRequest|Appointment) ], ... ; # 0..* Action taken as part of assessment procedure

  fhir:ClinicalImpression.note [ Annotation ], ... ; # 0..* Comments made about the ClinicalImpression
]

Changes since DSTU2 R3

ClinicalImpression.identifier Added Element ClinicalImpression.code
ClinicalImpression Added Element
ClinicalImpression.subject Renamed from patient to subject Add Reference(Group) ClinicalImpression.context Added Element ClinicalImpression.effective[x] Added Element ClinicalImpression.investigation Added Element ClinicalImpression.investigation.code Added Element ClinicalImpression.investigation.item
  • Added Element ClinicalImpression.protocol Max Cardinality Type changed from 1 to * ClinicalImpression.finding.item[x] Renamed from item Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|DiagnosticReport|RiskAssessment|ImagingStudy) to item[x] Add Reference(Condition), Add Reference(Observation) ClinicalImpression.finding.basis Added Element Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|DiagnosticReport|RiskAssessment|ImagingStudy|Media)
ClinicalImpression.prognosisCodeableConcept ClinicalImpression.finding.itemCodeableConcept
  • Added Element
ClinicalImpression.prognosisReference ClinicalImpression.finding.itemReference
  • Added Element
ClinicalImpression.action
  • Remove Reference(MedicationOrder), Remove Reference(DiagnosticOrder), Remove Reference(NutritionOrder), Remove Reference(SupplyRequest), Add Reference(MedicationRequest) ClinicalImpression.note Added Element ClinicalImpression.trigger[x] deleted ClinicalImpression.investigations deleted ClinicalImpression.finding.cause deleted ClinicalImpression.resolved deleted ClinicalImpression.ruledOut deleted ClinicalImpression.prognosis deleted Type changed from Reference(ReferralRequest|ProcedureRequest|Procedure|MedicationRequest|Appointment) to Reference(ServiceRequest|Procedure|MedicationRequest|Appointment)
ClinicalImpression.plan ClinicalImpression.finding.item[x]
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 Conversion Maps (status = 1 test that all execute ok. 1 fail round-trip testing and all r3 resources are valid.). Note: these have note yet been updated to be R3 to R4

Structure

Name Flags Card. Type Description & Constraints doco
. . ClinicalImpression D DomainResource A clinical assessment performed when planning treatments and management strategies for a patient
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier Business identifier
. . . status ?! Σ 1..1 code draft | completed | entered-in-error
ClinicalImpressionStatus ( Required )
. . . code Σ 0..1 CodeableConcept Kind of assessment performed
. . . description Σ 0..1 string Why/how the assessment was performed
. . . subject Σ 1..1 Reference ( Patient | Group ) Patient or group assessed
. . . context Σ 0..1 Reference ( Encounter | EpisodeOfCare ) Encounter or Episode created from
. . . effective[x] Σ 0..1 Time of assessment
. . . . effectiveDateTime dateTime
. . . . effectivePeriod Period
. . . date Σ 0..1 dateTime When the assessment was documented
. . . assessor Σ 0..1 Reference ( Practitioner ) The clinician performing the assessment
. . . previous 0..1 Reference ( ClinicalImpression ) Reference to last assessment
. . . problem Σ 0..* Reference ( Condition | AllergyIntolerance ) Relevant impressions of patient state
. . . investigation 0..* BackboneElement One or more sets of investigations (signs, symptions, symptoms, etc.)
. . . . code 1..1 CodeableConcept A name/code for the set
Investigation Type ( Example )
. . . . item 0..* Reference ( Observation | QuestionnaireResponse | FamilyMemberHistory | DiagnosticReport | RiskAssessment | ImagingStudy | Media ) Record of a specific investigation
. . . protocol 0..* uri Clinical Protocol followed
. . . summary 0..1 string Summary of the assessment
. . . finding 0..* BackboneElement Possible or likely findings and diagnoses
. . . item[x] . itemCodeableConcept 1..1 0..1 CodeableConcept What was found
Condition/Problem/Diagnosis Codes ( Example )
. . . itemCodeableConcept . itemReference CodeableConcept itemReference 0..1 Reference ( Condition | Observation | Media ) What was found
. . . . basis 0..1 string Which investigations support finding
. . . prognosisCodeableConcept 0..* CodeableConcept Estimate of likely outcome
Clinical Impression Prognosis ( Example )
. . . prognosisReference 0..* Reference ( RiskAssessment ) RiskAssessment expressing likely outcome
. . . action 0..* Reference ( ReferralRequest | ProcedureRequest ServiceRequest | Procedure | MedicationRequest | Appointment ) Action taken as part of assessment procedure
. . . note 0..* Annotation Comments made about the ClinicalImpression

doco Documentation for this format

UML Diagram ( Legend )

ClinicalImpression ( DomainResource ) A unique identifier Business identifiers assigned to the this clinical impression that remains consistent regardless of what server by the impression performer or other systems which remain constant as the resource is stored on updated and propagates from server to server identifier : Identifier [0..*] Identifies the workflow status of the assessment (this element modifies the meaning of other elements) status : code [1..1] « The workflow state of a clinical impression. (Strength=Required) ClinicalImpressionStatus ! » Categorizes the type of clinical assessment performed code : CodeableConcept [0..1] A summary of the context and/or cause of the assessment - why / where was it performed, and what patient events/status prompted it description : string [0..1] The patient or group of individuals assessed as part of this record subject : Reference [1..1] « Patient | Group » The encounter or episode of care this impression was created as part of context : Reference [0..1] « Encounter | EpisodeOfCare » The point in time or period over which the subject was assessed effective[x] : Type [0..1] « dateTime | Period » Indicates when the documentation of the assessment was complete date : dateTime [0..1] The clinician performing the assessment assessor : Reference [0..1] « Practitioner » A reference to the last assesment assessment that was conducted bon on this patient. Assessments are often/usually ongoing in nature; a care provider (practitioner or team) will make new assessments on an ongoing basis as new data arises or the patient's conditions changes previous : Reference [0..1] « ClinicalImpression » This a list of the relevant problems/conditions for a patient problem : Reference [0..*] « Condition | AllergyIntolerance » Reference to a specific published clinical protocol that was followed during this assessment, and/or that provides evidence in support of the diagnosis protocol : uri [0..*] A text summary of the investigations and the diagnosis summary : string [0..1] Estimate of likely outcome prognosisCodeableConcept : CodeableConcept [0..*] « Prognosis or outlook findings (Strength=Example) Clinical Impression Prognosis ?? » RiskAssessment expressing likely outcome prognosisReference : Reference [0..*] « RiskAssessment » Action taken as part of assessment procedure action : Reference [0..*] ReferralRequest « ServiceRequest | ProcedureRequest Procedure | Procedure | MedicationRequest | Appointment » Commentary about the impression, typically recorded after the impression itself was made, though supplemental notes by the original author could also appear note : Annotation [0..*] Investigation A name/code for the group ("set") ("set") of investigations. Typically, this will be something like "signs", "symptoms", "clinical", "diagnostic", "signs", "symptoms", "clinical", "diagnostic", but the list is not constrained, and others such groups such as (exposure|family|travel|nutitirional) (exposure|family|travel|nutritional) history may be used code : CodeableConcept [1..1] « A name/code for a set of investigations. (Strength=Example) Investigation Type ?? » A record of a specific investigation that was undertaken item : Reference [0..*] « Observation | QuestionnaireResponse | FamilyMemberHistory | DiagnosticReport | RiskAssessment | ImagingStudy | Media » Finding Specific text, code text or reference code for finding or diagnosis, which may include ruled-out or resolved conditions item[x] itemCodeableConcept : Type [1..1] CodeableConcept | Reference ( Condition | Observation ); [0..1] « Identification of the Condition or diagnosis. (Strength=Example) Condition/Problem/Diagnosis ?? » Specific reference for finding or diagnosis, which may include ruled-out or resolved conditions itemReference : Reference [0..1] « Condition | Observation | Media » Which investigations support finding or diagnosis basis : string [0..1] One or more sets of investigations (signs, symptions, symptoms, etc.). The actual grouping of investigations vary varies greatly depending on the type and context of the assessment. These investigations may include data generated during the assessment process, or data previously generated and recorded that is pertinent to the outcomes investigation [0..*] Specific findings or diagnoses that was considered likely or relevant to ongoing treatment finding [0..*]

XML Template 

<

<ClinicalImpression xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</identifier>
 <

 <identifier><!-- 0..* Identifier Business identifier --></identifier>
 <status value="[code]"/><!-- 1..1 draft | completed | entered-in-error -->

 <code><!-- 0..1 CodeableConcept Kind of assessment performed --></code>
 <

 <description value="[string]"/><!-- 0..1 Why/how the assessment was performed -->

 <subject><!-- 1..1 Reference(Patient|Group) Patient or group assessed --></subject>
 <context><!-- 0..1 Reference(Encounter|EpisodeOfCare) Encounter or Episode created from --></context>
 <effective[x]><!-- 0..1 dateTime|Period Time of assessment --></effective[x]>
 <

 <date value="[dateTime]"/><!-- 0..1 When the assessment was documented -->

 <assessor><!-- 0..1 Reference(Practitioner) The clinician performing the assessment --></assessor>
 <</previous>

 <previous><!-- 0..1 Reference(ClinicalImpression) Reference to last assessment --></previous>

 <problem><!-- 0..* Reference(Condition|AllergyIntolerance) Relevant impressions of patient state --></problem>
 <
  <</code>

 <investigation>  <!-- 0..* One or more sets of investigations (signs, symptoms, etc.) -->
  <code><!-- 1..1 CodeableConcept A name/code for the set --></code>

  <item><!-- 0..* Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|
    </item>

    DiagnosticReport|RiskAssessment|ImagingStudy|Media) Record of a specific investigation --></item>
 </investigation>
 <
 <

 <protocol value="[uri]"/><!-- 0..* Clinical Protocol followed -->
 <summary value="[string]"/><!-- 0..1 Summary of the assessment -->

 <finding>  <!-- 0..* Possible or likely findings and diagnoses -->
  <</item[x]>
  <

  <itemCodeableConcept><!-- 0..1 CodeableConcept What was found --></itemCodeableConcept>
  <itemReference><!-- 0..1 Reference(Condition|Observation|Media) What was found --></itemReference>
  <basis value="[string]"/><!-- 0..1 Which investigations support finding -->

 </finding>
 <prognosisCodeableConcept><!-- 0..* CodeableConcept Estimate of likely outcome --></prognosisCodeableConcept>
 <prognosisReference><!-- 0..* Reference(RiskAssessment) RiskAssessment expressing likely outcome --></prognosisReference>
 <|
   </action>

 <action><!-- 0..* Reference(ServiceRequest|Procedure|MedicationRequest|
   Appointment) Action taken as part of assessment procedure --></action>
 <note><!-- 0..* Annotation Comments made about the ClinicalImpression --></note>
</ClinicalImpression>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "ClinicalImpression",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "
  "

  "identifier" : [{ Identifier }], // Business identifier
  "status" : "<code>", // R!  draft | completed | entered-in-error
  "code" : { CodeableConcept }, // Kind of assessment performed
  "description" : "<string>", // Why/how the assessment was performed
  "subject" : { Reference(Patient|Group) }, // R!  Patient or group assessed
  "context" : { Reference(Encounter|EpisodeOfCare) }, // Encounter or Episode created from

  // effective[x]: Time of assessment. One of these 2:
  ">",
  " },
  "
  "
  "
  "
  "
    "
    "|
    

  "effectiveDateTime" : "<dateTime>",
  "effectivePeriod" : { Period },
  "date" : "<dateTime>", // When the assessment was documented
  "assessor" : { Reference(Practitioner) }, // The clinician performing the assessment
  "previous" : { Reference(ClinicalImpression) }, // Reference to last assessment
  "problem" : [{ Reference(Condition|AllergyIntolerance) }], // Relevant impressions of patient state
  "investigation" : [{ // One or more sets of investigations (signs, symptoms, etc.)
    "code" : { CodeableConcept }, // R!  A name/code for the set
    "item" : [{ Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|
    DiagnosticReport|RiskAssessment|ImagingStudy|Media) }] // Record of a specific investigation
  }],
  "
  "
  "
    
    " },
    " },
    "

  "protocol" : ["<uri>"], // Clinical Protocol followed
  "summary" : "<string>", // Summary of the assessment
  "finding" : [{ // Possible or likely findings and diagnoses
    "itemCodeableConcept" : { CodeableConcept }, // What was found
    "itemReference" : { Reference(Condition|Observation|Media) }, // What was found
    "basis" : "<string>" // Which investigations support finding

  }],
  "
  "
  "|
   
  "

  "prognosisCodeableConcept" : [{ CodeableConcept }], // Estimate of likely outcome
  "prognosisReference" : [{ Reference(RiskAssessment) }], // RiskAssessment expressing likely outcome
  "action" : [{ Reference(ServiceRequest|Procedure|MedicationRequest|
   Appointment) }], // Action taken as part of assessment procedure

  "note" : [{ Annotation }] // Comments made about the ClinicalImpression

}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:ClinicalImpression;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:

  fhir:ClinicalImpression.identifier [ Identifier ], ... ; # 0..* Business identifier

  fhir:ClinicalImpression.status [ code ]; # 1..1 draft | completed | entered-in-error
  fhir:ClinicalImpression.code [ CodeableConcept ]; # 0..1 Kind of assessment performed
  fhir:ClinicalImpression.description [ string ]; # 0..1 Why/how the assessment was performed
  fhir:ClinicalImpression.subject [ Reference(Patient|Group) ]; # 1..1 Patient or group assessed
  fhir:ClinicalImpression.context [ Reference(Encounter|EpisodeOfCare) ]; # 0..1 Encounter or Episode created from
  # ClinicalImpression.effective[x] : 0..1 Time of assessment. One of these 2
    fhir:ClinicalImpression.effectiveDateTime [ dateTime ]
    fhir:ClinicalImpression.effectivePeriod [ Period ]
  fhir:ClinicalImpression.date [ dateTime ]; # 0..1 When the assessment was documented
  fhir:ClinicalImpression.assessor [ Reference(Practitioner) ]; # 0..1 The clinician performing the assessment
  fhir:

  fhir:ClinicalImpression.previous [ Reference(ClinicalImpression) ]; # 0..1 Reference to last assessment

  fhir:ClinicalImpression.problem [ Reference(Condition|AllergyIntolerance) ], ... ; # 0..* Relevant impressions of patient state
  fhir:
    fhir:

  fhir:ClinicalImpression.investigation [ # 0..* One or more sets of investigations (signs, symptoms, etc.)
    fhir:ClinicalImpression.investigation.code [ CodeableConcept ]; # 1..1 A name/code for the set

    fhir:ClinicalImpression.investigation.item [ Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|DiagnosticReport|
  

  RiskAssessment|ImagingStudy|Media) ], ... ; # 0..* Record of a specific investigation
  ], ...;
  fhir:ClinicalImpression.protocol [ uri ], ... ; # 0..* Clinical Protocol followed
  fhir:ClinicalImpression.summary [ string ]; # 0..1 Summary of the assessment
  fhir:ClinicalImpression.finding [ # 0..* Possible or likely findings and diagnoses
    # . One of these 2
      fhir: ]
      fhir:) ]

    fhir:ClinicalImpression.finding.itemCodeableConcept [ CodeableConcept ]; # 0..1 What was found
    fhir:ClinicalImpression.finding.itemReference [ Reference(Condition|Observation|Media) ]; # 0..1 What was found

    fhir:ClinicalImpression.finding.basis [ string ]; # 0..1 Which investigations support finding
  ], ...;
  fhir:ClinicalImpression.prognosisCodeableConcept [ CodeableConcept ], ... ; # 0..* Estimate of likely outcome
  fhir:ClinicalImpression.prognosisReference [ Reference(RiskAssessment) ], ... ; # 0..* RiskAssessment expressing likely outcome
  fhir:

  fhir:ClinicalImpression.action [ Reference(ServiceRequest|Procedure|MedicationRequest|Appointment) ], ... ; # 0..* Action taken as part of assessment procedure

  fhir:ClinicalImpression.note [ Annotation ], ... ; # 0..* Comments made about the ClinicalImpression
]

Changes since DSTU2

ClinicalImpression.identifier Added Element ClinicalImpression.code
ClinicalImpression Added Element
ClinicalImpression.subject Renamed from patient to subject Add Reference(Group) ClinicalImpression.context Added Element ClinicalImpression.effective[x] Added Element ClinicalImpression.investigation Added Element ClinicalImpression.investigation.code Added Element ClinicalImpression.investigation.item
  • Added Element ClinicalImpression.protocol Max Cardinality Type changed from 1 to * ClinicalImpression.finding.item[x] Renamed from item Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|DiagnosticReport|RiskAssessment|ImagingStudy) to item[x] Add Reference(Condition), Add Reference(Observation) ClinicalImpression.finding.basis Added Element Reference(Observation|QuestionnaireResponse|FamilyMemberHistory|DiagnosticReport|RiskAssessment|ImagingStudy|Media)
ClinicalImpression.prognosisCodeableConcept ClinicalImpression.finding.itemCodeableConcept
  • Added Element
ClinicalImpression.prognosisReference ClinicalImpression.finding.itemReference
  • Added Element
ClinicalImpression.action
  • Remove Reference(MedicationOrder), Remove Reference(DiagnosticOrder), Remove Reference(NutritionOrder), Remove Reference(SupplyRequest), Add Reference(MedicationRequest) ClinicalImpression.note Added Element ClinicalImpression.trigger[x] deleted ClinicalImpression.investigations deleted ClinicalImpression.finding.cause deleted ClinicalImpression.resolved deleted ClinicalImpression.ruledOut deleted ClinicalImpression.prognosis deleted Type changed from Reference(ReferralRequest|ProcedureRequest|Procedure|MedicationRequest|Appointment) to Reference(ServiceRequest|Procedure|MedicationRequest|Appointment)
ClinicalImpression.plan ClinicalImpression.finding.item[x]
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 Conversion Maps (status = 1 test that all execute ok. 1 fail round-trip testing and all r3 resources are valid.). Note: these have note yet been updated to be R3 to R4

 

Alternate definitions: Master Definition ( XML , + JSON ), , XML Schema / Schematron (for ) + JSON Schema , ShEx (for Turtle ) + see the extensions & the dependency analysis

9.8.4.1 Terminology Bindings

Path Definition Type Reference
ClinicalImpression.status The workflow state of a clinical impression. Required ClinicalImpressionStatus
ClinicalImpression.code Identifies categories of clinical impressions. This is a place-holder only. It may be removed Unknown No details provided yet
ClinicalImpression.investigation.code A name/code for a set of investigations. Example Investigation Type
ClinicalImpression.finding.item[x] ClinicalImpression.finding.itemCodeableConcept Identification of the Condition or diagnosis. Example Condition/Problem/Diagnosis Codes
ClinicalImpression.prognosisCodeableConcept Prognosis or outlook findings Example Clinical Impression Prognosis

9.8.4.2 Known Issue

A known issue exists with circular references between Condition and ClinicalImpression, which is due to the low maturity level of ClinicalImpression. The Patient Care work group intends to address this issue when ClinicalImpression is considered substantially complete and ready for implementation.

9.8.5 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Expression In Common
action reference Action taken as part of assessment procedure ClinicalImpression.action
( Appointment , ReferralRequest , MedicationRequest , ProcedureRequest , Procedure , ServiceRequest )
assessor reference The clinician performing the assessment ClinicalImpression.assessor
( Practitioner )
context reference Encounter or Episode created from ClinicalImpression.context
( EpisodeOfCare , Encounter )
date date When the assessment was documented ClinicalImpression.date 18 17 Resources
finding-code token What was found ClinicalImpression.finding.item.as(CodeableConcept) ClinicalImpression.finding.itemCodeableConcept
finding-ref reference What was found ClinicalImpression.finding.item.as(Reference) ClinicalImpression.finding.itemReference
( Condition , Observation , Media )
identifier token Business identifier ClinicalImpression.identifier
investigation reference Record of a specific investigation ClinicalImpression.investigation.item
( RiskAssessment , FamilyMemberHistory , Observation , Media , DiagnosticReport , ImagingStudy , QuestionnaireResponse )
patient reference Patient or group assessed ClinicalImpression.subject
( Patient ) 		31 29 Resources
previous reference Reference to last assessment ClinicalImpression.previous
( ClinicalImpression )
problem reference Relevant impressions of patient state ClinicalImpression.problem
( Condition , AllergyIntolerance )
status token draft | completed | entered-in-error ClinicalImpression.status
subject reference Patient or group assessed ClinicalImpression.subject
( Group , Patient )