QI-Core Implementation Guide
7.0.0 - STU7 United States of America flag

QI-Core Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 7.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-qi-core/ and changes regularly. See the Directory of published versions

Resource Profile: QICoreAdverseEvent - Detailed Descriptions

Active as of 2018-08-22

Definitions for the qicore-adverseevent resource profile.

Guidance on how to interpret the contents of this table can be found here

0. AdverseEvent
Definition

Actual or potential/avoided event causing unintended physical injury resulting from or contributed to by medical care, a research study or other healthcare setting factors that requires additional monitoring, treatment, or hospitalization, or that results in death.

ShortMedical care, research study or other healthcare event causing physical injury
Control0..*
Is Modifierfalse
Summaryfalse
Alternate NamesAE
Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource (contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty())
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated (contained.meta.versionId.empty() and contained.meta.lastUpdated.empty())
dom-5: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
dom-6: A resource should have narrative for robust management (text.`div`.exists())
2. AdverseEvent.implicitRules
Definition

A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

ShortA set of rules under which this content was created
Comments

Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

Control0..1
Typeuri
Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. AdverseEvent.modifierExtension
Definition

May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

ShortExtensions that cannot be ignored
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
Summaryfalse
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Alternate Namesextensions, user content
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
6. AdverseEvent.actuality
Definition

Whether the event actually happened, or just had the potential to. Note that this is independent of whether anyone was affected or harmed or how severely.

Short(QI) actual | potentialactual | potential
Control1..1
BindingThe codes SHALL be taken from AdverseEventActualityhttp://hl7.org/fhir/ValueSet/adverse-event-actuality|4.0.1
(required to http://hl7.org/fhir/ValueSet/adverse-event-actuality|4.0.1)

Overall nature of the adverse event, e.g. real or potential.

Typecode
Is Modifiertrue because This element is labeled as a modifier because it has a potential code that indicates the adverse event did not actually happen.
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
8. AdverseEvent.category
Definition

The overall type of event, intended for search and filtering purposes.

Short(QI) product-problem | product-quality | product-use-error | wrong-dose | incorrect-prescribing-information | wrong-technique | wrong-route-of-administration | wrong-rate | wrong-duration | wrong-time | expired-drug | medical-device-use-error | problem-different-manufacturer | unsafe-physical-environmentproduct-problem | product-quality | product-use-error | wrong-dose | incorrect-prescribing-information | wrong-technique | wrong-route-of-administration | wrong-rate | wrong-duration | wrong-time | expired-drug | medical-device-use-error | problem-different-manufacturer | unsafe-physical-environment
Control0..*
BindingUnless not suitable, these codes SHALL be taken from AdverseEventCategoryhttp://hl7.org/fhir/ValueSet/adverse-event-category
(extensible to http://hl7.org/fhir/ValueSet/adverse-event-category)

Overall categorization of the event, e.g. product-related or situational.

TypeCodeableConcept
Is Modifierfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
10. AdverseEvent.event
Definition

This element defines the specific type of event that occurred or that was prevented from occurring.

Short(QI) Type of the event itself in relation to the subjectType of the event itself in relation to the subject
Control10..1
BindingThe codes SHOULD be taken from For example codes, see SNOMEDCTClinicalFindingshttp://hl7.org/fhir/ValueSet/adverse-event-type
(preferred to http://hl7.org/fhir/ValueSet/adverse-event-type)

Detailed type of event.

TypeCodeableConcept
Is Modifierfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
12. AdverseEvent.subject
Definition

This subject or group impacted by the event.

Short(QI) Subject impacted by eventSubject impacted by event
Comments

If AdverseEvent.resultingCondition differs among members of the group, then use Patient as the subject.

Control1..1
TypeReference(QICore Patient, Patient, Group, Practitioner, RelatedPerson)
Is Modifierfalse
Summarytrue
Requirements

Allows for exposure of biohazard (such as legionella) to a group of individuals in a hospital.

Alternate Namespatient
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
14. AdverseEvent.encounter
Definition

The Encounter during which AdverseEvent was created or to which the creation of this record is tightly associated.

Short(QI) Encounter created as part ofEncounter created as part of
Comments

This will typically be the encounter the event occurred within, but some activities may be initiated prior to or after the official completion of an encounter but still be tied to the context of the encounter. For example, if a medication administration was considered an adverse event because it resulted in a rash, then the encounter when the medication administration was given is the context. If the patient reports the AdverseEvent during a second encounter, that second encounter is not the context.

Control0..1
TypeReference(QICore Encounter, Encounter)
Is Modifierfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
16. AdverseEvent.date
Definition

The date (and perhaps time) when the adverse event occurred.

ShortWhen the event occurred
Control0..1
TypedateTime
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Must Supportfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
18. AdverseEvent.recordedDate
Definition

The date on which the existence of the AdverseEvent was first recorded.

Short(QI) When the event was recordedWhen the event was recorded
Comments

The recordedDate represents the date when this particular AdverseEvent record was created in the system, not the date of the most recent update. The date of the last record modification can be retrieved from the resource metadata.

Control0..1
TypedateTime
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
20. AdverseEvent.resultingCondition
Definition

Includes information about the reaction that occurred as a result of exposure to a substance (for example, a drug or a chemical).

Short(QI) Effect on the subject due to this eventEffect on the subject due to this event
Control0..*
TypeReference(QICore Condition Problems Health Concerns, QICore Condition Encounter Diagnosis, Condition)
Is Modifierfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
22. AdverseEvent.location
Definition

The information about where the adverse event occurred.

ShortLocation where adverse event occurred
Control0..1
TypeReference(QICore Location, Location)
Is Modifierfalse
Must Supportfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
24. AdverseEvent.recorder
Definition

Information on who recorded the adverse event. May be the patient or a practitioner.

ShortWho recorded the adverse event
Control0..1
TypeReference(QICore Patient, QICore RelatedPerson, QICore Practitioner, QICore PractitionerRole, Patient, Practitioner, PractitionerRole, RelatedPerson)
Is Modifierfalse
Must Supportfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
26. AdverseEvent.contributor
Definition

Parties that may or should contribute or have contributed information to the adverse event, which can consist of one or more activities. Such information includes information leading to the decision to perform the activity and how to perform the activity (e.g. consultant), information that the activity itself seeks to reveal (e.g. informant of clinical history), or information about what activity was performed (e.g. informant witness).

ShortWho was involved in the adverse event or the potential adverse event
Control0..*
TypeReference(QICore Practitioner, QICore PractitionerRole, QICore Device, US Core Implantable Device Profile, Practitioner, PractitionerRole, Device)
Is Modifierfalse
Must Supportfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
28. AdverseEvent.suspectEntity
Definition

Describes the entity that is suspected to have caused the adverse event.

ShortThe suspected agent causing the adverse event
Control0..*
TypeBackboneElement
Is Modifierfalse
Must Supportfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
30. AdverseEvent.suspectEntity.modifierExtension
Definition

May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

ShortExtensions that cannot be ignored even if unrecognized
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
Summarytrue
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Alternate Namesextensions, user content, modifiers
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
32. AdverseEvent.suspectEntity.instance
Definition

Identifies the actual instance of what caused the adverse event. May be a substance, medication, medication administration, medication statement or a device.

Short(QI) Refers to the specific entity that caused the adverse eventRefers to the specific entity that caused the adverse event
Control1..1
TypeReference(QICore Immunization, QICore Procedure, QICore Substance, QICore Medication, QICore MedicationAdministration, QICore MedicationStatement, QICore Device, US Core Implantable Device Profile, Immunization, Procedure, Substance, Medication, MedicationAdministration, MedicationStatement, Device)
Is Modifierfalse
Summarytrue
Alternate NamesSubstance or Medication or Device
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
34. AdverseEvent.suspectEntity.causality
Definition

Information on the possible cause of the event.

ShortInformation on the possible cause of the event
Control0..1*
TypeBackboneElement
Is Modifierfalse
Must Supportfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
36. AdverseEvent.suspectEntity.causality.modifierExtension
Definition

May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

ShortExtensions that cannot be ignored even if unrecognized
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
Summarytrue
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Alternate Namesextensions, user content, modifiers
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
38. AdverseEvent.subjectMedicalHistory
Definition

AdverseEvent.subjectMedicalHistory.

ShortAdverseEvent.subjectMedicalHistory
Control0..*
TypeReference(QICore Simple Observation, QICore AllergyIntolerance, QICore FamilyMemberHistory, QICore Immunization, QICore Procedure, QICore Condition Problems Health Concerns, QICore Condition Encounter Diagnosis, Condition, Observation, AllergyIntolerance, FamilyMemberHistory, Immunization, Procedure, Media, DocumentReference)
Is Modifierfalse
Must Supportfalse
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))