R4 Draft for Comment

This page is part of the FHIR Specification (v3.2.0: R4 Ballot 1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Patient Care Work GroupMaturity Level: 2 Trial Use Compartments: Device, Encounter, Patient, Practitioner, RelatedPerson

Detailed Descriptions for the elements in the Communication resource.

Communication
Definition

An occurrence of information being transmitted; e.g. an alert that was sent to a responsible provider, a public health agency was notified about a reportable condition.

Control1..1
Communication.identifier
Definition

Identifiers associated with this Communication that are defined by business processes and/ or used to refer to it when a direct URL reference to the resource itself is not appropriate (e.g. in CDA documents, or in written / printed documentation).

NoteThis is a business identifer, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
Summarytrue
Communication.instantiates
Definition

A protocol, guideline, or other definition that was adhered to in whole or in part by this communication event.

Control0..*
Typeuri
Summarytrue
Communication.basedOn
Definition

An order, proposal or plan fulfilled in whole or in part by this Communication.

Control0..*
TypeReference(Any)
Alternate Namesfulfills
Summarytrue
Comments

This must point to some sort of a 'Request' resource, such as CarePlan, CommunicationRequest, ServiceRequest, MedicationRequest, etc.

Communication.partOf
Definition

Part of this action.

Control0..*
TypeReference(Any)
Alternate Namescontainer
Summarytrue
Communication.inResponseTo
Definition

Prior communication that this communication is in response to.

Control0..*
TypeReference(Communication)
Communication.status
Definition

The status of the transmission.

Control1..1
Terminology BindingEventStatus (Required)
Typecode
Is Modifiertrue
Summarytrue
Comments

This element is labeled as a modifier because the status contains the codes aborted and entered-in-error that mark the communication as not currently valid.

Communication.statusReason
Definition

Captures the reason for the current state of the Communication.

Control0..1
Terminology BindingCommunicationNotDoneReason (Example)
TypeCodeableConcept
Alternate NamesSuspended Reason; Cancelled Reason
Summarytrue
Comments

This is generally only used for "exception" statuses such as "not-done", "suspended" or "aborted". The reason for performing the event at all is captured in reasonCode, not here.

Communication.category
Definition

The type of message conveyed such as alert, notification, reminder, instruction, etc.

Control0..*
Terminology BindingCommunicationCategory (Example)
TypeCodeableConcept
Comments

There may be multiple axes of categorization and one communication may serve multiple purposes.

Communication.priority
Definition

Characterizes how quickly the planned or in progress communication must be addressed. Includes concepts such as stat, urgent, routine.

Control0..1
Terminology BindingRequestPriority (Required)
Typecode
Meaning if MissingIf missing, this communication should be treated with normal priority
Summarytrue
Comments

Used to prioritize workflow (such as which communication to read first) when the communication is planned or in progress.

Communication.medium
Definition

A channel that was used for this communication (e.g. email, fax).

Control0..*
Terminology Bindingv3 Code System ParticipationMode (Example)
TypeCodeableConcept
Communication.subject
Definition

The patient or group that was the focus of this communication.

Control0..1
TypeReference(Patient | Group)
Alternate Namespatient
Summarytrue
Communication.recipient
Definition

The entity (e.g. person, organization, clinical information system, care team or device) which was the target of the communication. If receipts need to be tracked by individual, a separate resource instance will need to be created for each recipient.  Multiple recipient communications are intended where either a receipt(s) is not tracked (e.g. a mass mail-out) or is captured in aggregate (all emails confirmed received by a particular time).

Control0..*
TypeReference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson | Group | CareTeam)
Communication.topic
Definition

Description of the purpose/content, similar to a subject line in an email.

Control0..1
Terminology BindingCommunicationTopic:
TypeCodeableConcept
Comments

Communication.topic.text can be used without any codings.

Communication.about
Definition

Other resources that pertain to this communication and to which this communication should be associated.

Control0..*
TypeReference(Any)
Comments

Don't use Communication.about element when a more specific element exists, such as basedOn or reasonReference.

Communication.context
Definition

The encounter within which the communication was sent.

Control0..1
TypeReference(Encounter | EpisodeOfCare)
Alternate Namesencounter
Summarytrue
Communication.sent
Definition

The time when this communication was sent.

Control0..1
TypedateTime
Communication.received
Definition

The time when this communication arrived at the destination.

Control0..1
TypedateTime
Communication.sender
Definition

The entity (e.g. person, organization, clinical information system, or device) which was the source of the communication.

Control0..1
TypeReference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
Communication.reasonCode
Definition

The reason or justification for the communication.

Control0..*
Terminology BindingSNOMED CT Clinical Findings (Example)
TypeCodeableConcept
Summarytrue
Comments

Textual reasons can be caprued using reasonCode.text.

Communication.reasonReference
Definition

Indicates another resource whose existence justifies this communication.

Control0..*
TypeReference(Condition | Observation | DiagnosticReport | DocumentReference)
Summarytrue
Communication.payload
Definition

Text, attachment(s), or resource(s) that was communicated to the recipient.

Control0..*
Communication.payload.content[x]
Definition

A communicated content (or for multi-part communications, one portion of the communication).

Control1..1
Typestring|Attachment|Reference(Any)
[x] NoteSee Choice of Data Types for further information about how to use [x]
Communication.note
Definition

Additional notes or commentary about the communication by the sender, receiver or other interested parties.

Control0..*
TypeAnnotation