Configuring a Vocera Spacelabs CEI Adapter

These settings enable direct communication between the Vocera Spacelabs CEI Adapter and the Vocera Platform.

Select an empty field and begin typing, or select an existing value and type over it. To keep an existing value, do not edit that field.

  1. Access the Vocera Platform Web Console and navigate to the adapters.
  2. Select New Adapter in the Action menu, or select an adapter you wish to configure and then select Edit, to display the configuration fields. The configuration fields are the same for new and existing adapters.
  3. Navigate to the New Adapter option, or navigate to an existing adapter to edit. See Creating a New Adapter and Editing an Adapter for instruction as needed.
    The configuration fields are the same for new and existing adapters.
  4. Complete the configuration fields as described in the table.
    Configuration Field Description
    Component Name Click the Component Name field to display a list of the systems and devices that the Vocera Platform currently supports. Select the name of the adapter to create.
    Reference Name Enter a short descriptive name in the Reference Name field to uniquely identify an adapter instance. It may demonstrate the adapter function or other information; for example, Production adapter may differentiate a live adapter from a development or "sandbox" adapter.
    Enabled Select the Enabled checkbox to allow the Vocera Platform to use the new adapter. The Vocera Platform ignores the adapter if this option is disabled.
  5. Complete the Datasets Settings configuration fields as described in the table.
    Datasets Configuration Field Description
    Required Datasets If more than one dataset exists that meets the adapter's requirements, select the appropriate datasets for the new adapter to function correctly.

    The system searches for the datasets that meet the adapters requirements. If the datasets already exist, the system will use them. If the datasets do not exist, the system will create them automatically.

    Select Create in the drop-down menu to create a new dataset to meet the organization's requirements.

  6. Complete the General Settings configuration fields as described in the table.
    General Settings Configuration Field Description
    Server Host Name Enter the host name of the Spacelabs CEI server from which the adapter will receive Spacelab clinical events. This field is required. Use standard IP address format (xxx.xxx.xxx.xxx, where each xxx is a number from 0-255), or use standard FQDN format, such as smtp.gmail.com.
    Note: Only one server address is supported per adapter. Each Vocera Spacelabs CEI Adapter instance requires its own server host.
    Server Port Enter the number of the Spacelabs CEI server port on which the adapter will receive Spacelab clinical events. This field is required.
    Facility Enter the name of the facility from which Clinical Events will be received. This field is required. This value will be stored to both the "bed.unit.facility.name" and "bed.room.facility.name" attribute paths, as shown in the Bed Regex Mapping field.
    Alert Type Priority

    When more than one clinical event is received within a single message from Spacelabs, clinical events with the same Unit and Room/Bed will be evaluated to identify the event whose alert type is of the highest priority. The highest priority clinical event received within a single message from the Spacelabs CEI for a given Unit and Room/Bed will be compared to recently received events having the same Unit and Room/Bed Info to determine if the new event is of the highest priority.

    If a newly received clinical event is currently the highest priority alert for a given Unit and Room/Bed, then the activity state of the alert shall be stored as ACTIVE. If a newly received clinical event is not currently the highest priority alert for a given Unit and Room/Bed, then the activity state of the alert shall be stored as SUPPRESSED.

    Enter the list of alarm types, ranked in priority from high to low, captured from the event data of a clinical event.

  7. Complete the Location Types configuration fields as described in the table.

    Although only one location type is required to create the adapter, Implementation Specialists may add, clone, or modify location types as needed. If there are location types configured, one or more can be deleted. Location types can be reordered by dragging and dropping each into the preferred order.

    Select New Location Type to define the regular expressions needed to capture unit and bed data.
    Location Types Configuration Field Description
    Reference Name Enter a descriptive name to identify the location type. This field is required.
    Active Select the Active checkbox to indicate whether or not the location type is active.
    Bed Regex Enter the regular expression to capture values from the bed data of a clinical event received from the Spacelabs CEI server. This field is required.
    Bed Regex Mapping Enter the regex mapping from the capture groups of the Bed Regex to attribute paths starting from the Clinicals dataset. Both the “bed.bed_number” and “bed.room.room_number” attribute paths must be set in the Bed Regex Mapping field to support suppressing all but the highest priority clinical events.
    Unit Regex Enter the regular expression to capture values from the unit data of a clinical event received from the Spacelabs CEI server. This field is required.
    Unit Regex Mapping Enter the regex mapping from the capture groups of the Unit Regex to attribute paths starting from the Clinicals dataset.
    Add Location Type

    Select Add to create additional location types.

    Clone Location Type

    Select Clone to create a duplicate of the selected location type. The reference name of the cloned location type will automatically be unique, and will be set as inactive by default.

    Remove Location Type

    If one or more location type is created, the ability to remove a location type becomes active. Select Remove to delete the location type from the adapter configuration.

  8. Complete the Message Types Settings configuration fields as described in the table.

    The Vocera Spacelabs CEI Adapter message types include a regex mapping for the event data from the Spacelabs clinical event. The regex mapping stores the event data as a clinical alert. The type of alert is mapped to the attribute alert_type in the Clinicals dataset, and the additional details are mapped to the attributes clinical_details.detail_type and clinical_details.value in the ClinicalDetails dataset.

    Although only one message type is required to create the adapter, the Vocera Spacelabs CEI Adapter is configured to offer five different message types for critical alarm codes. Implementation specialists may add, clone, remove, or modify message types as needed. If there are multiple message types configured, one or more can be deleted. Message types can be reordered by dragging and dropping each into the preferred order. See Understanding Regular Expressions for an overview explanation and examples of Regex code and mappings.

    Select New Message Type to define the regular expressions needed to capture unit and bed data.

    Message Types Configuration Field Description
    Reference Name Enter a descriptive name for the message type. This field is required.
    Active Select the Active checkbox to indicate whether or not the message type is active.
    Regex Enter the regular expression to capture values from the event data of a clinical event received from the Spacelabs CEI server. This field is required. See Understanding Regular Expressions for an overview explanation and examples of Regex code and mappings.
    Regex Mapping Enter the regex mapping from the capture groups of the Regex to attribute paths from the Clinicals dataset. This field is required.
    Add Message Type

    Select Add to create additional message types.

    Clone Message Type

    Select Clone to create a duplicate of the selected message type. The reference name of the cloned message type will automatically be unique, and will be set as inactive by default.

    Remove Message Type

    If one or more message type is created, the ability to remove a message type becomes active. Select Remove to delete the message type from the adapter configuration.

  9. Select one of the available options to exit the adapter configuration page. See Saving an Adapter for details.