Difference between revisions of "Mobile access to Health Documents (MHD)"

From IHE Wiki
Jump to navigation Jump to search
(updated link to ITI TF)
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
defines a simple HTTP interface to a [[Document Sharing]] environment.
 
__TOC__
 
__TOC__
  
 +
==Formal Specification==
  
==Status==
+
===[https://profiles.ihe.net/ITI/TF/Volume1/ch-33.html MHD (html/IG) specification]===
The IHE MHD profile and the HL7 FHIR activities are working together to revise and enhance the transactions profiled here. For details on HL7 FHIR See http://hl7.org/fhir
+
* [https://profiles.ihe.net/ITI/TF/Volume1/ch-33.html Trial Implementation]
  
 
+
==Open Source==
==Summary==
+
https://oehf.github.io/ipf-docs/
 
 
'''Mobile access to Health Documents (MHD)''' profile defines a simple HTTP interface to a [[Document Sharing]] environment. The MHD profile is intended for any system that prefers the simplified HTTP RESTful technology rather than the more robust technology used in XDS. It defines transactions to
 
# submit a set of documents and metadata from the mobile device to a document receiver,
 
# find the document submission set metadata based on query parameters;
 
# find document entries containing metadata based on query parameters, and
 
# retrieve a copy of a specific document.
 
 
 
These transactions leverage the document content and format agnostic metadata concepts from XDS, but simplify them for access by constrained environments such as mobile devices, or other resource constrained systems. The MHD profile does not replace XDS.  It can be used to allow mobile devices, or other resource constrained systems, access to an XDS health information exchange. The following figure shows one possible way to implement MHD with a document sharing environment (that may, but is not necessarily, XDS based). This implementation choice is not mandatory and we recognize other architectures will be implemented.
 
 
 
==Benefits==
 
 
 
'''RESTful interface to XDS and other Document Sharing environments'''
 
 
 
The Mobile access to Health Documents (MHD) Profile defines one standardized interface to health documents (a.k.a. an Application Programming Interface (API)) for use by mobile devices so that deployment of mobile applications is more consistent and reusable. The transactions defined here leverage the document content- and format-agnostic metadata concepts from XDS, but simplify them for access in constrained environments including mobile devices. The MHD Profile does not replace XDS. Mobile devices, and other resource-constrained systems, can use MHD to access to an XDS Repository. The following figure shows one possible way to implement MHD within a document sharing environment (that may be, but is not necessarily, XDS-based). This implementation choice is not mandatory and we recognize other architectures will be implemented.
 
 
 
The XDS Profile has separated Document Registry and Document Repository to support the needs of Cross-Enterprise deployment architectures and enable robustness, security, privacy, and interoperability. The MHD Profile has simplified the interactions in ways that are more consistent with use within a single policy domain. MHD transactions are not specifically tied to XDS; some of the system implementations envisioned may interface directly to an organizational EHR, or a multi-national PHR.
 
 
 
The MHD Profile supports a broad set of XDS use cases and functionality while keeping the technology as simple as possible. MHD focuses on a useful subset of the XDS use cases and does not try to reproduce the full scalability, flexibility, privacy, or security supported by the more robust XDS infrastructure. The following are examples of environments which may choose the MHD Profile over the XDS Profile:
 
 
 
* Medical devices such as those targeted by the Patient Care Devices (PCD) domain or Continua organization, submitting data in the form of documents.
 
* Kiosks used by patients in hospital registration departments, where it is anticipated that a hospital staff member will review, edit, and approve the document before it is allowed into the hospital system.
 
* PHR publishing into a staging area for subsequent import into an EHR or HIE.
 
* Patient or provider application that is configured to securely connect to a PHR in order to submit a medical history document. (For example BlueButton+)
 
* Electronic measurement device participating in an XDW workflow and pulling medical history documents from an HIE.
 
* A General Practitioner physician’s office with minimal IT capabilities using a mobile application to connect to an HIE or EHR.
 
 
 
==Details==
 
 
 
Applications specific to resource-constrained and mobile devices are an emerging platform for healthcare-enhancing software. The MHD Profile is not limited to mobile devices, using the term “mobile” only as a grouping for mobile applications, mobile devices or any other systems that are resource and platform-constrained. These constraints may drive the implementer to use simpler network interface technology. There are numerous deployed implementations of Document Sharing that need a simpler network interface technology, for example those hosted by a Health Information Exchange (HIE), large health provider electronic health record (EHR), or personal health record (PHR).
 
 
 
The Mobile access to Health Documents (MHD) Profile defines one standardized interface to health documents (a.k.a. an Application Programming Interface (API)) for use by mobile devices so that deployment of mobile applications is more consistent and reusable. In this context, mobile devices include tablets, smartphones, and embedded devices including home-health devices. This profile is also applicable to more capable systems where needs are simple, such as pulling the latest summary for display. The critical aspects of the ‘mobile device’ are that it is resource-constrained, has a simple programming environment (e.g., JSON, JavaScript), simple protocol stack (e.g., HTTP), and simple display functionality (e.g., HTML browser). The goal is, in part, to avoid burdening the client with additional libraries such as those that are necessary to process SOAP, WSSE, MIME-Multipart, MTOM/XOP, ebRIM, and multi-depth XML.
 
 
 
The Mobile access to Health Documents (MHD) Profile defines one pair of actors and a transaction to submit or push new “document entries” from the mobile device to a receiving system. Another set of actors and transactions is used to query a list of “document entries” having specific metadata, and to retrieve a document.
 
 
 
This profile leverages the metadata concepts from XDS, but simplifies the transaction requirements for access by mobile devices.
 
The MHD Profile does not replace XDS. Rather, it enables simplified access by mobile devices to an XDS (or a similar) document management environment containing health information.
 
 
 
 
 
===Options===
 
Two options are defined
 
* Comprehensive Metadata -- Indicates that the actors will abide by the XDS definition of metadata cardinality (not minimal metadata)
 
* XDS on FHIR -- Indicates that the actors are expecting XDS implementation behind the Document Responder and Document Recipient.
 
 
 
===Proxy Service===
 
 
 
One deployment model is to use the MHD as a FHIR based API to XDS, thus more friendly to applications. This is defined as the "XDS on FHIR" Option. In this option the MHD Document Responder is responsible for converting the XDS metadata into MHD metadata. This Document Responder is thus responsible for setting the DocumentReference.content.attachment.url so that a Document Consumer simply requests the document from that URL. This URL is fully in the control of the Document Responder. Thus the Document Responder might choose to encode the XDS Document Repository ID and the Document UniqueID into the URL. It might encode them as query parameters in a URL. The Document Responder might alternatively use UUIDs that it keeps a mapping table. The URL might be rooted at the same or a different server endpoint as the Document Responder. The important point is that the Document Responder is empowered to fill the URL anyway it wants. The URL must simply be used by the Document Consumer, meaning the Document Consumer shall not try to interpret the URL, it should just GET.
 
 
 
[[Image:Slide1.PNG]]
 
 
 
==Systems Affected==
 
 
 
Systems involved in this profile are:
 
 
 
* Any application or service that would like to use RESTful interactions for Document Sharing.
 
 
 
'''Actors & Transactions:'''
 
 
 
[[file:MHD_Actors_Transactions.PNG|thumbnail|center|400px|'''Figure 33.1-1 MHD Actor Diagram''']]
 
 
 
==Specification==
 
 
 
'''Profile Status:''' [[Comments| Trial Implementation]] 
 
 
 
'''Documents:'''
 
[http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_Suppl_MHD.pdf MHD Supplement] Revised 2019-03-06
 
 
 
'''Additional Supplements:'''
 
[http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_Suppl_Appx-Z.pdf Appendix Z on HL7 FHIR] Revised 2019-03-06
 
 
 
'''Underlying Standards:'''
 
* HL7 FHIR R4 http://hl7.org/fhir/R4
 
** DocumentReference
 
** DocumentManifest
 
** List
 
** Patient
 
** Practitioner
 
** OperationOutcome
 
** Bundle
 
* RFC2616 IETF Hypertext Transfer Protocol – HTTP/1.1
 
* RFC3986 IETF Uniform Resource Identifier (URI): Generic Syntax
 
* RFC4627 The application/json Media Type for JavaScript Object Notation (JSON)
 
* RFC6585 IETF Additional HTTP Status Codes
 
 
 
==FHIR Implementation Guide==
 
Informatively this profile is also as a set of FHIR conformance resources, that are also registered at https://registry.fhir.org
 
 
 
The conformance resources are also available on the [[Implementation Material]] folder.
 
 
 
==Test Tools==
 
See [[IHE Test Tool Information]]
 
 
 
Bill's notes https://github.com/usnistgov/iheos-toolkit2/wiki/MHD-Testing-Notes
 
* Bill's notes [https://github.com/usnistgov/iheos-toolkit2/wiki/MHD-Testing-at-2018-North-American-Connectathon from 2018 North American Connectathon]
 
  
 
==See Also==
 
==See Also==
Line 118: Line 27:
 
[[Category:DocShare]]
 
[[Category:DocShare]]
  
Current: [[Frameworks#IHE IT Infrastructure Technical Framework| IT Infrastructure Technical Framework]].
+
Current: [https://profiles.ihe.net/ITI/ IT Infrastructure Technical Framework].

Latest revision as of 10:14, 9 December 2022

defines a simple HTTP interface to a Document Sharing environment.

Formal Specification

MHD (html/IG) specification

Open Source

https://oehf.github.io/ipf-docs/

See Also

This profile supports the security/privacy model discussed in Health Information Exchange: Enabling Document Sharing Using IHE Profiles white paper.


Related Profiles

  • PDQm -- provides HTTP (RESTful) equivalent to PDQ and PDQv3; and basis set of FHIR methods and data-types
  • IUA -- provides user token security for HTTP (RESTful) transactions

This page is based on the Profile Template

Current: IT Infrastructure Technical Framework.