This
page
is
part
of
the
Continuous
Integration
Build
of
FHIR
Specification
(v4.0.1:
R4
-
Mixed
Normative
and
STU
)
in
it's
permanent
home
(it
will
always
(will
be
available
incorrect/inconsistent
at
this
URL).
The
current
version
which
supercedes
this
version
is
5.0.0
.
For
a
full
list
of
available
versions,
see
times).
See
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
R2
Responsible
Owner:
Clinical
Decision
Support
Work
Group
|
|
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
|
|
| Business identifier for detected issue |
| Note | This is a business identifier, not a resource identifier (see discussion ) |
| Cardinality | 0..* |
| Type | Identifier |
| Requirements |
Allows
|
| 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 |
|
| Short Display | preliminary | final | entered-in-error | unknown | mitigated | processing-error |
| Cardinality | 1..1 |
| Terminology Binding |
|
| Type | code |
| Is Modifier |
true
(Reason:
This
element
is
labeled
as
a
modifier
because
it
is
a
status
element
that
contains
|
| Alternate Names | status |
| Summary | true |
| Comments |
Unknown
does
not
represent
"other"
-
one
of
the
defined
statuses
must
apply.
Unknown
is
|
| DetectedIssue.category | |
| Element Id | DetectedIssue.category |
| Definition |
Partitions
the
detected
issue
|
| 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
|
| DetectedIssue.code | |
| Element Id | DetectedIssue.code |
| Definition |
|
| Short Display | Specific type of detected issue, e.g. drug-drug, duplicate therapy, etc |
| Cardinality | 0..1 |
| Terminology Binding |
Detected
Issue
|
| 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 |
|
| Type |
|
| Alternate Names | severity |
| Summary | true |
|
|
|
| Element Id |
|
| Definition |
Indicates
the
|
| 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
|
| Short Display | When detected issue occurred/is occurring |
| Cardinality | 0..1 |
| Type | dateTime | Period | Timing |
| [x] Note |
See
Choice
of
|
| 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 |
|
|
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.qualityOfEvidence | |
| Element Id | DetectedIssue.qualityOfEvidence |
| Definition | The quality of the evidence supporting identification of the detected issue. The code system used specifies the quality scale used to grade this evidence source while the code specifies the actual quality score (represented as a coded value) associated with the evidence. |
| Short Display | The quality of the evidence supporting the detected issue |
| Cardinality | 0..1 |
| Terminology Binding |
QualityOfEvidenceRating
(
Example
)
|
| Type | CodeableConcept |
| Summary | false |
| DetectedIssue.expectedOnsetType | |
| Element Id | DetectedIssue.expectedOnsetType |
| Definition | The time frame in which the clinical effects of the detected issue may be expected to occur. Rapid refers to an expected onset within 24 hours. Delayed refers to an expected onset in more than 24 hours. |
| Short Display | Time frame of clinical effect |
| Cardinality | 0..1 |
| Terminology Binding | Detected Issue Expected Onset Type ( Example ) |
| Type | CodeableConcept |
| Summary | false |
| DetectedIssue.medicationClass | |
| Element Id | DetectedIssue.medicationClass |
| Definition | Represents the medication class that is responsible for the detected issue. |
| Short Display | What medication class |
| Cardinality | 0..* |
| Terminology Binding | Detected Issue Example Medication Class ( Example ) |
| Type | CodeableConcept |
| Summary | false |
| Comments | For example, for a duplicate therapy or an alergy alert, this class would represent the medication class to which the medications belong. |
| DetectedIssue.managementCode | |
| Element Id | DetectedIssue.managementCode |
| Definition | An indication of the importance or type of step that should or may be taken in order to address the detected issue. This is different than mitigation in that it is not specifically providing actions to be taken, rather general suggestions about approach. |
| Short Display | Importance of taking action on the issue |
| Cardinality | 0..1 |
| Terminology Binding | Detected Issue Management Code ( Example ) |
| Type | CodeableConcept |
| 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 |
|
|
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 |
|
|
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 |