Release 5 Ballot

This page is part of the FHIR Specification (v5.0.0-ballot: FHIR R5 Ballot Preview). 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

Clinical Decision Support Work GroupMaturity Level: 2 Trial UseSecurity Category: Patient Compartments: Device, Patient, Practitioner

Detailed Descriptions for the elements in the DetectedIssue resource.

DetectedIssue
Element IdDetectedIssue
Definition

Indicates an actual or potential clinical issue with or between one or more active or proposed clinical actions for a patient; e.g. Drug-drug interaction, Ineffective treatment frequency, Procedure-condition conflict, etc.

Short DisplayClinical issue with action
Cardinality0..*
TypeDomainResource
Alternate NamesDDI; drug-drug interaction; Contraindication; Alert
Summaryfalse
DetectedIssue.identifier
Element IdDetectedIssue.identifier
Definition

Business identifier associated with the detected issue record.

Short DisplayUnique id for the detected issue
NoteThis is a business identifier, not a resource identifier (see discussion)
Cardinality0..*
TypeIdentifier
Requirements

Allows linking instances of the same detected issue found on different servers.

Summarytrue
DetectedIssue.status
Element IdDetectedIssue.status
Definition

Indicates the status of the detected issue.

Short Displaypreliminary | final | entered-in-error | mitigated
Cardinality1..1
Terminology BindingDetected Issue Status (Required)
Typecode
Is Modifiertrue (Reason: This element is labeled as a modifier because it is a status element that contains the code entered-in-error which means that the resource should not be treated as valid)
Alternate Namesstatus
Summarytrue
Comments

This element is labeled as a modifier because the status contains the code entered-in-error that marks the issue as not currently valid.

DetectedIssue.category
Element IdDetectedIssue.category
Definition

A code that classifies the general type of detected issue.

Short DisplayType of detected issue, e.g. drug-drug, duplicate therapy, etc.
Cardinality0..*
Terminology BindingDetected Issue Category (Preferred)
TypeCodeableConcept
Requirements

Used for filtering what detected issues are retrieved and displayed.

Summaryfalse
Comments

In addition to the required category valueset, this element allows various categorization schemes based on the owner’s definition of the category and effectively multiple categories can be used at once. The level of granularity is defined by the category concepts in the value set.

DetectedIssue.code
Element IdDetectedIssue.code
Definition

Identifies the specific type of issue identified.

Short DisplaySpecific type of detected issue, e.g. drug-drug, duplicate therapy, etc.
Cardinality0..1
Terminology BindingDetected Issue Category (Preferred)
TypeCodeableConcept
Alternate Namestype
Summarytrue
DetectedIssue.severity
Element IdDetectedIssue.severity
Definition

Indicates the degree of importance associated with the identified issue based on the potential impact on the patient.

Short Displayhigh | moderate | low
Cardinality0..1
Terminology BindingDetectedIssueSeverity (Required)
Typecode
Alternate Namesseverity
Summarytrue
DetectedIssue.subject
Element IdDetectedIssue.subject
Definition

Indicates the subject whose record the detected issue is associated with.

Short DisplayAssociated subject
Cardinality0..1
TypeReference(Patient | Group | Device | Location | Organization | Procedure | Practitioner | Medication | Substance | BiologicallyDerivedProduct | NutritionProduct)
Requirements

While the subject could be inferred by tracing the subject of the implicated resources, it's useful to have a direct link for query purposes.

Summarytrue
DetectedIssue.identified[x]
Element IdDetectedIssue.identified[x]
Definition

The date or period when the detected issue was initially identified.

Short DisplayWhen identified
Cardinality0..1
TypedateTime|Period
[x] NoteSee Choice of Datatypes for further information about how to use [x]
Requirements

No-one can be responsible for mitigation prior to the issue being identified.

Summarytrue
DetectedIssue.author
Element IdDetectedIssue.author
Definition

Individual or device responsible for the issue being raised. For example, a decision support application or a pharmacist conducting a medication review.

Short DisplayThe provider or device that identified the issue
Cardinality0..1
TypeReference(Patient | RelatedPerson | Practitioner | PractitionerRole | Device)
Summarytrue
DetectedIssue.implicated
Element IdDetectedIssue.implicated
Definition

Indicates the resource representing the current activity or proposed activity that is potentially problematic.

Short DisplayProblem resource
Cardinality0..*
TypeReference(Any)
Alternate Namescause
Summarytrue
Comments

There's an implicit constraint on the number of implicated resources based on DetectedIssue.type; e.g. For drug-drug, there would be more than one. For timing, there would typically only be one.

DetectedIssue.evidence
Element IdDetectedIssue.evidence
Definition

Supporting evidence or manifestations that provide the basis for identifying the detected issue such as a GuidanceResponse or MeasureReport.

Short DisplaySupporting evidence
Cardinality0..*
Summaryfalse
DetectedIssue.evidence.code
Element IdDetectedIssue.evidence.code
Definition

A manifestation that led to the recording of this detected issue.

Short DisplayManifestation
Cardinality0..*
Terminology BindingManifestation and Symptom Codes (Example)
TypeCodeableConcept
Summaryfalse
DetectedIssue.evidence.detail
Element IdDetectedIssue.evidence.detail
Definition

Links to resources that constitute evidence for the detected issue such as a GuidanceResponse or MeasureReport.

Short DisplaySupporting information
Cardinality0..*
TypeReference(Any)
Summaryfalse
DetectedIssue.detail
Element IdDetectedIssue.detail
Definition

A textual explanation of the detected issue.

Short DisplayDescription and context
Cardinality0..1
Typestring
Summaryfalse
Comments

Should focus on information not covered elsewhere as discrete data - no need to duplicate the narrative.

DetectedIssue.reference
Element IdDetectedIssue.reference
Definition

The literature, knowledge-base or similar reference that describes the propensity for the detected issue identified.

Short DisplayAuthority for issue
Cardinality0..1
Typeuri
Summaryfalse
DetectedIssue.mitigation
Element IdDetectedIssue.mitigation
Definition

Indicates an action that has been taken or is committed to reduce or eliminate the likelihood of the risk identified by the detected issue from manifesting. Can also reflect an observation of known mitigating factors that may reduce/eliminate the need for any action.

Short DisplayStep taken to address
Cardinality0..*
Summaryfalse
DetectedIssue.mitigation.action
Element IdDetectedIssue.mitigation.action
Definition

Describes the action that was taken or the observation that was made that reduces/eliminates the risk associated with the identified issue.

Short DisplayWhat mitigation?
Cardinality1..1
Terminology BindingDetected Issue Mitigation Action (Preferred)
TypeCodeableConcept
Summaryfalse
Comments

The "text" component can be used for detail or when no appropriate code exists.

DetectedIssue.mitigation.date
Element IdDetectedIssue.mitigation.date
Definition

Indicates when the mitigating action was documented.

Short DisplayDate committed
Cardinality0..1
TypedateTime
Summaryfalse
Comments

This might not be the same as when the mitigating step was actually taken.

DetectedIssue.mitigation.author
Element IdDetectedIssue.mitigation.author
Definition

Identifies the practitioner who determined the mitigation and takes responsibility for the mitigation step occurring.

Short DisplayWho is committing?
Cardinality0..1
TypeReference(Practitioner | PractitionerRole)
Summaryfalse