Extensions for Using Data Elements from FHIR R5 in FHIR STU3
0.1.0 - STU International flag

Extensions for Using Data Elements from FHIR R5 in FHIR STU3 - Downloaded Version null See the Directory of published versions

Resource Profile: Profile_R5_Communication_R3 - Detailed Descriptions

Page standards status: Trial-use Maturity Level: 0

Definitions for the profile-Communication resource profile.

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

0. 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.

ShortA record of information transmitted from a sender to a receiver
Control0..*
Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.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-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
com-1: Not Done Reason can only be specified if NotDone is "true" (notDone or notDoneReason.exists().not())
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.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-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
com-1: Not Done Reason can only be specified if NotDone is "true" (notDone or notDoneReason.exists().not())
2. Communication.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.

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.

This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation.

Control0..1
Typeuri
Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
4. Communication.extension
Definition

An Extension


May be used to represent additional information that is not part of the basic definition of the resource. In order 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.

ShortExtensionAdditional Content defined by implementations
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
Alternate Namesextensions, user content
SlicingThis element introduces a set of slices on Communication.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ url
  • 6. Communication.extension:instantiatesUri
    Slice NameinstantiatesUri
    Definition

    R5: Communication.instantiatesUri (new:uri)

    ShortR5: Instantiates external protocol or definition (new)
    Comments

    Element Communication.instantiatesUri has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.instantiatesUri has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). This might be an HTML page, PDF, etc. or could just be a non-resolvable URI identifier.

    Control0..*
    This element is affected by the following invariants: ele-1
    TypeExtension(R5: Instantiates external protocol or definition (new)) (Extension Type: uri)
    Is Modifierfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    8. Communication.extension:inResponseTo
    Slice NameinResponseTo
    Definition

    R5: Communication.inResponseTo (new:Reference(Communication))

    ShortR5: Reply to (new)
    Comments

    Element Communication.inResponseTo has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.inResponseTo has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).

    Control0..*
    This element is affected by the following invariants: ele-1
    TypeExtension(R5: Reply to (new)) (Extension Type: Reference(Cross-version Profile for R5.Communication for use in FHIR STU3, Communication))
    Is Modifierfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    10. Communication.extension:priority
    Slice Namepriority
    Definition

    R5: Communication.priority (new:code)

    ShortR5: routine | urgent | asap | stat (new)
    Comments

    Element Communication.priority has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.priority has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). Used to prioritize workflow (such as which communication to read first) when the communication is planned or in progress.

    Control0..1
    This element is affected by the following invariants: ele-1
    TypeExtension(R5: routine | urgent | asap | stat (new)) (Extension Type: code)
    Is Modifierfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    12. Communication.extension:about
    Slice Nameabout
    Definition

    R5: Communication.about (new:Reference(Resource))

    ShortR5: Resources that pertain to this communication (new)
    Comments

    Element Communication.about has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.about has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). Don't use Communication.about element when a more specific element exists, such as basedOn or reasonReference.

    Control0..*
    This element is affected by the following invariants: ele-1
    TypeExtension(R5: Resources that pertain to this communication (new)) (Extension Type: Reference(Cross-version Profile for R5.Resource for use in FHIR STU3, Resource))
    Is Modifierfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    14. Communication.modifierExtension
    Definition

    An Extension


    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. Usually modifier elements provide negation or qualification. In order 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.

    ShortExtensionExtensions 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 No Modifier Reason provideed in previous versions of FHIR
    Alternate Namesextensions, user content
    SlicingThis element introduces a set of slices on Communication.modifierExtension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ url
    • 16. Communication.modifierExtension:status
      Slice Namestatus
      Definition

      R5: Communication.status additional codes

      ShortR5: preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown additional codes
      Comments

      Element Communication.status is mapped to FHIR STU3 element Communication.status as RelatedTo. Element Communication.status is mapped to FHIR STU3 element Communication.notDone as SourceIsBroaderThanTarget. The mappings for Communication.status do not allow expression of the necessary codes, per the bindings on the source and target. 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.

      Control0..1
      This element is affected by the following invariants: ele-1
      TypeExtension(R5: preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown additional codes) (Extension Type: code)
      Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
      ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
      18. Communication.status
      Definition

      The status of the transmission.

      Shortpreparation | in-progress | suspended | aborted | completed | entered-in-error
      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.

      Control1..1
      BindingThe codes SHALL be taken from EventStatus .http://hl7.org/fhir/ValueSet/event-status|3.0.2
      (required to http://hl7.org/fhir/ValueSet/event-status|3.0.2)

      The status of the communication.

      Typecode
      Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      20. Communication.notDone
      Definition

      If true, indicates that the described communication event did not actually occur.

      ShortCommunication did not occur
      Comments

      This element is labeled as a modifier because it marks the communication as a communication that did not occur. The more attributes are populated, the more constrained the negated statement is.

      Control0..1
      Typeboolean
      Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      Requirements

      Creating a Communication where notDone is true is intended for situations where there's a need for a specific statement in the record about something not being done. If the need is merely to indicate that a request wasn't fulfilled, that should be handled using Task.

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

      0. Communication
      2. Communication.extension
      Control0..*
      SlicingThis element introduces a set of slices on Communication.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
      • value @ url
      • 4. Communication.extension:instantiatesUri
        Slice NameinstantiatesUri
        Definition

        R5: Communication.instantiatesUri (new:uri)

        ShortR5: Instantiates external protocol or definition (new)
        Comments

        Element Communication.instantiatesUri has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.instantiatesUri has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). This might be an HTML page, PDF, etc. or could just be a non-resolvable URI identifier.

        Control0..*
        TypeExtension(R5: Instantiates external protocol or definition (new)) (Extension Type: uri)
        6. Communication.extension:inResponseTo
        Slice NameinResponseTo
        Definition

        R5: Communication.inResponseTo (new:Reference(Communication))

        ShortR5: Reply to (new)
        Comments

        Element Communication.inResponseTo has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.inResponseTo has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).

        Control0..*
        TypeExtension(R5: Reply to (new)) (Extension Type: Reference(Cross-version Profile for R5.Communication for use in FHIR STU3, Communication))
        8. Communication.extension:priority
        Slice Namepriority
        Definition

        R5: Communication.priority (new:code)

        ShortR5: routine | urgent | asap | stat (new)
        Comments

        Element Communication.priority has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.priority has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). Used to prioritize workflow (such as which communication to read first) when the communication is planned or in progress.

        Control0..1
        TypeExtension(R5: routine | urgent | asap | stat (new)) (Extension Type: code)
        10. Communication.extension:about
        Slice Nameabout
        Definition

        R5: Communication.about (new:Reference(Resource))

        ShortR5: Resources that pertain to this communication (new)
        Comments

        Element Communication.about has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.about has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). Don't use Communication.about element when a more specific element exists, such as basedOn or reasonReference.

        Control0..*
        TypeExtension(R5: Resources that pertain to this communication (new)) (Extension Type: Reference(Cross-version Profile for R5.Resource for use in FHIR STU3, Resource))
        12. Communication.modifierExtension
        Control0..*
        SlicingThis element introduces a set of slices on Communication.modifierExtension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
        • value @ url
        • 14. Communication.modifierExtension:status
          Slice Namestatus
          Definition

          R5: Communication.status additional codes

          ShortR5: preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown additional codes
          Comments

          Element Communication.status is mapped to FHIR STU3 element Communication.status as RelatedTo. Element Communication.status is mapped to FHIR STU3 element Communication.notDone as SourceIsBroaderThanTarget. The mappings for Communication.status do not allow expression of the necessary codes, per the bindings on the source and target. 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.

          Control0..1
          TypeExtension(R5: preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown additional codes) (Extension Type: code)
          16. Communication.definition
          18. Communication.definition.extension
          Control0..*
          SlicingThis element introduces a set of slices on Communication.definition.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
          • value @ url
          • 20. Communication.definition.extension:instantiatesCanonical
            Slice NameinstantiatesCanonical
            Definition

            R5: Communication.instantiatesCanonical additional types (canonical(http://hl7.org/fhir/StructureDefinition/PlanDefinition), canonical(http://hl7.org/fhir/StructureDefinition/ActivityDefinition), canonical(http://hl7.org/fhir/StructureDefinition/Measure), canonical(http://hl7.org/fhir/StructureDefinition/OperationDefinition), canonical(http://hl7.org/fhir/StructureDefinition/Questionnaire))

            ShortR5: Instantiates FHIR protocol or definition additional types
            Comments

            Element Communication.instantiatesCanonical is mapped to FHIR STU3 element Communication.definition as SourceIsBroaderThanTarget. The mappings for Communication.instantiatesCanonical do not cover the following types: canonical.

            Control0..*
            TypeExtension(R5: Instantiates FHIR protocol or definition additional types) (Extension Type: uri(Cross-version Profile for R5.PlanDefinition for use in FHIR STU3, PlanDefinition, Cross-version Profile for R5.ActivityDefinition for use in FHIR STU3, ActivityDefinition, Cross-version Profile for R5.Measure for use in FHIR STU3, Measure, Cross-version Profile for R5.OperationDefinition for use in FHIR STU3, OperationDefinition, Cross-version Profile for R5.Questionnaire for use in FHIR STU3, Questionnaire))
            22. Communication.basedOn
            24. Communication.basedOn.extension
            Control0..*
            SlicingThis element introduces a set of slices on Communication.basedOn.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
            • value @ url
            • 26. Communication.basedOn.extension:basedOn
              Slice NamebasedOn
              Definition

              R5: Communication.basedOn additional types from child elements (display, identifier, reference, type)

              ShortR5: basedOn additional types
              Comments

              Element Communication.basedOn is mapped to FHIR STU3 element Communication.basedOn as SourceIsBroaderThanTarget. The mappings for Communication.basedOn do not cover the following types based on type expansion: display, identifier, reference, type. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.basedOn with unmapped reference targets: Resource. This must point to some sort of a 'Request' resource, such as CarePlan, CommunicationRequest, ServiceRequest, MedicationRequest, etc.

              Control0..*
              TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
              28. Communication.partOf
              30. Communication.partOf.extension
              Control0..*
              SlicingThis element introduces a set of slices on Communication.partOf.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
              • value @ url
              • 32. Communication.partOf.extension:partOf
                Slice NamepartOf
                Definition

                R5: Communication.partOf additional types from child elements (display, identifier, reference, type)

                ShortR5: Part of referenced event (e.g. Communication, Procedure) additional types
                Comments

                Element Communication.partOf is mapped to FHIR STU3 element Communication.partOf as SourceIsBroaderThanTarget. The mappings for Communication.partOf do not cover the following types based on type expansion: display, identifier, reference, type. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.partOf with unmapped reference targets: Resource. The event the communication was part of - e.g. if you disclosed as "part" of counselling, it would be partOf that Procedure.

                Control0..*
                TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                34. Communication.subject
                36. Communication.subject.extension
                Control0..*
                SlicingThis element introduces a set of slices on Communication.subject.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                • value @ url
                • 38. Communication.subject.extension:subject
                  Slice Namesubject
                  Definition

                  R5: Communication.subject additional types from child elements (display, identifier, reference, type)

                  ShortR5: subject additional types
                  Comments

                  Element Communication.subject is mapped to FHIR STU3 element Communication.subject as SourceIsBroaderThanTarget. The mappings for Communication.subject do not cover the following types based on type expansion: display, identifier, reference, type. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.subject with unmapped reference targets: Group, Patient.

                  Control0..1
                  TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                  40. Communication.recipient
                  42. Communication.recipient.extension
                  Control0..*
                  SlicingThis element introduces a set of slices on Communication.recipient.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                  • value @ url
                  • 44. Communication.recipient.extension:recipient
                    Slice Namerecipient
                    Definition

                    R5: Communication.recipient

                    ShortR5: Who the information is shared with
                    Comments

                    Element Communication.recipient is mapped to FHIR STU3 element Communication.recipient as SourceIsBroaderThanTarget. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.recipient with unmapped reference targets: CareTeam, Device, Endpoint, Group, HealthcareService, Location, Organization, Patient, Practitioner, PractitionerRole, RelatedPerson. If receipts need to be tracked by an individual, a separate resource instance will need to be created for each recipient. Multiple recipient communications are intended where either receipts are not tracked (e.g. a mass mail-out) or a receipt is captured in aggregate (all emails confirmed received by a particular time).

                    Control0..*
                    TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                    46. Communication.topic
                    48. Communication.topic.extension
                    Control0..*
                    SlicingThis element introduces a set of slices on Communication.topic.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                    • value @ url
                    • 50. Communication.topic.extension:topic
                      Slice Nametopic
                      Definition

                      R5: Communication.topic additional types (CodeableConcept) additional types from child elements (coding, text)

                      ShortR5: Description of the purpose/content additional types
                      Comments

                      Element Communication.topic is mapped to FHIR STU3 element Communication.topic as RelatedTo. The mappings for Communication.topic do not cover the following types: CodeableConcept. The mappings for Communication.topic do not cover the following types based on type expansion: coding, text. Communication.topic.text can be used without any codings.

                      Control0..1
                      TypeExtension(R5: Description of the purpose/content additional types) (Extension Type: CodeableConcept)
                      52. Communication.context
                      54. Communication.context.extension
                      Control0..*
                      SlicingThis element introduces a set of slices on Communication.context.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                      • value @ url
                      • 56. Communication.context.extension:encounter
                        Slice Nameencounter
                        Definition

                        R5: Communication.encounter additional types from child elements (display, identifier, reference, type)

                        ShortR5: The Encounter during which this Communication was created additional types
                        Comments

                        Element Communication.encounter is mapped to FHIR STU3 element Communication.context as SourceIsBroaderThanTarget. The mappings for Communication.encounter do not cover the following types based on type expansion: display, identifier, reference, type. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.encounter with unmapped reference targets: Encounter. 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.

                        Control0..1
                        TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                        58. Communication.sender
                        60. Communication.sender.extension
                        Control0..*
                        SlicingThis element introduces a set of slices on Communication.sender.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                        • value @ url
                        • 62. Communication.sender.extension:sender
                          Slice Namesender
                          Definition

                          R5: Communication.sender

                          ShortR5: Who shares the information
                          Comments

                          Element Communication.sender is mapped to FHIR STU3 element Communication.sender as SourceIsBroaderThanTarget. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.sender with unmapped reference targets: CareTeam, Device, Endpoint, HealthcareService, Organization, Patient, Practitioner, PractitionerRole, RelatedPerson.

                          Control0..1
                          TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                          64. Communication.payload
                          66. Communication.payload.extension
                          Control0..*
                          SlicingThis element introduces a set of slices on Communication.payload.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                          • value @ url
                          • 68. Communication.payload.extension:content
                            Slice Namecontent
                            Definition

                            R5: Communication.payload.content[x] additional types (CodeableConcept)

                            ShortR5: content additional types
                            Comments

                            Element Communication.payload.content[x] is mapped to FHIR STU3 element Communication.payload.content[x] as SourceIsBroaderThanTarget. The mappings for Communication.payload.content[x] do not cover the following types: CodeableConcept. The target context Communication.payload.content[x] is a choice-type element and cannot directly hold extensions. The context is moved up to parent element Communication.payload. The standard extension alternate-reference has been mapped as PART of the representation of FHIR R5 element Communication.payload.content[x] with unmapped reference targets: Resource. Source element Communication.payload.content[x] has unmapped reference types. While the target element Communication.payload.content[x] is a choice type and does not allow extensions, the alternate-reference extension can be applied to Reference values within it. The content can be codified or textual. As an example of codified content, when working with machine generated communications, the payload may be drawn from a finite, terminology defined set of communications, especially for short, status update kinds of communications where more of a natural language approach isn't appropriate.

                            If the content isn't codified, contentCodeableConcept.text can be used.

                            When using contentCodeableConcept, the CodeableConcept is what is being communicated and is not a categorization of the content.

                            Control0..1
                            TypeExtension(R5: content additional types) (Extension Type: CodeableConcept)
                            70. Communication.payload.contentReference
                            72. Communication.payload.contentReference.extension:alternateReference
                            Slice NamealternateReference
                            Definition

                            R5: Communication.payload.content[x] additional types (CodeableConcept)

                            ShortR5: content additional types
                            Comments

                            Element Communication.payload.content[x] is mapped to FHIR STU3 element Communication.payload.content[x] as SourceIsBroaderThanTarget. The mappings for Communication.payload.content[x] do not cover the following types: CodeableConcept. The target context Communication.payload.content[x] is a choice-type element and cannot directly hold extensions. The context is moved up to parent element Communication.payload. The standard extension alternate-reference has been mapped as PART of the representation of FHIR R5 element Communication.payload.content[x] with unmapped reference targets: Resource. Source element Communication.payload.content[x] has unmapped reference types. While the target element Communication.payload.content[x] is a choice type and does not allow extensions, the alternate-reference extension can be applied to Reference values within it. The content can be codified or textual. As an example of codified content, when working with machine generated communications, the payload may be drawn from a finite, terminology defined set of communications, especially for short, status update kinds of communications where more of a natural language approach isn't appropriate.

                            If the content isn't codified, contentCodeableConcept.text can be used.

                            When using contentCodeableConcept, the CodeableConcept is what is being communicated and is not a categorization of the content.

                            TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)

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

                            0. 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.

                            ShortA record of information transmitted from a sender to a receiver
                            Control0..*
                            Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
                            dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.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-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
                            com-1: Not Done Reason can only be specified if NotDone is "true" (notDone or notDoneReason.exists().not())
                            2. Communication.id
                            Definition

                            The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.

                            ShortLogical id of this artifact
                            Comments

                            The only time that a resource does not have an id is when it is being submitted to the server using a create operation.

                            Control0..1
                            Typeid
                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                            Summarytrue
                            4. Communication.meta
                            Definition

                            The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content may not always be associated with version changes to the resource.

                            ShortMetadata about the resource
                            Control0..1
                            TypeMeta
                            Summarytrue
                            6. Communication.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.

                            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.

                            This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation.

                            Control0..1
                            Typeuri
                            Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                            Summarytrue
                            8. Communication.language
                            Definition

                            The base language in which the resource is written.

                            ShortLanguage of the resource content
                            Comments

                            Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).

                            Control0..1
                            BindingUnless not suitable, these codes SHALL be taken from Common Languages .
                            (extensible to http://hl7.org/fhir/ValueSet/languages|3.0.2)

                            A human language.

                            Additional BindingsPurpose
                            All LanguagesMax Binding
                            Typecode
                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                            10. Communication.text
                            Definition

                            A human-readable narrative that contains a summary of the resource, and may be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.

                            ShortText summary of the resource, for human interpretation
                            Comments

                            Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded in formation is added later.

                            Control0..1
                            This element is affected by the following invariants: dom-1
                            TypeNarrative
                            Alternate Namesnarrative, html, xhtml, display
                            12. Communication.contained
                            Definition

                            These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.

                            ShortContained, inline Resources
                            Comments

                            This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again.

                            Control0..*
                            TypeResource
                            Alternate Namesinline resources, anonymous resources, contained resources
                            14. Communication.extension
                            Definition

                            An Extension

                            ShortExtension
                            Control0..*
                            TypeExtension
                            SlicingThis element introduces a set of slices on Communication.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                            • value @ url
                            • 16. Communication.extension:instantiatesUri
                              Slice NameinstantiatesUri
                              Definition

                              R5: Communication.instantiatesUri (new:uri)

                              ShortR5: Instantiates external protocol or definition (new)
                              Comments

                              Element Communication.instantiatesUri has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.instantiatesUri has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). This might be an HTML page, PDF, etc. or could just be a non-resolvable URI identifier.

                              Control0..*
                              This element is affected by the following invariants: ele-1
                              TypeExtension(R5: Instantiates external protocol or definition (new)) (Extension Type: uri)
                              Is Modifierfalse
                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                              18. Communication.extension:inResponseTo
                              Slice NameinResponseTo
                              Definition

                              R5: Communication.inResponseTo (new:Reference(Communication))

                              ShortR5: Reply to (new)
                              Comments

                              Element Communication.inResponseTo has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.inResponseTo has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).

                              Control0..*
                              This element is affected by the following invariants: ele-1
                              TypeExtension(R5: Reply to (new)) (Extension Type: Reference(Cross-version Profile for R5.Communication for use in FHIR STU3, Communication))
                              Is Modifierfalse
                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                              20. Communication.extension:priority
                              Slice Namepriority
                              Definition

                              R5: Communication.priority (new:code)

                              ShortR5: routine | urgent | asap | stat (new)
                              Comments

                              Element Communication.priority has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.priority has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). Used to prioritize workflow (such as which communication to read first) when the communication is planned or in progress.

                              Control0..1
                              This element is affected by the following invariants: ele-1
                              TypeExtension(R5: routine | urgent | asap | stat (new)) (Extension Type: code)
                              Is Modifierfalse
                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                              22. Communication.extension:about
                              Slice Nameabout
                              Definition

                              R5: Communication.about (new:Reference(Resource))

                              ShortR5: Resources that pertain to this communication (new)
                              Comments

                              Element Communication.about has a context of Communication based on following the parent source element upwards and mapping to Communication. Element Communication.about has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). Don't use Communication.about element when a more specific element exists, such as basedOn or reasonReference.

                              Control0..*
                              This element is affected by the following invariants: ele-1
                              TypeExtension(R5: Resources that pertain to this communication (new)) (Extension Type: Reference(Cross-version Profile for R5.Resource for use in FHIR STU3, Resource))
                              Is Modifierfalse
                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                              24. Communication.modifierExtension
                              Definition

                              An Extension

                              ShortExtension
                              Control0..*
                              TypeExtension
                              Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
                              SlicingThis element introduces a set of slices on Communication.modifierExtension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                              • value @ url
                              • 26. Communication.modifierExtension:status
                                Slice Namestatus
                                Definition

                                R5: Communication.status additional codes

                                ShortR5: preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown additional codes
                                Comments

                                Element Communication.status is mapped to FHIR STU3 element Communication.status as RelatedTo. Element Communication.status is mapped to FHIR STU3 element Communication.notDone as SourceIsBroaderThanTarget. The mappings for Communication.status do not allow expression of the necessary codes, per the bindings on the source and target. 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.

                                Control0..1
                                This element is affected by the following invariants: ele-1
                                TypeExtension(R5: preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown additional codes) (Extension Type: code)
                                Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                                ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                28. 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).

                                ShortUnique identifier
                                NoteThis is a business identifier, not a resource identifier (see discussion)
                                Control0..*
                                TypeIdentifier
                                Summarytrue
                                30. Communication.definition
                                Definition

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

                                ShortInstantiates protocol or definition
                                Control0..*
                                TypeReference(PlanDefinition, ActivityDefinition)
                                Summarytrue
                                32. Communication.definition.id
                                Definition

                                unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                Shortxml:id (or equivalent in JSON)
                                Control0..1
                                Typestring
                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                XML FormatIn the XML format, this property is represented as an attribute.
                                34. Communication.definition.extension
                                Definition

                                An Extension

                                ShortExtension
                                Control0..*
                                TypeExtension
                                SlicingThis element introduces a set of slices on Communication.definition.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                • value @ url
                                • 36. Communication.definition.extension:instantiatesCanonical
                                  Slice NameinstantiatesCanonical
                                  Definition

                                  R5: Communication.instantiatesCanonical additional types (canonical(http://hl7.org/fhir/StructureDefinition/PlanDefinition), canonical(http://hl7.org/fhir/StructureDefinition/ActivityDefinition), canonical(http://hl7.org/fhir/StructureDefinition/Measure), canonical(http://hl7.org/fhir/StructureDefinition/OperationDefinition), canonical(http://hl7.org/fhir/StructureDefinition/Questionnaire))

                                  ShortR5: Instantiates FHIR protocol or definition additional types
                                  Comments

                                  Element Communication.instantiatesCanonical is mapped to FHIR STU3 element Communication.definition as SourceIsBroaderThanTarget. The mappings for Communication.instantiatesCanonical do not cover the following types: canonical.

                                  Control0..*
                                  TypeExtension(R5: Instantiates FHIR protocol or definition additional types) (Extension Type: uri(Cross-version Profile for R5.PlanDefinition for use in FHIR STU3, PlanDefinition, Cross-version Profile for R5.ActivityDefinition for use in FHIR STU3, ActivityDefinition, Cross-version Profile for R5.Measure for use in FHIR STU3, Measure, Cross-version Profile for R5.OperationDefinition for use in FHIR STU3, OperationDefinition, Cross-version Profile for R5.Questionnaire for use in FHIR STU3, Questionnaire))
                                  38. Communication.definition.reference
                                  Definition

                                  A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

                                  ShortLiteral reference, Relative, internal or absolute URL
                                  Comments

                                  Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

                                  Control0..1
                                  This element is affected by the following invariants: ref-1
                                  Typestring
                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                  Summarytrue
                                  40. Communication.definition.identifier
                                  Definition

                                  An identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

                                  ShortLogical reference, when literal reference is not known
                                  Comments

                                  When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

                                  When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

                                  Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

                                  NoteThis is a business identifier, not a resource identifier (see discussion)
                                  Control0..1
                                  TypeIdentifier
                                  Summarytrue
                                  42. Communication.definition.display
                                  Definition

                                  Plain text narrative that identifies the resource in addition to the resource reference.

                                  ShortText alternative for the resource
                                  Comments

                                  This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

                                  Control0..1
                                  Typestring
                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                  Summarytrue
                                  44. Communication.basedOn
                                  Definition

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

                                  ShortRequest fulfilled by this communication
                                  Comments

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

                                  Control0..*
                                  TypeReference(Resource)
                                  Summarytrue
                                  Alternate Namesfulfills
                                  46. Communication.basedOn.id
                                  Definition

                                  unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                  Shortxml:id (or equivalent in JSON)
                                  Control0..1
                                  Typestring
                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                  XML FormatIn the XML format, this property is represented as an attribute.
                                  48. Communication.basedOn.extension
                                  Definition

                                  An Extension

                                  ShortExtension
                                  Control0..*
                                  TypeExtension
                                  SlicingThis element introduces a set of slices on Communication.basedOn.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                  • value @ url
                                  • 50. Communication.basedOn.extension:basedOn
                                    Slice NamebasedOn
                                    Definition

                                    R5: Communication.basedOn additional types from child elements (display, identifier, reference, type)

                                    ShortR5: basedOn additional types
                                    Comments

                                    Element Communication.basedOn is mapped to FHIR STU3 element Communication.basedOn as SourceIsBroaderThanTarget. The mappings for Communication.basedOn do not cover the following types based on type expansion: display, identifier, reference, type. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.basedOn with unmapped reference targets: Resource. This must point to some sort of a 'Request' resource, such as CarePlan, CommunicationRequest, ServiceRequest, MedicationRequest, etc.

                                    Control0..*
                                    TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                                    52. Communication.basedOn.reference
                                    Definition

                                    A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

                                    ShortLiteral reference, Relative, internal or absolute URL
                                    Comments

                                    Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

                                    Control0..1
                                    This element is affected by the following invariants: ref-1
                                    Typestring
                                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                    Summarytrue
                                    54. Communication.basedOn.identifier
                                    Definition

                                    An identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

                                    ShortLogical reference, when literal reference is not known
                                    Comments

                                    When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

                                    When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

                                    Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

                                    NoteThis is a business identifier, not a resource identifier (see discussion)
                                    Control0..1
                                    TypeIdentifier
                                    Summarytrue
                                    56. Communication.basedOn.display
                                    Definition

                                    Plain text narrative that identifies the resource in addition to the resource reference.

                                    ShortText alternative for the resource
                                    Comments

                                    This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

                                    Control0..1
                                    Typestring
                                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                    Summarytrue
                                    58. Communication.partOf
                                    Definition

                                    Part of this action.

                                    ShortPart of this action
                                    Control0..*
                                    TypeReference(Resource)
                                    Summarytrue
                                    Alternate Namescontainer
                                    60. Communication.partOf.id
                                    Definition

                                    unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                    Shortxml:id (or equivalent in JSON)
                                    Control0..1
                                    Typestring
                                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                    XML FormatIn the XML format, this property is represented as an attribute.
                                    62. Communication.partOf.extension
                                    Definition

                                    An Extension

                                    ShortExtension
                                    Control0..*
                                    TypeExtension
                                    SlicingThis element introduces a set of slices on Communication.partOf.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                    • value @ url
                                    • 64. Communication.partOf.extension:partOf
                                      Slice NamepartOf
                                      Definition

                                      R5: Communication.partOf additional types from child elements (display, identifier, reference, type)

                                      ShortR5: Part of referenced event (e.g. Communication, Procedure) additional types
                                      Comments

                                      Element Communication.partOf is mapped to FHIR STU3 element Communication.partOf as SourceIsBroaderThanTarget. The mappings for Communication.partOf do not cover the following types based on type expansion: display, identifier, reference, type. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.partOf with unmapped reference targets: Resource. The event the communication was part of - e.g. if you disclosed as "part" of counselling, it would be partOf that Procedure.

                                      Control0..*
                                      TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                                      66. Communication.partOf.reference
                                      Definition

                                      A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

                                      ShortLiteral reference, Relative, internal or absolute URL
                                      Comments

                                      Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

                                      Control0..1
                                      This element is affected by the following invariants: ref-1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      68. Communication.partOf.identifier
                                      Definition

                                      An identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

                                      ShortLogical reference, when literal reference is not known
                                      Comments

                                      When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

                                      When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

                                      Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

                                      NoteThis is a business identifier, not a resource identifier (see discussion)
                                      Control0..1
                                      TypeIdentifier
                                      Summarytrue
                                      70. Communication.partOf.display
                                      Definition

                                      Plain text narrative that identifies the resource in addition to the resource reference.

                                      ShortText alternative for the resource
                                      Comments

                                      This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      72. Communication.status
                                      Definition

                                      The status of the transmission.

                                      Shortpreparation | in-progress | suspended | aborted | completed | entered-in-error
                                      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.

                                      Control1..1
                                      BindingThe codes SHALL be taken from EventStatus .
                                      (required to http://hl7.org/fhir/ValueSet/event-status|3.0.2)

                                      The status of the communication.

                                      Typecode
                                      Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      74. Communication.notDone
                                      Definition

                                      If true, indicates that the described communication event did not actually occur.

                                      ShortCommunication did not occur
                                      Comments

                                      This element is labeled as a modifier because it marks the communication as a communication that did not occur. The more attributes are populated, the more constrained the negated statement is.

                                      Control0..1
                                      Typeboolean
                                      Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      Requirements

                                      Creating a Communication where notDone is true is intended for situations where there's a need for a specific statement in the record about something not being done. If the need is merely to indicate that a request wasn't fulfilled, that should be handled using Task.

                                      76. Communication.notDoneReason
                                      Definition

                                      Describes why the communication event did not occur in coded and/or textual form.

                                      ShortWhy communication did not occur
                                      Control0..1
                                      This element is affected by the following invariants: com-1
                                      BindingFor example codes, see CommunicationNotDoneReason
                                      (example to http://hl7.org/fhir/ValueSet/communication-not-done-reason|3.0.2)

                                      Codes for the reason why a communication was not done.

                                      TypeCodeableConcept
                                      Summarytrue
                                      78. Communication.category
                                      Definition

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

                                      ShortMessage category
                                      Comments

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

                                      Control0..*
                                      BindingFor example codes, see CommunicationCategory
                                      (example to http://hl7.org/fhir/ValueSet/communication-category|3.0.2)

                                      Codes for general categories of communications such as alerts, instruction, etc.

                                      TypeCodeableConcept
                                      80. Communication.medium
                                      Definition

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

                                      ShortA channel of communication
                                      Control0..*
                                      BindingFor example codes, see ParticipationMode|2016-11-11
                                      (example to http://hl7.org/fhir/ValueSet/v3-ParticipationMode|2016-11-11)

                                      Codes for communication mediums such as phone, fax, email, in person, etc.

                                      TypeCodeableConcept
                                      82. Communication.subject
                                      Definition

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

                                      ShortFocus of message
                                      Control0..1
                                      TypeReference(Patient, Group)
                                      Summarytrue
                                      Alternate Namespatient
                                      84. Communication.subject.id
                                      Definition

                                      unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                      Shortxml:id (or equivalent in JSON)
                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      XML FormatIn the XML format, this property is represented as an attribute.
                                      86. Communication.subject.extension
                                      Definition

                                      An Extension

                                      ShortExtension
                                      Control0..*
                                      TypeExtension
                                      SlicingThis element introduces a set of slices on Communication.subject.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                      • value @ url
                                      • 88. Communication.subject.extension:subject
                                        Slice Namesubject
                                        Definition

                                        R5: Communication.subject additional types from child elements (display, identifier, reference, type)

                                        ShortR5: subject additional types
                                        Comments

                                        Element Communication.subject is mapped to FHIR STU3 element Communication.subject as SourceIsBroaderThanTarget. The mappings for Communication.subject do not cover the following types based on type expansion: display, identifier, reference, type. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.subject with unmapped reference targets: Group, Patient.

                                        Control0..1
                                        TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                                        90. Communication.subject.reference
                                        Definition

                                        A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

                                        ShortLiteral reference, Relative, internal or absolute URL
                                        Comments

                                        Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

                                        Control0..1
                                        This element is affected by the following invariants: ref-1
                                        Typestring
                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                        Summarytrue
                                        92. Communication.subject.identifier
                                        Definition

                                        An identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

                                        ShortLogical reference, when literal reference is not known
                                        Comments

                                        When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

                                        When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

                                        Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

                                        NoteThis is a business identifier, not a resource identifier (see discussion)
                                        Control0..1
                                        TypeIdentifier
                                        Summarytrue
                                        94. Communication.subject.display
                                        Definition

                                        Plain text narrative that identifies the resource in addition to the resource reference.

                                        ShortText alternative for the resource
                                        Comments

                                        This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

                                        Control0..1
                                        Typestring
                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                        Summarytrue
                                        96. Communication.recipient
                                        Definition

                                        The entity (e.g. person, organization, clinical information system, 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).

                                        ShortMessage recipient
                                        Control0..*
                                        TypeReference(Device, Organization, Patient, Practitioner, RelatedPerson, Group)
                                        98. Communication.recipient.id
                                        Definition

                                        unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                        Shortxml:id (or equivalent in JSON)
                                        Control0..1
                                        Typestring
                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                        XML FormatIn the XML format, this property is represented as an attribute.
                                        100. Communication.recipient.extension
                                        Definition

                                        An Extension

                                        ShortExtension
                                        Control0..*
                                        TypeExtension
                                        SlicingThis element introduces a set of slices on Communication.recipient.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                        • value @ url
                                        • 102. Communication.recipient.extension:recipient
                                          Slice Namerecipient
                                          Definition

                                          R5: Communication.recipient

                                          ShortR5: Who the information is shared with
                                          Comments

                                          Element Communication.recipient is mapped to FHIR STU3 element Communication.recipient as SourceIsBroaderThanTarget. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.recipient with unmapped reference targets: CareTeam, Device, Endpoint, Group, HealthcareService, Location, Organization, Patient, Practitioner, PractitionerRole, RelatedPerson. If receipts need to be tracked by an individual, a separate resource instance will need to be created for each recipient. Multiple recipient communications are intended where either receipts are not tracked (e.g. a mass mail-out) or a receipt is captured in aggregate (all emails confirmed received by a particular time).

                                          Control0..*
                                          TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                                          104. Communication.recipient.reference
                                          Definition

                                          A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

                                          ShortLiteral reference, Relative, internal or absolute URL
                                          Comments

                                          Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

                                          Control0..1
                                          This element is affected by the following invariants: ref-1
                                          Typestring
                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                          Summarytrue
                                          106. Communication.recipient.identifier
                                          Definition

                                          An identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

                                          ShortLogical reference, when literal reference is not known
                                          Comments

                                          When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

                                          When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

                                          Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

                                          NoteThis is a business identifier, not a resource identifier (see discussion)
                                          Control0..1
                                          TypeIdentifier
                                          Summarytrue
                                          108. Communication.recipient.display
                                          Definition

                                          Plain text narrative that identifies the resource in addition to the resource reference.

                                          ShortText alternative for the resource
                                          Comments

                                          This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

                                          Control0..1
                                          Typestring
                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                          Summarytrue
                                          110. Communication.topic
                                          Definition

                                          The resources which were responsible for or related to producing this communication.

                                          ShortFocal resources
                                          Control0..*
                                          TypeReference(Resource)
                                          112. Communication.topic.id
                                          Definition

                                          unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                          Shortxml:id (or equivalent in JSON)
                                          Control0..1
                                          Typestring
                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                          XML FormatIn the XML format, this property is represented as an attribute.
                                          114. Communication.topic.extension
                                          Definition

                                          An Extension

                                          ShortExtension
                                          Control0..*
                                          TypeExtension
                                          SlicingThis element introduces a set of slices on Communication.topic.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                          • value @ url
                                          • 116. Communication.topic.extension:topic
                                            Slice Nametopic
                                            Definition

                                            R5: Communication.topic additional types (CodeableConcept) additional types from child elements (coding, text)

                                            ShortR5: Description of the purpose/content additional types
                                            Comments

                                            Element Communication.topic is mapped to FHIR STU3 element Communication.topic as RelatedTo. The mappings for Communication.topic do not cover the following types: CodeableConcept. The mappings for Communication.topic do not cover the following types based on type expansion: coding, text. Communication.topic.text can be used without any codings.

                                            Control0..1
                                            TypeExtension(R5: Description of the purpose/content additional types) (Extension Type: CodeableConcept)
                                            118. Communication.topic.reference
                                            Definition

                                            A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

                                            ShortLiteral reference, Relative, internal or absolute URL
                                            Comments

                                            Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

                                            Control0..1
                                            This element is affected by the following invariants: ref-1
                                            Typestring
                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                            Summarytrue
                                            120. Communication.topic.identifier
                                            Definition

                                            An identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

                                            ShortLogical reference, when literal reference is not known
                                            Comments

                                            When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

                                            When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

                                            Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

                                            NoteThis is a business identifier, not a resource identifier (see discussion)
                                            Control0..1
                                            TypeIdentifier
                                            Summarytrue
                                            122. Communication.topic.display
                                            Definition

                                            Plain text narrative that identifies the resource in addition to the resource reference.

                                            ShortText alternative for the resource
                                            Comments

                                            This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

                                            Control0..1
                                            Typestring
                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                            Summarytrue
                                            124. Communication.context
                                            Definition

                                            The encounter within which the communication was sent.

                                            ShortEncounter or episode leading to message
                                            Control0..1
                                            TypeReference(Encounter, EpisodeOfCare)
                                            Summarytrue
                                            Alternate Namesencounter
                                            126. Communication.context.id
                                            Definition

                                            unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                            Shortxml:id (or equivalent in JSON)
                                            Control0..1
                                            Typestring
                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                            XML FormatIn the XML format, this property is represented as an attribute.
                                            128. Communication.context.extension
                                            Definition

                                            An Extension

                                            ShortExtension
                                            Control0..*
                                            TypeExtension
                                            SlicingThis element introduces a set of slices on Communication.context.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                            • value @ url
                                            • 130. Communication.context.extension:encounter
                                              Slice Nameencounter
                                              Definition

                                              R5: Communication.encounter additional types from child elements (display, identifier, reference, type)

                                              ShortR5: The Encounter during which this Communication was created additional types
                                              Comments

                                              Element Communication.encounter is mapped to FHIR STU3 element Communication.context as SourceIsBroaderThanTarget. The mappings for Communication.encounter do not cover the following types based on type expansion: display, identifier, reference, type. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.encounter with unmapped reference targets: Encounter. 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.

                                              Control0..1
                                              TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                                              132. Communication.context.reference
                                              Definition

                                              A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

                                              ShortLiteral reference, Relative, internal or absolute URL
                                              Comments

                                              Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

                                              Control0..1
                                              This element is affected by the following invariants: ref-1
                                              Typestring
                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                              Summarytrue
                                              134. Communication.context.identifier
                                              Definition

                                              An identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

                                              ShortLogical reference, when literal reference is not known
                                              Comments

                                              When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

                                              When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

                                              Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

                                              NoteThis is a business identifier, not a resource identifier (see discussion)
                                              Control0..1
                                              TypeIdentifier
                                              Summarytrue
                                              136. Communication.context.display
                                              Definition

                                              Plain text narrative that identifies the resource in addition to the resource reference.

                                              ShortText alternative for the resource
                                              Comments

                                              This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

                                              Control0..1
                                              Typestring
                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                              Summarytrue
                                              138. Communication.sent
                                              Definition

                                              The time when this communication was sent.

                                              ShortWhen sent
                                              Control0..1
                                              TypedateTime
                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                              140. Communication.received
                                              Definition

                                              The time when this communication arrived at the destination.

                                              ShortWhen received
                                              Control0..1
                                              TypedateTime
                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                              142. Communication.sender
                                              Definition

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

                                              ShortMessage sender
                                              Control0..1
                                              TypeReference(Device, Organization, Patient, Practitioner, RelatedPerson)
                                              144. Communication.sender.id
                                              Definition

                                              unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                              Shortxml:id (or equivalent in JSON)
                                              Control0..1
                                              Typestring
                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                              XML FormatIn the XML format, this property is represented as an attribute.
                                              146. Communication.sender.extension
                                              Definition

                                              An Extension

                                              ShortExtension
                                              Control0..*
                                              TypeExtension
                                              SlicingThis element introduces a set of slices on Communication.sender.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                              • value @ url
                                              • 148. Communication.sender.extension:sender
                                                Slice Namesender
                                                Definition

                                                R5: Communication.sender

                                                ShortR5: Who shares the information
                                                Comments

                                                Element Communication.sender is mapped to FHIR STU3 element Communication.sender as SourceIsBroaderThanTarget. The standard extension alternate-reference has been mapped as the representation of FHIR R5 element Communication.sender with unmapped reference targets: CareTeam, Device, Endpoint, HealthcareService, Organization, Patient, Practitioner, PractitionerRole, RelatedPerson.

                                                Control0..1
                                                TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                                                150. Communication.sender.reference
                                                Definition

                                                A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

                                                ShortLiteral reference, Relative, internal or absolute URL
                                                Comments

                                                Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

                                                Control0..1
                                                This element is affected by the following invariants: ref-1
                                                Typestring
                                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                Summarytrue
                                                152. Communication.sender.identifier
                                                Definition

                                                An identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

                                                ShortLogical reference, when literal reference is not known
                                                Comments

                                                When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

                                                When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

                                                Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

                                                NoteThis is a business identifier, not a resource identifier (see discussion)
                                                Control0..1
                                                TypeIdentifier
                                                Summarytrue
                                                154. Communication.sender.display
                                                Definition

                                                Plain text narrative that identifies the resource in addition to the resource reference.

                                                ShortText alternative for the resource
                                                Comments

                                                This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

                                                Control0..1
                                                Typestring
                                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                Summarytrue
                                                156. Communication.reasonCode
                                                Definition

                                                The reason or justification for the communication.

                                                ShortIndication for message
                                                Comments

                                                Textual reasons can be caprued using reasonCode.text.

                                                Control0..*
                                                BindingFor example codes, see SNOMED CT Clinical Findings
                                                (example to http://hl7.org/fhir/ValueSet/clinical-findings|3.0.2)

                                                Codes for describing reasons for the occurrence of a communication.

                                                TypeCodeableConcept
                                                Summarytrue
                                                158. Communication.reasonReference
                                                Definition

                                                Indicates another resource whose existence justifies this communication.

                                                ShortWhy was communication done?
                                                Control0..*
                                                TypeReference(Condition, Observation)
                                                Summarytrue
                                                160. Communication.payload
                                                Definition

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

                                                ShortMessage payload
                                                Control0..*
                                                TypeBackboneElement
                                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                                                162. Communication.payload.id
                                                Definition

                                                unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                Shortxml:id (or equivalent in JSON)
                                                Control0..1
                                                Typestring
                                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                XML FormatIn the XML format, this property is represented as an attribute.
                                                164. Communication.payload.extension
                                                Definition

                                                An Extension

                                                ShortExtension
                                                Control0..*
                                                TypeExtension
                                                SlicingThis element introduces a set of slices on Communication.payload.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                                • value @ url
                                                • 166. Communication.payload.extension:content
                                                  Slice Namecontent
                                                  Definition

                                                  R5: Communication.payload.content[x] additional types (CodeableConcept)

                                                  ShortR5: content additional types
                                                  Comments

                                                  Element Communication.payload.content[x] is mapped to FHIR STU3 element Communication.payload.content[x] as SourceIsBroaderThanTarget. The mappings for Communication.payload.content[x] do not cover the following types: CodeableConcept. The target context Communication.payload.content[x] is a choice-type element and cannot directly hold extensions. The context is moved up to parent element Communication.payload. The standard extension alternate-reference has been mapped as PART of the representation of FHIR R5 element Communication.payload.content[x] with unmapped reference targets: Resource. Source element Communication.payload.content[x] has unmapped reference types. While the target element Communication.payload.content[x] is a choice type and does not allow extensions, the alternate-reference extension can be applied to Reference values within it. The content can be codified or textual. As an example of codified content, when working with machine generated communications, the payload may be drawn from a finite, terminology defined set of communications, especially for short, status update kinds of communications where more of a natural language approach isn't appropriate.

                                                  If the content isn't codified, contentCodeableConcept.text can be used.

                                                  When using contentCodeableConcept, the CodeableConcept is what is being communicated and is not a categorization of the content.

                                                  Control0..1
                                                  This element is affected by the following invariants: ele-1
                                                  TypeExtension(R5: content additional types) (Extension Type: CodeableConcept)
                                                  Is Modifierfalse
                                                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                                                  ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                  168. Communication.payload.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 that contains it. Usually modifier elements provide negation or qualification. In order 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.

                                                  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 No Modifier Reason provideed in previous versions of FHIR
                                                  Summarytrue
                                                  Alternate Namesextensions, user content, modifiers
                                                  170. Communication.payload.content[x]
                                                  Definition

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

                                                  ShortMessage part content
                                                  Control1..1
                                                  TypeChoice of: string, Attachment, Reference(Resource)
                                                  [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                  172. Communication.payload.content[x].id
                                                  Definition

                                                  unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                  Shortxml:id (or equivalent in JSON)
                                                  Control0..1
                                                  Typestring
                                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                  XML FormatIn the XML format, this property is represented as an attribute.
                                                  174. Communication.payload.content[x].extension
                                                  Definition

                                                  May be used to represent additional information that is not part of the basic definition of the element. In order 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.

                                                  ShortAdditional Content defined by implementations
                                                  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
                                                  Alternate Namesextensions, user content
                                                  SlicingThis element introduces a set of slices on Communication.payload.content[x].extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                                  • value @ url
                                                  • 176. Communication.payload.content[x].extension:alternateReference
                                                    Slice NamealternateReference
                                                    Definition

                                                    R5: Communication.payload.content[x] additional types (CodeableConcept)

                                                    ShortR5: content additional types
                                                    Comments

                                                    Element Communication.payload.content[x] is mapped to FHIR STU3 element Communication.payload.content[x] as SourceIsBroaderThanTarget. The mappings for Communication.payload.content[x] do not cover the following types: CodeableConcept. The target context Communication.payload.content[x] is a choice-type element and cannot directly hold extensions. The context is moved up to parent element Communication.payload. The standard extension alternate-reference has been mapped as PART of the representation of FHIR R5 element Communication.payload.content[x] with unmapped reference targets: Resource. Source element Communication.payload.content[x] has unmapped reference types. While the target element Communication.payload.content[x] is a choice type and does not allow extensions, the alternate-reference extension can be applied to Reference values within it. The content can be codified or textual. As an example of codified content, when working with machine generated communications, the payload may be drawn from a finite, terminology defined set of communications, especially for short, status update kinds of communications where more of a natural language approach isn't appropriate.

                                                    If the content isn't codified, contentCodeableConcept.text can be used.

                                                    When using contentCodeableConcept, the CodeableConcept is what is being communicated and is not a categorization of the content.

                                                    Control0..*
                                                    TypeExtension(http://hl7.org/fhir/StructureDefinition/alternate-reference)
                                                    178. Communication.note
                                                    Definition

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

                                                    ShortComments made about the communication
                                                    Control0..*
                                                    TypeAnnotation