Mobile Health Document Sharing
2.3.2-current - ci-build
Mobile Health Document Sharing, published by IHE IT Infrastructure Technical Committee. This guide is not an authorized publication; it is the continuous build for version 2.3.2-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/ITI.MHDS/ and changes regularly. See the Directory of published versions
This section modifies other IHE profiles or the General Introduction appendices and is not a part of the MHDS Profile. The content here will be incorporated into the target narrative at a future time, usually when MHDS Profile goes normative.
| Editor: Apply the following updates to Section 18.2.3 Grouping Rules by the following: |
Grouping with a Document Consumer is used in situations where an Initiating Gateway and/or Responding Gateway are supporting an XDS Affinity Domain.
When an Initiating Gateway is supporting an XDS Affinity Domain, it can choose to query and retrieve from local actors in addition to remote communities. This is accomplished by grouping the Initiating Gateway with a Document Consumer Actor. This grouping allows Document Consumers such as EHR/PHR/etc. systems to query the Initiating Gateway to retrieve document information and content from both the local XDS Affinity Domain as well as remote communities. For details see Section 18.2.3.1. An Initiating Gateway that is not grouped with a Document Consumer is only able to return results from remote communities, so local EHR/PHR/etc. systems (Document Consumer Actors) must direct separate query and document retrieve transactions internally and externally.
When a Responding Gateway is supporting an XDS Affinity Domain, it may resolve Cross Gateway Query and Cross Gateway Retrieve Transactions by grouping with a Document Consumer and using the Registry Stored Query and Retrieve Document Set transactions. For details see Section 18.2.3.2
Grouping with a MHD Document Consumer is used in situations where a Responding Gateway belongs to a community with an MHD Document Responder.
When a Responding Gateway belongs to an MHDS community, it may resolve Cross Gateway Query and Cross Gateway Retrieve transactions by grouping with an MHD Document Consumer and using the Find Document Lists, Find Document References and Retrieve Document transactions. For details see Section 18.2.3.3
A Responding Gateway MAY use non-IHE interactions to collect local information in response to a Cross Gateway Query or Cross Gateway Retrieve. These proprietary interactions are not further described within any IHE profile.
| Editor: Apply the following updates to Section 18.2.3.2 Responding Gateway grouped with XDS Document Consumer with the following: |
Responding Gateways that are grouped with a Document Consumer:
When a Responding Gateway is not grouped with a Document Consumer it is expected to be using non-IHE specified interactions to collect local information in response to a Cross Gateway Query or Cross Gateway Retrieve. These proprietary interactions are not further described within any IHE profile.
| Editor: Add Section 18.2.3.3 Responding Gateway grouped with MHD Document Consumer with the following: |
Responding Gateways that are grouped with an MHD Document Consumer:
Table 18.2.3.3-1: XDS query mapping to MHD transactions
| XDS Query | MHD Transaction |
|---|---|
| FindDocuments | Find Document References |
| FindSubmissionSets | Find Document Lists |
| FindFolders | Find Document Lists |
| GetAll | Find Document References Find Document Lists |
| GetDocuments | Find Document References |
| GetFolders | Find Document Lists |
| GetAssociations | Find Document References Find Document Lists |
| GetDocumentsAndAssociations | Find Document References |
| GetSubmissionSets | Find Document Lists |
| GetSubmissionSetAndContents | Find Document References Find Document Lists |
| GetFolderAndContents | Find Document References Find Document Lists |
| GetFoldersForDocument | Find Document Lists |
| GetRelatedDocuments | Find Document References |
| FindDocumentsByReferenceId | Find Document References |
Figure 18.2.3.3-1: Responding Gateway grouped with MHD Document Consumer
| Editor: Apply the following updates to Section 27.2 XCPD Actor Options with the following: |
Options that may be selected for this Integration Profile are listed in Table 27.2-1 along with the actors to which they apply. Dependencies between options when applicable are specified in notes.
Table 27.2-1: XCPD - Actors and Options
| Actor | Options | Vol. & Section |
|---|---|---|
| Initiating Gateway | Asynchronous Web Services Exchange | ITI TF-1: 27.2.1 |
| Deferred Response | ITI TF-1: 27.2.2 | |
| Responding Gateway | Deferred Response | ITI TF-1: 27.2.2 |
| MHDS Federation Option | ITI TF-1: 27.2.3 |
| Editor: Add Section 27.2.3 MHDS Federation Option with the following: |
Grouping with a Patient Demographics Consumer is used in situations where a Responding Gateway belongs to a MHDS community which defines document sharing using the MHD Profile.
When a Responding Gateway belongs to an MHDS community, it may resolve Cross Gateway Patient Discovery transactions by grouping with a Patient Demographics Consumer implementing either the Match Operation Option and using the Patient Demographics Match [ITI-119] transaction or implementing the Patient Search Option and using the Mobile Patient Demographics Query [ITI-78] transaction.
When a Responding Gateway is not grouped with a Patient Demographics Consumer it is expected to be using non-IHE specified interactions to collect local information in response to a Cross Gateway Patient Discovery. These proprietary interactions are not further described within any IHE profile.
Figure 27.2.3-1: Responding Gateway grouped with Patient Demographics Consumer
| Editor: Add section 3.38.4.1.3.3 MHD Grouping Considerations with the following: |
When multiple codes are allowed in the FHIR Resource but the XDS metadata supports only a single code (E.g., DocumentReference.type mapped to DocumentEntry.typeCode), the Responding Gateway SHALL select one of the codes to use in XDS metadata. The Responding Gateway SHALL select a code that matches the inbound query. If multiple codes match the inbound query, or the inbound query did not specify the relevant parameter, then the Responding Gateway SHOULD select the code that is deemed to be the best representation according to its business rules.
The CodeableConcept FHIR datatype allows for the assignment of codes with similar meanings to accommodate systems with differing vocabularies. There is no equivalent in XDS metadata, so implementers should be aware that the equivalence of codes will be lost when converting to XDS.