Document Subscription for Mobile (DSUBm)
1.0.0 - Trial-Implementation International flag

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

CapabilityStatement: DSUBm Resource Notification Broker Actor

Official URL: https://profiles.ihe.net/ITI/DSUBm/CapabilityStatement/IHE.DSUBm.ResourceNotificationBroker Version: 1.0.0
Active as of 2023-10-27 Computable Name: IHE_DSUBm_ResourceNotificationBroker

The DSUBm Resource Notification Broker Actor CapabilityStatement requirements expresses the requirements that SHALL be provided.

  • Using FHIR R4
  • SHALL support both json and xml encoding
  • SHOULD use a security framework. Recommend ATNA, encouraged IHE-IUA or SMART-app-launch
  • SHALL support the ITI-110 transaction and support the basic type of Subscription and related SubscriptionTopic
  • MAY support the ITI-111 transaction
  • SHALL support the ITI-112 transaction:
    • SHALL support Handshake Notification
    • SHOULD support Heartbeat Notification
    • SHALL support Event Notification
    • SHOULD support Subscription Deactivation Notification
  • SHALL support the ITI-113 transaction:
    • SHALL support the following Search Parameters
      • _id
      • status
      • url
      • filter-criteria
      • topic
    • SHALL support the DSUBm $status operation
    • SHOULD support the DSUBm $events operation
  • SHALL support the ITI-114 transaction:
    • SHALL support the following Search Parameters
      • code
      • _id
      • resource
      • derived-or-self
      • status
      • url

Raw OpenAPI-Swagger Definition file | Download

IHE DSUBm ResourceNotificationBroker

  • Implementation Guide Version: 1.0.0
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+xml, application/fhir+json
  • Supported Patch Formats:
  • Published on: Fri Oct 27 00:00:00 CDT 2023
  • Published by: IHE IT Infrastructure Technical Committee

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as "SHALL NOT". A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

REST Configuration 1

Mode: server

DSUBm Resource Notification Broker provides capability to receive subscription, receive the stream of events, receive Subscription and SubscriptionTopic Resource search

Security

Recommend ATNA, encouraged IHE-IUA or SMART-app-launch

Summary of System-wide Interactions
  • Supports the transaction interaction described as follows:

    https://profiles.ihe.net/ITI/MHD/StructureDefinition-IHE.MHD.Minimal.ProvideBundle.html

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
SubscriptionSupported profiles:
  Subscription for DocumentReference Patient-Dependent
  Subscription for DocumentReference Multi-Patient
  Subscription for SubmissionSet Patient-Dependent
  Subscription for SubmissionSet Multi-Patient		yyyy_id, status, url, filter-criteria, topic$events, $status
Basic yycode, _id, resource, derived-or-self, status, url
Resource Conformance: SHALLSubscription
Core FHIR Resource
Subscription
Reference Policy
Interaction summary
  • Supports read, create, update, search-type.

Supported Profiles

https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/DSUBm-DocumentReference-PatientDependent-Subscription
https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/DSUBm-DocumentReference-MultiPatient-Subscription
https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/DSUBm-SubmissionSet-PatientDependent-Subscription
https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/DSUBm-SubmissionSet-MultiPatient-Subscription

Documentation

Resource Subscription ITI-110 and Resource Subscription Search ITI-113

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idstring

The id of the Subscription

SHALLstatustoken

The current state of the subscription

SHALLurluri

The URI that will receive the notifications

SHALLfilter-criteriastring

This SearchParameter enables query of subscriptions by filter criteria

SHALLtopicuri

This SearchParameter enables query of subscriptions by canonical topic-url

 
Extended Operations
ConformanceOperationDocumentation
SHALL$status

The Response Bundle SHALL be conformed with https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/DSUBm-StatusOperation-Bundle

SHOULD$events

The Response Bundle SHALL be conformed with https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/DSUBm-EventsOperation-Bundle

Resource Conformance: SHALLBasic
Core FHIR Resource
Basic
Reference Policy
Interaction summary
  • Supports read, search-type.

Documentation

Resource SubscriptionTopic Search ITI-114: The Resource Notification Broker Actor SHALL support the canonical instances of SubscriptionTopic presented in the DSUBm profile. See here

Search Parameters
ConformanceParameterTypeDocumentation
SHALLcodetoken

Kind of Resource

SHALL_idstring

The id of the SubscriptionTopic

SHALLresourceuri

Allowed Data type or Resource (reference to definition) for this definition, searches resourceTrigger, eventTrigger, and notificationShape for matches.

SHALLderived-or-selfuri

A server defined search that matches either the url or derivedFrom

SHALLstatustoken

SHOULD be valued with active

SHALLurluri

Logical canonical URL to reference this SubscriptionTopic (globally unique)

 

REST Configuration 2

Mode: client

DSUBm Resource Notification Broker provides capability to send notification

Security

Recommend ATNA, encouraged IHE-IUA or SMART-app-launch

Summary of System-wide Interactions

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
BundleSupported profiles:
  Event Notification Bundle
  Handshake Notification Bundle
  Heartbeat Notification Bundle
  Subscription Deactivation Notification Bundle
Resource Conformance: supportedBundle
Core FHIR Resource
Bundle
Reference Policy
Interaction summary

    Supported Profiles

    https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/IHE.DSUBm.EventNotification
    https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/IHE.DSUBm.HandshakeNotification
    https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/IHE.DSUBm.HeartbeatNotification
    https://profiles.ihe.net/ITI/DSUBm/StructureDefinition/IHE.DSUBm.SubscriptionDeactivationNotification

    Documentation