============================================================================= Run Date: JUL 20, 2021 Designation: MAG*3*258 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #205 Status: Released Compliance Date: AUG 20, 2021 ============================================================================= Subject: Clinical Display Defects Category: - Routine Description: ============ This document describes MAG*3.0*258, a patch that provides fixes to the VistA Imaging Clinical Display. This patch addresses the following issues: INC8727563 - MAC: P234 VI Display will not view images side-by- side in 2X1 stack view settings INC9415571 - BCS-2/V23/MIN (618) Primary Care Social Work office reports Advance Directive patient filter results have non-advance directive documents listed in addition to expected results. INC11275507 - Add "Duplicate Entry" to the VistA Imaging QA Review function in VistA Imaging INC9876109 - View side-by-side images in CPRS>VISTA IMAGING without the image moving in the opposite direction of the arrows selected Enhancement - Add '200CRNR' site code to VI 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: ----------------------- Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) and Overview: 1. Defect 1197398 (INC8727563) - MAC:P234 VI Display will not view images side-by-side in 2X1 stack view settings Problem: -------- VI Display will not allow users to view images side-by-side in the 2X1 stack view settings. Display works on the 1X1, 3X2, and 4X3. Additionally, image in Full Resolution View is greyed out. Resolution: ----------- Resolved error by making a change to the Radiology Viewer. With this update, when a user initially enters the Radiology Viewer and loads only one study (1x1) before changing the setting to 2x1, it will display the first study in both viewers. In this case, the first viewer contains the image the user selected, and the second viewer contains the first image of the study. Previously, if a user closed the viewer and reopened it, it did not reload the second study. This issue was resolved by changing the code to force the second view mode after loading if the viewer is initially opened with one study in the 2x1 stack mode. The viewer will then reload the image in the second viewer regardless of the number of studies opened. 2. Defect 1260340 (Trouble Ticket INC9415571) - BCS-2/V23/MIN(618) Primary Care Social Work office reports Advance Directive patient filter results have non-advance directive documents listed in addition to expected results. Problem: -------- The VistA Imaging Display filters based on Type do not work properly. When a public or private filter based on Type is selected, image entries without a specified Type are always included along with the results to the image entries which match the designated type. For example, when the Public filter 'Advance Directive' is selected, the resulting list will include the patient's advance directive image entries as well as any image entries without an assigned Type Index value. Resolution: ----------- Modified filter to exclude image entries without a specified type when the user has designated a type value. 3. Defect 1280968 (Trouble Ticket INC11275507) - Add "Duplicate Entry" to the VistA Imaging QA Review function in VistA Imaging Problem: -------- Requestor wishes to add "Duplicate Entry" to the VistA Imaging QA Review function in VistA Imaging. This will be an additional choice for staff to select when marking an image as needing QA Review in VistA Imaging. Resolution: ----------- Added "Duplicate Entry" entry in the MAG REASON (#2005.88) file. 4. Defect 1289184 (Trouble Ticket INC9876109) - View side-by-side images in CPRS>VISTA IMAGING without the image moving in the opposite direction of the arrows selected. Problem: -------- AEU is experiencing an issue with side-by-side images while attempting to compare two CT images in the Radiology Viewer. The mouse scroll button initially tracks in the same starting direction but loses sync when attempting to change direction. Resolution ---------- Research revealed that this was introduced in Mag*3.0*188 as a result of a fix to a scrolling issue that was addressed in that patch. A mouse scroll timer had been added that worked OK in the initial stack (1x1) but not if two stacks were showing (2x1). To resolve the problem, a code change was made in P258T2 to add the backward/forward click events back to the scroll timer code, resolving the directional scrolling problems so that both images move in the same directions (backward and forward) when the "scroll images together" option is selected. 5. Enhancement IMAG-1095 (Trouble Ticket INC1298903) - Add '200CRNR' site code to VI Problem: -------- For Vista Imaging Display, add, connect and display '200CRNR'/CERNER site code to the patient's treatment facility list. Also, display Cerner-related non-DICOM images. In addition, turn off Annotations/Annotations history calls and file/text file requests for Cerner-related images as these are not supported in Cerner. A couple of things were found in the P258T2 build during pre-CERNER testing that were addressed here in the P285T3 build. * The CERNER tab had no records in either IPO1 or IPO2 and the DOD tab disappeared. * Load Annotations and Load Annotations history were being called and producing errors. * Load Text File being called and producing errors and sluggish performance. Resolution ---------- Four actions were required to resolve this enhancement request/bug in the P258T3 build: 1) For the enhancement, development changed references of DOD to CRNR and related messages, plus duplicated CRNR enhancement code from VI Capture. Development changed only code related to the display of images, as there were some 100 various modules within our codebase that reference DOD. 2) To resolve the CERNER/DOD tab issues, development changed references in the treatment facility routine so that it names the tabs "200CRNR" for CERNER and "200" for DOD. This made all tabs reappear, and additional tweaks to the server calls enabled retrieval of the missing CERNER records. 3) To resolve the "load annotations/load annotations history" errors, development removed all calls that get annotations and annotations history information for CERNER and for DOD. There were multiple places this was needed, as a couple had been missed in the first pass through the code in P258T2. 4) And finally, to resolve the text file errors, development removed calls that request downloading a text file for both CERNER and DOD tabs, because these facilities do not support this text file. Test Site(s): ----------- Boise VA Medical Center (Boise, ID) VA Puget Sound Health Care System (Seattle, WA) 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_0P258.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 --------------------------------------------------------------------- Kernel Installation and MAG3_0P258.KID Distribution System (KIDS) build for MAG*3.0*258 VistA Imaging Clinical Display installation file - New MAG3_0P258_CLINICAL_DISPLAY_SETUP.EXE VistA Imaging Clinical Display push installation file MAG3_0P258_CLINICAL_DISPLAY_INSTALL.MSI Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*258 MAG3_0P258_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P258_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*258 is released, the list of supported versions of Clinical Display will change: Client Versions Supported: * 3.0.258 * 3.0.256 * 3.0.225 Client Versions No Longer Supported: * 3.0.234 * 3.0.216 * 3.0.188 Pre/Post Installation Overview: MAG*3.0*258 must be installed on the VistA System and on 64-bit workstations on which the VistA Imaging Applications will be used. This patch must be installed by the compliance date. This patch should take less than five minutes to install. All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*258. The Clinical Display Application is only supported on Windows 10 operating systems. Other operating systems are not officially supported. Clinical Display is distributed as an MSI and EXE installation. The MSI is intended for sites that want to do a push installation (using SCCM or another tool). The EXE is intended for use to install on a single workstation. The MAG3_0P258_Clinical_Display_Setup.exe file can be installed manually on workstations as described in the Single Workstation Installation section in the VistA Imaging System Installation Guide. 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_0P258.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*258). 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 of any routines exported with this patch. It will not backup any other changes such as DDs or templates. 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. When prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. Post-Installation Instructions: N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: If it is necessary to uninstall the MAG*3.0*258 client, use the Uninstall option from Programs and Features within Windows Control Panel to Uninstall: VistA Imaging Clinical Display. Then install the previous version of Clinical Display which was included in MAG*3.0*256. KIDS Uninstall: If it is necessary to uninstall the MAG*3.0*258 VistA KIDS, then select the Kernel Installation & Distribution System menu option, Backup a Transport Global, see the Installation Steps section where step 4c must be done before installing the patch. Administrators will need to use the PackMan function INSTALL/CHECK MESSAGE. Check the MailMan messages for the backup message sent by the Backup a Transport Global function executed prior to the patch install. 1. Select the message shown below: Backup of MAG*3.0*258 install on 2. Select the Xtract PackMan option. 3. Select the Install/Check Message option. 4. Enter Yes at the prompt. 5. Enter No at the backup prompt. There is no need to back up the backup. Enter message action (in IN basket): Ignore// Xtract PackMan Select PackMan function: ? Answer with PackMan function NUMBER, or NAME Choose from: 1 ROUTINE LOAD 2 GLOBAL LOAD 3 PACKAGE LOAD 4 SUMMARIZE MESSAGE 5 PRINT MESSAGE 6 INSTALL/CHECK MESSAGE 7 INSTALL SELECTED ROUTINE(S) 8 TEXT PRINT/DISPLAY 9 COMPARE MESSAGE Select PackMan function: Select PackMan function: 6 INSTALL/CHECK MESSAGE Warning: Installing this message will cause a permanent update of globals and routines. Do you really want to do this? NO// YES Routines are the only parts that are backed up. NO other parts are backed up, not even globals. You may use the Summarize Message option of PackMan to see what parts the message contains. Those parts that are not routines should be backed up separately if they need to be preserved. Shall I preserve the routines on disk in a separate back-up message? YES// NO No backup message built. Line 2 Message #43934 Unloading Routine MAGXXXX (PACKMAN_BACKUP) Select PackMan function: Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 22 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGGTU4D Before: B4951761 After: B4954392 **93,94,106,117,122,131,149, 138,156,161,167,181,191,188, 216,234,225,256,258** Routine Name: MAGIP258 Before: n/a After: B6596351 **258** Routine Name: MAGSIXG3 Before:B109262683 After:B109900690 **93,117,150,138,167,221,258** Routine list of preceding patches: 221, 256 ============================================================================= User Information: Entered By : Date Entered : MAR 04, 2020 Completed By: Date Completed: JUL 14, 2021 Released By : Date Released : JUL 20, 2021 ============================================================================= Packman Mail Message: ===================== No routines included