This page is part of the FHIR Specification (v5.0.0: R5 - STU). This is the current published version. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3
FHIR Infrastructure | Maturity Level: 1 | Informative |
Detailed Descriptions for the elements in the Event pattern.
Event | |||||||||||||
Definition | A pattern to be followed by resources that represent the performance of some activity, possibly in accordance with a request or service definition. | ||||||||||||
Short Display | Event Pattern | ||||||||||||
Cardinality | 0..* | ||||||||||||
Type | Logical | ||||||||||||
Invariants |
| ||||||||||||
Event.identifier | |||||||||||||
Definition | Business identifiers assigned to this {{title}} 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 {{title}} | ||||||||||||
Note | This is a business identifier, not a resource identifier (see discussion) | ||||||||||||
Cardinality | 0..* | ||||||||||||
Type | Identifier | ||||||||||||
Requirements | Allows identification of the {{title}} 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. | ||||||||||||
Event.basedOn | |||||||||||||
Definition | A plan, proposal or order that is fulfilled in whole or in part by this {{title}}. | ||||||||||||
Short Display | Fulfills plan, proposal or order | ||||||||||||
Cardinality | 0..* | ||||||||||||
Type | Reference(Request[Appointment, AppointmentResponse, CarePlan, Claim, CommunicationRequest, CoverageEligibilityRequest, DeviceRequest, EnrollmentRequest, ImmunizationRecommendation, MedicationRequest, NutritionOrder, RequestOrchestration, ServiceRequest, SupplyRequest, Task, Transport, VisionPrescription]) | ||||||||||||
Requirements | Allows tracing of authorization for the {{title}} and tracking whether proposals/recommendations were acted upon. | ||||||||||||
Alternate Names | fulfills | ||||||||||||
Summary | true | ||||||||||||
Comments | [The allowed reference resources may be adjusted as appropriate for the event resource]. | ||||||||||||
Event.partOf | |||||||||||||
Definition | A larger event of which this particular {{title}} is a component or step. | ||||||||||||
Short Display | Part of referenced event | ||||||||||||
Cardinality | 0..* | ||||||||||||
Type | Reference(Event[AdverseEvent, AuditEvent, ChargeItem, ClaimResponse, ClinicalImpression, Communication, Composition, Consent, Contract, Coverage, CoverageEligibilityResponse, DetectedIssue, DeviceDispense, DeviceUsage, DiagnosticReport, DocumentReference, Encounter, EnrollmentResponse, EpisodeOfCare, ExplanationOfBenefit, FamilyMemberHistory, GenomicStudy, GuidanceResponse, ImagingSelection, ImagingStudy, Immunization, ImmunizationEvaluation, InventoryReport, Invoice, MedicationAdministration, MedicationDispense, MedicationStatement, MessageHeader, NutritionIntake, Observation, PaymentNotice, PaymentReconciliation, Procedure, Provenance, QuestionnaireResponse, RiskAssessment, SupplyDelivery, Transport]) | ||||||||||||
Requirements | [E.g. Drug administration as part of a procedure, procedure as part of observation, etc.]. | ||||||||||||
Alternate Names | container | ||||||||||||
Summary | true | ||||||||||||
Comments | Not to be used to link an {{title}} to an Encounter - use 'context' for that.[The allowed reference resources may be adjusted as appropriate for the event resource]. | ||||||||||||
Event.researchStudy | |||||||||||||
Definition | Indicates that this {{title}} is relevant to the specified research study(ies). | ||||||||||||
Short Display | Associated research study | ||||||||||||
Cardinality | 0..* | ||||||||||||
Type | Reference(ResearchStudy) | ||||||||||||
Comments | This relevance might mean that the {{title}} occurred as part of the study protocol, but can also include events that occurred outside the study but still have relevance. | ||||||||||||
Event.status | |||||||||||||
Definition | The current state of the {{title}}. | ||||||||||||
Short Display | preparation | in-progress | not-done | suspended | aborted | completed | entered-in-error | unknown | ||||||||||||
Cardinality | 1..1 | ||||||||||||
Terminology Binding | EventStatus (Required) | ||||||||||||
Type | code | ||||||||||||
Is Modifier | true (Reason: This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid) | ||||||||||||
Summary | true | ||||||||||||
Comments | A nominal state-transition diagram can be found in the (Event pattern)[event.html#statemachine] 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. | ||||||||||||
Event.statusReason | |||||||||||||
Definition | Captures the reason for the current state of the {{title}}. | ||||||||||||
Short Display | Reason for current status | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Terminology Binding | EventStatusReason: | ||||||||||||
Type | CodeableConcept | ||||||||||||
Alternate Names | Suspended Reason; Cancelled Reason | ||||||||||||
Comments | This is generally only used for "exception" statuses such as "not-done", "suspended" or "cancelled". The reason for performing the event at all is captured in reasonCode, not here. [distinct reason codes for different statuses can be enforced using invariants if they are universal bindings]. | ||||||||||||
Event.category | |||||||||||||
Definition | Partitions the {{title}} 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 {{title}} | ||||||||||||
Cardinality | 0..* | ||||||||||||
Type | CodeableConcept | ||||||||||||
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. | ||||||||||||
Event.code | |||||||||||||
Definition | A code that identifies the specific service or action that was or is being performed. | ||||||||||||
Short Display | What service was done | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Terminology Binding | EventCode: | ||||||||||||
Type | CodeableConcept | ||||||||||||
Alternate Names | type | ||||||||||||
Summary | true | ||||||||||||
Comments | [In some cases, the service type is implicit based on the scope of the resource and only a product element will be present]. | ||||||||||||
Event.product | |||||||||||||
Definition | Indicates the product supplied or manipulated by this {{title}}. | ||||||||||||
Short Display | Product used/provided | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Type | CodeableReference(BiologicallyDerivedProduct | Device | DeviceDefinition | Medication | NutritionProduct | Substance) | ||||||||||||
Summary | true | ||||||||||||
Event.subject | |||||||||||||
Definition | The individual or set of individuals the action is being or was performed on. | ||||||||||||
Short Display | Individual service was done for/to | ||||||||||||
Cardinality | 1..1 | ||||||||||||
Type | Reference(Patient | Group) | ||||||||||||
Requirements | Links the {{title}} to the Patient context. May also affect access control. | ||||||||||||
Alternate Names | patient | ||||||||||||
Summary | true | ||||||||||||
Comments | [For resources that aren't patient-specific, the set of allowed resources may be extended to include other things. Group should generally be retained unless there's certainty this resource won't be used for veterinary, research or public health settings where Group may be necessary (e.g. this cage of rats/crate of chickens, group of people in a 5 mile radious of the incident, etc.)]. | ||||||||||||
To Do | For mapping, is it better if we make this Any and then constrain it down? | ||||||||||||
Event.encounter | |||||||||||||
Definition | The Encounter during which this {{title}} was created or to which the creation of this record is tightly associated. | ||||||||||||
Short Display | Encounter the {{title}} is part of | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Type | Reference(Encounter) | ||||||||||||
Requirements | Links the {{title}} to the Encounter context. May also affect access control. | ||||||||||||
Alternate Names | context | ||||||||||||
Summary | true | ||||||||||||
Comments | This will typically be the encounter the {{title}} was created during, but some {{title}}s 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). | ||||||||||||
Event.occurrence[x] | |||||||||||||
Definition | The date, period or timing when the {{title}} did occur or is occurring. | ||||||||||||
Short Display | When {{title}} occurred/is occurring | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Type | dateTime|Period|Timing | ||||||||||||
[x] Note | See Choice of Datatypes for further information about how to use [x] | ||||||||||||
Alternate Names | timing | ||||||||||||
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. [The list of types may be constrained as appropriate for the type of event. The use of 'Timing' in type is generally only appropriate for Events that are typically used to represent summary information.]. | ||||||||||||
Event.recorded | |||||||||||||
Definition | The date the occurrence of the {{title}} was first captured in the record - potentially significantly after the occurrence of the event. | ||||||||||||
Short Display | When {{title}} was first captured in the subject's record | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Type | dateTime | ||||||||||||
Summary | true | ||||||||||||
Event.reported[x] | |||||||||||||
Definition | Indicates if this record was captured as a secondary 'reported' record rather than as an original primary source-of-truth record. It may also indicate the source of the report. | ||||||||||||
Short Display | Reported rather than primary record | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Type | boolean|Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization) | ||||||||||||
[x] Note | See Choice of Datatypes for further information about how to use [x] | ||||||||||||
Requirements | Reported data may have different rules on editing and may be visually distinguished from primary data. | ||||||||||||
Alternate Names | informer | ||||||||||||
Summary | true | ||||||||||||
Event.performer | |||||||||||||
Definition | Indicates who or what performed the {{title}} and how they were involved. | ||||||||||||
Short Display | Who performed {{title}} and what they did | ||||||||||||
Cardinality | 0..* | ||||||||||||
Summary | true | ||||||||||||
Comments | [Resources may choose to replace this with just a single performer or repeating where there's no need to distinguish the function performed]. | ||||||||||||
Event.performer.function | |||||||||||||
Definition | Distinguishes the type of involvement of the performer in the {{title}}. [Consider adding examples]. | ||||||||||||
Short Display | Type of performance | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Terminology Binding | EventPerformerFunction: | ||||||||||||
Type | CodeableConcept | ||||||||||||
Requirements | Allows disambiguation of the types of involvement of different performers. | ||||||||||||
Summary | true | ||||||||||||
Event.performer.actor | |||||||||||||
Definition | Indicates who or what performed the {{title}}. | ||||||||||||
Short Display | Who performed {{title}} | ||||||||||||
Cardinality | 1..1 | ||||||||||||
Type | Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | Device | RelatedPerson) | ||||||||||||
Summary | true | ||||||||||||
Event.location | |||||||||||||
Definition | The principal physical location where the {{title}} was performed. | ||||||||||||
Short Display | Where {{title}} occurred | ||||||||||||
Cardinality | 0..1 | ||||||||||||
Type | Reference(Location) | ||||||||||||
Requirements | Ties the event to where the records are likely kept and provides context around the event occurrence (e.g. if it occurred inside or outside a dedicated healthcare setting). | ||||||||||||
Summary | true | ||||||||||||
Event.reason | |||||||||||||
Definition | Describes why the {{title}} occurred in coded or textual form or Indicates another resource whose existence justifies this {{title}}. | ||||||||||||
Short Display | Why was {{title}} performed? | ||||||||||||
Cardinality | 0..* | ||||||||||||
Terminology Binding | EventReason: | ||||||||||||
Type | CodeableReference(Condition | Observation | DiagnosticReport | DocumentReference) | ||||||||||||
Summary | true | ||||||||||||
Comments | Textual reasons can be captured using reasonCode.text. | ||||||||||||
Event.note | |||||||||||||
Definition | Comments made about the {{title}} by the performer, subject or other participants. | ||||||||||||
Short Display | Comments made about the event | ||||||||||||
Cardinality | 0..* | ||||||||||||
Type | Annotation | ||||||||||||
Event.relevantHistory | |||||||||||||
Definition | Links to Provenance records for past versions of this resource or component resources that identify key state transitions or updates that are likely to be relevant to a user looking at the current version of the resource. | ||||||||||||
Short Display | Key events in history of {{title}} | ||||||||||||
Cardinality | 0..* | ||||||||||||
Type | Reference(Provenance) | ||||||||||||
Alternate Names | eventHistory | ||||||||||||
Comments | This element does not point to the Provenance associated with the current version of the resource - as it would be created after this version existed. The Provenance for the current version can be retrieved with a _revinclude. Referenced provenances should adhere to the provenance-relevant-history profile. See additional guidance here. |