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 Group | Maturity Level: 2 | Trial Use | Security Category: Patient | Compartments: Device, Patient, Practitioner |
Detailed Descriptions for the elements in the DetectedIssue resource.
DetectedIssue | |
Element Id | DetectedIssue |
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 Display | Clinical issue with action |
Cardinality | 0..* |
Type | DomainResource |
Alternate Names | DDI; drug-drug interaction; Contraindication; Alert |
Summary | false |
DetectedIssue.identifier | |
Element Id | DetectedIssue.identifier |
Definition | Business identifier associated with the detected issue record. |
Short Display | Unique id for the detected issue |
Note | This is a business identifier, not a resource identifier (see discussion) |
Cardinality | 0..* |
Type | Identifier |
Requirements | Allows linking instances of the same detected issue found on different servers. |
Summary | true |
DetectedIssue.status | |
Element Id | DetectedIssue.status |
Definition | Indicates the status of the detected issue. |
Short Display | preliminary | final | entered-in-error | mitigated |
Cardinality | 1..1 |
Terminology Binding | Detected Issue Status (Required) |
Type | code |
Is Modifier | true (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 Names | status |
Summary | true |
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 Id | DetectedIssue.category |
Definition | A code that classifies the general type of detected issue. |
Short Display | Type of detected issue, e.g. drug-drug, duplicate therapy, etc. |
Cardinality | 0..* |
Terminology Binding | Detected Issue Category (Preferred) |
Type | CodeableConcept |
Requirements | Used for filtering what detected issues are retrieved and displayed. |
Summary | false |
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 Id | DetectedIssue.code |
Definition | Identifies the specific type of issue identified. |
Short Display | Specific type of detected issue, e.g. drug-drug, duplicate therapy, etc. |
Cardinality | 0..1 |
Terminology Binding | Detected Issue Category (Preferred) |
Type | CodeableConcept |
Alternate Names | type |
Summary | true |
DetectedIssue.severity | |
Element Id | DetectedIssue.severity |
Definition | Indicates the degree of importance associated with the identified issue based on the potential impact on the patient. |
Short Display | high | moderate | low |
Cardinality | 0..1 |
Terminology Binding | DetectedIssueSeverity (Required) |
Type | code |
Alternate Names | severity |
Summary | true |
DetectedIssue.subject | |
Element Id | DetectedIssue.subject |
Definition | Indicates the subject whose record the detected issue is associated with. |
Short Display | Associated subject |
Cardinality | 0..1 |
Type | Reference(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. |
Summary | true |
DetectedIssue.identified[x] | |
Element Id | DetectedIssue.identified[x] |
Definition | The date or period when the detected issue was initially identified. |
Short Display | When identified |
Cardinality | 0..1 |
Type | dateTime|Period |
[x] Note | See 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. |
Summary | true |
DetectedIssue.author | |
Element Id | DetectedIssue.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 Display | The provider or device that identified the issue |
Cardinality | 0..1 |
Type | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Device) |
Summary | true |
DetectedIssue.implicated | |
Element Id | DetectedIssue.implicated |
Definition | Indicates the resource representing the current activity or proposed activity that is potentially problematic. |
Short Display | Problem resource |
Cardinality | 0..* |
Type | Reference(Any) |
Alternate Names | cause |
Summary | true |
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 Id | DetectedIssue.evidence |
Definition | Supporting evidence or manifestations that provide the basis for identifying the detected issue such as a GuidanceResponse or MeasureReport. |
Short Display | Supporting evidence |
Cardinality | 0..* |
Summary | false |
DetectedIssue.evidence.code | |
Element Id | DetectedIssue.evidence.code |
Definition | A manifestation that led to the recording of this detected issue. |
Short Display | Manifestation |
Cardinality | 0..* |
Terminology Binding | Manifestation and Symptom Codes (Example) |
Type | CodeableConcept |
Summary | false |
DetectedIssue.evidence.detail | |
Element Id | DetectedIssue.evidence.detail |
Definition | Links to resources that constitute evidence for the detected issue such as a GuidanceResponse or MeasureReport. |
Short Display | Supporting information |
Cardinality | 0..* |
Type | Reference(Any) |
Summary | false |
DetectedIssue.detail | |
Element Id | DetectedIssue.detail |
Definition | A textual explanation of the detected issue. |
Short Display | Description and context |
Cardinality | 0..1 |
Type | string |
Summary | false |
Comments | Should focus on information not covered elsewhere as discrete data - no need to duplicate the narrative. |
DetectedIssue.reference | |
Element Id | DetectedIssue.reference |
Definition | The literature, knowledge-base or similar reference that describes the propensity for the detected issue identified. |
Short Display | Authority for issue |
Cardinality | 0..1 |
Type | uri |
Summary | false |
DetectedIssue.mitigation | |
Element Id | DetectedIssue.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 Display | Step taken to address |
Cardinality | 0..* |
Summary | false |
DetectedIssue.mitigation.action | |
Element Id | DetectedIssue.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 Display | What mitigation? |
Cardinality | 1..1 |
Terminology Binding | Detected Issue Mitigation Action (Preferred) |
Type | CodeableConcept |
Summary | false |
Comments | The "text" component can be used for detail or when no appropriate code exists. |
DetectedIssue.mitigation.date | |
Element Id | DetectedIssue.mitigation.date |
Definition | Indicates when the mitigating action was documented. |
Short Display | Date committed |
Cardinality | 0..1 |
Type | dateTime |
Summary | false |
Comments | This might not be the same as when the mitigating step was actually taken. |
DetectedIssue.mitigation.author | |
Element Id | DetectedIssue.mitigation.author |
Definition | Identifies the practitioner who determined the mitigation and takes responsibility for the mitigation step occurring. |
Short Display | Who is committing? |
Cardinality | 0..1 |
Type | Reference(Practitioner | PractitionerRole) |
Summary | false |