Perceptive Interact for EpicCare Link

Transcription

1 Perceptive Interact for EpicCare Link Installation and Setup Guide Version: 1.2.x Written by: Product Knowledge, R&D Date: February 2017

2 Lexmark. All rights reserved. Lexmark is a trademark of Lexmark International Inc., 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 Perceptive Interact for EpicCare Link... 4 Prerequisites... 4 Overview of the setup process... 4 Add an EpicCare user... 4 Grant privileges to an EpicCare user... 5 Configure 7.x.x for Perceptive Interact for EpicCare Link... 5 Configure 6.7.x for Perceptive Interact for EpicCare Link... 7 Download and Install Perceptive Interact for EpicCare Link... 8 Download Perceptive Interact for EpicCare Link... 8 Install Perceptive Interact for EpicCare Link... 8 Configure the INEpicCareLink.ini file... 9 Configure the programmatic ID in Epic Appendix A: INEpicCareLink.ini definitions Appendix B: Troubleshooting Documents do not load in EpicCare Link Missing Perceptive Interact for EpicCare Link logs

4 Perceptive Interact for EpicCare Link The Perceptive Interact for EpicCare Link solution allows a user to access a document stored in Perceptive Content directly from the EpicCare Link interface. The solution also provides a method for EpicCare Link users to view documents stored in Perceptive Content as separate TIFF image files by combining them into a single, multi-page TIFF file. Prerequisites You must install and have access to the following programs before installing Perceptive Interact for EpicCare Link. Perceptive Content Server and Client, version 6.7.x or 7.x.x Perceptive Integration Server, version 6.7.x or 7.x.x Epic 2012, Epic 2014, Epic 2015, or Epic 2017.NET Framework, version 4.0 or higher Overview of the setup process Complete the following procedures in order. 1. Add an EpicCare user 2. Optional. Grant privileges to the EpicCare user. 3. Configure ImageNow 6.7.x Perceptive Content 7.x.x for Interact for EpicCare Link. 4. Download and install Interact for EpicCare Link. 5. Configure the INEpicCareLink.ini file. Add an EpicCare user To add an EpicCare user, complete the following steps. 1. To add the service user to authentication, add a local account to your Lightweight Directory Access Protocol (LDAP) Server or on Perceptive Content Server. 2. To add the service user to Perceptive Content, complete the following substeps. 1. Log into Management Console as a Perceptive Manager. 2. In Management Console, in the left pane, click Users. 3. In the right pane, on the User Profiles tab, use one of the two options to add a user: 1. Click New, type EpicCare user, press Enter. 2. Click Import, follow the Import Users wizard to add the new user. 4. Highlight the new user and then click Modify. 5. In the Modify User Profile dialog box, in the left pane, click Personal Information. 4

5 6. In the right pane, under Miscellaneous, select the Is Active check box and click OK. 7. In the left pane, click Privileges. 8. In the right pane, click Global Privileges, click Deny All, click Apply, and then click OK. 9. Close Management Console and Perceptive Content. Grant privileges to an EpicCare user To grant privileges to an EpicCare user, complete the following steps. 1. Log into Management Console as a Department Manager. 2. Use the Select Department drop-down menu to select the correct department. 3. In the left pane, click Users. 4. Highlight the new user and then click Modify. 5. In the left pane, click Privileges. 6. In the right pane, click Drawer Privileges. 7. In the right pane, in the Drawer list, select Medical Records. 8. Under Privileges, under Content, click the icons adjacent to Open and Search until Grant displays, and then click Apply. 9. Close Management Console and Perceptive Content. Configure 7.x.x for Perceptive Interact for EpicCare Link Individual Perceptive Interact for EpicCare Link users do not access Perceptive Content directly. Perceptive Interact for EpicCare Link authenticates as a service user and retrieves documents from Perceptive Content. The service user is a standard Perceptive Content user with limited privileges. For more information on adding users, refer to the Perceptive Content Update Guide 7.1.x For the service account, you set privileges that accommodate the needs of your EpicCare Link users. The privileges allow you to restrict access to sensitive Perceptive Content documents. The following example demonstrates one way to configure Perceptive Content. In this scenario, you set privileges to view documents in an unrestricted drawer, labeled Medical Records. You may modify the privileges to fit your particular security rules. For more information on types of privileges, refer to the Privilege Definitions Overview topic. 1. To add the service user to authentication, add a local account to your Lightweight Directory Access Protocol (LDAP) Server or on Perceptive Content Server. 2. To add the service user to Perceptive Content, complete the following substeps. 1. Log into Management Console as a Perceptive Manager. 2. In Management Console, in the left pane, click Users. 3. In the right pane, on the User Profiles tab, use one of the two options to add a user: 1. Click New, type EpicCare user, press Enter. 5

6 2. Click Import, follow the Import Users wizard to add the new user. 4. Highlight the new user and then click Modify. 5. In the Modify User Profile dialog box, in the left pane, click Personal Information. 6. In the right pane, under Miscellaneous, select the Is Active check box and click OK. 7. In the left pane, click Privileges. 8. In the right pane, click Global Privileges, click Deny All, click Apply, and then click OK. 9. Close Management Console and Perceptive Content. 3. To add privileges, complete the following substeps. 1. Log into Management Console as a Department Manager. 2. Use the Select Department drop-down menu to select the correct department. 3. In the left pane, click Users. 4. Highlight the new user and then click Modify. 5. In the left pane, click Privileges. 6. In the right pane, click Drawer Privileges. 7. In the right pane, in the Drawer list, select Medical Records. 8. Under Privileges, under Content, click the icons adjacent to Open and Search until the Grant icon displays, and then click Apply. 9. Close Management Console and Perceptive Content. 6

7 Configure 6.7.x for Perceptive Interact for EpicCare Link Individual Perceptive Interact for EpicCare Link users do not access ImageNow directly. Perceptive Interact for EpicCare Link authenticates as a service user and retrieves documents from ImageNow. The service user is a standard ImageNow user with limited privileges. For more information on adding users, refer to ImageNow Administrator Getting Started Guide. For the service account, you set privileges that accommodate the needs of your EpicCare Link users. The privileges allow you to restrict access to sensitive ImageNow documents. The following example demonstrates one way to configure ImageNow. In this scenario, you set privileges to view documents in an unrestricted drawer, labeled Medical Records. You may modify the privileges to fit your particular security rules. For more information on types of privileges, refer to Privilege definitions in Management Console Help. To create a service user account and set privileges, complete the following steps. 1. To add the service user to authentication, add a local account to your Lightweight Directory Access Protocol (LDAP) Server or on ImageNow Server. 2. To add the service user to ImageNow, complete the following substeps. 1. In Management Console, in the left pane, click Users. 2. In the right pane, on the User Profiles tab, click New, type EpicCare user, press Enter, and then click Modify. 3. In the Modify User Profile dialog box, in the left pane, click Personal Information. 4. In the right pane, under Miscellaneous, select the Is Active check box and click OK. 3. To add privileges, complete the following substeps. 1. On the Security tab, click Search. To refresh the list, in the User Search dialog box, click Yes. 2. Click EpicCare user and click Modify. 3. In the Security Settings dialog box, in the left pane, click Drawer Privileges. 4. In the right pane, in the Drawer list, select Medical Records. 5. Under Privileges, under Content, click the icons adjacent to Open and Search until the Grant icon displays, and then click Apply. 6. In the Security Settings dialog box, in the left pane, click Global Privileges, click Deny All, click Apply, and then click OK. 7. Close Management Console and ImageNow. 7

8 Download and Install Perceptive Interact for EpicCare Link In this section, you download and install Perceptive Interact for EpicCare Link. Download Perceptive Interact for EpicCare Link To download Perceptive Interact for EpicCare Link, complete the following steps. 1. Go to the and log in to the Customer Portal. 2. In the Downloads page, search for the latest build of Perceptive Interact for EpicCare Link, as shown by the highest build number. 3. Download the file and extract the contents to a temporary directory on your computer. 4. Copy the contents of the temporary directory to the EpicCare Link Shared Files directory. For example, [drive:]\program Files (x86)\epic\8.2\shared Files. Install Perceptive Interact for EpicCare Link You install Perceptive Interact for EpicCare Link by completing three tasks. Register your DLL file in your Windows environment. Create a logging directory to assist you in troubleshooting the solution. Grant the correct permission settings to the user or system account configured in Internet Information Services (IIS) that runs EpicCare Link. To install Perceptive Interact for EpicCare Link, complete the following steps. 1. To register the DLL, from the Start menu, open a Command Prompt window and complete the following substeps. 1. Navigate to [drive:]\windows\microsoft.net\framework\v4.[.net version]. 2. Enter a command, as shown in the following example. RegAsm.exe "[drive:]\program Files (x86)\epic\8.2\shared Files\INEpicCareLink.dll" /tlb /codebase 2. Create a directory for the Perceptive Interact for EpicCare Link logs. For example, [drive:]\logs\epiccarelink. 3. Follow your operating system instructions to grant permissions to the EpicCare Link user or server account in IIS. 1. Grant read and write permissions to the Perceptive Interact for EpicCare Link logging directory. 2. Grant read permission for EpicCare Link Shared Files directory. For example, [drive:]\program Files (x86)\epic\8.2\shared Files. 8

9 Configure the INEpicCareLink.ini file In this section, you configure the INEpicCareLink.ini file with your Perceptive Integration Server, logging, and output compression parameters. The User Audit logging option in the INEpicCareLink.INI file allows you to configure Perceptive Interact for EpicCare Link to record the documents each EpicCare Link user accesses. If your Perceptive Content document contains more than one image file, the output compression parameter allows you to configure the solution to combine these images into a single, multi-page TIFF. Output compression does not alter documents stored as a single image file or a multi-page TIFF file. To configure the INEpicCareLink.ini file, complete the following steps. 1. Navigate to EpicCare Link Shared Files directory. For example, [drive:]\program Files (x86)\epic\8.2\shared Files. 2. Open INEpicCareLink.ini with a text editor. 3. Under [General], set the following parameters to your server information. Note For more information on parameter names and descriptions, see the Appendix A: INEpicCareLink.ini definitions section. Integration Server URL Integration Server Username Note This is the name of the user you created in the Configure Perceptive Content for Perceptive Interact for EpicCare Link section. Integration Server Password 4. Under [Logging], set debug.dir.file to the logging directory, such as [drive:]\logs\epiccarelink. 5. Under [Logging], set debug.level.file to a value between zero and three. 0. Logs only critical errors. 1. This is the User Auditing setting, recommended for standard use. 2. This is the Information setting. 3. This is the Debugging setting, recommended for troubleshooting. 6. Under [output], set output.compression to a value between 0 and No compression. Use this setting for higher image quality and the fastest performance. 1. Lempel-Zov-Welch (LZW). Use this setting for higher compression, higher image quality. This setting results in the slowest performance. 2. Joint Photographic Expert Group (JPEG). This is a compression method. 9

10 3. Run-length encoding (RLE). Use this setting for lower compression, higher image quality, and faster performance. 7. Save and close the INEpicCareLink.ini file. Configure the programmatic ID in Epic You must enter a programmatic ID in the Epic.ini file so that the Epic web server can invoke Interact for EpicCare Link. To configure the programmatic ID in Epic, complete the following steps. 1. Navigate to the EpicCare Link Shared Files directory. For example, [drive:]\program Files (x86)\epic\8.2\shared Files. Open Epic.ini with a text editor. 2. Under Enter the ProgID of an ActiveX server (MediaHandler) that implements the ICWebMedia interface, enter PerceptiveSoftware.EpicCareLink. 3. Save and close the Epic.ini file. 10

11 Appendix A: INEpicCareLink.ini definitions The following table provides definitions and sample data for the settings in the INEpicCareLink.ini configuration file. This table displays the INI settings under group headings in brackets, in the order the groups appear in the INI file. The table below defines and describes each setting and offers two or more options. Use this table as a guide when customizing the file. The INI file resides in the destination folder you selected during the installation process. Group Setting Options Description [General] The General group of settings specifies Perceptive Interact for EpicCare Link settings. integration_server.url Any valid Integration Server URL in the following format: Server]:8443/ integrationserver Specifies the URL for Integration Server. Replace [Integration Server] with the Integration Server computer name. Replace 8443 with your Apache Tomcat port, if different. Example There is no default setting. integration_server.user Any valid string Specifies the Perceptive Content username for the EpicCare Link user account. This setting is required. There is no default setting. integration_server.password Any valid string Specifies the password for the EpicCare Link user account. Configure this setting with the password specified for the above account in the operating system. This setting is required. There is no default setting. 11

12 Group Setting Options Description [output] The output setting specifies what action to take on multi-page TIFF images. output.compression 0 through 3 Specifies the compression method for multi-page TIFF images. 0 = None No compression, higher image quality, fastest 1 = Lempel-Zov-Welch (LZW) - higher compression, higher image quality, slowest 2 = Joint Photographic Expert Group (JPEG) - a compression method 3 = Run-length encoding (RLE) - lower compression, higher image quality, fast The default is 0. [Logging] The Logging group settings specify how Interact for Epic logs transactions and communications. debug.dir.file [drive:]/<path> Specifies the directory where Interact for Epic records the logging files. debug.level.file 0 through 3 Specifies the level Interact for Epic uses to log errors for troubleshooting. Use minimal logging unless you are debugging an issue. If you increase the logging level, make sure that you set it back down after you finish debugging. Failure to do so can slow performance and consume hard disk space. 1 through 3 = Logging is on. The higher the number, the more verbose the logging. For example, 1 offers minimal logging, whereas 3 offers the most detailed log information. 0 = Logging is off. Only critical errors will be logged. 1 = User Auditing 2 = Information 3 = Debugging The default is 0. 12

13 Appendix B: Troubleshooting The following procedures can help you troubleshoot the Perceptive Interact for EpicCare Link solution. Documents do not load in EpicCare Link To troubleshoot the solution when documents do not load in EpicCare Link, complete the following steps. 1. Turn on the EpicCare Link logging feature in the epic.ini file. Set DebugMedia=True. 2. Retry the document. 3. Check the application log file for errors that refer to PerceptiveSoftware.EpicCareLink. Note Incorrect permissions cause most errors. For more information, refer to Install Perceptive Interact for EpicCare Link. Missing Perceptive Interact for EpicCare Link logs To troubleshoot missing Perceptive Interact for EpicCare Link logs, complete the following steps to correct the three most likely causes. 1. Ensure the INEpicCareLink.ini file contains a valid path for the logging directory. For more information, refer to Configure the INEpicCareLink.ini file. 2. Ensure the INEpicCareLink.ini file contains a valid value for the logging level. For more information, refer to Configure the INEpicCareLink.ini file. 3. Ensure the EpicCare Link user or server account in IIS has the correct permissions to write to the log directory. For more information, refer to Install Perceptive Interact for EpicCare Link. 13