$TXT Created by at DEVFEX.DOMAIN.EXT (KIDS) on Tuesday, 12/17/24 at 12:12 ============================================================================= Run Date: JAN 10, 2025 Designation: DVBA*2.7*252 Package : DVBA - AUTOMATED MED INFO EXCHANGE Priority: Mandatory Version : 2.7 SEQ #213 Status: Released Compliance Date: FEB 03, 2025 ============================================================================= Associated patches: (v)DVBA*2.7*250<<= must be installed BEFORE `DVBA*2.7*252' (v)DVBA*2.7*251<<= must be installed BEFORE `DVBA*2.7*252' Subject: CAPRI GUI NEW CMT FUNCTIONALITY Category: - Routine - Data Dictionary - Other Description: ============ Patch DVBA*2.7*252 introduces the Progress Notes Construction Set (PNCS) replacement, Content Management Tool (CMT) system. This allows the Medical Disability Examination Office (MDEO) to create/update DBQ forms as needed. With the introduction of CMT, Compensation and Pension Record Interchange (CAPRI) will also allow users to create and edit Disability Benefits Questionnaires (DBQ) in a Portable Document Format (PDF). Patch DVBA*2.7*252 will also be addressing 508 issues and the following: INC27409886: Deleting an Open Template INC23389024: Disabled users still able to connect to claims.domain.ext INC30600763: Cannot access CAPRI Training Site INC34120499: CAPRI default/timeout window is "save and exit" rather than "keep working" which causes issues CAPRI 8151: When the User Runs the Report Builder, Blank Drug Classes will be Populated with Incorrect Data CAPRI-7883: Resizing Voc-Rehab Medical Services Request Dialog CAPRI-7884: Resizing Address Verification CAPRI-7879: Exam Reference Error in VistA-When the requested exam is opened, the field labeled 'Exam Reference' is being filled with the record number instead of the actual exam reference number based in VistA CAPRI-7867: Report Builder-data from the Diet tab appears in another patients data CAPRI-8244: Deprecate the CAPRI Manifest Query Going to DAS to Support DAS Release CAPRI-11150: Surgery Report error message encountered: DVBAB OPERATION REPORT could not be accessed! CAPRI-10958: Empty window displaying on screen during CAPRI worksheet signing process CAPRI-12105: Surgery Report Ok Button Active without Report Selected, Out of Bound error message received CAPRI-10314: Capability to Sort and Filter the Edit Local Tab in DBQ Push Utility using an RPC CAPRI-11496: EFolder Transmission message for Remote Users CAPRI-11586: Display Error Message for Users for Missing SecID in the NEW PERSON File CAPRI-11938: SecID and SSN Validation based on VistA DVBA CAPRI SECURITY TOGGLE Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- CAPRI TEMPLATES(#396.17) DOCUMENT MANAGER(#2) Modified WORKSHEET ORIGINATOR(#13) New CMT PDF TEMPLATE DATA (#27) New CMT PDF TEMPLATE DATA (#27.01) New CMT PDF SAVE DATE (#27.02) New CMT TEMPLATE UTILIZED (#27.03) New CMT SAVE DATA COMMENTS (#27.04) New CMT PDF DATA (#27.05) New CMT PDF DATA (#27.0501) New SIGNER (#28) New COSIGNER REQUIRED (#29) New COSIGNER (#30) New 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 ----------- ---- -------------------- DVBA CAPRI GUI GUI Modified 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 --------------------- -------------------- DVBA CAPRI ADD EXAM New DVBA CAPRI CMT SSN VAR New DVBA CAPRI CMT TOGGLE New DVBA CAPRI CREATE WORKSHEET New DVBA CAPRI DBQ TRANS FAIL LIST New DVBA CAPRI DELETE CHECK New DVBA CAPRI DELETE EXAM New DVBA CAPRI DELETE WORKSHEET New DVBA CAPRI EXAM RESTORE New DVBA CAPRI GET DBQ PDF New DVBA CAPRI GET EFOLDER TOKEN New DVBA CAPRI GET EXAM HISTORY New DVBA CAPRI GET EXAM PDF New DVBA CAPRI GET EXAMINER INFO New DVBA CAPRI GET GITHUB DATA New DVBA CAPRI GET GITHUB DATE New DVBA CAPRI GET SECID New DVBA CAPRI GET WORKSHEET New DVBA CAPRI GET WORKSHEET LIST New DVBA CAPRI GITHUB DATE New DVBA CAPRI GITHUB LOCATION New DVBA CAPRI IEPD DATA New DVBA CAPRI INVALID CHAR LIST New DVBA CAPRI PASCAL CHECK New DVBA CAPRI PDF SIG FIELD NAMES New DVBA CAPRI SAVE EXAM PDF New DVBA CAPRI SAVE REVIEW DATA New DVBA CAPRI SAVE SIGNER New DVBA CAPRI SECURITY TOGGLE New DVBA CAPRI TEMP DEF LIST New DVBA CAPRI TRAINEE DOC MANAGER New DVBA CAPRI TRAINEE SIGNATURE New DVBA CAPRI UNCOSIGN COUNT New DVBA CAPRI UNCOSIGNED INFO New DVBA CAPRI UNLOCK EXAM New DVBA CAPRI WORKSHEET UPDATE New DVBAB TEMPLATE REPORT FULL Modified DVBA CAPRI PN TOGGLE New DVBA CAPRI ALERTS DATA New DVBA CAPRI PARAM INQ New DVBA CAPRI PARAM UPDATE New DVBA CAPRI PDF LOGIC TOGGLE New DVBA CAPRI STATUS COUNT New DVBA CAPRI WORKSHEET BY EXAM New Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- DVBAB CAPRI CMT SSN VAR New DVBAB CAPRI CMT TOGGLE New DVBAB CAPRI DOC LIBRARY New DVBAB CAPRI GITHUB APP ID New DVBAB CAPRI GITHUB ERROR DATE New DVBAB CAPRI GITHUB INSTALL ID New DVBAB CAPRI GITHUB LINK New DVBAB CAPRI GITHUB TOKEN New DVBAB CAPRI INVALID CHARACTERS New DVBAB CAPRI PDF SIG FLD NAMES New DVBAB CAPRI SECURITY TOGGLE New DVBAB CAPRI SP IEPD INFO New DVBAB CAPRI PN TOGGLE New DVBAB CAPRI DBQ COND LOGIC New Additional Information: ----------------------- N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. INC23389024: Disabled users still able to connect to claims.domain.ext Problem: -------- Disabled users were still able to connect to claims.domain.ext using the CAPRI GUI. Resolution: ----------- Code changed to check users account for the DISUSERED flag set in VistA. 2. INC30600763: Cannot access CAPRI Training Site Problem: -------- When in CAPRI and attempting to utilize the drop-down menu CAPRI C&P Template Training Website, an error message "500 Internal Server Error" is received. Resolution: ----------- Renamed the menu option to CAPRI Documentation Library and created a parameter to hold the URL to that website. 3. INC34120499: CAPRI default/timeout window is "save and exit" rather than "keep working" which causes issues Problem: -------- When in CAPRI and editing a PDF Template, a timeout window erroneously appears prompting the user to "Save and Exit" or "Keep Working". Resolution: ----------- Remove the code instantiating the Template timeout window 4. CAPRI-7884: Resizing Address Verification Problem: -------- Address verification displayed after Add New C&P Request is no longer resizable. Resolution: ----------- Changed form properties in viewaddress.dfm, so the user cannot click and drag to resize. 5. CAPRI-7883: Resizing Voc-Rehab Medical Services Request Dialog Problem: -------- Add Request form, Point of Contact form, and Assign Consults form under the VOCREHAB tab no longer lets user click and drag to resize. Resolution: ----------- Changed form properties in VocRehabMedicalRequest.dfm, VocRehabPOC.dfm, and VocRehabAssnConsults.dfm so the user cannot click and drag to resize 6. CAPRI-8151: When the User Runs the Report Builder, Blank Drug Classes will be Populated with Incorrect Data Problem: -------- The Report Builder for the Out-Patient Medications report is displaying a Drug Classification, even though there was no Drug Code input. The Drug Classification displayed was from the previous prescription where there was a Drug Code present. Resolution: ----------- Newing the ORDIALOG array was the best suited solution to 1) localize the array to this sub-routine, and 2) initializing it every time the DRUG subroutine is called. 7. CAPRI-7867: Report Builder-data from the Diet tab appears in another patients data Problem: -------- If a user runs the report builder under Clinical Documents -> Diet tabs and then switches to another patient, the first patient's diet report text will show up in the second patient's diet report text. Resolution: ----------- A new line was added in DVBMOST tagline of DVBCREPT to kill the data @DVBRPT if data was returned. 8. CAPRI-7879: Exam Reference Error in VistA-When the requested exam is opened, the field labeled 'Exam Reference' is being filled with the record number instead of the actual exam reference number based in VistA Problem: -------- Exam reference number on the Exam Details form now displays the Exam Reference IEN. Resolution: ----------- Replaced the variable used to set frmExamDetails.edExamReferenceNumber.Text in two places, to display the expected Exam reference number. 9. CAPRI-11150: Surgery Report error message encountered: DVBAB OPERATION REPORT could not be accessed Problem: -------- In the CAPRI tab Reports, submenu Surgery Report if a user attempts to view a report more than once, on the second and every subsequent attempt the user would get the error message: DVBAB OPERATION REPORT could not be accessed! Resolution: ----------- The routine was writing erroneous characters to the CAPRI RPC Broker, incorrect write commands to the broker were removed. 10. CAPRI-10958: Empty window displaying on screen during CAPRI worksheet signing process Problem: -------- A non-functional blank window appears when signing a worksheet. Resolution: ----------- Modified TPNCSForm.AddToReport2 so PNCSSandbox form is moved before being made visible. 11. CAPRI-12105: Surgery Report Ok Button Active without Report Selected, Out of Bound error message received Problem: -------- "OK" button in Surgery Reports is inappropriately enabled Resolution: ----------- Added a conditional so ButtonOKSurgeryReports is only enabled if user selected a report. 12. CAPRI-10314: Capability to Sort and Filter the Edit Local Tab in DBQ Push Utility using an RPC Problem: -------- Enhancement to the CAPRI DBQ Push Utility to add the ability to filter and sort in the Edit Local tab Resolution: ----------- New routine DVBCPSH2 and new RPC DVBA CAPRI TEMP DEF LIST which filter and sort stored data in VistA CAPRI TEMPLATES (#396.18) 13. CAPRI-11496: EFolder Transmission message for Remote Users Problem: -------- EFolder transmission message is not appropriate for Remote Users. Resolution: ----------- Changed the pop-up message related to eFolder holding messages to be sent. 14. CAPRI-11586: Display Error Message for Users for Missing SecID in the NEW PERSON File Problem: -------- CAPRI does not display a message to the user when their New Person account is missing a SecID. Resolution: ----------- Added a check that user's Sec ID is present in their NEW PERSON file, if SecID is not present. 15. CAPRI-11938: SecID and SSN Validation based on VistA DVBA CAPRI SECURITY TOGGLE Problem: -------- CAPRI needs to allow users to be screened according to SSN or/and SecID. Resolution: ----------- Added a check for a new Security Toggle That makes the previously added check for user's Social Security Number (SSN) and the new check for user's Sec ID both optional. Based on the setting of the new security option in VistA, CAPRI will, following valid login to a server, optionally validate, user SSN, or user Sec ID, or both SSN and Sec ID, or neither SSN nor Sec ID. 16. CAPRI-8244: Deprecate the CAPRI Manifest Query Going to DAS to Support DAS Release Problem: -------- Certain users types could see an (unused) button on the CAPRI Alerts form related to CAPRI Contract Referral enhancement (CCR). CCR is not implemented in production. Resolution: ----------- Commented out the code to retrieve the manifest count from VistA and then hid the button. Test Sites: ----------- Tampa VA Medical Center (Tampa, FL) Minneapolis VA Medical Center (Minneapolis, MN) Test Sites - SNOW Change Order #: Tampa VA Medical Center: CHG0557347 Minneapolis VA Medical Center: CHG0557282 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 Format --------------------------------------------------------------------- CAPRI GUI ZIP DVBA_27_P252_59.ZIP BINARY Zip file contents: - CAPRI.exe CAPRI v252.59 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_252_RN.PDF DVBA_2_7_252_RN.DOCX Patch Installation: ------------------- 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. Installation Instructions: The CAPRI GUI is CAPRI.exe contained in DVBA_27_P252_59.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*252 MUST be installed in all production VistA instances throughout the enterprise prior to the deployment of CAPRI GUI v2.7.252.59 to avoid possible disruptions of services by VBA and National CAPRI GUI users. **DUE TO MICROSOFT SECURITY after download of the GUI, Right click on the .EXE (NOT THE SHORTCUT), and select Properties and then check the Unblock box and then click APPLY.** Post release installation and deployment schedule: Days 1-4 (Monday, January 13 - Thursday, January 16): CAPRI VistA Patch DVBA*2.7*252 will be deployed to all VistA production instances. Users will not see or experience any changes. CT Field Testing (Friday, January 17 - Thursday, January 23): Software deployment to 10% of workstations Days 5 (Sunday, January 26): CAPRI GUI DVBA*2.7*252.59 can begin deployment to all VistA Application Consolidated Servers (VACS) Days 5-11 (Friday, January 24 - Tuesday, February 3): CAPRI GUI DVBA*2.7*252.59 will be deployed to all applicable endpoint devices to include client desktop workstations, other application shares, and Citrix Virtual Desktops. CAPRI GUI DVBA*2.7*252.59 will remain compatible with VistA patch DVBA*2.7*250 until February 3, 2025. Users will see a pop-up screen indicating they need to upgrade the CAPRI GUI seven (7) days prior to this date. 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. or XXXXX BUILD X.X) 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 XXX*#.#*### 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 Only Backup Type: B// iv. When prompted "Do you wish to secure your build? 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 . a. When prompted 'Enter options you wish to mark as 'Out Of Order':', press the Enter key. b. When prompted 'Enter protocols you wish to mark as 'Out Of Order':', press the Enter key. c. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Post-Installation Instructions: Installation Verification: -------------------------- Successful installation can be verified by reviewing the first 2 lines of the routines contained in the patch. The second line will contain the patch number (252) in the [PATCH LIST] section. ;;2.7;AMIE;**[Patch List]**;Apr 10, 1995 The option Calculate and Show Checksum Values [XTSUMBLD-CHECK] can be run to compare the routine checksums to what is documented in the patch description. Back-Out/Roll Back 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. Validation of Back-out Procedure --------------------------------- The Back-out Procedure can be verified by printing the first 2 lines of the DVB Routines contained in this patch using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the routines contained in the DVBA*2.7*252 patch have been rolled back, the first two lines of the Routines will no longer contain the designation of patch DVBA*2.7*252 in the patch list section on line 2. Routine Information: ==================== The second line of each of these routines now looks like: ;;2.7;AMIE;**[Patch List]**;Apr 10, 1995;Build 92 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DVBAB82 Before:B149057820 After:B158607602 **42,90,100,119,156,149,179, 181,184,185,192,196,193,252** Routine Name: DVBAB85 Before: B8725026 After: B10959830 **90,185,237,240,252** Routine Name: DVBABURL Before: B11691305 After: B11911531 **104,136,143,149,168,181,186, 192,205,237,240,238,245,252** Routine Name: DVBC252P Before: n/a After: B37787527 **252** Routine Name: DVBC252P2 Before: n/a After: B65697308 **252** Routine Name: DVBCPSH2 Before: n/a After: B13529150 **252** Routine Name: DVBCPUSH Before: B41125875 After: B48038358 **238,242,248,252** Routine Name: DVBCTPD2 Before: B11466058 After: B72055551 **250,252** Routine Name: DVBCTPDF Before: n/a After: B95181423 **252** Routine Name: DVBCTXM2 Before: B1393574 After: B3514031 **250,252** Routine Name: DVBCTXML Before: B20916923 After: B34778785 **250,252** Routine Name: DVBSECID Before: n/a After: B1068656 **252** Routine Name: DVBSIGN Before: n/a After: B46691586 **252** Routine Name: DVBSIGN2 Before: n/a After: B8997454 **252** Routine Name: DVBUTIL Before: n/a After: B32988055 **252** Routine Name: DVBWKSHT Before: n/a After: B18369815 **252** ============================================================================= User Information: Entered By : Date Entered : NOV 21, 2023 Completed By: Date Completed: JAN 10, 2025 Released By : Date Released : JAN 10, 2025 ============================================================================= Packman Mail Message: ===================== $END TXT