Allscripts Developer Program
Installation Guide for TouchWorks EHR
and Juxly Vault
Last updated: October 5, 2020
Copyright © 2020 Allscripts Healthcare, LLC www.allscripts.com
and/or its affiliates. All Rights Reserved.
Published Date: October 5, 2020
For further information about this manual or other Allscripts Healthcare, LLC products, contact Global Product Support Services,
as follows:
Global Product Support Services
Allscripts Central Website: https://clientconnect.allscripts.com/welcome (Allscripts Central login is required. Contact information
varies by product.)
Telephone: http://www.allscripts.com/contact-us/phone-numbers
Proprietary Notice
© 2020 Allscripts Healthcare, LLC and/or its affiliates. All Rights Reserved.
This document contains confidential and proprietary information protected by trade secret and copyright law. This document, the
information in this document, and all rights thereto are the sole and exclusive property of Allscripts Healthcare, LLC and/or its
affiliates, are intended for use by customers and employees of Allscripts Healthcare, LLC and/or its affiliates and others authorized
in writing by Allscripts Healthcare, LLC and/or its affiliates, and are not to be copied, used, or disclosed to anyone else, in whole
or in part, without the express written permission of Allscripts Healthcare, LLC and/or its affiliates. For authorization from Allscripts
Healthcare, LLC to copy this information, please call Allscripts Global Product Support Services at 888 GET-HELP or 888
438-4357. Notice to U.S. Government Users: This is “Commercial Computer Software Documentation” within the meaning of
FAR Part 12.212 (October 1995), DFARS Part 227.7202 (June 1995) and DFARS 252.227-7014 (a) (June 1995). All use,
modification, reproduction, release, performance, display, and disclosure shall be in strict accordance with the license terms of
Allscripts Healthcare, LLC and/or its affiliates. Manufacturer is Allscripts Healthcare, LLC, and/or its affiliates, 222 Merchandise
Mart Plaza, Suite #2024, Chicago, IL 60654 USA.
IMPORTANT NOTICE REGARDING GOVERNMENT USE
The software and other materials provided to you by Allscripts Healthcare, LLC include "commercial computer software" and
related documentation within the meaning of Federal Acquisition Regulation 2.101, 12.212, and 27.405-3 and Defense Federal
Acquisition Regulation Supplement 227.7202 and 52.227-7014(a). These materials are highly proprietary to Allscripts Healthcare,
LLC and its vendors. Users, including those that are representatives of the U.S. Government or any other government body, are
permitted to use these materials only as expressly authorized in the applicable written agreement between Allscripts Healthcare,
LLC and your organization. Neither your organization nor any government body shall receive any ownership, license, or other
rights other than those expressly set forth in that agreement, irrespective of (a) whether your organization is an agency, agent,
or other instrumentality of the U.S. Government or any other government body, (b) whether your organization is entering into or
performing under the agreement in support of a U.S. Government or any other government agreement or utilizing any U.S.
Government or any other government funding of any nature, or (c) anything else.
Allscripts® Analytics Platform is a trademark of Allscripts Software, LLC and/or its affiliates.
All trademarks, service marks, trade names, trade dress, product names, and logos are property of their respective owners. Any
rights not expressly granted herein are reserved.
The names and associated patient data used in this documentation are fictional and do not represent any real person living or
otherwise. Any similarities to actual people are coincidental.
Images and option names used in this documentation might differ from how they are displayed in your environment. Certain
options and labels vary according to your specific configuration. Images are for illustration purposes only.
Fee schedules, relative value units, conversion factors and/or related components are not assigned by the AMA, are not part of
CPT, and the AMA is not recommending their use. The AMA does not directly or indirectly practice medicine or dispense medical
services. The AMA assumes no liability for data contained or not contained herein.
Excel and Microsoft are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other
countries.
Adobe, the Adobe logo, Acrobat, and Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in
the United States and/or other countries.
iPhone® and iPad® are trademarks of Apple Inc., registered in the U.S. and other countries.
Perceptive Content, Lexmark, and the Lexmark logo are trademarks of Lexmark International, Inc., registered in the United States
and/or other countries.
Allscripts Patient Administration Solution (PAS) contains barcode components licensed from IDAutomation.com, Inc. These
products may only be used as part of and in connection with the Allscripts Patient Administration Solution software.
InterQual and InterQual Connect are registered trademarks of Change Healthcare, LLC in the United States or other countries.
Vendor
Juxly, LLC
Integration
Juxly Vault streamlines your HCC coding process by enabling the following:
• Capture of HCC (Hierarchical Condition Category) Coding in an intuitive user-friendly way
• Improvement of RAF scoring accuracy
• Coding specificity for HCC eligible conditions
• Satisfaction of CMS Coding requirements
• Seamless launch at the point of care from within Allscripts
Juxly Vault integration with Allscripts is designed for ease of use. It is an intuitive tool enabling
providers to accurately code and document patient conditions to CMS specifications. Customers
report a speedy realization of value. Provider on-boarding is quick and easy. All features are
designed with the provider in mind.
Minimum configuration
Minimum third-party requirements
• Vendor software application name: Juxly Vault v20.04.1
• Minimum requirements: Internet Explorer 11 or higher
Minimum Allscripts server requirements
• Allscripts TouchWorks EHR v15.1 and v17 approved
• JSON must be enabled
• Unity must be installed in a public domain
• Minimum version of Unity: Born on Date: 2020-Aug-03
• Operating System on server: Windows Server 2012 R2
• Operating System on workstation: Windows 10
• Microsoft Server Mgmt Studio: Windows Microsoft SQL Server 2014
• New Document Type: SQL included to add Enhanced Note
• SQL Juxly-TW-launch-button.sql
Juxly Enhanced Note TW document type,sql
• EHR username Vendor, Juxly (user = juxly) used in testing
• Launching? Yes
• Scan Required? Not needed for this Enhanced Note
• Desktop Agent No
Dataflow
How it works
Juxly is a launched app from TouchWorks that creates a new Enhanced Note in the EHR (found
in Chart Viewer) and creates a new Diagnosis in EHR (see Diagnosis tab).
There must be an open encounter in context for launch to be successful.
Allscripts responsibilities
• Create the EHR username.
• Add launcher button to EHR; a SQL script is provided for this on Allscripts SharePoint.
• Create the enhanced note with the provided SQL, also found on SharePoint
• Endpoint URL for practice/clinic for Ubiquity and unique Client ID for connectivity.
Vendor responsibilities
• Configure the endpoint URL and Ubiquity ID for this practice on their backend.
• Create the Enhanced Note with the provided SQL, also found on SharePoint
• Train clients on the use of their system.
Vendor needs
• Endpoint URL and Ubiquity ID of the practice or organization.
• EHR username. Allscripts will supply EHR username. Vendor will use for tracking and
debugging of activity.
• Test patient. This should be supplied by client to test connectivity.
Instructions
Create EHR username
This is an authorized provider with physician-level privileges in EHR. NPI number must be 10
digits in length, and the mnemonic must begin with a letter.
You can copy an existing provider like twprovider.
1. Log into TouchWorks as an administrator and select TW Admin.
2. Click TWUser Admin.
3. In Search, select User Name.
4. Search for twprovider.
5. Click Copy.
6. Enter the following under User Details:
Last Name: Vendor
First Name: Juxly
Username: juxly
Provider Mnemonic Code: any value
Provider Code: any value
Create Launcher
1. Move SQL scripts to the Desktop of targeted server.
2. Open Microsoft SQL Server Management Studio and select the targeted server.
3. Click File > Open > File, and then select the script you copied to the server, and click
Open.
4. Select the Works database, and then click Execute.
This places the launching arguments in the UAI_Vender Action table.
To configure the Clinical Desktop button in TouchWorks, do the following:
1. Log into TouchWorks as an administrative user.
2. On the vertical toolbar, click Work Def Admin.
3. In View, select Adult Patient View.
4. Click Add/Edit Desktop View.
5. Click the Problem tab.
6. Click Define Buttons.
7. Click the Commands tab.
8. Select the partner application from the list of commands.
9. Drag and drop the partner to the Customize Toolbar Buttons list.
10. Save and close.
11. Log into TouchWorks as regular provider to view launcher button.
Create enhanced note
1. Move SQL scripts to the Desktop of the targeted server.
2. Open Microsoft SQL Server Management Studio, and then select the targeted server.
3. Click File > Open > File. Select the script, and then click Open.
4. Select the Works database, and then click Execute.
This places a new doc type in tablename = 'Document_Type_DE for the Enhanced Note. No
additional steps are required for Enhanced Note to appear in Chart Viewer.
Workflow
1. Log into TouchWorks EHR as a provider. Switch to the Provider workspace.
2. Locate the test patient that has an encounter for previous year and this year, and then go
to the Adult Patient View, Problems tab. You must have an existing encounter in context
to launch.
3. Launch Juxly Vault.
4. Search for a chronic illness, and then click Diagnose.
5. Complete each section, and then click Save.
This is a trigger to save the diagnosis back to TouchWorks on the Diagnosis tab.
Confirm that the diagnosis displays in TouchWorks on the ChartViewer Diagnosis tab.
ChartViewer also has changes. Closing Vault is required for the enhanced note to be created in
TouchWorks.
Double-click on the enhanced note to display information from Juxly Vault.
Known issues
None.
Additional information
Video:
https://vimeo.com/372411664
ADP SharePoint:
https://businessdevelopment.intranet.allscripts.com/ADP/Lists/Product%20List/Item/displayifs.asp
x?List=8113c546%2De460%2D4f0b%2D8db9%2D3b990eaf683f&ID=621&Source=https%3A%2
F%2Fbusinessdevelopment%2Eintranet%2Eallscripts%2Ecom%2FADP%2FSitePages%2FOpen
QA%2520Testing%2Easpx&ContentTypeId=0x0100714AB6E4AA19DD45BBC37A34DB3533F3
&IsDlg=1
Contacts
Main office Support: 888-399-0359, Extension: 703
These are the ADP partner team members who will be participating in and supporting the
OpenQA Testing activities.
Full Name Title/Role Phone Email Time Zone
James Ingold Senior Software [email protected] Central Time
Engineer
Rishi Bhayana Product Manager 888-399-0359 [email protected] Central Time
x703
Mail Certificate to:
JUXLY, LLC
ATTN: James Ingold
425 W MCDANIEL, STE 164
SPRINGFIELD MISSOURI, 65806
To license this vendor:
This section describes how to request an activation/installation of an application on a client
server. The vendor requests activation on the Developer Portal. http://developer.allscripts.com/
Activation instructions
The process of getting the vendor app installed with a client:
Allscripts requires the Client Account Number (usually five digits) to install an application's
license on the client server. Use the developer portal at http://developer.allscripts.com/ with the
following information in this template to request activation:
Subject: Activation Request, [CLIENT ACCOUNT #], [CLIENT NAME]
Body: Client Account #: [CLIENT ACCOUNT #]
Client Name: [CLIENT NAME]
Partner Name: Juxly, LLC
Unity AppName: Juxly.Vault.ProdApp
The ADP team licenses the application for the client server requested in the production
environment, and an ADP representative confirms the application was activated.
When requesting activation, there is a notes section called “Additional Client Info’ for the
requestor to provide additional detail to Allscripts Activations teams.
Managing expired credentials
Unity credentials are stored in an encrypted database for the application and will be updated
before expiring.
