Real Time Location Services Implementation Guide
1.0.0-ballot - CI Build International flag

Real Time Location Services Implementation Guide, published by HL7 International - Patient Administration Work Group. This is not an authorized publication; it is the continuous build for version 1.0.0-ballot). This version is based on the current content of https://github.com/HL7/rtls-ig/ and changes regularly. See the Directory of published versions

Specification

Page standards status: Trial-use Maturity Level: 3

Overview

This specification page details the technical requirements and behavior of this implementation for an integration between a RTLS and another system.

Enroll Tag

This event type is used to indicate to the RTLS that a subscribed non-RTLS system wants to receive updates for a specific tag’s location. It is assumed that an active rtlsSubscription resource corresponding to the rtlsSubscriptionTopic that the non-RTLS system is interested in already exists and was communicated.

FHIR Messaging Model

Enroll Tag messages shall utilize the FHIR messaging model.

  1. rtlsMessageBundle
  2. rtlsMessageHeader
  3. rtlsDevice

Unenroll Tag

This event type is used to indicate to the RTLS that a subscribed non-RTLS system no longer wants to receive updates for a specific tag’s location. It is assumed that an active rtlsSubscription resource corresponding to the rtlsSubscriptionTopic that the non-RTLS system is interested in already exists and was communicated.

FHIR Messaging Model

Unenroll Tag messages shall utilize the FHIR messaging model.

  1. rtlsMessageBundle
  2. rtlsMessageHeader
  3. rtlsDevice

Tag Location Update

This event type is used to send notifications from the RTLS, informing other systems of an updated location associated with one of the tags. The specific requirements for what constitutes an “updated location” is out of the scope of this IG, and is left to the implementing RTLS to define.

Subscription Notification Model

Location updates shall conform to subscription notification model, in which the RTLS server defines a “Location Update” event type using the rtlsSubscriptionTopic resource that a client (e.g. a EHR system) can subscribe to. Clients or non-RTLS systems subscribe to the pre-defined Location Update topic using the rtlsSubscription resource which establishes proactive event notifications from the RTLS server to the subscriber. Once a subscription is created, any RTLS event that matches the specified location update rtlsSubscriptionTopic and corresponds to a tag that the subscriber system has indicated interest in (see enroll/unenroll), shall result in a notification to be sent to the subscriber via FHIR messaging.

  1. rtlsSubscriptionTopic
  2. rtlsSubscription
  3. rtlsMessageBundle
  4. rtlsMessageHeader
  5. rtlsSubscriptionStatus
  6. rtlsDevice
  7. rtlsLocation