============================================================================= Run Date: OCT 06, 2022 Designation: YS*5.01*202 Package : YS - MENTAL HEALTH Priority: Mandatory Version : 5.01 SEQ #158 Status: Released Compliance Date: NOV 06, 2022 ============================================================================= Associated patches: (v)YS*5.01*121 <<= must be installed BEFORE `YS*5.01*202' (v)YS*5.01*130 <<= must be installed BEFORE `YS*5.01*202' (v)YS*5.01*141 <<= must be installed BEFORE `YS*5.01*202' (v)YS*5.01*172 <<= must be installed BEFORE `YS*5.01*202' (v)YS*5.01*207 <<= must be installed BEFORE `YS*5.01*202' Subject: MHA WEB UPDATES Category: - Routine - Other Description: ============ The purpose of this patch is to release an update to the Mental Health Assistant (MHA) Web application. MHA Dashboard is a new feature that is integrated into the MHA Web application along with new instruments, updates to graphing and other functionality. -Add Print Title to individual instruments for printing. -Update Location input box to search for both clinics and wards. -Update Location input to allow locations starting with numbers and if entered text is exact match to a location. -Update Ordered By, Interviewer, and Location input box to allow / and ~ -Add CAT-PSYCHOSIS, EHS-14, PEBS-20, PEBS-27, WBS, ASRS, and DAR-5 instruments. -Update Print Title for PCL-5, PCL-5 Weekly, CAD-PTSD-DX, and CSI Partner Version. -Update BASIS-24 instrument for blank fields. -Update FAST instrument scoring. -Update FOCI skip logic. -Update PHI question text -Update MCMI4 to allow skipped questions and not allow >13 skipped. -Update SLUMS and GDS DEMENTIA to add story text to JSON in the MH TEST/SURVEY SPEC file. -Add Instrument Interpretive Text data to MH TESTS AND SURVEYS file. -Add RPC to get Interpretive Text for instruments. -Update Instrument Exchange to transport INTERPRETIVE TEXT for instruments, ROUTINE FOR SUICIDE RISK and TAG FOR SUICIDE RISK. -Remove CAT-ADHD, CAT-SDOH, and CAT-PTSD instruments. -Update Parameter Definitions for MHA Web preferences. -Update Parameter GET and POST to remove inactive instruments for Favorite Instruments, Batteries, and Special Graph Reports. -Add Dashboard RPC calls to MHA Web. -Add Dashboard UI to MHA Web. -Update Instrument Exchange to fix CRLF bug. -Update Dashboard Done in 7, Last CSRE, and Last Safety Plan logic to only honor signed notes. -Update Dashboard drilldown logic when searching for CSRE and Safety Plan documents to always find latest if multiple on same day. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------ -------------------- MH DASHBOARD WIDGET(605.1) New MH TESTS AND SURVEYS INTERPRETIVE TEXT(110) New (601.71) 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 ----------- ---- -------------------- N/A Protocols Associated: Protocol Name Type 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 Parameters Associated: Parameter Definition Name New/Modified/Deleted ------------------------- -------------------- YSB CSRE HEADER TEXT New YSB CSRE NEW EVALUATION New YSB CSRE UPDATE EVALUATION New YSB SAFETY PLAN DECLINE New YSB SAFETY PLAN HEADER TEXT New YSB SAFETY PLAN REVIEWED New YSB SAFETY PLAN SOC CONT NO New YSB SAFETY PLAN SOC CONT YES New YSB USER COLUMN PREFERENCE New YS MHA_WEB BATTERIES Modified YS MHA_WEB FAV INST Modified YS MHA_WEB GRAPH PREFS Modified YS MHA_WEB LAST ASSIGN SET Modified YS MHA_WEB PROG NOTE PREFS Modified YS MHA_WEB REPORT PREFS Modified YS MHA_WEB SPECIAL GRAPH RPT Modified Additional Information: New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- SPP-10644 MHA Web-Favorites- User is able to create an Instrument Favorites list with a null instrument. In a specific button click sequence it is possible for a user to create an Instrument Favorites list with a null instrument. Instead, the user should be notified that an instrument must be selected. SPP-10576 MCMI-4 does not allow skipped questions. The MCMI4 instrument did not allow skipped questions. The instrument was updated to allow skipped questions and alert clinicians when more than 13 questions are skipped. SPP-10511 MHA Web - Graphing - Maximum call size exceeded. When using the mouse to drill down into a graph an error of "maximum call size exceeded" may be displayed on the graph instead of data. The UI was updated to fix the error when loading the graphing preferences and when the split graph option is chosen. SPP-11213 - MHA Web - User Name entry fails when multiple names match When creating a new assignment, if the name for the ordering doctor or interviewer matches multiple users, the user's title will show up appended to the name to help the user select the correct name. If a user selects the name with the title appended, trying to create the assignment by hitting Patient Entry or Staff Entry will result in an error message for an incorrect field. SPP-11256 - MHA Web - Locations/Clinics with long names show as invalid Locations/Clinics with long names are failing the field validations which keep users from entering the correct location. SPP-11371 - "Done in 7" status change is incorrect for unsigned Safety Plan When a user completes a Safety Plan (SP) in CPRS and selects the "Finish" button, Dashboard changes the status in the "Done in 7" column to "COMPLETE" even though the SP has not been signed by the user. SPP-11373 - Dashboard - Safety Plans are not showing up in the patient drilldown When a SP is completed in CPRS, under certain circumstances, the SP is not showing up when the user enters the patient drilldown to look at the details of the SP. Some are present, and others are not. SPP-11395 - Dashboard - CSRE should only show when it is signed When a CSRE is completed in CPRS but is not signed, there should be no data that appears in Dashboard. Only once a CSRE is signed should it then appear in the dashboard "Last CSRE" Column and only then should it appear in the Drill down for the patient under CSRE. SPP-11465 - Location Field - 7B Location should be Selectable And It is Not When a location name starts with a number, the search for the location name fails. SPP-11452 - Location Field - Typing single digit numbers in location field cause error to populate When a location name begins with a single digit number, the search for the location name fails. This is related to SPP-11465 SPP-10738 - MHA Web - Create/Edit Assignment-Ordered by, Interviewer, and Location field throws error when tilde (~) used. Entering a ~ in Ordered by, Interviewer, or Location fields causes an error to be generated instead of the input being accepted. SPP-11301 - MHA Web - Ordered by, Interviewer, and Location fields error out when manually entering a "/" character Entering a / in Ordered by, Interviewer, or Location fields causes an error to be generated instead of the input being accepted. Test Sites: ----------- Clement J. Zablocki VAMC (Milwaukee, WI) Orlando VAMC (Orlando, FL) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/YS_5_01_202.KID 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 Title File Name ------------------------------------------------------------------- Deployment, Installation YS_5_01_202_DIBRG.DOCX Back-out and Rollback Guide- YS_5_01_202_DIBRG.PDF YS*5.01*202 Mental Health Assistant MHA_WEB_UM.DOCX User Manual MHA_WEB_UM.PDF Release Notes YS_5_01_202_RN.DOCX YS_5_01_202_RN.PDF Patch Installation: ------------------- Pre/Post Installation Overview: The pre-installation consists of the normal checks to ensure the integrity of the PackMan message. A post-installation routine, YS202PST, runs at the end of the installation. Pre-Installation Instructions: This patch can be loaded with users in the system, but it is recommended that it be installed when user activity is low. Installation time will be less than 5 minutes. Installation Instructions: 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/YS_5_01_202.KID 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. (YS*5.01*202) 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 (YS*5.01*202) iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build 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 NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Post-Installation Instructions: There are no post-installation steps. Back-Out/Roll Back Plan: ------------------------ For information about back-out steps, see this document: YS_5_01_202_DIBRG.DOCX in the VistA Documentation Library at: http://www.domain.ext/vdl/ Routine Information: ==================== The second line of each of these routines now looks like: ;;5.01;MENTAL HEALTH;**[Patch List]**;Dec 30, 1994;Build 47 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: YS202PST Before: n/a After: B31326919 **202** Routine Name: YS202TXT Before: n/a After:B110611824 **202** Routine Name: YSBDD1 Before: n/a After:B143139238 **202** Routine Name: YSBJSON Before: n/a After: B42050108 **202** Routine Name: YSBPREFS Before: n/a After: B52870651 **202** Routine Name: YSBRPC Before: n/a After: B68268540 **202** Routine Name: YSBWHIG2 Before: n/a After: B90905063 **202** Routine Name: YSBWHIGH Before: n/a After:B207104998 **202** Routine Name: YTQRCAT Before: B43767637 After: B44680325 **182,199,202** Routine Name: YTQREST Before: B27305745 After: B32941761 **158,178,182,181,187,199,202** Routine Name: YTQRQAD2 Before: B49402666 After: B50997052 **130,141,173,178,182,181,199,202** Routine Name: YTQRQAD3 Before: B76501689 After: B82183785 **130,141,158,178,182,181,187, 199,207,202** Routine Name: YTQRQAD4 Before:B180097624 After:B208885212 **158,178,182,181,187,199,202** Routine Name: YTQRQAD5 Before: B53880383 After: B54727270 **158,178,182,181,187,199,202** Routine Name: YTQRQAD7 Before: B59545179 After:B205041922 **181,187,202** Routine Name: YTQRQAD8 Before: B9054687 After: B9054687 **199,207,202** Routine Name: YTSCAT Before: B41254960 After: B44396601 **182,199,202** Routine Name: YTSEHS14 Before: n/a After: B9892060 **202** Routine Name: YTSFAST Before: B5556501 After: B3839483 **123,202** Routine Name: YTSMCMI4 Before:B246584185 After:B251360451 **151,187,202** Routine Name: YTSPEB20 Before: n/a After: B10412071 **202** Routine Name: YTSPEB27 Before: n/a After: B10411704 **202** Routine Name: YTSWBS Before: n/a After: B5723495 **202** Routine Name: YTWJSON Before: B78473167 After: B78132023 **130,141,202** Routine Name: YTWJSONO Before: B23558411 After: B23348872 **130,141,202** Routine Name: YTXCHGI Before: B54913462 After: B55947879 **121,202** Routine Name: YTXCHGM Before: B73386322 After: B75625677 **121,123,172,202** Routine Name: YTXCHGT Before: B23916651 After: B24969505 **121,123,130,202** Routine list of preceding patches: 172, 207 ============================================================================= User Information: Entered By : Date Entered : MAR 30, 2022 Completed By: Date Completed: OCT 05, 2022 Released By : Date Released : OCT 06, 2022 ============================================================================= Packman Mail Message: ===================== No routines included