FHIR CI-Build

This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon

Clinical Decision Support icon Work GroupMaturity Level: 3 Trial UseSecurity Category: Patient Compartments: Device, Group, Patient, Practitioner

Detailed Descriptions for the elements in the DetectedIssue resource.

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
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.

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.

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.

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
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
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
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).

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. .

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
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.

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
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
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
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.

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
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
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.

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.

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
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