$TXT Created by K at DEVFEX.DOMAIN.EXT (KIDS) on Wednesday, 07/27/22 at 14:52 ============================================================================= Run Date: AUG 11, 2022 Designation: DVBA*2.7*238 Package : DVBA - AUTOMATED MED INFO EXCHANGE Priority: EMERGENCY Version : 2.7 SEQ #205 Status: Released Compliance Date: AUG 15, 2022 ============================================================================= Associated patches: (v)DVBA*2.7*179<<= must be installed BEFORE `DVBA*2.7*238' (v)DVBA*2.7*240<<= must be installed BEFORE `DVBA*2.7*238' Subject: CLINICAL DOCUMENTS AND DELPHI 10.4 UPGRADE Category: - Routine - Other - Data Dictionary Description: ============ ******************************************************************** * ** IMPORTANT ** ** IMPORTANT ** ** IMPORTANT ** * * * * The installer MUST hold the XUMGR key in order for the * * new security key to be installed and added to necessary users * * correctly. * * Post Release schedule MUST be followed to prevent errors with * * Security Certificate Validation. * ******************************************************************** The BFI DocOperations service that CAPRI GUI currently uses as an endpoint for sending Clinical Documents to eFolder resides on a server that is scheduled for decommissioning by the end of August 2022. In order to maintain the capability to send Clinical Documents to the eFolder, the CAPRI GUI will send documents directly to the eFolder. 1. VistA has been modified to add CAPRI CLINICAL EFOLDER TRANSMISSIONS (#396.21) file to store transmission metrics for eFolder processes. 2. VistA has been modified to add DVBA CAPRI CLIN DOC-EFOLDER security key to allow DVBA CAPRI GUI users to send clinical documents to the eFolder. 3. VistA has been modified to add DVBA METRICS DATA REPORT option to allow users to run a report of the eFolder transmission metrics. 4. VistA has been modified to add DVBA CAPRI METRICS PURGE security key and option to allow a user to purge eFolder transmission data. 5. VistA has been modified to add DVBA METRICS DATA REPORT to the DVBA C MEDICAL ADM REPORT MENU. 6. VistA has been modified to add DVBA METRICS DATA PURGE to the DVBA C MEDICAL ADM REPORT MENU. Patch DVBA*2.7*238 is also addressing 1. CAPRI GUI is updated to DELPHI 10.4 to comply with the VA Enterprise TRM requirements. 2. INC21519211: CAPRI - unable to sign DBQ - DBQ XML schema validation failed. Patch Components: ---------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- CAPRI CLINICAL EFOLDER 396.21 New TRANSMISSIONS Forms Associated: Form Name File # New/Modified/Deleted --------- ------ -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- DVBA CAPRI GUI MENU Modified DVBA METRICS DATA PURGE RUN ROUTINE New DVBA METRICS DATA REPORT RUN ROUTINE New Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- DVBA CAPRI CLIN DOC-EFOLDER DVBA CAPRI METRICS PURGE Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- ------------------- DVBA CAPRI CLINDOC URLS New DVBA CAPRI GET EFOLDER TOKEN New DVBA CAPRI GET PAR DESC New DVBA CAPRI GET TOGGLES New DVBA CAPRI PARAM INQ New DVBA CAPRI PARAM UPDATE New DVBAB VERSION New DVBA CAPRI SET METRICS New DVBA CAPRI PURGE MET New DVBA CAPRI GET MET RPT New Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- ------------------- DVBAB CAPRI CDEFOLD TOKEN New DVBAB CAPRI PIV ACTIVE New DVBAB CAPRI PIV URL New DVBAB CAPRI PREVIOUS VERSION New DVBAB CAPRI PROXY ACTIVE New DVBAB CAPRI PROXY URL New DVBAB PIV RESOURCE New DVBAB PROXY RESOURCE New DVBAB TRANSMISSION PRIORITY New Additional Information: N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1.) INC21519211: CAPRI - unable to sign DBQ - DBQ XML schema validation failed Problem: --------- The new XML Validation introduced by DVBA*2.7*240 is catching an error where the metadata has not been generated for the XML which is utilized to transmit a DBQ. The reason for the missing metadata is that a memo within the DBQ contains an invalid character. When CAPRI is generating the nodes for our XML at run time, trying to process the invalid XML causes an error to occur, thus the metadata is skipped and the XML is not complete. Resolution: ----------- CAPRI GUI is reviewing the XML for invalid characters then replacing with the text [Unknown Character]. This will then allow the XML to be transmitted successfully. Test Sites: ---------- Tampa VA Medical Center (Tampa, FL) Software and Documentation Retrieval Instructions: ---------------------------------------------------- The software for this patch is being released in a PackMan message Other Software Files: This release also includes other software files. They can be obtained at location: /srv/vista/patches/Software Other software files can also be obtained by accessing the URL: https://download.vista.domain.ext/index.html/SOFTWARE File Title File Name FTP Mode ----------------------------------------------------------------------- CAPRI GUI ZIP DVBA_27_P238_2.ZIP BINARY Zip file contents: - CAPRI.exe CAPRI v238.2 executable - VACAPRIVVA.dll Virtual VA dynamically linked library - CAPRI_Help.chm CAPRI On-line Help - CAPRI.map CAPRI error map - CAPRISession.rdox MicroFocus Reflection session configuration - CapriTerminalEmulators.ini - ssh_config Secure Shell configuration - Libeay32.dll VLER /DAS dynamically linked library - Ssleay32.dll VLER /DAS dynamically linked library - QPDF.exe Support PDF compression and Linearization - QPDF13.dll Support PDF compression and Linearization - LIBGCC_S_DW2-1.dll Support PDF compression and Linearization - LIBSTDC++-6.dll Support PDF compression and Linearization - DelZip192.dll Delphi Zip Dynamically linked library - DelZip192x64.dll Delphi Zip Dynamically linked library - TUtil32.dll Table Utility Dynamically linked library - UnzDll.dll Delphi Unzip Dynamically linked library 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 ----------------------------------------------------------------------- DEPLOYMENT, INSTALLATION, BACK-OUT and ROLLBACK GUIDE DVBA_DIBRG.PDF DVBA_DIBRG.DOCX CAPRI GUI USER MANUAL DVBA_UM.PDF DVBA_UM.DOCX SYSTEM ADMINISTRATION AND TECHNICAL GUIDE DVBA_TM.PDF DVBA_TM.DOCX CAPRI RELEASE NOTES DVBA_2_7_238_RN.PDF DVBA_2_7_238_RN.DOCX DVBA AMIE TECHNICAL MANUAL AMIE_TM.PDF AMIE_TM.DOCX DVBA AMIE USER MANUAL AMIE_UM.PDF AMIE_UM.DOCX Patch Installation: Pre/Post Installation Overview: ------------------------------- N/A Pre-Installation Instructions: ------------------------------ This patch may be installed with users on the system although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 5 minutes to install. IMPORTANT- The installer MUST hold the XUMGR key in order for the new security key to be installed and added to necessary users correctly. Installation Instructions: -------------------------- The CAPRI GUI is CAPRI.exe contained in DVBA_27_P238_2.ZIP. Please refer to the DVBA_DIBRG.doc document for supplemental installation instructions regarding the installation of the following files: VACAPRIVVA.dll Virtual VA dynamically linked library CAPRI_Help.chm CAPRI On-line Help CAPRI.map CAPRI error map ssh_config Secure Shell configuration Libeay32.dll VLER /DAS dynamically linked library CapriTerminalEmulators.ini Configuration settings Ssleay32.dll VLER /DAS dynamically linked library QPDF.exe Support PDF compression and Linearization QPDF13.dll Support PDF compression and Linearization LIBGCC_S_DW2-1.dll Support PDF compression and Linearization LIBSTDC++-6.dll Support PDF compression and Linearization CAPRISession.rdox Micro Focus Reflections configuration DelZip192.dll Delphi Zip Dynamically linked library DelZip192x64.dll Delphi Zip Dynamically linked library TUtil32.dll Table Utility Dynamically linked library UnzDll.dll Delphi Unzip Dynamically linked library NOTE: DVBA*2.7*238 MUST be installed in all production VistA instances throughout the enterprise prior to the deployment of CAPRI GUI v2.7.238.2 to avoid possible disruptions of services by VBA and National CAPRI GUI users. Post release installation and deployment schedule: Post Release Days 1-5 (August 11-August 15): VistA Patch DVBA*2.7*238 will be deployed to all VistA production instances. Users will not see or experience any changes. Post Release Days 6-9 (August 16-August 19): CAPRI GUI v2.7.238.2 will be deployed to all applicable endpoint devices to include client desktop workstations, VistA Application Consolidated Servers (VACS) and other application shares, the Citrix Virtual Desktops. Installation Instructions: -------------------------- 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 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. ) 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 DVBA*2.7*238 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build (including Routines) R Routines Enter response: Build (including Routines) 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. 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 of the 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? NO//', answer . ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer . iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer . Post-Installation Instructions ------------------------------ N/A Back-Out Plan: -------------------- Back-out Procedures are only needed if there are major problems (examples include the KIDS notice of incompletion or hard errors) resulting from the installation of this patch. Log a ServiceNow helpdesk ticket so the development team can assist in this process. Prior to installing a patch, the site/region should have saved a back-up of the routines in a mail message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The message containing the backed-up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The Packman function "INSTALL/CHECK MESSAGE" is then used to install the backed-up routines. Routine Information: ==================== The second line of each of these routines now looks like: ;;2.7;AMIE;**[Patch List]**;Apr 10, 1995;Build 16 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DVBAB1 Before:B100042303 After:B108027921 **35,37,50,42,53,57,73,104,109, 137,146,143,179,238** Routine Name: DVBABURL Before: B10774984 After: B12675140 **104,136,143,149,168,181,186, 192,205,237,240,238** Routine Name: DVBC238P Before: n/a After: B5129382 **238** Routine Name: DVBCP238 Before: n/a After: B18211790 **238** Routine Name: DVBCPUSH Before: n/a After: B21437561 **238** Routine Name: DVBCTOG Before: n/a After: B21760317 **238** Routine list of preceding patches: 179, 240 ============================================================================= User Information: Entered By : Date Entered : DEC 14, 2021 Completed By: Date Completed: AUG 10, 2022 Released By : Date Released : AUG 11, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT