============================================================================= Run Date: AUG 22, 2023 Designation: MAG*3*291 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #245 Status: Released Compliance Date: SEP 22, 2023 ============================================================================= Associated patches: (v)MAG*3*321 <<= must be installed BEFORE `MAG*3*291' Subject: VI CLINICAL CAPTURE - DEFECT PATCH Category: - Routine Description: ============ This document describes MAG*3.0*291, a patch that provides fixes to VistA Imaging Clinical Capture. This patch addresses the following issues: Defects: -------- 1. HDSO-1297/INC19274331 - Progress Notes window expand and goes to out of screen when changing the font size. 2. HDSO-1293/INC19273882 - Vista imaging Capture cuts off the word Cancel on the button in Create New Note window. Adaptive Maintenance: --------------------- 1. Accusoft Errors: HDSO-1290/INC16332567 - Accusoft errors when trying to capture dermatology images from a Google PXL camera (Google Pixel 2). HDSO-1298/INC16486908 - Photo won't upload via capture. HDSO-1296/INC11769541/INC22675150 - AEU receives an error when capturing Telederm images. 2. HDSO-1292 - Upgraded Delphi from 10.2.4 to 10.4 3. HDSO-1295 - Updated C++ binary compatibility of Clinical Capture to the latest version (2017). 4. HDSO-1291/INC10833657 - VI Clinical Capture will not support a jpg sent from a camera. 5. HDSO-3937 - Index out of bounds. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- N/A Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1. HDSO-1297/INC19274331 - Progress Notes window expand and goes to out of screen when changing the font size. Problem: -------- When changing font size, the progress notes window expands beyond the monitor's width. Resolution: ----------- Required code changes. When there is a change of the progress notes font size, the code now checks that the screen does not exceed the monitor's width. 2. HDSO-1293/INC19273882 - Vista imaging Capture cuts off the word Cancel on the button in Create New Note window. Problem: -------- Vista imaging Capture cuts off the word Cancel on the button in Select progress note / Create New Note tab. Resolution: ----------- Required code changes - On Font window, system now defaults and shows the new changed font style values instead of MS Sans Serif, black and font size. Additionally, the progress note window properly resizes all fields when the font, font size, or font style is changed. Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- 1. Accusoft Errors: HDSO-1290/INC16332567 - Accusoft errors when trying to capture dermatology images from a Google PXL camera (Google Pixel 2). HDSO-1298/INC16486908 - Photo won't upload via capture. HDSO-1296/INC11769541/INC22675150 - AEU receives an error when capturing Telederm images. Problem: -------- VA sites had attempted to import images using the VI Capture application, but encountered the following error message: "**2 Accusoft errors***, *for file: c:/users/vhaXXX/Desktop/XXXXX/XXXXX.jpg Action was ImageGear: Loading Image, *Error=2 of 2 *Pointer passed to an IP function is NULL, *Error- 1 of 2 * XML parser has return unknown error." Resolution: ----------- Upgraded the Accusoft version within the Clinical Capture client from v16 to v18. This allowed image import without any of the previous errors. 2. HDSO-1292 - Upgraded Delphi from 10.2.4 to 10.4 Problem: -------- Delphi 10.2.4 within Clinical Capture was no longer TRM compliant. Resolution: ----------- Upgraded Delphi from 10.2.4 to 10.4. 3. HDSO-1295 - Updated C++ binary compatibility of Clinical Capture to the latest version (2017). Problem: -------- Existing C++ binary compatibility of Clinical Capture are no longer TRM compliant. Resolution: ----------- Updated C++ binary compatibility of Clinical Capture to the latest, with the correct 2017 C++ binaries being added during installation if not present. 4. HDSO-1291/INC10833657 - VI Clinical Capture will not support a jpg sent from a camera. Problem: -------- VI capture will not support a jpg sent from a camera. Resolution: ----------- Upgraded Clinical Capture client Upgraded Accusoft from v16 to v18 which then allowed capture without errors. 5. HDSO-3937 - Index out of bounds. Problem: -------- The index error appears immediately following the "Apply" and "OK" buttons and the font is simultaneously changed. The progress note window does not close until the "OK" button is pressed on the index. In the development environment, the security key 'MAG NOTE EFILE' is assigned to the test user account, therefore when the code attempted the resize of radio button "Electronically Filed" the out of index error message is not shown. Resolution: ----------- The index out of bounds error occurred when attempting to resize radio button "Electronically Filed" via menu "Option->Font" in the background. The radio button "Electronically Filed" is added to the group box "New Notes Status" if the user has security key 'MAG NOTE EFILE'. Test Sites: ----------- Alexandria VA Health Care System (Alexandria, VA) Puget Sound VA Health Care System (Seattle, WA) Test Sites - SNOW Change Order #: Alexandria VA Health Care System (Alexandria,VA):CHG0395523 Puget Sound VA Health Care System (Seattle, WA) :CHG0395384 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P291.KID Other Software Files: This release also includes other software files. These files can be obtained by accessing the URL: https://download.vista.domain.ext/index.html/SOFTWARE. File Title File Name Format -------------------------------------------------------------------------- Kernel Installation and MAG3_0P291.KID ASCII Distribution System (KIDS) build for MAG*3.0*291 VistA Imaging Clinical Capture MAG3_0P291_ Binary Push Installation File CLINICAL_CAPTURE_INSTALL.MSI Vista Imaging Clinical Capture MAG3_0P291_ Binary Workstation Installation File CLINICAL_CAPTURE_SETUP.EXE Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE Documentation Title File Name -------------------------------------------------------------------------- Patch Description for MAG*3.0*291 MAG3_0P291_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P291_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Supported Client Versions: -------------------------- When MAG*3.0*291 is released, the list of supported versions of Clinical Capture will change: Client Versions Supported: -------------------------- 3.0.291 3.0.321 3.0.267 Client Versions No Longer Supported: ------------------------------------ 3.0.264 3.0.226 3.0.233 Pre/Post Installation Overview: -------------------------------- MAG*3.0*291 must be installed on the VistA System. This patch must be installed by the compliance date. This patch should take less than five minutes to install. Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*291. Installation Instructions: -------------------------- 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/MAG3_0P291.KID 2. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, A. Select the Verify Checksums in Transport Global option to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME enter the patch or build name. (ex. MAG*3.0*291). NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. i. At the Installation option menu, select Backup a Transport Global ii. At the Select INSTALL NAME prompt, enter your build MAG*3.0*291 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build iv. When prompted "Do you wish to secure this message? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. vii. Repeat step ii for each build in the host file. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install?,' answer NO. ii. If prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. iii. If prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols?,' answer NO. KIDS Installation Example: --------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*291 12/16/22@15:07:26 => MAG*3.0*291 v3 ;Created on Dec 16, 2022@13:55:27 This Distribution was loaded on Dec 16, 2022@15:07:26 with header of MAG*3.0*291 v3 ;Created on Dec 16, 2022@13:55:27 It consisted of the following Install(s): MAG*3.0*291 Checking Install for Package MAG*3.0*291 Install Questions for MAG*3.0*291 Want KIDS to INHIBIT LOGONs during the install? NO// Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// HOME (CRT) Install Started for MAG*3.0*291: Installing Routines: Dec 16, 2022@15:08:36 Running Post-Install Routine: POS^MAGIP291 Post Install Mail Message: Dec 16, 2022@15:08:36 Updating Routine file... Updating KIDS files... MAG*3.0*291 Installed. Dec 16, 2022@15:08:36 Not a production UCI NO Install Message sent -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Client Installation Instructions -------------------------------- For installing or updating, refer to the VistA Imaging System Installation Guide. Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Please refer to the Deployment, Implementation, Back-Out and Rollback Guide (MAG3_0P291_DIBORG.PDF) for Client Installation instructions. Uninstalling the Application: ----------------------------- If it is necessary to uninstall the MAG*3.0*291 client, use the Uninstall option from Programs and Features within Windows Control Panel to Uninstall: VistA Imaging Clinical Capture. Then install the previous version of Clinical Capture which was included in MAG*3.0*321. Note: There are special installation instructions for MAG*3.0*321. Be sure to review the associated readme file (MAG3_0P321_README.PDF) when reverting to this version from the following location: https://download.vista.domain.ext/index.html/SOFTWARE/MAG3_0P321_README.p df KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*291 VistA KIDS, the patch backup must be installed. The Kernel Installation & Distribution System menu option, Backup a Transport Global should have been used to create a patch backup of the build prior to installing the patch. (see Installation Steps section, step 2b). Administrators will need to check MailMan for the backup message sent by the Backup a Transport Global function executed prior to the patch install. The patch backup must first be loaded from the MailMan backup message, by performing the message action Xtract KIDS, followed by the PackMan function INSTALL/CHECK MESSAGE. The patch may then be installed using the Install Package(s) option in the KIDS Installation menu. 1. Navigate to the Mailman inbox containing the patch backup message. a. Select the MAG*3.0*291 backup message as shown below: * Backup of MAG*3.0*291 install on b. At the "Enter message action:" prompt, select the Xtract PackMan option. c. At the "Select PackMan function:" prompt, select the Install/Check Message option. d. Enter Yes at the prompt "OK to continue with Load?" 2. Navigate to the Kernel Installation and Distribution System Menu and select the Installation Menu. From this menu: a. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 61 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGGTU4C Before: B4977181 After: B4954042 **93,94,106,117,122,129,140, 151,178,189,211,215,223,233, 226,264,267,321,291** Routine Name: MAGIP291 Before: n/a After: B4076421 **291** Routine list of preceding patches: 321 ============================================================================= User Information: Entered By : JR Date Entered : DEC 15, 2020 Completed By: Date Completed: AUG 21, 2023 Released By : Date Released : AUG 22, 2023 ============================================================================= Packman Mail Message: ===================== No routines included