R6 Ballot (3rd Draft) (1st Full Ballot)

This page is part of the FHIR Specification v6.0.0-ballot3: v6.0.0-ballot4: Release 6 Ballot (3rd Draft) (1st Full Ballot) (see Ballot Notes ). The current version is 5.0.0 . For a full list of available versions, see the Directory of published versions for published versions icon

9.11 9.10 Resource RiskAssessment - Content

Responsible Owner: Clinical Decision Support icon Work Group Maturity Level : 2   Trial Use Normative Security Category : Patient Compartments : Device , Group , Patient , Practitioner

An assessment of the likely outcome(s) for a patient or other subject as well as the likelihood of each outcome.

9.11.1 9.10.1 Scope and Usage

This resource is an event resource from a FHIR workflow perspective - see Workflow , specifically Event .

This resource captures predicted outcomes for a patient or population on the basis of source information. Examples include:

  • A prognosis statement for a particular condition
  • Risk of health outcome (heart attack, particular type of cancer) on the basis of lifestyle factors and/or family history
  • List of potential health risks based on a patient's genetic analysis
  • A prediction of outbreak infection rates within a geography based on immunization rates

This resource can be used to represent the results of formal scoring/decision support tools that evaluate risk. It can also be used to capture a practitioner's subjective assessment of the patient's risk based on existing knowledge and previous experience.

9.11.2 9.10.2 Boundaries and Relationships

Risk assessments are a specialized type of observation. A specialized resource is used to provide a simpler mechanism to capture of a series of risks and to associate those risks with time-ranges, probabilities, etc. All risk assertions are captured at one time based on a single set of source inputs. Capture of a single risk MAY be done using the Observation class, particularly in circumstances where it's treated as a generic observation, but for consistency, all risk assessments and prognosis SHOULD be captured using RiskAssessment .

Risk assessments may be based on a variety of factors, including:

Because so many resources can potentially be used, no limit is placed on what resources can be sent in RiskAssessment.basis . However, some resources would be nonsensical for this use (e.g. MessageHeader ).

AllergyIntolerance and RiskAssessment

AllergyIntolerance describes a specific type of risk - propensity to reaction to a substance while RiskAssessment describes general risks to a subject, not generally based on a reaction.

9.11.3 9.10.3 Background and Context

Risk Assessments can be determined manually by health-care providers based on their professional expertise, by using an algorithmic scoring system or through a combination. Risk assessments can also be computed by decision support systems. OperationDefinitions may be defined by servers to generate risk assessments based on particular combinations of source resources or other inputs.

9.11.4 9.10.4 References to this Resource

9.11.5 9.10.5 Resource Content

Structure

Name Flags Card. Type Description & Constraints      Filter: Filters doco
. . RiskAssessment TU N DomainResource Potential outcomes for a subject with likelihood

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier Unique identifier for the assessment

. . . basedOn 0..1 Reference ( Any ) Request fulfilled by this assessment
. . . parent 0..1 Reference ( Any ) Part of this occurrence
. . . method Σ 0..1 CodeableConcept Evaluation mechanism
Binding: Risk Assessment Method ( Example )
. . . code Σ 0..1 CodeableConcept Type of assessment
Binding: Risk Assessment Method ( Example )
. . . subject Σ 1..1 Reference ( Patient | Group ) Who/what does assessment apply to?
. . . encounter Σ 0..1 Reference ( Encounter ) Where was assessment performed?
. . . occurrence[x] Σ 0..1 When was assessment made?
. . . . occurrenceDateTime dateTime
. . . . occurrencePeriod Period
. . . condition Σ 0..1 Reference ( Condition ) Condition assessed
. . . performer Σ 0..1 Reference ( Patient | Practitioner | PractitionerRole | RelatedPerson | Device ) Who did assessment?
. . . reason 0..* CodeableReference ( Condition | Observation | DiagnosticReport | DocumentReference ) Why was the assessment necessary?

. . . basis 0..* Reference ( Any ) Information used in assessment

. . . prediction C 0..* BackboneElement Outcome predicted
+ Rule: Probability as a deciml decimal must be <= 100
+ Rule: Probability as a Quantity must be <= 100%

. . . . outcome 0..1 CodeableConcept Possible outcome for the subject
Binding: Risk Assessment Outcome ( Example )
. . . . probability[x] C 0..1 Likelihood of specified outcome
+ Rule: low and high must be percentages, if present
. . . . . probabilityDecimal decimal
. . . . . probabilityQuantity Quantity
..... probabilityRange Range
. . . . qualitativeRisk 0..1 CodeableConcept Likelihood of specified outcome as a qualitative value
Binding: Risk Probability ( Example )
. . . . relativeRisk 0..1 decimal Relative likelihood
. . . . when[x] 0..1 Timeframe or age range
. . . . . whenPeriod Period
. . . . . whenRange Range
. . . . rationale 0..1 string Explanation of prediction
. . . mitigation 0..1 string How to reduce risk
. . . note 0..* Annotation Comments on the risk assessment


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

RiskAssessment ( DomainResource ) Business identifier assigned to the risk assessment identifier : Identifier [0..*] A reference to the request that is fulfilled by this risk assessment basedOn : Reference [0..1] « Any » A reference to a resource that this risk assessment is part of, such as a Procedure parent : Reference [0..1] « Any » The status of the RiskAssessment, using the same statuses as an Observation status : code [1..1] « null (Strength=Required) ObservationStatus ! » The algorithm, process or mechanism used to evaluate the risk method : CodeableConcept [0..1] « null (Strength=Example) RiskAssessmentMethod ?? » The type of the risk assessment performed code : CodeableConcept [0..1] « null (Strength=Example) RiskAssessmentMethod ?? » The patient or group the risk assessment applies to subject : Reference [1..1] « Patient | Group » The encounter where the assessment was performed encounter : Reference [0..1] « Encounter » The date (and possibly time) the risk assessment was performed occurrence[x] : DataType [0..1] « dateTime | Period » For assessments or prognosis specific to a particular condition, indicates the condition being assessed condition : Reference [0..1] « Condition » The provider, patient, related person, or software application that performed the assessment performer : Reference [0..1] « Patient | Practitioner | PractitionerRole | RelatedPerson | Device » The reason the risk assessment was performed reason : CodeableReference [0..*] « Condition | Observation | DiagnosticReport | DocumentReference » Indicates the source data considered as part of the assessment (for example, FamilyHistory, Observations, Procedures, Conditions, etc.) basis : Reference [0..*] « Any » A description of the steps that might be taken to reduce the identified risk(s) mitigation : string [0..1] Additional comments about the risk assessment note : Annotation [0..*] Prediction One of the potential outcomes for the patient (e.g. remission, death, a particular condition) outcome : CodeableConcept [0..1] « null (Strength=Example) RiskAssessmentOutcome ?? » Indicates how likely the outcome is (in the specified timeframe) timeframe). Range SHOULD be expressed as a Quantity (with a unit of '%'), rather than as a decimal value to make sure the percentage semantics are clear probability[x] : DataType [0..1] « decimal | Quantity | Range » « This element has or is affected by some invariants C » Indicates how likely the outcome is (in the specified timeframe), expressed as a qualitative value (e.g. low, medium, or high) qualitativeRisk : CodeableConcept [0..1] « null (Strength=Example) RiskProbability ?? » Indicates the risk for this particular subject (with their specific characteristics) divided by the risk of the population in general. (Numbers greater than 1 = higher risk than the population, numbers less than 1 = lower risk.) relativeRisk : decimal [0..1] Indicates the period of time or age range of the subject to which the specified probability applies when[x] : DataType [0..1] « Period | Range » Additional information explaining the basis for the prediction rationale : string [0..1] Describes the expected outcome for the subject prediction [0..*]

XML Template 

<RiskAssessment xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Unique identifier for the assessment --></identifier>
 <basedOn><!-- 0..1 Reference(Any) Request fulfilled by this assessment --></basedOn>
 <parent><!-- 0..1 Reference(Any) Part of this occurrence --></parent>
 <status value="[code]"/><!-- 1..1 registered | specimen-in-process | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | unknown | cannot-be-obtained -->
 <method><!-- 0..1 CodeableConcept Evaluation mechanism --></method>
 <code><!-- 0..1 CodeableConcept Type of assessment --></code>
 <subject><!-- 1..1 Reference(Group|Patient) Who/what does assessment apply to? --></subject>
 <encounter><!-- 0..1 Reference(Encounter) Where was assessment performed? --></encounter>
 <occurrence[x]><!-- 0..1 dateTime|Period When was assessment made? --></occurrence[x]>
 <condition><!-- 0..1 Reference(Condition) Condition assessed --></condition>
 <performer><!-- 0..1 Reference(Device|Patient|Practitioner|PractitionerRole|
   RelatedPerson) Who did assessment? --></performer>
 <reason><!-- 0..* CodeableReference(Condition|DiagnosticReport|DocumentReference|
   Observation) Why was the assessment necessary? --></reason>
 <basis><!-- 0..* Reference(Any) Information used in assessment --></basis>
 <prediction>  <!-- 0..* Outcome predicted -->
  <outcome><!-- 0..1 CodeableConcept Possible outcome for the subject --></outcome>
  <</probability[x]>

  <probability[x]><!-- I 0..1 decimal|Quantity|Range Likelihood of specified outcome --></probability[x]>

  <qualitativeRisk><!-- 0..1 CodeableConcept Likelihood of specified outcome as a qualitative value --></qualitativeRisk>
  <relativeRisk value="[decimal]"/><!-- 0..1 Relative likelihood -->
  <when[x]><!-- 0..1 Period|Range Timeframe or age range --></when[x]>
  <rationale value="[string]"/><!-- 0..1 Explanation of prediction -->
 </prediction>
 <mitigation value="[string]"/><!-- 0..1 How to reduce risk -->
 <note><!-- 0..* Annotation Comments on the risk assessment --></note>
</RiskAssessment>

JSON Template 

{doco
  "resourceType" : "RiskAssessment",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Unique identifier for the assessment
  "basedOn" : { Reference(Any) }, // Request fulfilled by this assessment
  "parent" : { Reference(Any) }, // Part of this occurrence
  "status" : "<code>", // R!  registered | specimen-in-process | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | unknown | cannot-be-obtained
  "method" : { CodeableConcept }, // Evaluation mechanism
  "code" : { CodeableConcept }, // Type of assessment
  "subject" : { Reference(Group|Patient) }, // R!  Who/what does assessment apply to?
  "encounter" : { Reference(Encounter) }, // Where was assessment performed?
  // occurrence[x]: When was assessment made?. One of these 2:
  "occurrenceDateTime" : "<dateTime>",
  "occurrencePeriod" : { Period },
  "condition" : { Reference(Condition) }, // Condition assessed
  "performer" : { Reference(Device|Patient|Practitioner|PractitionerRole|
   RelatedPerson) }, // Who did assessment?
  "reason" : [{ CodeableReference(Condition|DiagnosticReport|DocumentReference|
   Observation) }], // Why was the assessment necessary?
  "basis" : [{ Reference(Any) }], // Information used in assessment
  "prediction" : [{ // Outcome predicted
    "outcome" : { CodeableConcept }, // Possible outcome for the subject
    
    ">,
    " },

    // probability[x]: Likelihood of specified outcome. One of these 3:
    "probabilityDecimal" : <decimal>,
    "probabilityQuantity" : { Quantity },
    "probabilityRange" : { Range },

    "qualitativeRisk" : { CodeableConcept }, // Likelihood of specified outcome as a qualitative value
    "relativeRisk" : <decimal>, // Relative likelihood
    // when[x]: Timeframe or age range. One of these 2:
    "whenPeriod" : { Period },
    "whenRange" : { Range },
    "rationale" : "<string>" // Explanation of prediction
  }],
  "mitigation" : "<string>", // How to reduce risk
  "note" : [{ Annotation }] // Comments on the risk assessment
}

Turtle Template 

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


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

  # from 
  # from 

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

  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Unique identifier for the assessment
  fhir:basedOn [ Reference(Any) ] ; # 0..1 Request fulfilled by this assessment
  fhir:parent [ Reference(Any) ] ; # 0..1 Part of this occurrence
  fhir:status [ code ] ; # 1..1 registered | specimen-in-process | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | unknown | cannot-be-obtained
  fhir:method [ CodeableConcept ] ; # 0..1 Evaluation mechanism
  fhir:code [ CodeableConcept ] ; # 0..1 Type of assessment
  fhir:subject [ Reference(Group|Patient) ] ; # 1..1 Who/what does assessment apply to?
  fhir:encounter [ Reference(Encounter) ] ; # 0..1 Where was assessment performed?
  # occurrence[x] : 0..1 When was assessment made?. One of these 2
    fhir: ]

    fhir:occurrence [  a fhir:DateTime ; dateTime ]

    fhir:occurrence [  a fhir:Period ; Period ]
  fhir:condition [ Reference(Condition) ] ; # 0..1 Condition assessed
  fhir:performer [ Reference(Device|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who did assessment?
  fhir:reason  ( [ CodeableReference(Condition|DiagnosticReport|DocumentReference|Observation) ] ... ) ; # 0..* Why was the assessment necessary?
  fhir:basis  ( [ Reference(Any) ] ... ) ; # 0..* Information used in assessment
  fhir:prediction ( [ # 0..* Outcome predicted
    fhir:outcome [ CodeableConcept ] ; # 0..1 Possible outcome for the subject
    # . One of these 2
      fhir: ]
      fhir: ]

    # probability[x] : 0..1 I Likelihood of specified outcome. One of these 3
      fhir:probability [  a fhir:Decimal ; decimal ]
      fhir:probability [  a fhir:Quantity ; Quantity ]
      fhir:probability [  a fhir:Range ; Range ]

    fhir:qualitativeRisk [ CodeableConcept ] ; # 0..1 Likelihood of specified outcome as a qualitative value
    fhir:relativeRisk [ decimal ] ; # 0..1 Relative likelihood
    # when[x] : 0..1 Timeframe or age range. One of these 2
      fhir:when [  a fhir:Period ; Period ]
      fhir:when [  a fhir:Range ; Range ]
    fhir:rationale [ string ] ; # 0..1 Explanation of prediction
  ] ... ) ;
  fhir:mitigation [ string ] ; # 0..1 How to reduce risk
  fhir:note  ( [ Annotation ] ... ) ; # 0..* Comments on the risk assessment
]

Changes from both R5 to R6

RiskAssessment
RiskAssessment.status
  • Remove code corrected
  • Add codes specimen-in-process , cannot-be-obtained
RiskAssessment.prediction.probability[x]
  • Add Type Quantity

Changes from R4 and R4B to R6

RiskAssessment
RiskAssessment.status
  • Remove code corrected
  • Add codes specimen-in-process , appended , cannot-be-obtained
RiskAssessment.performer
  • Type Reference: Added Target Types Patient, RelatedPerson
RiskAssessment.reason
  • Added Element
  • Merged both reasonCode and reasonReference into reason
RiskAssessment.prediction.probability[x]
  • Add Type Quantity
RiskAssessment.reasonCode
  • Deleted (-> reason) reason.concept)
RiskAssessment.reasonReference
  • Deleted (-> reason) reason.reference)

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

Structure

Name Flags Card. Type Description & Constraints      Filter: Filters doco
. . RiskAssessment TU N DomainResource Potential outcomes for a subject with likelihood

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier Unique identifier for the assessment

. . . basedOn 0..1 Reference ( Any ) Request fulfilled by this assessment
. . . parent 0..1 Reference ( Any ) Part of this occurrence
. . . method Σ 0..1 CodeableConcept Evaluation mechanism
Binding: Risk Assessment Method ( Example )
. . . code Σ 0..1 CodeableConcept Type of assessment
Binding: Risk Assessment Method ( Example )
. . . subject Σ 1..1 Reference ( Patient | Group ) Who/what does assessment apply to?
. . . encounter Σ 0..1 Reference ( Encounter ) Where was assessment performed?
. . . occurrence[x] Σ 0..1 When was assessment made?
. . . . occurrenceDateTime dateTime
. . . . occurrencePeriod Period
. . . condition Σ 0..1 Reference ( Condition ) Condition assessed
. . . performer Σ 0..1 Reference ( Patient | Practitioner | PractitionerRole | RelatedPerson | Device ) Who did assessment?
. . . reason 0..* CodeableReference ( Condition | Observation | DiagnosticReport | DocumentReference ) Why was the assessment necessary?

. . . basis 0..* Reference ( Any ) Information used in assessment

. . . prediction C 0..* BackboneElement Outcome predicted
+ Rule: Probability as a deciml decimal must be <= 100
+ Rule: Probability as a Quantity must be <= 100%

. . . . outcome 0..1 CodeableConcept Possible outcome for the subject
Binding: Risk Assessment Outcome ( Example )
. . . . probability[x] C 0..1 Likelihood of specified outcome
+ Rule: low and high must be percentages, if present
. . . . . probabilityDecimal decimal
. . . . . probabilityQuantity Quantity
..... probabilityRange Range
. . . . qualitativeRisk 0..1 CodeableConcept Likelihood of specified outcome as a qualitative value
Binding: Risk Probability ( Example )
. . . . relativeRisk 0..1 decimal Relative likelihood
. . . . when[x] 0..1 Timeframe or age range
. . . . . whenPeriod Period
. . . . . whenRange Range
. . . . rationale 0..1 string Explanation of prediction
. . . mitigation 0..1 string How to reduce risk
. . . note 0..* Annotation Comments on the risk assessment


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

RiskAssessment ( DomainResource ) Business identifier assigned to the risk assessment identifier : Identifier [0..*] A reference to the request that is fulfilled by this risk assessment basedOn : Reference [0..1] « Any » A reference to a resource that this risk assessment is part of, such as a Procedure parent : Reference [0..1] « Any » The status of the RiskAssessment, using the same statuses as an Observation status : code [1..1] « null (Strength=Required) ObservationStatus ! » The algorithm, process or mechanism used to evaluate the risk method : CodeableConcept [0..1] « null (Strength=Example) RiskAssessmentMethod ?? » The type of the risk assessment performed code : CodeableConcept [0..1] « null (Strength=Example) RiskAssessmentMethod ?? » The patient or group the risk assessment applies to subject : Reference [1..1] « Patient | Group » The encounter where the assessment was performed encounter : Reference [0..1] « Encounter » The date (and possibly time) the risk assessment was performed occurrence[x] : DataType [0..1] « dateTime | Period » For assessments or prognosis specific to a particular condition, indicates the condition being assessed condition : Reference [0..1] « Condition » The provider, patient, related person, or software application that performed the assessment performer : Reference [0..1] « Patient | Practitioner | PractitionerRole | RelatedPerson | Device » The reason the risk assessment was performed reason : CodeableReference [0..*] « Condition | Observation | DiagnosticReport | DocumentReference » Indicates the source data considered as part of the assessment (for example, FamilyHistory, Observations, Procedures, Conditions, etc.) basis : Reference [0..*] « Any » A description of the steps that might be taken to reduce the identified risk(s) mitigation : string [0..1] Additional comments about the risk assessment note : Annotation [0..*] Prediction One of the potential outcomes for the patient (e.g. remission, death, a particular condition) outcome : CodeableConcept [0..1] « null (Strength=Example) RiskAssessmentOutcome ?? » Indicates how likely the outcome is (in the specified timeframe) timeframe). Range SHOULD be expressed as a Quantity (with a unit of '%'), rather than as a decimal value to make sure the percentage semantics are clear probability[x] : DataType [0..1] « decimal | Quantity | Range » « This element has or is affected by some invariants C » Indicates how likely the outcome is (in the specified timeframe), expressed as a qualitative value (e.g. low, medium, or high) qualitativeRisk : CodeableConcept [0..1] « null (Strength=Example) RiskProbability ?? » Indicates the risk for this particular subject (with their specific characteristics) divided by the risk of the population in general. (Numbers greater than 1 = higher risk than the population, numbers less than 1 = lower risk.) relativeRisk : decimal [0..1] Indicates the period of time or age range of the subject to which the specified probability applies when[x] : DataType [0..1] « Period | Range » Additional information explaining the basis for the prediction rationale : string [0..1] Describes the expected outcome for the subject prediction [0..*]

XML Template 

<RiskAssessment xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Unique identifier for the assessment --></identifier>
 <basedOn><!-- 0..1 Reference(Any) Request fulfilled by this assessment --></basedOn>
 <parent><!-- 0..1 Reference(Any) Part of this occurrence --></parent>
 <status value="[code]"/><!-- 1..1 registered | specimen-in-process | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | unknown | cannot-be-obtained -->
 <method><!-- 0..1 CodeableConcept Evaluation mechanism --></method>
 <code><!-- 0..1 CodeableConcept Type of assessment --></code>
 <subject><!-- 1..1 Reference(Group|Patient) Who/what does assessment apply to? --></subject>
 <encounter><!-- 0..1 Reference(Encounter) Where was assessment performed? --></encounter>
 <occurrence[x]><!-- 0..1 dateTime|Period When was assessment made? --></occurrence[x]>
 <condition><!-- 0..1 Reference(Condition) Condition assessed --></condition>
 <performer><!-- 0..1 Reference(Device|Patient|Practitioner|PractitionerRole|
   RelatedPerson) Who did assessment? --></performer>
 <reason><!-- 0..* CodeableReference(Condition|DiagnosticReport|DocumentReference|
   Observation) Why was the assessment necessary? --></reason>
 <basis><!-- 0..* Reference(Any) Information used in assessment --></basis>
 <prediction>  <!-- 0..* Outcome predicted -->
  <outcome><!-- 0..1 CodeableConcept Possible outcome for the subject --></outcome>
  <</probability[x]>

  <probability[x]><!-- I 0..1 decimal|Quantity|Range Likelihood of specified outcome --></probability[x]>

  <qualitativeRisk><!-- 0..1 CodeableConcept Likelihood of specified outcome as a qualitative value --></qualitativeRisk>
  <relativeRisk value="[decimal]"/><!-- 0..1 Relative likelihood -->
  <when[x]><!-- 0..1 Period|Range Timeframe or age range --></when[x]>
  <rationale value="[string]"/><!-- 0..1 Explanation of prediction -->
 </prediction>
 <mitigation value="[string]"/><!-- 0..1 How to reduce risk -->
 <note><!-- 0..* Annotation Comments on the risk assessment --></note>
</RiskAssessment>

JSON Template 

{doco
  "resourceType" : "RiskAssessment",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Unique identifier for the assessment
  "basedOn" : { Reference(Any) }, // Request fulfilled by this assessment
  "parent" : { Reference(Any) }, // Part of this occurrence
  "status" : "<code>", // R!  registered | specimen-in-process | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | unknown | cannot-be-obtained
  "method" : { CodeableConcept }, // Evaluation mechanism
  "code" : { CodeableConcept }, // Type of assessment
  "subject" : { Reference(Group|Patient) }, // R!  Who/what does assessment apply to?
  "encounter" : { Reference(Encounter) }, // Where was assessment performed?
  // occurrence[x]: When was assessment made?. One of these 2:
  "occurrenceDateTime" : "<dateTime>",
  "occurrencePeriod" : { Period },
  "condition" : { Reference(Condition) }, // Condition assessed
  "performer" : { Reference(Device|Patient|Practitioner|PractitionerRole|
   RelatedPerson) }, // Who did assessment?
  "reason" : [{ CodeableReference(Condition|DiagnosticReport|DocumentReference|
   Observation) }], // Why was the assessment necessary?
  "basis" : [{ Reference(Any) }], // Information used in assessment
  "prediction" : [{ // Outcome predicted
    "outcome" : { CodeableConcept }, // Possible outcome for the subject
    
    ">,
    " },

    // probability[x]: Likelihood of specified outcome. One of these 3:
    "probabilityDecimal" : <decimal>,
    "probabilityQuantity" : { Quantity },
    "probabilityRange" : { Range },

    "qualitativeRisk" : { CodeableConcept }, // Likelihood of specified outcome as a qualitative value
    "relativeRisk" : <decimal>, // Relative likelihood
    // when[x]: Timeframe or age range. One of these 2:
    "whenPeriod" : { Period },
    "whenRange" : { Range },
    "rationale" : "<string>" // Explanation of prediction
  }],
  "mitigation" : "<string>", // How to reduce risk
  "note" : [{ Annotation }] // Comments on the risk assessment
}

Turtle Template 

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


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

  # from 
  # from 

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

  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Unique identifier for the assessment
  fhir:basedOn [ Reference(Any) ] ; # 0..1 Request fulfilled by this assessment
  fhir:parent [ Reference(Any) ] ; # 0..1 Part of this occurrence
  fhir:status [ code ] ; # 1..1 registered | specimen-in-process | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | unknown | cannot-be-obtained
  fhir:method [ CodeableConcept ] ; # 0..1 Evaluation mechanism
  fhir:code [ CodeableConcept ] ; # 0..1 Type of assessment
  fhir:subject [ Reference(Group|Patient) ] ; # 1..1 Who/what does assessment apply to?
  fhir:encounter [ Reference(Encounter) ] ; # 0..1 Where was assessment performed?
  # occurrence[x] : 0..1 When was assessment made?. One of these 2
    fhir: ]

    fhir:occurrence [  a fhir:DateTime ; dateTime ]

    fhir:occurrence [  a fhir:Period ; Period ]
  fhir:condition [ Reference(Condition) ] ; # 0..1 Condition assessed
  fhir:performer [ Reference(Device|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who did assessment?
  fhir:reason  ( [ CodeableReference(Condition|DiagnosticReport|DocumentReference|Observation) ] ... ) ; # 0..* Why was the assessment necessary?
  fhir:basis  ( [ Reference(Any) ] ... ) ; # 0..* Information used in assessment
  fhir:prediction ( [ # 0..* Outcome predicted
    fhir:outcome [ CodeableConcept ] ; # 0..1 Possible outcome for the subject
    # . One of these 2
      fhir: ]
      fhir: ]

    # probability[x] : 0..1 I Likelihood of specified outcome. One of these 3
      fhir:probability [  a fhir:Decimal ; decimal ]
      fhir:probability [  a fhir:Quantity ; Quantity ]
      fhir:probability [  a fhir:Range ; Range ]

    fhir:qualitativeRisk [ CodeableConcept ] ; # 0..1 Likelihood of specified outcome as a qualitative value
    fhir:relativeRisk [ decimal ] ; # 0..1 Relative likelihood
    # when[x] : 0..1 Timeframe or age range. One of these 2
      fhir:when [  a fhir:Period ; Period ]
      fhir:when [  a fhir:Range ; Range ]
    fhir:rationale [ string ] ; # 0..1 Explanation of prediction
  ] ... ) ;
  fhir:mitigation [ string ] ; # 0..1 How to reduce risk
  fhir:note  ( [ Annotation ] ... ) ; # 0..* Comments on the risk assessment
]

Changes from both R5 to R6

RiskAssessment
RiskAssessment.status
  • Remove code corrected
  • Add codes specimen-in-process , cannot-be-obtained
RiskAssessment.prediction.probability[x]
  • Add Type Quantity

Changes from R4 and R4B to R6

RiskAssessment
RiskAssessment.status
  • Remove code corrected
  • Add codes specimen-in-process , appended , cannot-be-obtained
RiskAssessment.performer
  • Type Reference: Added Target Types Patient, RelatedPerson
RiskAssessment.reason
  • Added Element
  • Merged both reasonCode and reasonReference into reason
RiskAssessment.prediction.probability[x]
  • Add Type Quantity
RiskAssessment.reasonCode
  • Deleted (-> reason) reason.concept)
RiskAssessment.reasonReference
  • Deleted (-> reason) reason.reference)

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

 

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

9.11.5.1 9.10.5.1 Terminology Bindings

Path ValueSet Type Documentation
RiskAssessment.status ObservationStatus Required

Codes providing the status of an observation.

RiskAssessment.method RiskAssessmentMethod Example

Example value set illustrating possible codes for identifying the mechanism or algorithm used to make the assessment; e.g. TIMI, PRISM, Cardiff Type 2 diabetes, etc.

RiskAssessment.code RiskAssessmentMethod Example

Example value set illustrating possible codes for identifying the mechanism or algorithm used to make the assessment; e.g. TIMI, PRISM, Cardiff Type 2 diabetes, etc.

RiskAssessment.prediction.outcome RiskAssessmentOutcome Example

Example value set illustrating possible codes for identifying the condition or other outcome; e.g. death, remission, amputation, infection, etc.

RiskAssessment.prediction.qualitativeRisk RiskProbability Example

Codes representing the likelihood of a particular outcome in a risk assessment.

9.11.5.2 9.10.5.2 Constraints

UniqueKey Level Location Description Expression
img  ras-1 Rule RiskAssessment.prediction.probability[x] low and high must be percentages, if present (low.empty() or ((low.code = '%') and (low.system = %ucum))) and (high.empty() or ((high.code = '%') and (high.system = %ucum)))
img  ras-2 Rule RiskAssessment.prediction Probability as a deciml decimal must be <= 100 probability.empty() or ((probability is decimal) implies ((probability as decimal) <= 100))
img  ras-3 Rule RiskAssessment.prediction Probability as a Quantity must be <= 100% probability.empty() or ((probability is Quantity) implies (((probability as Quantity).value <= 100) and ((probability as Quantity).code = '%') and ((probability as Quantity).system = %ucum)))

9.11.6 9.10.6 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource , and check the Extensions registry for search parameters on extensions related to 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
condition reference Condition assessed RiskAssessment.condition
( Condition )
date date When was assessment made? (RiskAssessment.occurrence.ofType(dateTime)) 25 22 Resources
encounter reference Where was assessment performed? RiskAssessment.encounter
( Encounter ) 		28 26 Resources
identifier token Unique identifier for the assessment RiskAssessment.identifier 64 58 Resources
method token Evaluation mechanism RiskAssessment.method
patient reference Who/what does assessment apply to? RiskAssessment.subject.where(resolve() is Patient)
( Patient ) 		64 60 Resources
performer reference Who did assessment? RiskAssessment.performer
( Practitioner , Device , Patient , PractitionerRole , RelatedPerson )
probability number Likelihood of specified outcome RiskAssessment.prediction.probability.ofType(decimal)
probability-quantity quantity Likelihood of specified outcome (as a Quantity or Range) RiskAssessment.prediction.probability.ofType(Quantity) | RiskAssessment.prediction.probability.ofType(Range)
risk token Likelihood of specified outcome as a qualitative value RiskAssessment.prediction.qualitativeRisk
subject reference Who/what does assessment apply to? RiskAssessment.subject
( Group , Patient )