============================================================================= Run Date: JUL 20, 2023 Designation: ANRV*5.1*8 Package : ANRV - VISUAL IMPAIRMENT SERVICE TE Priority: Mandatory Version : 5.1 SEQ #5 Status: Released Compliance Date: JUL 20, 2023 ============================================================================= Subject: Java GUI and Functionality Defect Repairs Category: - Informational - Other Description: ============ ANRV*5.1*8 "Informational" patch is for Blind Rehabilitation Services (BRS) 5.1 Java Graphic User Interface (GUI). After release, the BRS GUI/Web Server version will be 5.1.4. Patch ANRV*5.1*8 addresses the following defects: 1. HDSO-3128 - Restore default data-only VIST Roster Sorts. 2. HDSO-3037 - 508 issue - Sensitive patient lookup status notification is not read by JAWS. 3. HDSO-2846 - Error Message for Eye Exam missing mandatory field needs to be more specific. 4. HDSO-2845 - Error message for date format should specify which input field is at fault. 5. HDSO-2821 - 508 issue - BR patient, Patient Search results are not announced by JAWS. 6. HDSO-846 - 508 issue - Existing Referral Edit buttons not unique. 7. HDSO-760 - VIST Roster Summary report start date - set default to Oct 1st. 8. HDSO-738 - 508 issue - Select button not unique for common names on Blind Patient. 9. HDSO-815 - VIST Annual Review should be in all upper case. 10. HDSO-817 - Edit Blind Patient date box is missing label. 11. HDSO-4864 - Security Scan Remediation. Defect Tracking System Tickets(s) & Overview: ============================================= 1. HDSO-3128 - Restore default data-only VIST Roster Sorts. Problem: -------- The application's CSV data exports contain extraneous text and formatting that are not useful for the user's purposes. Technical Problem: ------------------ "Data-only" export is provided within the application which provides for some of the reports a legitimately useful comma-separated data export suitable for import to Microsoft Excel or another spreadsheet capable of ingesting CSV files. Exports are already available in the application for some of the reports in the Print Reports menu. Reports in the Print VIST Roster Sorts menu are similarly available but currently disabled in the GUI. Resolution: ----------- The GUI has been modified to enable data-only exports for the reports in the Print VIST Roster Sorts menu. 2. HDSO-3037 - 508 issue - Sensitive patient lookup status notification is not read by JAWS. Problem: -------- When a user clicks on the Select button for a Sensitive patient, there is a pop-up window that opens but is not read by JAWS. An unsighted user does not know the window is there or that the patient selected is Sensitive. Technical Problem: ------------------ Since the desired information appears in a modal dialog, it is not read by the screen reader. Resolution: ----------- Added aria-live attribute to force reading of the dialog. 3. HDSO-2846 - Error Message for Eye Exam missing mandatory field needs to be more specific. Problem: -------- Form validation generates error message that does not adequately specify the invalid form element. Technical Problem: ------------------ The error message is vague and does not identify the field for which the user has entered an invalid value. Resolution: ----------- Error message has been augmented to specify that the user should enter a valid exam date. 4. HDSO-2845 - Error message for date format should specify which input field is at fault. Problem: -------- Form validation generates an error message that do not adequately identify the invalid field. In another location, a default validation message presents the error indication in a format not suitable to a screen reader user. Technical Problem: ------------------ Error messages are inappropriate for a non-sighted user. Resolution: ----------- Error messages have been modified to identify the field(s) failing validation in a way more easily understood by a non-sighted user. 5. HDSO-2821 - 508 issue - BR patient, Patient Search results are not announced by JAWS. Problem: -------- The end of a patient search gives no indication to a non-sighted user. Technical Problem: ------------------ The screen reader of an unsighted user does not announce the completion of the patient search. Resolution: ----------- The table presenting patient search results has been enclosed in a div with the aria-live attribute set to "assertive" to force the screen reader to announce an update to the table. 6. HDSO-846 - 508 issue - Existing Referral Edit buttons not unique. Problem: -------- The referral search on this page includes selection buttons that are not differentiated for patients with identical names. Technical Problem: ------------------ Patients with identical names were not uniquely identified in this table due to the lack of an identifier other than the patient's name. Resolution: ----------- The database referral key was introduced into the aria-label of the command button, uniquely identifying the referral. The getter and setter methods for statusChangeReasons() in CreateReferralModifyBacking.java have been modified to pass Lists of CodeDTO objects rather than arrays9. 7. HDSO-760 - VIST Roster Summary report start date - set default to Oct 1st. Problem: -------- The application's default start date for VIST roster sort reports is not useful for generating reports for entire fiscal years. Technical Problem: ------------------ The default start date for VIST roster sort reports is currently set one month before the current (i.e. end) date. This is not convenient to the user interested in annual reports who must then select the start of the current fiscal year. Resolution: ----------- Initialization code has been modified to calculate the first day of the current fiscal year and set the default start date to that value. 8. HDSO-738 - 508 issue - Select button not unique for common names on Blind Patient. Problem: -------- Select buttons in the search results table are not differentiated for patients with identical names. Technical Problem: ------------------ The select button is identified and announced only with the patient's name. It is not possible for an unsighted user to differentiate between patients with the same name. Resolution: ----------- Added the patient's date of birth to the aria-label for the select buttons to guarantee uniqueness. 9. HDSO-815 - VIST Annual Review should be in all upper case. Problem: -------- VIST is an acronym and as such should be rendered in capital letters. Technical Problem: ------------------ "VIST" is rendered as "Vist" in the title of this page. Resolution: ----------- Page was corrected to read "VIST Annual Review". 10. HDSO-817 - Edit Blind Patient date box is missing label. Problem: -------- Date of Enrollment datepicker is not labeled on the Edit Blind Patient page. Technical Problem: ------------------ Datepicker in basicInformation.xhtml is not accompanied by a label. Resolution: ----------- Added a label to the datepicker reading "Enrollment Date (MM/DD/YYYY):". 11. HDSO-4864 - Security Scan Remediation. Problem: -------- Security scans identified potential vulnerabilities Technical Problem: ------------------ Application Code has some items that need to be remediated and libraries need to be updated. Resolution: ----------- Changed code where recommended upgraded libraries to the latest versions to remove vulnerabilities. Test Sites: =========== Southern Arizona Health Care System - Tucson Division Charlie Norwood VA Medical Center (Augusta) SNOW Change Order #: -------------------- CHG0388912 Software and Documentation Retrieval Instructions: ================================================== The software for this patch is being deployed by the IO Enterprise Server Support Team. 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://www.download.vista.domain.ext/index.html/SOFTWARE/ Documentation Title File Name ---------------------------------------------------------------------- Blind Rehab 5.1 Release Notes ANRV_5_1_8_RN.pdf Blind Rehab 5.1 Centralized Server Installation/Implementation Guide ANRV_5_1_8_CIG.pdf Installation Instructions: ========================== This is a web application Java Build. This is a centralized server promotion. No installation is required at local sites. Adaptive Technology Software ============================= Blind Rehabilitation users are responsible for ensuring their adaptive technology software is fully updated (JAWS/ZoomText/etc.). Please contact local desktop support for assistance if needed. Your adherence to the VA Technical Reference Model (TRM) is essential to improving the technical environment within VA. Architecture & Engineering Services (AES), specifically EA, has overall responsibility for the VA TRM and needs your support and cooperation to make it a success. You may access TRM: https://trm.oit.domain.ext/TRMHomePage.aspx to view approved versions. JAWS 2020 Software enhancements version releases: -------------------------------------------------------------------------- Enhancements in JAWS 2020.2001.70 (February 2020) Enhancements in JAWS 2020.2003.13 (March 2020) Enhancements in JAWS 2020.2004.66 (April 2020) Enhancements in JAWS 2020.2006.12 (June 2020) Enhancements in JAWS 2020.2008.24 (August 2020) Enhancements in JAWS 2020.2012.9 (December 2020) Enhancements in JAWS 2020.2110.3 (November 2021) The latest patch for JAWS 2020 is: JAWS 2020.2110.3 Offline 64-bit November 2021. It is recommended that BR staff be updated to JAWS 2023. ZoomText ---------------- Recommended version - 2023.x (October 2022). For more info on these releases, please go here: https://support.freedomscientific.com/Downloads/JAWS/JAWSWhatsNew#Enhancem ents and select in the drop-down JAWS 2020. Back-Out/Roll Back Plan: ======================== Any back-out/roll back will be handled by the central server deployment team. No actions are required of local sites in the event of back-out/roll back. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : MAR 08, 2023 Completed By: Date Completed: JUL 20, 2023 Released By : Date Released : JUL 20, 2023 ============================================================================= Packman Mail Message: ===================== No routines included