Interfaces

Feature #30131 - Configurable support for updating unscheduled orders

Summary

This minor enhancement to Interfaces merges EMR functionality into this release as was updated in v3.2021.2.15 for the new EMR framework, and introduces a new configuration option for enabling the functionality introduced with Feature #23948 - Support updating a scheduled order via the interface introduced in v3.2018.3.1.

A new EIS_EMROrderUpdatesEnabled RIS System Config setting has been introduced to control whether the interface will permit updates to EMR orders to be processed or just ignored completely. This setting defaults to False, and only customers upgrading from v3.2018.3.x that were previously using this functionality will need to enable this system config. All other customers can leave it disabled to maintain the EMR behavior provided in v3.2021.3.15 release.

Usage

Scenarios and expected outcomes:

1.    Sending an order update to a non scheduled EMR order

1.    EIS_EMROrderUpdatesEnabled = False:

1.    error not thrown, audit entry created

2.    EIS_EMROrderUpdatesEnabled = True:

1.    update accepted, no "error" audit entry

2.    Sending an order update to a non scheduled non-EMR order

1.    EIS_EMROrderUpdatesEnabled is irrelevant

2.    Update will be accepted and applied

3.    Sending an order update to a scheduled EMR order

1.    EIS_EMROrderUpdatesEnabled = False:

1.    error not thrown, audit entry created, attributes irrelevant

2.    EIS_EMROrderUpdatesEnabled = True:

3.    if auto_cancel_scheduled_studies and auto_cancel_reason_code are specified: update accepted, no exception, studies cancelled

4.    if attributes not provided: update rejected, exception thrown

4.    Sending an order update to a scheduled non-EMR order

1.    EIS_EMROrderUpdatesEnabled is irrelevant

2.    if auto_cancel_scheduled_studies and auto_cancel_reason_code are specified: update accepted, no exception, studies cancelled

3.    if attributes not provided: update rejected, exception thrown

Service Team Upgrade Instructions

The Service Team must complete the following actions to deploy this feature:

No Service Team actions are necessary to deploy this feature; however, optional configuration is available:

(exclude if none)

RIS Client

The following related settings were added or updated:

Changes to RIS ParagraphConfig Settings

Web Services

(applicationsettings.config, settings.config, rRISServices.exe.config / rRISServices64.exe.config)

Portals

(applicationsettings.config, web.config)

Digital Forms

(web.config)

Configuration Instructions

No System Administrator actions are necessary to enable this feature; however, optional configuration is available:

RIS Client

Changes to RIS System Configuration Settings

ยท         If upgrading from v3.2018.3.x and utilizing the functionality introduced with Feature #23948 - Support updating a scheduled order via the interface, then enable EMROrderUpdatesEnabled for your site.

The following related settings were added or updated:

Setting

Default

Purpose

EIS_EMROrderUpdatesEnabled

Value=Boolean, Default=[FALSE]

When True the interface will return an exception if a 3rd party system attempts to update a scheduled EMR order via the interface without enabling the auto cancel functionality on the message itself, all other order updates will be accepted. When False any attempt to update an EMR order, scheduled or not, will result in an audit entry and ignoring of any changes. Added in v3.2021.7.5 #30131