============================================================================= Run Date: APR 28, 2022 Designation: WEBP*1*26 Package : WEBP - PATIENT CENTERED MANAGEMENT Priority: Mandatory Version : 1 SEQ #25 Status: Released Compliance Date: MAY 28, 2022 ============================================================================= Subject: PCMM TECH REFRESH FOLLOW-UP Category: - Informational - Enhancement (Mandatory) Description: ============ Patient Centered Management Module (PCMM) Web informational patch, WEBP*1.0*26, will address several defects within PCMM web application, remediate security and compliance issues of outdated libraries and components within the PCMM Application with the VA's Technical Reference Model (TRM) that was identified through Fortify security scans. ********************************************************************** * NOTE: The PCMM Web Application URL has been changed to: * * https://vaww-pcmm.cc.domain.ext/pcmmr_web/ * * All previous saved links will need to be updated with the new URL.* ********************************************************************** Upgraded Components: Log4J 2.17.2 Libraries upgraded to the latest version (excluding the React-Router): Axios: 0.26.0 Moment: 2.29.1 Moment-Timezone: 0.5.34 MUI-Datatables: 4.1.2 QS: 6.10.1 React-Datepicker: 4.7.0 React-Draggable: 4.4.4 React-Idle-Timer: 4.6.4 React-Number-Gormat: 4.9.1 React-Scripts: 5.0.0 TypeScript: 4.5.5 React-App-Polyfill: 3.0.0 Patch Components: ---------------- This patch includes the following files: File Name Description ========================================================= CISS.EAR Installation file PCMMHELP.WAR Installation file PCMMR.EAR Installation file PCMMR_UNATTENDED_EAR-2.0.1.EAR Installation file Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A 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 ----------- ---- -------------------- N/A 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 --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. INC20328578: Time Lag for unassignment to assignment of MHTC Problem: Error received when attempting to reassign a patient to a new team if made within the same minute, due to seconds not being recorded in the database. Resolution: Added seconds to the database for Patient/Team Assignment, reassignment and/or unassignment 2. INC20798139: Alert displays when attempting to unassign a staff member from a position on the *HBPC* team. Problem: Error received when attempting to reassign a staff to a new team if made within the same minute, due to seconds not being recorded in the database. Resolution: Added seconds to the database for Patient/Team Assignment, reassignment and/or unassignment. 3. WEBPCMM-21 Problem: Alert is not generated if patient is NOT assigned to the team. Resolution: Additional code added to generate alert. 4. WEBPCMM-22 Problem: Alert Summary not displaying count when the number of stations & sub-stations that the user has access to is more than 2000. Resolution: Added code to display count when all stations and substations are available to a user. 5. INC20367293: HBPC Views in PCMM Problem: When a user clicks on the first alert, filters go away and re-sorts. Resolution: Added code to prevent the loss of the filter and sorting 6. WEBPCMM-23 Problem: Alerts did not display exceptions received from APIs inside the Error form. Resolution: Code added to display exceptions from within the Error form 7. INC21445374: PCMM updates for vets not assigned to our HCS. Problem: Alerts for current station not working correctly (shows another site alerts) Resolution: Code modified to prevent alerts from the wrong Station to be displayed. 8. INC22039312: Actionable alert for validate person class Problem: Staff cannot be selected from Open alerts Resolution: Code modified to mitigate error causing endless spinning circle 9. WEBPCMM-24 Problem: A team's station cannot change if no patients/staff members has been assigned to it Resolution: Allow a team's station to change if no patients/staff members has been assigned to it 10. INC21248842: When using an & as expected with CC&ICM teams creates an error within the name Problem: Ampersand and special characters cannot be searched Resolution: Code modified to enable searching for special characters 11. INC21248842: When using an & as expected with CC&ICM teams creates an error within the name Problem: Ampersand not displaying correctly throughout the application Resolution: Code modified to correctly display the Ampersand character 12. INC20476776: error selecting provider for new MHTC assignments Problem: Checkbox selects/clears when a name in a list is clicked Resolution: Allow the user to select a checkbox in any order 13. INC21526455: WASA Findings - Remediation/Mitigation Plan Problem: WASA scan findings discovered a CORS vulnerability Resolution: CORS disabled throughout the entire PCMM codebase 14. INC21263718: Unable to change Non-VA PCP information. City and State required. Problem: When changes are needed to Non-VA PCPs, they cannot be made without entering a city and state. This is not appropriate as some Non-VA PCPs work in various cities and have one profile with multiple practices associated. Resolution: Display Address fields for all categories of Non-VA Providers (New Requirement) 15. INC20367293: The dialog box listing all the positions to assign the Veteran to is smaller than the list and so there is a roll/scroll bar Problem: Display more Providers for Patient/Team assignments Resolution: The space between providers in the pop-up box to select checkboxes is reduced 16. WEBPCMM-25 Problem: Users are not able to get out of the error message (no red X). Escape does not work Resolution: Code modified to enable escape from an error message. 17. INC21522226: Receiving 15 days, but station is zero alert pending and Generated Report also zero cases Problem: Receiving lots of 15 day alerts emails, yet PCMM Alert Summary shows zero cases and Generated Report MPACT needs our approval report also shows zero cases. Resolution: Added code to ensure that if action is taken for alerts, escalation email will not be performed. 18. INC20930299: INCORRECT TEAMS LISTED FOR ROOMS Problem: Unassigned rooms displaying for Team Room assignment Resolution: Code modified to filter unassigned rooms to be displayed in the Shared Teams 19. INC20798139: alert displays when attempting to unassign a staff member from a position Problem: Unassigning a staff from a position required entering FTE Resolution: FTE no longer required when unassigning a staff from a position 20. WEBPCMM-26 Problem: Fortify Scan findings require multiple libraries to be upgraded to the latest versions. Resolution: Libraries upgraded latest version except for React-router: axios: 0.26.0, moment: 2.29.1, moment-timezone: 0.5.34, mui-datatables: 4.1.2, qs: 6.10.1, react-datepicker: 4.7.0, react-draggable: 4.4.4, react-idle-timer: 4.6.4, react-number-format: 4.9.1, react-scripts: 5.0.0, typescript: 4.5.5, react-app-polyfill: 3.0.0 21. INC20367293: HBPC Views in PCMM Problem: Message Boxes cannot be moved on the user's screen Resolution: Allow user to drag to viewable area 22. WEBPCMM-27 Problem: MPACT Comments not saving Resolution: Code updated to correctly save and display comments 23. INC21263718: Unable to change Non-VA PCP information. City and State required. Problem: Non-VA practice search Address field not showing. Resolution: Code modified to display the Address field when searching for a Non-VA Practice 24. WEBPCMM-28 Problem: Error when trying to open the patient profile due to a NULL patient gender Resolution: Code modified to mitigate error when patient gender is empty 25. INC21263718: Unable to change Non-VA PCP information. City and State required. Problem: When changes are needed to Non-VA PCPs, they cannot be made without entering a city and state. This is not appropriate as some Non-VA PCPs work in various cities and have one profile with multiple practices associated. Resolution: Code modified to require Practice as a required field when creating a new Non-VA provider, also to not allow removal of the last associated practice from the practice list for all Non-VA providers (New Requirement) 26. INC21113958: AP PROVIDERS ARE NOT LISTED IN PCMM UNDER MY NP RESIDENT CLINICS- UNABLE TO USE THE PENCIL FOR ADDING/EDIT Problem: Preceptors/Preceptees Missing for Primary Care reassignments Resolution: Code modified to display Preceptor/Preceptee in the assignments popup box after assigning a patient to the team 27. INC21405206: Unable to view team assignments Problem: Showing previous station when opening a team in a substation, updating the team and saving the changes. Resolution: Code modified to mitigate refresh issue for previous stations and substations 28. INC20930299: Old teams still listed Problem: Rooms showing Historical/inactive teams Resolution: Code updated for rooms to no longer display historical teams 29. INC21423822: Can't inactivate Teamlet and Staff member in PCMM Web. Problem: FTE for Exam rooms & Interview rooms showing a value of 0 Resolution: If it's an exam room, user should not see interview room FTE. If it's an interview room, user should not see exam room FTE. 30. WEBPCMM-29 Problem: Staff Assignment Cancel button does not return to originating form but rather to position details. Resolution: Code modified to direct user back to originating form when pressing the Cancel button 31. WEBPCMM-30 Problem: Staff Assignment Position details does not change the station when a change station popup is displayed Resolution: Code modified to correctly update station selection 32. INC22060444: Physician Attending Team Role and Person Class Problem: In PCMM, the Team Role Physician-Attending currently doesn't require a person class. It needs to require a physician class in order to assign Resolution: Database modified to correct role and person class mismatch 33. INC21423822: Can't inactivate Teamlet and Staff member in PCMM Web. Problem: Staff unassignment results in error "No staff member can have an actual FTE allocation of greater than 1.0 at any time." Resolution: Code modified to prevent FTE exceeding 1.0 34. INC21389507: Unable to view team assignments. Problem: Staff update doesn't change the station, error message received Resolution: Code modified to correctly update the station 35. WEBPCMM-31 Problem: Station cannot be selected in PCMM when switching between User Management if a Station was not originally chosen Resolution: Code corrected to allow station selection when switching between User Management and PCMM 36. WEBPCMM-32 Problem: Station Selection doesn't allow Space bar in search Resolution: Code updated to allow spaces when searching for a Station 37. WEBPCMM-33 Problem: Team Profile does not clean up Patient list when an error occurs Resolution: Modify an Existing Team page corrected to display team information and patient assignments 38. WEBPCMM-34 Problem: Users unable to drag Team search dialog box Resolution: Code modified to enable dragging of the Team Search dialog box 39. INC20305663: TVCs listed are not correct for 528GN since upgrade Problem: TVCs not correctly displaying for substations Resolution: Code modified to display correct TVCs for substations 40. INC20857004: Unable to view all roles Problem: Users unable to see all user permissions and update table color to a 508 compliant shade of blue Resolution: User Management updated to display all user permissions 41. INC21154732: When I try to add, change, or remove PCMM access to facilities, I get an error message Problem: User Management: Unable to update user because some institution / visn id in database are null Resolution: Code updated to enable updates regardless of null values in database 42. WEBPCMM-35 Problem: Vista Station Positions Distribution Notification Rules show checked by default any value when the Do not Send is selected. Resolution: Code modified to not default the a checked value when "Do Not Send" is selected. HF-1 (deployed 04/15/2022) -------------------------- 1. INC22173687 and INC22175996: PCMM / TVC Alert Processing Issues / New Orleans LA 629 Problem: TVC's are not able to approve alerts from 3 digit stations outside of theirs. After completing the request decision and "Submitting" - nothing happens. Resolution: Code fixed to enable submission of approvals by TVCs 2. INC22174568: PCMM / Patient Assignment while patient has a pending assignment / Minneapolis MN 618 Problem: When a patient has a Pending Assignment at a site (618) and the PCMM Coordinator attempts to assign to another team at the same station (618). The application no longer displays an error message stating that the patient cannot have 2 pending assignments at the same station. No changes are made to the current patients pending assignment. Resolution: Code fixed to enable error message stating patient cannot have 2 pending assignments at the same station. HF-2 (deployed 04/21/2022) -------------------------- 1. INC#: N/A Problem: The links to Alerts Summary and Closed Alerts were not working. Resolution: Code fixed on the Open Alerts page 2. INC#: N/A Problem: The links to Alerts Summary and Open Alerts were not working. Resolution: Code fixed on the Closed Alerts Page 3. INC#: N/A Problem: Non-VA Provider Practice was not displaying the Practice Address. Resolution: Fixed code in Patient Details page 4. INC#: N/A Problem: Escalation Alerts were not being generated Resolution: Additional code added to generate alerts 5. INC#: N/A Problem: Alerts were not generating Resolution: Fixed code to check for null value when checking for duplicate alerts 6. INC#: INC22212829 - PCMM / Bread Crumbs missing when processing alerts / Salem VA 658N/A Problem: Breadcrumbs clear when the user goes to a substation for Alerts Summary Resolution: Additional code fixed to ensure breadcrumbs would not clear for substations 7. INC#: N/A Problem: Alerts were not generating Resolution: Added delay for Alerts generation 8. INC#: N/A Problem: Relocation completion alert was not generating: Resolution: Code fixed lazy loading exception for relocation completion alerts Test Sites: ----------- Memphis VAMC Roseburg VAMC Software and Documentation Retrieval Instructions: -------------------------------------------------- See Documentation section below. Other Software Files: File Title File Name Format ---------------------------------------------------------------- N/A 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, PCMM_WEBP_1_26_DIBRG_v2.2.DOCX and Rollback Guide PCMM_WEBP_1_26_DIBRG_v2.2.PDF Additional documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name --------------------------------------------------------------------- PCMM Web Version Description WEBP_1_26_PCMM_VDD.DOCX Document WEBP_1_26_PCMM_VDD.PDF Patch Installation: =================== PCMM Web patch, WEBP*1*26, is a centrally managed web-based application and will be implemented and deployed to a central web server. No installation is required by sites. Pre/Post Installation overview: --------------------------------------- See PCMM PCMM_WEBP_1_26_DIBRG_v2.2.DOCX for additional information. Pre-Installation Instructions: ------------------------------ Installation Instructions: ------------------------- ****************************************************************** ** PLEASE NOTE: THERE IS NO INSTALLATION FOR THIS PATCH. ** ****************************************************************** This informational patch, WEBP*1.0*26, is for PCMM Web. Installation is done on a centralized server. Please refer to the PCMM_WEBP_DIBRG_v2.2.docx for more details. Post-Installation Instructions: ----------------------------- N/A Back-Out Plan: -------------------------- Backout plan is provided as part of deployment guide detailed in section 5.1 page 25 in the PCMM_WEBP_DIBRG_v2.2.docx document. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : MAR 11, 2022 Completed By: Date Completed: APR 28, 2022 Released By : Date Released : APR 28, 2022 ============================================================================= Packman Mail Message: ===================== No routines included