$TXT Created by DEVFEY.DOMAIN.EXT (KIDS) on Wednesday, 10/25/23 at 13:53 ============================================================================= Run Date: NOV 15, 2023 Designation: DVBA*2.7*250 Package : DVBA - AUTOMATED MED INFO EXCHANGE Priority: Mandatory Version : 2.7 SEQ #211 Status: Released Compliance Date: DEC 07, 2023 ============================================================================= Associated patches: (v)DVBA*2.7*35 <<= must be installed BEFORE `DVBA*2.7*250' (v)DVBA*2.7*227<<= must be installed BEFORE `DVBA*2.7*250' (v)DVBA*2.7*243<<= must be installed BEFORE `DVBA*2.7*250' (v)DVBA*2.7*248<<= must be installed BEFORE `DVBA*2.7*250' Subject: CAPRI ENHANCEMENTS FOR NEWSFEED, ERROR HANDLING AND MISSING SSN Category: - Routine - Data Dictionary - Other Description: ============ Patch DVBA*2.7*250 will implement the following: 1. Enhancements to the CAPRI News Feed to call the SharePoint application and launch Pdf's with the CAPRI GUI, no longer launching an external browser. 2. Enhance transmission error handling to save the encoded XML in a VistA file and allow users to resend, while maintaining a logged sender, response codes received and an attempted transmission count. a. VistA CAPRI TEMPLATES FILE (#396.17) has been modified to store transmission metrics for transmission processes. 3. Short term fix for a Kernel issue for users with duplicate VistA New Person accounts and missing social security numbers. 4. Pseudo SSN was not working properly within the CAPRI GUI application, this internal issue was found and corrected. Patch DVBA*2.7*250 will also address the following bugs: INC24303017: Edit Fields Not Announced by Screen Reader INC23768900: CAPRI Application Error Resulting in Shut Down INC25976939: CAPRI copy/paste and tab malfunction when entering a new patient INC24797102: HRC - Eu is having issues with the CAPRI Fayetteville location whenever EU's want to place an order INC21249123: CAPRI 2507 rerouted from Muskogee VAMC to Cheyenne VAMC was not delivered to Cheyenne VAMC INC26557317: Connection to server for DVBAB REPORT 7131INQ could not be established Patch Components: ---------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- CAPRI TEMPLATES FILE CMT TRANSMISSION DATA New (#396.17) (#26) 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 Modified DVBA HRC MENU PHARMACY 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 GET DBQ XML New DVBA CAPRI UPDATE DBQ TRANSTAT New DVBA CAPRI DBQ TRANS FAIL LIST New DVBA CAPRI SAVE DBQ XML New DVBA CAPRI NF DATA New DVBA CAPRI GET EXAM REPORT New DVBA CAPRI FAIL CHECK New Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- ------------------- DVBAB CAPRI NF TENANT New DVBAB CAPRI NF CLIENT New DVBAB CAPRI NF TOKEN New DVBAB CAPRI NF TOKEN URL New DVBAB CAPRI NF SITEID URL New DVBAB CAPRI NF DRIVEID URL New DVBAB CAPRI NF FILEINFO URL New Additional Information: N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1. INC24303017: Edit Fields Not Announced by Screen Reader Problem: -------- Form fields are not labeled under the vocab rehab tab when adding a medical services request. Resolution: ----------- Updated edit box properties to allow the JAWS screen reader to announce them Technical Resolution: --------------------- VocRehadMedicalRequest.dfm - updated the AccessText Hint property of the Edit boxes. frmMVISearch.dfm - updated the AccessText Hint property of the Edit boxes. 2. INC23768900: CAPRI Application Error Resulting in Shut Down Problem: -------- CAPRI shutting down causes an error. Resolution: ----------- When the application was shutting down CAPRI would try and free objects which had already been released. Technical Resolution: --------------------- Killprocess method is now removed from Mainform, as this method was not triggering the formclose event which was causing issue Also FreeAndNil call is removed from formclose event and formdestroy event for those form objects which were already destroyed by the respective parent objects. Capri is throwing an exception currently when user clicks on "GenerateTemplate" button multiple times on Browse Template form. In order to resolve this a change is made to disable the button when user clicks on the button first time and the button is re-enabled when process completes.Similarly same functionality is added to "SendExam Request" button in SendExamRequest Form and on OK button in TTIUSign Form 3. INC25976939: CAPRI copy/paste and tab malfunction when entering a new patient Problem: -------- CAPRI Veteran new patient entry won't allow copy and paste ssn. It also won't allow you to tab (tab button) to the next field. Tabbing to "verify SSN is not in use" causes the previously input SSN to be cleared out. Resolution: ----------- Enabled paste into SSN field of Enter New Patient window. Prevented clearing of SSN when user tabs from SSN input to "Verify SSN is Not in Use" button. Technical Resolution: --------------------- Enterpt.pas: procedure TfrmEnterPt.edSSNKeyPress: Enable input of ctrl-V character which is used to paste the clipboard into a field, specifically edSSN. Procedure TfrmEnterPt.Button1Click: The clearing of the SSN field was moved from the SSN exit event to the button click event of the verify SSN button Button1 procedure TfrmEnterPt.edSSNExit: calls a new function IsValidSSN to verify that the input into edSSN is a valid number. 4. INC24797102: HRC - Eu is having issues with the CAPRI Fayetteville location whenever EU's want to place an order Problem: -------- A CPRS menu option has been decommissioned and is still showing available in CAPRI/VistA causing an error. User is selecting the option and is getting an error. Resolution: ----------- Option DVBA HRC MENU PHARMACY CC has been decommissioned. Technical Resolution: --------------------- Option DVBA HRC MENU PHARMACY CC has been set with a message to notify users it is no longer available. 5. INC21249123: CAPRI 2507 rerouted from Muskogee VAMC to Cheyenne VAMC was not delivered to Cheyenne VAMC Problem: -------- Using the CAPRI 2507 Re-Route feature, Muskogee VAMC rerouted a sensitive record 2507 to Cheyenne VAMC on 1/31/2022. Cheyenne VAMC does not show the rerouted 2507 as "New, Re-Routed" or "Re-Routed, Pending Acceptance" in the CAPRI Reports/Pending C&P Exams. Resolution: ----------- User is unable to pull 2507 veteran up after it was rerouted from Muskogee VAMC to Cheyenne VAMC. It was not delivered due to the maximum character was exceeded for comment (free text field). Add code to split the comment which was exceeded maximum characters limit on sender side and add code to processing it on receiver side to resolve the issue. Technical Resolution: --------------------- EN1+19^DVBCXFR2 ;PLE ; CAPRI 1214 2507 Reroute limit $RDAT to 250 char I $L($G(LINE(7)))>250 D .S LINE(7)="$RDAT "_REQDA_U_PIEN_U_RRF_U_RR_U_""_U_INAM_U_RRDT_U_CLTYP_U_ECF_U_RRFD .S LINE(7)=LINE(7)_U_RRFIEN_U_RRFSTN_U_STN_U_INUM_U_DVBINF .S LINE(8)="$SPEC "_SPEC .S LINE(9)="$RDES "_RD RDES^DVBCXFRC: RDES ;PLE ; CAPRI 1214 2507 Reroute description / comment S RD1=XLN Q REQEDIT+38^DVBCXFRC: ;PLE ; CAPRI 1214 2507 Reroute description / comment I $D(RD1) D .S RRIF=$$UPRR^DVBCUTL8(REQDA,RRDT) .S DA=$P(RRIF,"^")-1 .S DIE="^DVB(396.3,"_REQDA_",6,",DA(1)=REQDA .S DR="5////"_RD1 D ^DIE EXIT+9^DVBCXFRC K RDAT,DVRRIEN,RD1 6. INC26557317: Connection to server for DVBAB REPORT 7131INQ could not be established Problem: -------- Unable to run status inquiry on 7131 request at Spokane VAMC. Resolution: ----------- resolve it: adding code to allow system to process when claim number is not exist. Technical Resolution: --------------------- STRT+16^DVBAB71 S ^TMP("CAPRI",MCNT)=" SSN: "_$P(^DPT(DFN,0),U,9)_" Claim Number:"_$P($G(^DPT(DFN,.31)),U,3)_"^",MCNT=MCNT+1 ;CAPRI-4838 Test Sites: ---------- Tampa VA Medical Center (Tampa, FL) Minneapolis VA Medical Center (Minneapolis, MN) SNOW Change Order #: -------------------- Software and Documentation Retrieval Instructions: ---------------------------------------------------- The software for this patch is being released in a PackMan message 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_P250_07.ZIP BINARY Zip file contents: - CAPRI.exe CAPRI v250.7 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 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_250_RN.PDF DVBA_2_7_250_RN.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. Installation Instructions: -------------------------- The CAPRI GUI is CAPRI.exe contained in DVBA_27_P250_07.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*250 MUST be installed in all production VistA instances throughout the enterprise prior to the deployment of CAPRI GUI v2.7.250.7 to avoid possible disruptions of services by VBA and National CAPRI GUI users. Post release installation and deployment schedule: Days 1-3 (Wednesday, November 15 - Friday, November 17): CAPRI VistA Patch DVBA*2.7*250 will be deployed to all VistA production instances. Users will not see or experience any changes. CT Field Testing (Monday, November 20 - Tuesday, November 28): Software deployment to 10% of workstations. Days 4-10 (Monday, November 20): CAPRI GUI DVBA*2.7*250.07 can begin deployment to all VistA Application Consolidated Servers (VACS) Days 4-10 (Wednesday, November 29 - Thursday, December 7): CAPRI GUI DVBA*2.7*250.07 will be deployed to all applicable endpoint devices to include client desktop workstations, and other application shares, and Citrix Virtual Desktops. 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*250 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 . 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. Back-out/Rollback Strategy: =========================== 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 (250) 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: 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*250 patch have been rolled back, the first two lines of the Routines will no longer contain the designation of patch DVBA*2.7*250 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 19 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DVBAB71 Before: B26000515 After: B26159616 **35,250** Routine Name: DVBC250P Before: n/a After: B8531905 **250** Routine Name: DVBCTPD2 Before: n/a After: B11466058 **250** Routine Name: DVBCTXM2 Before: n/a After: B1393574 **250** Routine Name: DVBCTXML Before: n/a After: B20916923 **250** Routine Name: DVBCXFR2 Before: B32555905 After: B34652566 **193,227,250** Routine Name: DVBCXFRC Before: B71513192 After: B75848819 **1,6,18,65,149,193,209,229,227,250** Routine list of preceding patches: 35, 227 ============================================================================= User Information: Entered By : Date Entered : AUG 03, 2023 Completed By: Date Completed: NOV 15, 2023 Released By : Date Released : NOV 15, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT