ACE 2016
AUGUST 9 – 11, 2016
Still Need to Upgrade to Common
Interface Engine? We’ll Show You How
Tuesday, August 9, 2016
Kevin Cahoon
Interface Analyst, Innovation and Delivery Center
Michael Krakow
Expert Technical Support Consultant, TouchWorks Support
Presenters
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 4
Session Learning Objectives
• Why Rhapsody/ Common Interface Engine (CIE)?
• Rhapsody Management Console Overview
• Reconciler Overview
• How do I?
• Upgrades – “Super Kit”
• Rhapsody (CIE) Interface Education Class
• Q&A
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 5
Continuation of ConnectR Support• Microsoft’s Maintenance on Windows Server 2003 software ended on August
1st 2015.
• Known issues with workarounds for ConnectR installations on Windows 2008.
• GE does not support ConnectR because the OS it runs on is at end of life.
TouchWorks EHR development does not have the ability to support or modify
ConnectR.
• Server Upgrade Options:
– Migrate to CIE (Recommended).
– Install ConnectR on Windows 2008 R2.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 6
TouchWorks 17.1 SES Changes
Questions:
• Is Allscripts formally dropping support for ConnectR?
– Support will provide “best effort” support, but Allscripts is ultimately not
responsible for supporting the ConnectR engine.
• Are all ConnectR clients required to upgrade in advance of (or at the time
of) the TouchWorks EHR 17.1 upgrade?
– No, TouchWorks EHR 17.1 does not require a change to the interface
server.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 7
Allscripts’ Choice for CIE
Ease of Maintenance• No additional SQL requirements or SQL License
• Runs on recent browsers: Chrome, Firefox, IE 12, Safari
• Orion continues to develop and enhance the Rhapsody Engine
Functionality Enhancements
• No file size limitation for large documents
• CIE Interface & Reconciler Integration
Rhapsody Management Console
Overview
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 9
Rhapsody Management Console
The management console is a user-friendly web
application to:
• Monitor interface connections
• View lookup tables
• Run backups
• Resend messages when needed
• Run audit and performance reports
• Configure notifications
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 10
Rhapsody Management Console
• Accessible via any internet
browser.
• Rhapsody server URL can
be accessed from any
machine.
• Different security profiles
available.
Your Engine Name Here
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 11
Management Console Toolbar
• Expandable and collapsible sections.
• Grouped by similar tasks:
– Monitoring
– Find Messages
– Notifications
– Management
– System State
– Reports
Monitoring • Find Messages • Notifications • Management
System State • Reports
Monitoring Engine and Interfaces
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 13
Engine Monitor Page
Monitoring
The first screen after login
by default is the Engine
Monitor.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 14
Engine Monitor Page - Warnings
Monitoring
• By Escalation Status
• By Watchlist
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 15
15
Communication Points
Monitoring
Quickly toggle list to view
Stopped or Running
Communication Points are
usually an interface to an
external system.
• TCP/IP
• File Directory
• FTP/ SFTP
• Database
• *Sinks*
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 16
16
Start or Stop Communication Points
Monitoring
• Select all or some communication
points with a checkbox. Click start
or stop hyperlink (not shown)
• Start or stop a single
communication point with the action
hyperlink.
• Click anywhere in a row to display
Communication Point Properties,
from where you can also start and
stop.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 17
17
Communication Points Queues
Quickly view Current Statistics
• Connections
• In Queue
• Out Queue
• Received (reset allowed)
• Sent (reset allowed)
• Idle Time
Monitoring
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 18
Routes Queues
Monitoring
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 19
Routes Queues
Monitoring
Quickly view Current Statistics
• Waiting
• Currently Processing
• Total Processed
• Idle Time
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 20
Routes Status Icons
Monitoring
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 21
System Monitor Page• Throughput
Graph
• Available
Disk Space
Graph (not
shown)
• Rhapsody
Heap
Memory
Graph (not
shown)
Monitoring
Change the view window to
All, 30 days, 7 days, 24
hours, 1 hour or a specific
time frame.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 22
System Monitor Page
• System Specific
Notification & Thresholds
Settings
Monitoring
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 23
Error queue
Messages which have
failed unexpectedly
within the Route
• Connectivity Issues
• Mapping issues
• Invalid Data Types
• Standard Interface
Errors will not
appear here
Monitoring
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 24
Message Event with Errors
• Viewing the
message shows
where the message
failed in the route.
• Helps pinpoint
where you can
troubleshoot from
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 25
Error DescriptionThere is a link next to the component. Clicking the link will open a description of the error which is
useful for troubleshooting.
Searching in the Message Store
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 27
Types of Searching (Messages)
Find
Messages
Three delivered search
types:
• Input search
• Output search
• Route Search
• Input – allows you to
search the incoming
message content for
strings.
• Output – allows you
to search output
message content.
• Route Search – allows
you to search
properties and
message body content
within the route.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 28
Searching by date
Find
Messages
Time Frame search
• To and from date
• To and from time
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 29
Adding components
Find
Messages
1. Click on the folder icon.
2. Check the components to
include.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 30
Search Filter
Find
Messages
• Next to “Message
contains” enter a
string
• The value must
appear somewhere in
the message body.
• Allows you to search a
string such as MRN
across multiple
interfaces.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 31
Editing the parameters of Message Search
Find
Messages
Advanced Search options
allows you to add more
search parameters on the
fly.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 32
Message view
• Message Events show
the path the message
followed in the
interface.
• Displays each step
through communication
points, routes and
route filters with a
new tree.
• Helps pinpoint specific
points in message
transformation
Management, System State &
Notifications
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 34
Lookup Tables
Management
Import or Export using the
Action Pane.
View values by Single
clicking on the Lookup table
name.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 35
Lookup Values & Lookup Failures
Management
• Values listed at the top.
• Failures listed at the
bottom.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 36
Archive Cleanup
A single criteria for
purging of messages
across all routes.
• Recommended:
• 30 days.
• Daily schedule.
• Caveat -- Messages in
the Error Queue do
not get Archived with
the cleanup. Management
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 37
Backup and Restore
• Save Full and
Incremental
schedules.
• Ability to restore
specific areas:
• Administration
Details
• Configuration
(mappings)
• Message Store Management
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 38
System Log
Warnings, Errors or
Info on System
Events such as:
• Backup
Success
• Cleanup
Completed
• Component
Events
System State
Select Level of
Severity from: All, Info,
Fatal, Warnings etc.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 39
Audit Logs
Examples of
Logged
Information:• User access or
failures
• Lookup table
changes
• Message views
and message edits
• Component check-
out and check-inSystem State
Audit only a specific
person’s activity.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 40
Watchlist
• Groups users and
components together.
• Allows different job roles
to receive notifications for
different interfaces.
• Notifications include
stopped interfaces, error
queue messages,
performance alerts, etc.
Notifications
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 41
Notifications: Delivery Methods
• SMTP email notification
• SNMP
• Format options for SMS
or Pager
Notifications
Required fields:
• Email Server
• Port
• From Address
• Flood Control
Reconciler
Part II
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 43
TouchWorks Reconciler
The Reconciler is an Error Worklist right in the TouchWorks
application
• New tab on the Queue Admin HTB
• View message details
• Refile
• Remove
• Bridge
• Search Errors
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 44
Reconciler (New Menu 11.3+)
The Error Queue
tab comes pre-
loaded in the
Queue Admin
Horizontal Tool Bar.
To add the page to
a users view:
• Add the Queue
Admin HTB to
an existing VTB
• Or add the
Error Queue
Document to an
existing HTB.
(Admin-Menus)
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 45
Reconciler – User security• Read security is
granted via
Interface Error
Queue View
• Read/Write
security is granted
via Interface Error
Queue Edit security
classifications.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 46
New MRN and Patient Name Fields
A nice
improvement in
functionality, the
message list
shows the Patient
Name and MRN!
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 47
Details Button
Click Details button in the
bottom toolbar to launch
a details dialog.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 48
Details
Displays:
• Source
Message
• Target
Message
• Error
Description
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 49
Bridging
Highlight
Message with the
suspension
“bridge” icon.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 50
Reconciler Bridging
• Same look and
feel as the
ConnectR Bridge
tool.
• Select your
patient and then
click Refile.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 51
Reconciler Filters and SearchesString filter fields
allow you to search
by Patient Name,
MRN, Other, Other2,
DOB and SSN
Drop down filters to
immediately view by
Interface, Interface
Type, Error
Search across
multiple interfaces at
the same time
How do I?
Part III
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 53
Example
• The Radiology vendor has
received an Order
message but the Insurance
carrier code is wrong.
• They’ve sent you a copy of
the HL7 message with the
IN1 segment highlighted.
• They do not have 317
listed as a carrier id in
their system. This carrier is
listed as L_AMC in their
system.
MSH|^~\&|AHSEHR|TEST|Radiology||20150626173228||ORM^O01|1986|
T|2.3|||Y<13>
PID|1||6839||Test^Molly^^||19630323|F|||25 Green Mountain Drive ^^South
Burlington^VT^05403|||||||v1789|555-55-5555
PV1|1|OP|^TouchW orks
Clinic||||123^Allscripts^AppAdmin|123^Allscripts^AppAdmin|||||||||||v1789||||
|||||||||||||||||||3^TouchW orks||20150515140600
IN1|1||317|ACM|535 Griswold Street Suite 111-
605^^Detroit^MI^48226||(888)881-
8010|999999999ZZ||||||||Test^Molly||||||||||||||||||||111111111AB|||||||||||T
GT1|1||Test^Molly|||||19630323|F||^|555-55-5555
ORC|NW |TW 14360||1394|Active||||20150626173228|||123^Allscripts^AppA
dmin|||||3^TouchW orks||||^TouchW orks Clinic
OBR|1|TW 14360||TW MRSPINE^CT Scan Of The Lumbar
Spine||20150525010006|20150525010006|||||||||123^Allscripts^AppAdmin||
|1394||||||||^^^^^R
DG1|1|ICD|S21.202S|Back avulsion
OBX|1|TX
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 54
Carrier ID Lookup
1. Use the Search box to
find the Radiology lookup
tables.2. Use the name of the table
and the description of the
purpose to locate the table.
1
1
2
2
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 55
Check Lookup Failures• Existing table values are in
the top. ‘317’ does not
appear in the list.
• Lookup failures appear in
the bottom. The ‘317’
lookup was attempted but
there was not a
corresponding value in the
lookup values so it was
logged as a lookup failure.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 56
Move LookupFailure
1. Click Add Next to the
Lookup Failure for 317
2. Enter the missing translation
target value (L_AMC).
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 57
Lookup Failure
The lookup failure is
gone and the new entry
appears in the top.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 58
Locate Original Message by Searching• Use the calendar
and clock icons to
specify the
timeframe.
• Use the route
folder icon to
select a route.
• Type a string filter
into the Message
contains text field.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 59
View the search Results
Click on the row to open
the message view.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 60
Confirm it is the right Message1. Click on a filter
after the mapper
filter to view the
outbound HL7
message.
2. Confirm that it is
the message
originally sent out
with the wrong
data.
(the MSH segment
matches and the patient
matches, you can see
the wrong insurance in
it)
1
2
12
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 61
Reinject the Message
Click Reinject
Reinjecting sends the
same input message
back through the
interface mappings.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 62
Return to Search
Find the Back to
Result Set button
near the top to
return back to the
search screen.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 63
Locate New Message by Re-Searching
Simply click Search to
rerun the search.
• The most recent
message (the
reinjected
message) should
then appear
toward the top.
Click on the new message
from the search.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 64
Confirm Message contains new Value
View the HL7 message
to confirm the value has
been updated.
Upgrades, CIE Interface Training
Courses, TouchWorks Interface
ClientConnect Page
Part IV
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 66
CIE Migration ProjectsMigration Options at this time
• Allscripts Led Migration
• AHS would migrate all contracted TW interfaces for you
Services with migration options
• Project management, interface consulting, technical services
Phased Migrations
• Recommended outbound interfaces be done together
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 67
Upgrading CIE – “Super Kit”
• Standardizes the end points, initial processing
and connection to the works database.
• Standard Kits for the following modules:
– Results, Document, Reg Sched, PAMI, Charge,
Order
• Preserves the mappings that are unique to
the interface in the mapper filter.
• Done during implementation or upgrade
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 68
Initiating a Request for CIE Migration
• In the Client Portal click Log a Case.
• Enter a case description such as “Request for quote to start a CIE
interface migration/ConnectR server upgrade.”
• Select Sales categories for the speediest routing:
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 69
Client Connect TouchWorks Interface Page
• Useful documents:
• Migration to CIE Commonly Asked Questions
• TouchWorks CIE Datasheet
• Canceled maintenance official communication
• ConnectR known issues official communication
• Announcements
• Blog
• Discussion
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 70
Client Connect TouchWorks Interface Page
1. Choose All Places from Client Connect
Drop down.
2. Type in ‘interface’ in the search field to
automatically filter the displayed
items.
2
1
1
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 71
Adding a group to profile
1. Hover your mouse over the left hand corner of the
TouchWorks Interfaces group until you see the
Settings dial. Once you see the Settings dial click
on it.
2. You will now see options to Join the group. Click
Join.
1
2
1
2
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 72
Thank you• Thank you for attending today’s presentation.
Copyright © 2016 Allscripts Healthcare Solutions, Inc. 73
Questions?
• If we do not get to your question today, please join us tomorrow for a Technical Roundtable
(Friday 1:30 PM) discussion.
• We will also be available in the Hub throughout the conference.
• Our email: