Document Subscription for Mobile (DSUBm)
1.0.0 - Trial-Implementation
This page is part of the Document Subscription for Mobile (DSUBm) (v1.0.0: Publication) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions
This section corresponds to the Resource Publish [ITI-111] transaction of the IHE Technical Framework. The Resource Publish [ITI-111] transaction is used by the Resource Notification Publisher and Resource Notification Broker Actors. This transaction is used to communicate events about DocumentReference, Folder type List and SubmissionSet type List Resources.
The Resource Publish [ITI-111] transaction delivers information from the Resource Notification Publisher to the Resource Notification Broker about events regarding DocumentReference, Folder type List and SubmissionSet type List resources. This information can be evaluated by the Resource Notification Broker against active Subscriptions and which MAY trigger a notification.
Table 2:3.111.2-1: Actor Roles
Actor | Role |
---|---|
Resource Notification Publisher | Publishes information to the Resource Notification Broker when applicable events occur about DocumentReference, Folder type List and SubmissionSet type List resources for which a subscription MAY exist |
Resource Notification Broker | Receives and processes information about events for which there MAY be a subscription |
FHIR-R4 HL7 FHIR Release 4.0.1
This method uses an HTTP POST method on the target Resource Notification Broker endpoint to communicate a event that MAY have a subscription.
When an event occurs for which a Subscription MAY exist, the Resource Notification Publisher will trigger a Resource Publish Request message to the Resource Notification Broker. The basic events that could trigger this message are:
Note that these events could be determined by DocumentEntry and SubmissionSet Objects events in an XDS environment.
When the Resource Notification Publisher supports the DocumentReference Subscription for Minimal Update Option, in addition to the basic events, events that could trigger this message also are:
Note that also these events could be determined by DocumentEntry Objects events in an XDS environment.
When the Resource Notification Publisher supports the DocumentReference Subscription for Full Events Option, in addition to the basic events, events that could trigger this message also are:
Note that also these events could be determined by DocumentEntry Objects events in an XDS environment.
When the Resource Notification Publisher supports the Basic Folder Subscription Option, in addition to the basic events, events that could trigger this message also are:
Note that also these events could be determined by Folder and Association Objects events in an XDS environment.
When the Resource Notification Publisher supports the Folder Subscription for Minimal Update Option, in addition to the basic events, events that could trigger this message also are:
Note that also these events could be determined by Folder and Association Objects events in an XDS environment.
When the Resource Notification Publisher supports the Folder Subscription for Update Option, in addition to the basic events, events that could trigger this message also are:
Note that also these events could be determined by Folder and Association Objects events in an XDS environment.
When the Resource Notification Publisher supports the Folder Subscription for Full Events Option, in addition to the basic events, events that could trigger this message also are:
Note that also these events could be determined by Folder and Association Objects events in an XDS environment.
The Resource Notification Publisher SHALL initiate a FHIR “transaction” using a “create” action by sending an HTTP POST request method composed of a FHIR Bundle Resource containing: one SubmissionSet type List Resource
; zero or more DocumentReference Resources
; zero or more Folder type List Resources
.
The Bundle resource SHALL contain all the FHIR resources related to the event that has occurred in the Bundle.entry
element.
The media type of the HTTP body SHALL be either application/fhir+json
or application/fhir+xml
.
See http://hl7.org/fhir/R4/http.html#transaction for complete requirements of a transaction. See http://hl7.org/fhir/R4/bundle-transaction.html for example of a transaction Bundle.
The Provide Document Bundle message is sent to the base URL as defined in FHIR. See http://hl7.org/fhir/R4/http.html for the definition of “HTTP” access methods and “base”.
It is possible to use HTTP protocol or HTTPS protocol. The HTTPS protocol is highly recommended.
For complete information on constructing a FHIR Bundle Resource, see http://hl7.org/fhir/R4/bundle.html.
For the basic events, the FHIR Bundle SHALL be conform to the Minimal Metadata Bundle of Provide Document Bundle [ITI-65] transaction of MHD Profile.
When supported the DocumentReference Subscription for Minimal Update Option the FHIR Bundle that SHALL be used for transmitting the DocumentReference Subscription for Minimal Update Trigger Events SHALL have the following constraints:
entry
of SubmissionSet type List, DocumentReference and Folder type List, the request.method
element SHALL be valued according with the event regarding the resourceWhen the DocumentReference Subscription for Full Events Option is supported the FHIR Bundle that SHALL be used for transmitting the DocumentReference Subscription for Full Events Option Trigger Events SHALL be the Extended Publishing Bundle.
When the Basic Folder Subscription Option is supported the FHIR Bundle that SHALL be used for transmitting the Subscription with Basic Folder Subscription Option Trigger Events SHALL be conform to the Minimal Metadata Bundle of Provide Document Bundle [ITI-65] transaction of MHD Profile.
When the Folder Subscription for Minimal Update Option is supported the FHIR Bundle that SHALL be used for transmitting the Folder Subscription for Minimal Update Option Trigger Events SHALL be conform to the Minimal Metadata Bundle of Provide Document Bundle [ITI-65] transaction of MHD Profile.
When the Folder Subscription for Update Option is supported the FHIR Bundle that SHALL be used for transmitting the Folder Subscription for Update Option Trigger Events SHALL be conform to the Minimal Metadata Bundle of Provide Document Bundle [ITI-65] transaction of MHD Profile.
When the Folder Subscription for Full Events Option is supported the FHIR Bundle that SHALL be used for transmitting the Folder Subscription for Full Events Option Trigger Events SHALL be the Extended Publishing Bundle.
The Resource Notification Broker SHALL accept both media types application/fhir+json
and application/fhir+xml
.
The Resource Notification Broker SHALL process the bundle atomically as specified in http://hl7.org/fhir/R4/http.html#transaction.
The Resource Notification Broker SHALL validate the Bundle first against the FHIR specification. Guidance on what FHIR considers a valid Resource can be found at http://hl7.org/fhir/R4/validation.html.
If necessary for processing, the Resource Notification Broker SHALL retrieve Resources referenced by absolute URLs in the FHIR Bundle Resource.
If the Resource Notification Broker validations failed, the Resource Notification Broker SHALL return an error, as documented in Resource Publish Response Message.
If the validation of the Resource Publish Request Message is completed, the Resource Notification Broker SHALL evaluate the DocumentReference, the Folder type List and the SubmissionSet type List Resources that are present in the Bundle against the active Subscriptions. The Resource Notification Broker MAY not care about the other resources present in the Bundle. If there are matching subscriptions, the Resource Notification Broker SHALL send the Event Notification Message [ITI-112] to the appropriate Resource Notification Recipient.
The Resource Notification Broker sends a Resource Publish Response Message to respond to a Resource Publish Request Message.
The Resource Notification Broker has received a Resource Publish Request Message.
The Resource Notification Broker SHALL return a Bundle, with type
set to transaction-response
, that contains one entry for each entry in the request, in the same order as received, with the Bundle.entry.response.outcome indicating the results of processing the entry. TheResource Notification Broker SHALL comply with FHIR http://hl7.org/fhir/R4/bundle.html#transaction-response and http://hl7.org/fhir/R4/http.html#transaction-response.
To indicate success the overall http 200
response is used. The Bundle.entry.response.status
SHALL be 201
and the location element SHALL be populated if the Resource has been created or deleted. The Bundle.entry.response
.status SHALL be 200
and the location element SHALL be populated if the Resource has been updated.
The Resource Notification Publisher processes the results according to application-defined rules.
The Resource Notification Publisher implementing this transaction SHALL provide a CapabilityStatement Resource as described in ITI TF-2x: Appendix Z.3 indicating the transaction has been implemented. The possible CapabilityStatements for the Resource Notification Publisher are listed in Section 1:54.1.1.3 Resource Notification Publisher.
The Resource Notification Broker implementing this transaction SHALL provide a CapabilityStatement Resource as described in ITI TF-2x: Appendix Z.3 indicating the transaction has been implemented. The possible CapabilityStatements for the Resource Notification Broker are listed in Section 1:54.1.1.1 Resource Notification Broker.
See DSUBm Security Considerations.
It is highly RECOMMENDED that the Resource Notification Publisher SHOULD use some form of authentication method when sending the Resource Publish Request Message. The Resource Notification Broker SHOULD always verify the authentication token used in this transaction before considering the message received.
The Resource Notification Publisher, when grouped with ATNA Secure Node or Secure Application Actor, SHALL be able to record fundamental AuditEvents for Resource Notification Publisher Publish, when performing this transaction.
The Resource Notification Broker, when grouped with ATNA Secure Node or Secure Application Actor, SHALL be able to record fundamental AuditEvents for Resource Notification Broker Publish, when performing this transaction.