DRAFT. Allscripts PrintAttach Installation Guide. Allscripts Care Management 16.2

Transcription

1 Allscripts Care Management 16.2 Allscripts PrintAttach Installation Guide DRAFT Copyright 2016 Allscripts Healthcare, LLC and/or its affiliates. All Rights Reserved.

2 Published Date: September 15, 2016 for release 16.2 of Allscripts Care Management For further information about this manual or other Allscripts Healthcare, LLC products, contact Global Product Support Services, as follows: Global Product Support Services Website (Client Support login is required. Contact information varies by product.) Telephone: The Documentation Center of Excellence welcomes your opinion regarding this document. Please your comments and suggestions to Proprietary Notice 2016 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 Notice to U.S. Government Users: This is Commercial Computer Software Documentation within the meaning of FAR Part (October 1995), DFARS Part (June 1995) and DFARS (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 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, , and and Defense Federal Acquisition Regulation Supplement and (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 Care Management 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.

3 Table of Contents Chapter 1: Allscripts PrintAttach Requirements and Installation...5 Allscripts PrintAttach...5 Supported operating systems...5 Allscripts PrintAttach driver installation for Windows server...6 Install the Allscripts PrintAttach driver on 32-bit Windows 7 operating system...6 Install the Allscripts PrintAttach driver on 64-bit Windows 7 operating system...7 Install the Allscripts PrintAttach driver on 64-bit Windows 8 or 10 operating system...7 Install the Allscripts PrintAttach driver on the Windows Server or Citrix with Terminal Services...8 Test Allscripts PrintAttach...9 Chapter 2: Configure driver preferences and start the application...11 Configure Allscripts PrintAttach driver preferences...11 Start the application...11 Chapter 3: Registry and Allscripts PrintAttach driver settings...13 Registry settings and Allscripts Print Attach driver files...13 Chapter 4: Uninstalling Black Ice and Allscripts PrintAttach...17 Uninstall Black Ice or Allscripts PrintAttach...17 Manually delete other Black Ice files and registry settings...19 Index...21 September 15, 2016 Allscripts Care Management

4 Table of Contents 4 Allscripts Care Management 16.2 September 15, 2016

5 Chapter 1 Allscripts PrintAttach Requirements and Installation Allscripts PrintAttach Allscripts PrintAttach is a print driver for desktops or external terminal environments. Allscripts PrintAttach consists of the following components: > The Allscripts PrintAttach PDF print driver. Note: This driver generates a PDF file that is saved to your TEMP folder. > The PrintAttach.exe file (desktop version) or PrintAttachNet.WinFormsApp.exe (server and Windows 8+ version). Note: The PDF driver automatically runs these files after you save the PDF output. The respective PrintAttach executable file securely saves the PDF file back to Allscripts Web servers for backup with the patient record. Allscripts licenses the PDF print driver from Black Ice Software, LLC. For more information about the Black Ice PDF driver, see the Black Ice Printer Driver Manual. Supported operating systems When installing the Allscripts PrintAttach PDF print driver, select the print driver associated with the Windows operating system you are installing the driver on. > Allscripts PrintAttach 32-bit Note: This version requires Windows 2000 Professional, Windows XP, or Windows Vista or higher, installed as 32-bit. > Allscripts PrintAttach 64-bit for Windows 7 Note: This version requires Windows 7 installed as 64-bit. September 15, 2016 Allscripts Care Management

6 Chapter 1 Allscripts PrintAttach Requirements and Installation > Allscripts PrintAttach 64-bit for Windows 8 or Windows 10 Note: This version requires Windows 8 or Windows 10 installed as 64-bit. > Allscripts PrintAttach 64-bit for Terminal Services Note: This version requires Windows 2008 or Windows 2012, with Terminal Services installed (renamed RDS by Microsoft ). Allscripts PrintAttach driver installation for Windows server The steps for installing the Allscripts PrintAttach driver depend on which Windows operating system you are using. Install the Allscripts PrintAttach driver on 32-bit Windows 7 operating system Use the following steps for installing the Allscripts PrintAttach driver on 32-bit Windows 7 operating system. Before you begin To successfully install the Allscripts PrintAttach driver, you must have administrator privileges. If you try to install the driver without having administrator privileges, the installation process displays an error stating you don t have access to write a file to the machine. 1. Download the 32-bit MSI package by clicking the following link in this document: Allscripts Print Attach 32-bit. 2. Do one of the following to run the MSI package on your facility's 32-bit operating system: > Double-click the MIS file. > At the command prompt, enter: C:\>msiexec.exe /i Allscripts_PrintAttach_32bit.msi. 3. Follow the instructions provided by the installation wizard. Note: To check the disk space before installing the program, select Custom on the Choose Setup Type window and then click Disk Usage. 6 Allscripts Care Management 16.2 September 15, 2016

7 Allscripts PrintAttach driver installation for Windows server Install the Allscripts PrintAttach driver on 64-bit Windows 7 operating system Use the following steps for installing the Allscripts PrintAttach driver on a 64-bit Windows 7 operating system. Before you begin To successfully install the driver, you must have administrator privileges. If you try to install the Allscripts PrintAttach driver without having administrator privileges, the installation process displays an error stating you don t have access to write a file to the machine. 1. Download the 64-bit MSI package for Windows 7 by clicking the following link in this document: Allscripts Print Attach 64-bit. 2. Do one of the following to run the MSI package on your facility's 64-bit Windows 7 operating system: > Double-click the MIS file. > At the command prompt, enter: C:\>msiexec.exe /i Allscripts_PrintAttach_64bit.msi. 3. Follow the instructions provided by the installation wizard. Note: To check the disk space before installing the program, select Custom on the Choose Setup Type window and then click Disk Usage. Install the Allscripts PrintAttach driver on 64-bit Windows 8 or 10 operating system Use the following steps for installing the Allscripts PrintAttach driver on a 64-bit Windows 8 or Windows 10 operating system. Before you begin To successfully install the driver, you must have administrator privileges. If you try to install the Allscripts PrintAttach driver without having administrator privileges, the installation process displays an error stating you don t have access to write a file to the machine. 1. Download the 64-bit MSI package by clicking the following link in this document: Allscripts Print Attach 64-bit. September 15, 2016 Allscripts Care Management

8 Chapter 1 Allscripts PrintAttach Requirements and Installation 2. Do one of the following to run the MSI package on your facility's 64-bit Windows 8 or Windows 10 operating system: > Double-click the MIS file. > Run the command prompt as administrator. At the command prompt enter: C:\>msiexec.exe /i PrintAttach_Installer_Windows10_x64.msi. 3. Follow the instructions provided by the installation wizard. Note: To check the disk space before installing the program, select Custom on the Choose Setup Type window and then click Disk Usage. Install the Allscripts PrintAttach driver on the Windows Server or Citrix with Terminal Services Before you begin To successfully install the driver, you must have Terminal Server Service Pack 4. You must also have administrator privileges. You cannot install the printer driver from a remote computer, even if you have administrator privileges. In addition, if you add the port monitor or the printer port to the registry, this job will fail. Note: If there are terminal services on the server, even if used only for remote administration, you must use the terminal server version of the printer driver. Because the Windows 2003 server operating systems include terminal services, the terminal server version of the printer driver is required for this family of operating systems. To install a non-terminal server driver on a Windows 2000 server, you must completely uninstall terminal services. 1. To install the Allscripts PrintAttach PDF print driver on a Windows server or Citrix Terminal Services, set the terminal server to install mode by starting the driver installation under Control Panel > Add/Remove Programs. You can correctly install the terminal server printer driver only from the server. The terminal server is set to install mode. 2. To begin the installation, run the 64-bit Windows Server MSI by going to or clicking Allscripts Print Attach 64-bit from the Allscripts Care Management Download Page. 8 Allscripts Care Management 16.2 September 15, 2016

9 Test Allscripts PrintAttach Test Allscripts PrintAttach Before you begin To verify that the Allscripts PrintAttach driver is working correctly, you must be logged in with a standard user account, and not an administrator account. 1. Log in to the workstation as the user who will most frequently use Allscripts PrintAttach. 2. Log in to Allscripts PrintAttach. 3. Select Manage > Forms > Forms Default View. Forms Default View opens. 4. From the Actions menu, select Forms and Attachments, and then click Go. 5. Click Add Print Attach. If you do not see Add Print Attach, the Allscripts PrintAttach feature is not enabled. Contact your Allscripts project manager. 6. Create a test document using Notepad or any Windows -based application that can print to a local printer, and print the document to the Allscripts PrintAttach printer. 7. (Optional) Add a description for the document. 8. When processing is complete, minimize the source application and return to Allscripts PrintAttach. The Forms and Attachments page will refresh, and the printed document is displayed in the Attachments list. September 15, 2016 Allscripts Care Management

10 Chapter 1 Allscripts PrintAttach Requirements and Installation 10 Allscripts Care Management 16.2 September 15, 2016

11 Chapter 2 Configure driver preferences and start the application Configure Allscripts PrintAttach driver preferences 1. From the Windows Start menu, select Settings > Printers and Faxes. 2. Right-click the Allscripts Print Attach printer and select Properties. The Allscripts Print Attach Properties wizard displays. 3. Select the Advanced tab. 4. Click Printing Defaults to open the Allscripts Print Attach Printing Defaults wizard. 5. Select the File Formats tab. 6. For Color Depth, select 1 bit. 7. In the Options section, select Create Multipage Image. Note: Leave all other options on their default settings. Start the application Run the Allscripts PrintAttach executable file for the desktop or the server version. 1. Select the Start Application tab. 2. Select Enable Start Application. 3. Do 1 of the following: Desktop version Server version Enter C:\Program Files\Allscripts\PrintAttach\PrintAttach.exe, or click... (the ellipses) to navigate to the Print Attach folder, select PrintAttachNet.WinFormsApp.exe, and click Open. Enter C:\Program Files\Allscripts\PrintAttach\ PrintAttachNet.WinFormsApp.exe, or click (the ellipses) to September 15, 2016 Allscripts Care Management

12 Chapter 2 Configure driver preferences and start the application navigate to the Print Attach folder, select PrintAttachNet.WinFormsApp.exe file, and click Open. 4. Click OK to close the Printing Defaults. 5. Click OK to close the Print Attach Properties. Note: Leave all other options in their default settings. 12 Allscripts Care Management 16.2 September 15, 2016

13 Chapter 3 Registry and Allscripts PrintAttach driver settings Registry settings and Allscripts Print Attach driver files You must have Read and Write permissions to access the HKEY_LOCAL_MACHINE\SOFTWARE\Black Ice Software LLC registry key. Windows XP install files Table 1: XP install files Description Name Locations Black Ice Documented Location Port monitor utility DLL BiImgUser.dll < SYSTEM > Application Starter BuPAppNT.exe < SYSTEM > Driver File BuPDRVNT.dll \spool\drivers\w32x86 \spool\drivers\w32x86\3 Driver initialization file AllscriptsPrintAttach -BuPiniNT.ini \spool\drivers\w32x86 \spool\drivers\w32x86\3 Port monitor file BuPMonNT.dll SYSTEM> Print processor file BuPProNT.dll \spool\prtprocs\w32x86 < PROCESSORDIR > Resource DLL BuPResNT.dll <SYSTEM> \spool\drivers\w32x86 \spool\drivers\w32x86\3 September 15, 2016 Allscripts Care Management

14 Chapter 3 Registry and Allscripts PrintAttach driver settings Description Driver Remove DLL User Interface DLL Name BiPRmvNT.dll BuPUifNT.dll Locations \spool\drivers\w32x86 \spool\drivers\w32x86\3 Black Ice Documented Location < SYSTEM > JPEG32.DLL Jpeg32.dll <SYSTEM> \spool\drivers\w32x86 \spool\drivers\w32x86\3 PDF32.DLL Pdf32.dll < SYSTEM > \spool\drivers\w32x86 \spool\drivers\w32x86\3 TIFF DLL Tiff32.dll <SYSTEM> \spool\drivers\w32x86 \spool\drivers\w32x86\3 Table 2: Terminal Services (TS) install files Description Name Locations Black Ice Documented Location Port monitor utility DLL BiImgUser.dll < SYSTEM > Application Starter BuPAppTS.exe < SYSTEM > Driver File BuPDRVTS.dll \spool\drivers\w32x86 \spool\drivers\w32x86\3 Driver initialization file AllscriptsPrintAttach- BuPiniTS.ini \spool\drivers\w32x86 \spool\drivers\w32x86\3 Port monitor file BuPMonTS.dll SYSTEM> Print processor file BuPProTS.dll \spool\prtprocs\w32x86 < PROCESSORDIR > Resource DLL BuPResTS.dll <SYSTEM> \spool\drivers\w32x86 \spool\drivers\w32x86\3 14 Allscripts Care Management 16.2 September 15, 2016

15 Registry settings and Allscripts Print Attach driver files Description Name Locations Black Ice Documented Location Driver Remove DLL BiPRmvTS.dll < SYSTEM > User Interface DLL BuPUifTS.dll \spool\drivers\w32x86 \spool\drivers\w32x86\3 JPEG32.DLL Jpeg32.dll <SYSTEM> \spool\drivers\w32x86 \spool\drivers\w32x86\3 PDF32.DLL Pdf32.dll < SYSTEM > \spool\drivers\w32x86 \spool\drivers\w32x86\3 TIFF DLL Tiff32.dll <SYSTEM> \spool\drivers\w32x86 \spool\drivers\w32x86\3 Table 3: TS install files Variable <SYSTEM> <WINDOWS> <DRIVERDIR> <PROCESSORDIR> Definition The system folder for the operating system; by default, Windows\. The Windows directory. For Windows NT or Windows 2000, the default location for the driver files is \WINNT\system32\spool\drivers\w32x86 and the \WINNT\system32\spool\drivers\w32x86\2. (The files should be copied to both of these directories.) To find this folder, use the dgetprinterdriverdirectory function from the InstallDLL. For Windows NT or Windows 2000, the default location for the print processor files is \WINNT\system32\spool\prtprocs\w32x86. To find this folder, use the dgetprintprocessordirectory function from the InstallDLL. September 15, 2016 Allscripts Care Management

16 Chapter 3 Registry and Allscripts PrintAttach driver settings 16 Allscripts Care Management 16.2 September 15, 2016

17 Chapter 4 Uninstalling Black Ice and Allscripts PrintAttach Uninstall Black Ice or Allscripts PrintAttach Uninstall Allscripts PrintAttach or the Black Ice driver. Before you begin Before you reinstall Allscripts PrintAttach or the Black Ice driver, you must completely uninstall all of the software's components using Windows Add/Remove programs. Note: When you uninstall an Allscripts PrintAttach version that was installed, the all-in-1 install program names the files slightly differently, using BuP instead of BiP. 1. Click Start > Control Panel > Programs > Programs and Features >. 2. Select either ECIN Print Attach or Allscripts Print Attach and click Uninstall. The following is displayed. 3. Click Yes. During the uninstall, you will receive the following dialog box related to closing the Print Spooler. September 15, 2016 Allscripts Care Management

18 Chapter 4 Uninstalling Black Ice and Allscripts PrintAttach Note: Allscripts recommends that you select Do not close applications. Results of this task Both Black Ice and Allscripts PrintAttach PDF should be uninstalled, as the new install program will install both programs at the same time. Note: If Allscripts PrintAttach PDF is not displayed in the Add/Remove Programs, you must uninstall it manually. What to do next Because the uninstall of Black Ice often does not remove all the associated files, DLL and registry setting, you must manually delete these files. 18 Allscripts Care Management 16.2 September 15, 2016

19 Manually delete other Black Ice files and registry settings Manually delete other Black Ice files and registry settings To ensure that the reinstallation of Black Ice and Allscripts PrintAttach PDF works correctly, you must ensure that any Black Ice files, dll and registry settings that were not removed using Add/Remove, are deleted. Note: When you uninstall an Allscripts PrintAttach version that was installed using the new program, note that the new all-in-one install program names the files slightly differently, using BuP instead of BiP. 1. Delete the following files if they are still present on your computer. The file names for the terminal services version will have TS instead of NT. > C:\WINNT\system32\BiPMonNT.dll C:\WINNT\system32\BiPResNT.dll > C:\WINNT\system32\BiPAppNT.exe C:\WINNT\system32\BiPiniNT.ini > C:\WINNT\system32\BiPImg.dll > C:\WINNT\system32\spool\drivers\w32x86\2\BiPDrvNT.dll > C:\WINNT\system32\spool\drivers\w32x86\2\BiPiniNT.ini > C:\WINNT\system32\spool\drivers\w32x86\2\BiPUifNT.dll > C:\WINNT\system32\spool\drivers\w32x86\BiPDrvNT.dll > C:\WINNT\system32\spool\drivers\w32x86\BiPiniNT.ini > C:\WINNT\system32\spool\drivers\w32x86\BiPUifNT.dll 2. Delete the following registry settings, if they are still present on your computer. > HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\Environments\Windows NT x86\drivers\version-2\black Ice PDF Driver > HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\Environments\Windows NT x86\printprocessors\pdf Print Processor > HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\Monitors\Ice Monitor P > HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\Printers\Black Ice PDF 3. Search the registry for ECIN PrintAttach, and delete any instances found of ECIN PrintAttach. September 15, 2016 Allscripts Care Management

20 Chapter 4 Uninstalling Black Ice and Allscripts PrintAttach Results of this task Your computer should be clean and no longer have the files and registries from the previous installation and ready for the new installation of Black Ice and Allscripts PrintAttach PDF 20 Allscripts Care Management 16.2 September 15, 2016

21 Index Index A Allscripts PrintAttach 5 configure driver preference 11 install files 13 start application 11 testing 9 I Installation on 32-bit Windows 7 server 6 on 64-bit Windows 7 server 7 on 64-bit Windows 8 or 10 server 7 Installation (continued) on Citrix with terminal services 8 installation for Windows server Allscripts PrintAttach 6 R registry settings 13 S Supported operating systems Allscripts PrintAttach 5 U Uninstall Allscripts PrintAttach 17, 19 Black Ice 17, 19 September 15, 2016 Allscripts Care Management

22 Index 22 Allscripts Care Management 16.2 September 15, 2016