This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions
Clinical Decision Support ![]() | Maturity Level: 3 | Trial Use | Security Category: Patient | Compartments: Device, Group, 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, gaps in care, 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 identifiers assigned to this detected issue by the performer and/or other systems. These identifiers remain constant as the resource is updated and propagates from server to server. |
Short Display | Business identifier for detected issue |
Note | This is a business identifier, not a resource identifier (see discussion) |
Cardinality | 0..* |
Type | Identifier |
Requirements | Allows identification of the detected issue as it is known by various participating systems and in a way that remains consistent across servers. |
Summary | true |
Comments | Note: This is a business identifier, not a resource identifier (see discussion). It is best practice for the identifier to only appear on a single resource instance, however business practices may occasionally dictate that multiple resource instances with the same identifier can exist - possibly even with different resource types. For example, multiple Patient and a Person resource instance might share the same social insurance number. |
DetectedIssue.status | |
Element Id | DetectedIssue.status |
Definition | The current state of the detected issue. |
Short Display | preliminary | final | entered-in-error | unknown | 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 | A nominal state-transition diagram can be found in the (Event pattern documentation Unknown does not represent "other" - one of the defined statuses must apply. Unknown is used when the authoring system is not sure what the current status is. |
DetectedIssue.category | |
Element Id | DetectedIssue.category |
Definition | Partitions the detected issue into one or more categories that can be used to filter searching, to govern access control and/or to guide system behavior. |
Short Display | High level categorization of detected issue |
Cardinality | 0..* |
Terminology Binding | Detected Issue Category (Preferred) |
Type | CodeableConcept |
Requirements | Used for filtering what detected issues are retrieved and displayed. |
Summary | true |
Comments | Categorization might be done automatically (inferred by code) or manually by user assertion. The absence of a category may limit the ability to determine when the element should be handled, so strong consideration should be given to how systems will be able to determine category values for legacy data and how data that cannot be categorized will be handled. As well, some categories might not be mutually exclusive, so systems should prepare for multiple declared categories - even within a single category 'axis'. In general, there should not be a 'strong' binding ('required' or 'extensible') on the category element overall. Instead, the element can be sliced and bindings can be asserted that apply to particular repetitions. |
DetectedIssue.code | |
Element Id | DetectedIssue.code |
Definition | A code that identifies the specific type of issue detected. |
Short Display | Specific type of detected issue, e.g. drug-drug, duplicate therapy, etc |
Cardinality | 0..1 |
Terminology Binding | Detected Issue Code (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 | Detected Issue Severity (Preferred) |
Type | CodeableConcept |
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.encounter | |
Element Id | DetectedIssue.encounter |
Definition | The Encounter during which this detected issue was created or to which the creation of this record is tightly associated. |
Short Display | Encounter the detected issue is part of |
Cardinality | 0..1 |
Type | Reference(Encounter) |
Requirements | Links the detected issue to the Encounter context. May also affect access control. |
Alternate Names | context |
Summary | true |
Comments | This will typically be the encounter the detected issue was created during, but some detected issues may be initiated prior to or after the official completion of an encounter but still be tied to the context of the encounter (e.g. pre-admission lab tests). |
DetectedIssue.identified[x] | |
Element Id | DetectedIssue.identified[x] |
Definition | The date, period or timing when the detected issue did occur or is occurring. |
Short Display | When detected issue occurred/is occurring |
Cardinality | 0..1 |
Type | dateTime|Period|Timing |
[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 |
Comments | This indicates when the activity actually occurred or is occurring, not when it was asked/requested/ordered to occur. For the latter, look at the occurence element of the Request this {{event}} is "basedOn". The status code allows differentiation of whether the timing reflects a historic event or an ongoing event. Ongoing events should not include an upper bound in the Period or Timing.bounds. . |
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 | markdown |
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 |
DetectedIssue.mitigation.note | |
Element Id | DetectedIssue.mitigation.note |
Definition | Clinicians may add additional notes or justifications about the mitigation action. For example, patient can have this drug because they have had it before without any issues. Multiple justifications may be provided. |
Short Display | Additional notes about the mitigation |
Cardinality | 0..* |
Type | Annotation |
Summary | false |