Perceptive Interact for Epic Release of Information

Transcription

1 Perceptive Interact for Epic Release of Information Installation Guide Version: 10.1.x Written by: Product Knowledge, R&D Date: September 2016

2 2015 Lexmark International Technology, S.A. All rights reserved. Lexmark is a trademark of Lexmark International Technology, S.A., or its subsidiaries, registered in the U.S. and/or other countries. All other trademarks are the property of their respective owners. No part of this publication may be reproduced, stored, or transmitted in any form without the prior written permission of Lexmark.

3 Table of Contents What is the Perceptive Interact for Epic Release of Information plug-in?... 4 About installing Interact for Epic ROI plug-in... 4 Prerequisites... 4 Uninstall previous versions... 4 Workstation Settings... 4 Download Interact for Epic ROI plug-in... 5 Run the Interact for Epic ROI attended installation... 5 Run the Interact for Epic ROI unattended installation... 6 Configure single sign-on... 7 Configure the SSO settings... 7 Configure the inow.ini file... 7 Configure the INEpicPainter.ini file... 8 Troubleshoot Interact for Epic ROI... 8 Set logging for Interact for Epic ROI

4 What is the Perceptive Interact for Epic Release of Information plug-in? Perceptive Interact for Epic provides embedded access to your Perceptive Content and ImageNow documents from within Epic s health information system. The Interact for Epic Release of Information (ROI) plug-in allows a user to fulfill an ROI request from within the Epic HIM ROI module. The Interact for Epic plug-in sends existing Perceptive Content data for a specific patient to Epic's ROI module. For product technical specifications and system requirements, refer to the Perceptive Interact for Epic ROI Technical Specifications 10.1.x. About installing Interact for Epic ROI plug-in Prerequisites You must install and have access to the following programs before installing Interact for Epic ROI plug-in. Interact for Epic Server, versions 6.6.x, 6.7.x, 7.0.x, or 7.1.x. One of the following supported versions of Epic Epic 2012 (v79) Epic 2014 (v81) Epic 2015 (v82) Microsoft.NET Framework, version 4 Microsoft Visual C SP1 Redistributable Package (x86) Uninstall previous versions If you have installed a version of Interact for Epic ROI plug-in prior to , you must create a backup of the INEpicPainter[.NET4].ini file prior to uninstalling the previous version and installing version 10.x, or higher. Then you must manually merge changes from the backup copy of the INEpicPainter[.NET4].ini file and the new file. Workstation Settings When installing the ROI plug-in, you enter Workstation Settings, which supply the value for the Epic resource. Epic passes the following criteria into the XML structure in Perceptive Content. Perceptive Content user name of the logged-in Epic user Perceptive Content password of the logged-in Epic user Document IDs of any items included in the ROI report Print group for the ROI plug-in that utilizes documents from Perceptive Content 4

5 The following example shows Perceptive Content s XML structure. {\*\EpicData xml <epicdata format="imagenow_doc"><userid>username</userid><password>userpassword</password><docum entid>301yt7v_0001kfq </documentid><imagesize Width='4' Height='8' /></epicdata>} Download Interact for Epic ROI plug-in To download Interact for Epic ROI, complete the following steps. 1. Go to the Perceptive Software website at and log in to the Customer Portal. 2. On the Downloads page, download the following files to a temporary directory on your computer. The latest build of Interact for Epic Server, as shown by the highest build number. Perceptive Interact for Epic ROI (InteractEpicROISetup_ msi) 3. Complete the installation on a computer that has both internet access and network access to Perceptive Content Server. Run the Interact for Epic ROI attended installation You must work with an Epic resource to complete the installation and configuration. Notes Changing the default installation location may require changing the default drive and the Epic version directory number, such as or Verify that you install the Interact for Epic ROI plug-in in the directory for the Epic version that generates ROIs. You can only install the Interact for Epic ROI plug-in for one Epic version, on a single Epic Print server. To install the Interact for Epic ROI plug-in, complete the following steps. 1. Double-click the Interact for Epic ROI file you previously downloaded. Click Install. 2. In the Welcome to the Installation Wizard for Interact for Epic Release of Information plug-in page, click Next. 3. In the License Agreement page, read the agreement, click the I accept the terms in the license agreement option, and then click Next. 4. In the Destination Folder page, verify the installation location for the ROI plug-in corresponds to the correct Epic version. To set a different installation location, click Change. After verifying or changing the location, click Next. An example location is [drive:]\epic\sdk\8.2\epic Print Service\bin\Plugins\Painter\. 5

6 5. In the Configuration page, complete the following substeps. 1. In the Server:Port box, type your server and port number for the Interact for Epic Server. For example, type : Optional. To enable single sign-on capability, select the Enable SSO check box. In the SSO key box, type the single sign-on key value. 3. Click Next. 6. Optional. To enable single sign-on capability, select the Enable SSO check box. In the SSO key box, type the single sign-on key value. 7. Click Next. 8. In the Start Installation page, click Install. 9. When the installation is complete, click Finish. 10. Complete the following substeps within Epic. For more information, refer to the Epic application help. 1. In the FDI settings, under Image Plug-in Name, type imagenow_doc. 2. On the EPS server, restart the EPS service. Run the Interact for Epic ROI unattended installation Using this unattended, silent installation method, you can perform a custom installation or use a combination of default and customized settings. The following tables contain the arguments you can use when you install Interact for Epic ROI unattended. If you do not manually set argument values, then the silent installer uses the default values. Argument Description Default Example L*v The argument sets the logging level and generates a log file to the specified location. The path for the log file generation must be a valid, existing path. This argument is typically used to diagnose installation errors. <blank> /L*v "C:\logs\I4EROI_Unattended Install.txt" INSTALLFOLDER The location of the Interact for Epic ROI files. [drive:]\ Epic\sdk\8.2\ EpicPrint Service\bin\Plugin s\painters. INSTALLFOLDER= C:\Epic\sdk\8.2\EpicPrintService\b in\plugins\painters" ES_SERVERPORT The server name and port of the Interact for Epic Server, in the format server:port :8080 ES_SERVERPORT= "jdoe:8080" 6

7 EP_SSO_ENABLED A Boolean value specifying whether SSO is enabled. <blank> EP_SSO_ENABLED=TRUE Note TRUE enables SSO. Omit the argument or use EP_SSO_ENABLE= to disable SSO. EP_SSO_KEY If SSO is enabled, this argument sets the key. <blank> EP_SSO.KEY= Type the following command using one of these methods. A command in a Command Prompt window A command line script you create for your deployment software, for example: msiexec /i InteractEpicROISetup_ msi /qn <argument list> The following example shows the command format using argument values. msiexec /i InteractEpicROISetup_ msi /qn /L*v C:\logs\I4EROI_UnattendedInstall.txt INSTALLFOLDER= C:\Epic\sdk\8.2\Epic Print Service\bin\Plugins\Painters\ ES_SERVERPORT= jdoe:8080 EP_SSO_ENABLED= EP_SSO_KEY= Configure single sign-on Single sign-on (SSO) allows your users to log on to the ROI plug-in using your SSO provider logon. Configure the SSO settings Use the following procedures to configure the SSO settings. Configure the inow.ini file To enable SSO between Interact for Epic and Perceptive Content, complete the following steps. 1. On the Perceptive Content Server computer, navigate to the [drive:]\{path}\inserver6\etc folder for ImageNow, version 6.7.x or navigate to [drive:]\{path}\inserver\etc for Perceptive Content, version 7.0.x and higher. 2. Using a text editor, open the inow.ini file. 3. Under [Logon Control], add the following settings. Create the setting epic.sso and set to TRUE. Create the setting epic.sso.key and specify a value for the token sent from Perceptive Content. The value can be any valid string. 4. Save and close the inow.ini file. 7

8 Configure the INEpicPainter.ini file During installation, the Release of Information (ROI) plug-in installation wizard provides the option to enable SSO and enter the SSO key. If you did not configure SSO during installation, complete the following steps to configure the INEpicPainter.ini file. 1. On the EPS server, browse to the [drive:]\{path}\epic Print Service\bin\Plugins\Painters folder. 2. Using a text editor, open the INEpicPainter.ini file. 3. Under [General], update the following settings. Set sso.enabled to TRUE. Set sso.key to the same value you specified for the epic.sso.key setting in the inow.ini file. 4. Save and close the INEpicPainter.ini file. Troubleshoot Interact for Epic ROI If a functional issue occurs, use the information in this section to create logs to aid with troubleshooting. Set logging for Interact for Epic ROI To set the logging for Interact for Epic ROI, complete the following steps. 1. On the EPS server, navigate to the [drive:]\{path}\epic Print Service\bin\Plugins\Painters directory. 2. Using a text editor, in the INEpicPainter.ini file, under [Logging], set debug.level.file to a number between 1 and Save and close the INEpicPainter.ini file. 4. To view a log, navigate to [drive:]\users\{username}\appdata\roaming\imagenow\log and open the most recent log file in a text editor. Note Interact for Epic ROI creates the error log in the {username} directory for the username Epic Print Service runs as, not to the directory for the user requesting the ROI. 8