============================================================================= Run Date: NOV 30, 2022 Designation: ANRV*5.1*2 Package : ANRV - VISUAL IMPAIRMENT SERVICE TE Priority: Mandatory Version : 5.1 SEQ #2 Status: Released Compliance Date: DEC 31, 2022 ============================================================================= Subject: GUI and Functionality Defect Repairs Category: - Informational - Other Description: ============ This 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.2. Patch ANRV*5.1*2 addresses the following defects: 1. HDSO-728 - 508 issue - Change Referral is missing the program label for Offered Service Date. 2. HDSO-925 - 508 issue - Modify/Create Referral Search results are not announced by JAWS. 3. HDSO-797 - 508 issue - Screen reader identifies Status Change reason as editable, but it is not. 4. HDSO-739 - 508 issue - The warning timeout message is not read by the screen reader. 5. HDSO-742 - 508 issue - Error message notification conveyed by the screen reader is incomplete. 6. HDSO-947 - INC23985738 - BR-5.1 Create Referral Option for VA Outpatient Low Vision (LV) Clinic isn't working properly. 7. HDSO-726 - 508 issue - Patient Status Change - Status Change Date is missing the programmatic label. 8. HDSO-741 - 508 issue - Other causes of vision loss Ocular health is not 508 compliant. 9. HDSO-914 - Referrals as notifications aren't showing on the home screen. 10. HDSO-895 - Other Health & Medical Treatment notes are not being displayed in the patient record. 11. HDSO-736 - 508 issue - Activate patient date and reason have no programmatic label. 12. HDSO-844 - 508 issue - Create Referrals - Referred To Institution is not selectable. 13. HDSO-845 - 508 issue - Create Referrals is missing a table heading for Existing Referrals. 14. HDSO-847 - 508 issue - Create Referrals Referred From Institution has no programmatic label. 15. HDSO-1022 - INC24177532 Blind Rehab - user unable to log into BR 5.1. 16. HDSO-730 - 508 issue - Modify Referrals found Edit Referral buttons are programmatically identical & missing headings. 17. HDSO-1094 - Data Only Reports. 18. HDSO-915 - Connectivity configuration for Master Patient Index (MPI). 19. HDSO-737 - BR Patient page takes too long to load patient data in IOC. 20. HDSO-858 508 issue - Modify Referral By patient the New Status is missing the label. 21. HDSO-998 INC24102338 - BR 5.1 - Station 534 is not updating when PSDUpdater runs. Defect Tracking System Tickets(s) & Overview: ============================================= 1. HDSO-728 - 508 issue - Change Referral missing program label for Offered Service Date. Problem: -------- The Offered Service Date & Offer Accepted fields are missing programmatic labels and therefore are not read by Assistive Technologies (AT). Technical Problem: ------------------ Label component for Offered Service was using the incorrect ID. Resolution: ----------- Updated the label components "for" attribute to use the correct ID. 2. HDSO-925 - 508 issue - Modify/Create Referral Search results are not announced by JAWS. Problem: -------- After Searching for a patient, the patient search results are not read/announced by JAWS, so an unsighted user does not know that the page has loaded. This also happens when the user does a search under Create Referral. Technical Problem: ------------------ The table containing search results has no heading. Resolution: ----------- A table heading was added, so JAWS can read it. 3. HDSO-797 - 508 issue - Screen reader identifies Status Change reason as editable but it isn't. Problem: -------- Under Change Referral Status the Status Change Reason box should not be active unless the New Status = Withdrawn or Cancelled. Screen Reader reads the Status Change Reason box as a Combo box, to change the selection use the arrow keys. When attempting to use the arrow keys they do not work, since the box should not be active. Technical Problem: ------------------ The Status Change Reason box does not have a disabled condition set on the disabled attribute. Resolution: ----------- Added a disabled condition to the "disabled" attribute that is toggled to enabled when the Status is changed to either Withdrawn or Cancelled. 4. HDSO-739 - 508 issue - The warning timeout message is not read by the screen reader. Problem: -------- When the warning timeout pop up message came up, the screen reader only announced "Close". So, it only read the Close button. The entire warning message should have been read by AT. The message is not conveyed to an unsighted user. Technical Problem: ------------------ The timeout dialog message focuses immediately on the close button instead of the dialog content. Resolution: ----------- Accessible Rich Internet Applications (ARIA) labels were added to the dialog so that the entire message receives focus when it appears. JAWS is then able to read it. 5. HDSO-742 - 508 issue - Error message notification conveyed by the screen reader is incomplete. Problem: -------- Under Enter/Edit -> Eye Exam eligibility -> Edit Eye Exam if several required fields are left incomplete an error alert pops up but is not completely read and announced by the screen reader. Only 1 line of the alert message is conveyed by the screen reader. All error messages should be announced by the screen reader to be compliant. Technical Problem: ------------------ JAWS only reads the last line of the error message section. Resolution: ----------- ARIA-atomic was added to the entire message/error section, so JAWS can read it when the messages appear. 6. HDSO-947 - INC23985738 - BR-5.1 Create Referral Option for VA Outpatient LV Clinic Not Working Properly. Problem: -------- Agency Type should only be active if the Referral Type = Non-VA. The Referred To Institution drop down should contain those institutions with Service Area: LV. If the Referral Type= VA Audible devices, then the Referred To Institutions drop down should contain institutions with Service Area = OTHER. Technical Problem: ------------------ Multiple Referral Types along with the Non-VA types were assigned to the "Other" Service Area which is causing the incorrect Referred To Institutions. This is being corrected with a data correction. The Agency type does not have a disabled flag associated. Resolution: ----------- Correct the Service Area related data to properly support another service area and separate the VA Audible referral types from the Non-VA referral types. Also, add the ability to disable the Agency type under the appropriate conditions. 7. HDSO-726 - 508 issue - Patient Status Change - Status Change Date is missing programmatic label. Problem: -------- Under Inactive Patient, the labels are too far away from the boxes and the Status Change Date has no programmatic label or indication to a screen reader that it is a required field. Technical Problem: ------------------ Label positioning needs to be adjusted and the "for" attribute on the Status Change Date label needs to include "_input" at the end of the ID for the reader to associate it properly with the calendar component in use. Resolution: ----------- Realigned the labels and form elements to line up in the middle, cleaned up styles and html. Added missing ID to the "Select Reason" select box. 8. HDSO-741 - 508 issue - Other causes of vision loss Ocular health is not 508 compliant. Problem: -------- Under Enter/Edit, BR Patient, Edit Blind Patient and enter required Basic Information click Save and Continue. Tab or click to the Ocular Health box. Tab down to the Other Causes of Vision Loss. AT tells you to use the arrow keys to change selection. Although, end user can tab into the dropdown box, Jaws did not read the selections properly and it was difficult to use the arrow keys to make selections. Technical Problem: ------------------ Prime faces component in use is not 508 compliant and needs to be replaced with a component that can handle multi selection and is 508 compliant. Resolution: ----------- Replaced the Primfaces SelectCheckboxMenu component, which was not 508 compliant, with multiple components that are each 508 compliant. It is now a DataTable, SelectOneMenu and two CommandButtons. 9. HDSO-914 - Referrals as notifications not showing on the home screen. Problem: -------- Referral notifications are not being displayed on the home screen. Technical Problem: ------------------ Code that is used to transform a referral into a notification is missing due to a rollback in GitHub. Resolution: ----------- Code has been re-added to the application to fix this issue. 10. HDSO-895 - Other Health & Medical Treatment notes are not being displayed in the patient record. Problem: -------- There is a notification that the patient data is saved. But when clicking on the patient's name link, the patient record that comes up does not show the saved data. Technical Problem: ------------------ The content for Other Health & Medical Treatment and sections below it is not shown in the patient record component. Resolution: ----------- Renamed a field used within Other Health & Medical Treatment to the correct one. 11. HDSO- 736 - Activate Patient Date and Reason have no programmatic Label. Problem: -------- The Status Change Date input form and Select Reason drop down box have no programmatic label and are not read by a screen reader. Technical Problem: ------------------ The Status Change Date input form and Select Reason drop down box have no programmatic label and are not read by a screen reader. Resolution: ----------- ID name mismatch within XHTML code for this combo box was fixed. 12. HDSO-844 - 508 issue - Create Referrals - Referred To Institution is not selectable Problem: -------- When tabbing to the Referred To Institution box, JAWS reads "Combo box, to change the selection use the arrow keys". If the up/down arrow is used, it loses focus. Technical Problem: ------------------ Programmatic label for "Referred To Institution" is missing; therefore, it isn't read properly by JAWS. Resolution: ----------- ID name mismatch within XHTML code for the combo box was fixed. 13. HDSO-845 - 508 issue - Create Referrals missing table heading for Existing Referrals. Problem: -------- The table that shows referrals is missing the heading above the table that should read "Existing Referrals for this Patient". Technical Problem: ------------------ The table does not contain a header. Resolution: ----------- A header with the text "Existing Referrals for this Patient" was added to the table. 14. HDSO-847 - 508 issue - Create Referrals Referred From Institution has no programmatic label Problem: -------- The Referred From Institution are marked as required but have no programmatic label and is not read by a screen reader. Technical Problem: ------------------ Programmatic label for "Referred From Institution" is missing, so not read properly by JAWS. Resolution: ----------- ID name mismatch within XHTML code for this combo box was fixed. 15. HDSO-1022 - INC24177532 Blind Rehab - user unable to log into BR 5.1. Problem: -------- User with an apostrophe in their name are unable to login to BR 5.1. They are receiving "Access Denied You must request to have one or more user roles associated with your account to access the Blind Rehabilitation (BRVS) application. Please contact the National Blind Rehabilitation Services Program Office". Technical Problem: ------------------ The system is escaping the single quote; however, when used as a prepared statement this is not necessary. Resolution: ----------- Removed the code that was escaping the apostrophe. Code for escaping should only be used when dynamically creating SQL not when using prepared statement. Problem: -------- Save is not being read by reader when page is saved. Technical Problem: ------------------ The block that displays the save message is missing the aria-live Attribute. Resolution: ----------- Added the aria live attribute also added second message lower on the page as the page is quite long. 16. HDSO-730 - Modify Referrals found Edit Referral buttons are programmatically identical & missing headings. Problem: -------- Reader is reading all the buttons as Edit. Technical Problem: ------------------ Buttons are missing the aria-label that adds the information needed by an impaired user to differentiate the buttons from one another. Resolution: ----------- Add the aria-label attribute to the button with enough data to differentiate the buttons. 17. HDSO-1094 - Data Only Reports. Problem: -------- Reports are missing the data only export capability. Technical Problem: ------------------ Data only was assumed to be the CSV export when the reports were created. Instead, it should have been just the raw data without heading or markup. Resolution: ----------- Create a new export type that dumps the raw data to a text file if the report is comprised of a single report. Later enhancements will need to hone this better for more complex reports. 18. HDSO-915 - Connectivity configuration for MPI. Problem: -------- MPI could not be reached and MPI could not reach BR. Technical Problem: ------------------ Firewall rules were missing that allowed the back-and-forth communication. Resolution: ----------- Rules added to support the communication. 19. HDSO-737 - BR Patient page takes too long to load patient data in IOC. Problem: -------- BR Patient -> Basic Info screen extremely slow to load and process. Technical Problem: ------------------ BR Patient -> Basic Info was building the list of tracking user on every call and this list requires multiple SQL calls per user to load. Resolution: ----------- Made it so the tracking users load on application startup and the resulting list is held in memory so as to load the user quicker on each call. 20. HDSO-858 508 issue - Modify Referral By patient the New Status is missing the label. Problem: -------- Reader is not reading the label associated with the New Status. Technical Problem: ------------------ The SelectOneMenu component is missing the id label. Resolution: ----------- Added appropriate id to the SelectOneMenu component. 21. HDSO-998 INC24102338 - BR 5.1 - Station 534 is not updating when PSDUpdater runs. Problem: -------- Station 534 is not updating when PSD updater runs. Technical Problem: ------------------ Station 534 is experiencing a SQL exception for one of the patients when the PSD updater is running, which is causing no updates for any patients at the site. The code for the issue was written for a previous release but due to an issue with a rollback of code it was left out. Resolution: ----------- Code Change was added again. This added a catch statement for SQL exception that allowed the site to continue processing remaining patients' and only rolling back the patient with the issue instead of rolling back the whole site. Test Sites: =========== Tibor Rubin VA Medical Center in Long Beach (CA)Charlie Norwood VA Medical Center in Augusta (GA) Software and Documentation Retrieval Instructions: ================================================== The software for this patch is being deployed by the IO Enterprise ServerSupport Team. Documentation describing the new functionality is included in this Release. Documentation can be found on the VA Software Documentation Library at: https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.va.g ov%2Fvdl%2F&data=05%7C01%7C%7C1eb348fc69e74fdf6c6508dab83a4135%7Ce95f1 b23abaf45ee821db7ab251ab3bf%7C0%7C0%7C638024857599682315%7CUnknown%7CTWFpb GZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D% 7C3000%7C%7C%7C&sdata=%2BIKMQsxcZYPlMVRnAu%2BIHKHHnVRWxkpbG9p3keMW5Dw% 3D&reserved=0. Documentation can also be obtained at https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdownload .vista.domain.ext%2Findex.html%2FSOFTWARE&data=05%7C01%7C%7C1eb348fc69 e74fdf6c6508dab83a4135%7Ce95f1b23abaf45ee821db7ab251ab3bf%7C0%7C0%7C638024 857599682315%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiL CJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=hSB5u2y1nf9yVFZRh5 rcQjaXAn5dLzOGQkpP8Z%2FQKfs%3D&reserved=0. Documentation Title File Name ---------------------------------------------------------------- Blind Rehab 5.1 User Manual ANRV_5_1_2_UM.pdf Blind Rehab 5.1 Centralized Server Installation/Implementation Guide ANRV_5_1_2_CIG.pdf Installation Instructions: ========================== This is a web application Java Build. This is a centralized server promotion. No installation is required at local sites. 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 26, 2009 Completed By: Date Completed: NOV 30, 2022 Released By : Date Released : NOV 30, 2022 ============================================================================= Packman Mail Message: ===================== No routines included