Message Thread
Message Thread
Source Object: Message Thread
The Message Thread source object represents a collection of messages exchanged between users within a healthcare system. Message threads help facilitate communication and collaboration among healthcare professionals and patients.
Overview
Message threads are used for communication and discussion of various healthcare-related topics. These threads can be created for specific patients, practices, or groups. They contain individual messages sent by users participating in the thread.
Usage
The Message Thread source object is utilized in the following ways:
- Message Storage: It stores the messages sent within a particular thread. Each message contains details such as the sender, recipient, message body, and sending timestamp.
- Participants: It tracks the members or participants of the message thread, including their status and acknowledgment time if applicable. Users can be part of multiple threads, depending on the context.
- Urgency: It indicates whether a message thread is marked as urgent, which may be crucial for prioritizing communication.
- Timestamps: The source object includes various timestamps like creation date, delivery date, document date, and message send date to ensure proper record-keeping.
- Associations: Messages are associated with patients and practices, providing context and helping users identify the relevant healthcare entities.
Message threads are essential for secure and organized communication within healthcare systems, ensuring that healthcare professionals and patients can easily share information and collaborate.
Mapping Table
| Data Field | Source Field Data Type | Resource Mapping Context | Source Data Field Cardinality | Source Data Field Description | Example Value | Source Data Field Validation Rule | Mapped FHIR Resource | Mapped FHIR Data Field | Augmented Mapping | Associated Coding System | Associated FHIR Data Field Extension | Mapped FHIR Data Field Type |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| chart_date | DateTime | Top Level | 0..1 | The patient id | - | - | CommunicationRequest | extension[*].valueDateTime | - | NA | chart-date | TBD |
| created_date | DateTime | Top Level | 0..1 | When the message thread was created | - | - | CommunicationRequest | extension[*].valueDateTime | - | NA | created-date | TBD |
| deleted_date | DateTime | Top Level | 0..1 | When the message thread was deleted | - | - | CommunicationRequest | extension[*].valueDateTime | - | NA | deleted-date | TBD |
| delivery_date | DateTime | Top Level | 0..1 | When the message thread's document was created | - | - | CommunicationRequest | occurrenceDateTime | - | NA | - | TBD |
| document_date | DateTime | Top Level | 0..1 | When the message thread's patient chart was created | - | - | CommunicationRequest | extension[*].valueDateTime | - | NA | document-date | TBD |
| id | Integer | Top Level | 0..1 | Id of the message thread | - | - | CommunicationRequest | id | - | NA | - | TBD |
| is_urgent | Boolean | Top Level | 0..1 | The message thread id | - | - | CommunicationRequest | extension[*].valueBoolean | - | NA | urgent | TBD |
| patient | Integer | Top Level | 0..1 | The practice id | - | - | CommunicationRequest | subject.reference | Patient | NA | - | TBD |
| practice | Integer | Top Level | 0..1 | Is the message thread urgent? | - | - | CommunicationRequest | extension[*].valueReference.reference | - | NA | practice | TBD |
| members | Object | Contained | 0..* | - | - | - | Person | - | resourceType = Person | NA | - | TBD |
| members.ack_time | DateTime | Contained | 0..1 | The time at which the member acknowledge the message thread. | - | - | Person | contained[].extension[].valueBoolean | resourceType = Person | NA | ack-time | TBD |
| members.group | Integer | Contained | 0..1 | The id of the group referenced by this thread member.Should only ever be one of either a user or group set for the thread member. | - | - | Person | contained[].extension[].valueInteger | resourceType = Person | NA | group | TBD |
| members.id | Integer | Contained | 0..1 | The id of the thread member. | - | - | Person | contained[*].id | resourceType = Person | NA | - | TBD |
| members.status | String | Contained | 0..1 | Whether this member has acknowledged the message thread. | - | Addressed,Requiring Action | Person | contained[].extension[].valueString | resourceType = Person | NA | status | TBD |
| members.thread | Integer | Contained | 0..1 | The id of the thread this thread member is a member of. | - | - | Person | contained[].extension[].valueInteger | resourceType = Person | NA | thread | TBD |
| members.user | Integer | Contained | 0..1 | The id of the user referenced by this thread member.Should only ever be one of either a user or group set for the thread member. | - | - | Person | contained[].extension[].valueInteger | resourceType = Person | NA | user | TBD |
| messages | Object | Contained | 0..* | The ids of the thread messages | - | - | Communication | - | resourceType = Practition | NA | - | TBD |
| messages.body | String | Contained | 0..1 | The actual message body | - | - | Communication | contained[].payload[].contentString | - | NA | - | TBD |
| messages.id | Integer | Contained | 0..1 | The id of the thread message | - | - | Communication | contained[*].id | - | NA | - | TBD |
| messages.patient | Integer | Contained | 0..1 | The patient id | - | - | Communication | contained[*].subject.reference | Patient | NA | - | TBD |
| messages.practice | Integer | Contained | 0..1 | The practice id | - | - | Communication | contained[].extension[].valueReference.reference | - | NA | practice | TBD |
| messages.send_date | Date | Contained | 0..1 | The date of when the message was sent | - | - | Communication | contained[*].sent | - | NA | - | TBD |
| messages.sender | Integer | Contained | 0..1 | The id of who sent the message | - | - | Communication | contained[*].sender.reference | Practitioner | NA | - | TBD |
| messages.thread | Integer | Contained | 0..1 | The message thread id | - | - | Communication | contained[].extension[].valueInteger | - | NA | thread | TBD |
| messages.to_document | Object | Contained | 0..1 | - | - | Communication | - | - | NA | - | TBD |