R6 Ballot (2nd Draft)

Publish-box (todo)

Clinical Decision Support icon Work GroupMaturity Level: 2 Trial UseSecurity 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, 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 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 Detected Issue Severity (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.encounter
Element Id DetectedIssue.encounter
Definition

The encounter during which this issue was detected.

Short Display Encounter detected issue is part of
Cardinality 0..1
Type Reference(Encounter)
Requirements

Links this detected issue to the Encounter context.

Alternate Names context
Summary true
Comments

This will typically be the encounter the DetectedIssue was created during, but some DetectedIssues 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 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 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