$TXT Created by ANN at DEVVSB.DOMAIN.EXT (KIDS) on Monday, 11/09/20 at 06:36 ============================================================================= Run Date: DEC 09, 2020 Designation: SD*5.3*756 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #624 Status: Released Compliance Date: DEC 23, 2020 ============================================================================= Associated patches: (v)SD*5.3*745 <<= must be installed BEFORE `SD*5.3*756' Subject: COVID-19 VISTA CHANGES FOR VS GUI RELEASE 1.7.2.1 Category: - Routine - Data Dictionary - Other Description: ============ ************************************************************************* * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the Graphical User Interface (GUI) * * update for release 1.7.2.1 of VistA Scheduling (VS) is installed. * * The corresponding informational patch is SD*5.3.757 * * * * NOTE: The previous version of VS GUI will not operate after this patch * * is installed. * * * * NOTE: This patch should not be installed at Columbus, OH or Spokane, WA* * due to the EHRM Cerner Millennium Change Freeze. * * * ************************************************************************** In addition to the items listed in the defect tracking ticket and overview below, the following enhancements were made: 1. New Remote Procedure Call (RPC) that supports the launching of Virtual Care Manager (VCM) from the VS GUI when schedulers create a video appointment. 2. Added a picklist of static comments (hashtags) to the free text CANCELLATION REMARKS Field (#17) in the PATIENT File (#2). The picklist is a multi-select list and is configurable at the local level. 3. The COVID-19 priority from the Consolidated Patient Record System (CPRS) consult template is now displayed in the Request Management (RM) Grid. 4. Updated the following fields in the SDEC SETTINGS File (#409.98) with the post-install routine SDEC756P. CURRENT GUI VERISON Field (#2) GUI VERSION EFFECTIVE DATE Field (#3) VVC APP URL Field (#6) VVC STOP CODE multiple #409.987, Field (#.01) Patch Components ================ Files & Fields Associated: File Name (#) Field Name (#) New/Modified/Deleted ------------- --------------------- -------------------- SDEC SETTINGS (#409.98) VVC APP URL (#6) NEW VVC STOP CODE multiple VVC STOP CODE (#.01) NEW (#409.987) SDEC CANCELLATION COMMENT (#409.88) NEW 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 ----------- ---- -------------------- SDEC CANCEL COMMENTS - LOCAL ROUTINE NEW SDSUP MENU MODIFIED Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC VVC_APPT NEW SDEC CANCMT NEW SDEC APPDEL MODIFIED SDEC REQGET 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 (#) New/Modified/Deleted ------------- ---- ------------------ -------------------- n/a Remote Procedures Associated: Additional Information: New Service Requests (NSRs): ----------------------------- n/a Patient Safety Issues (PSIs): ------------------------------ n/a Defect Tracking Ticket(s) & Overviews: ------------------------------------- 1. JIRA #VSE-38 - Display Priority setting from CPRS COVID-19 Template in RM Grid Problem: ------- Schedulers need to see the COVID-19 priority from the CPRS consult template in the RM Grid. Resolution: ---------- The new COVID PRIORITY column was created to display the latest COVID-19 priority entered on the Consult in CPRS. The COVID priority codes are CV1, CV2, CV3, and CV4. 2. JIRA #VSE-37 - Expandable comments Problem: ------- There is a need for consistent verbiage and messaging within the VS GUI. This enhancement allows schedulers to choose canned cancellation comments (hashtags) from a multi-select picklist and add them to the free text CANCELLATION REMARKS Field (#17) in the PATIENT File (#2). The comments (hashtags) are configurable at the local level. Resolution: ---------- Modified the VS GUI to add the national and local canned cancellation comments (hashtags) when cancelling an appointment. The national comment field is a dropdown picklist that allows the user to choose one item from the list of national comments. The local comment field is a checkbox list control that allows the user to select multiple local comments. 3. JIRA #VSE-36 - New RPC that supports the launch of VCM from the VS GUI when a scheduler creates a video appointment. Problem: ------- Schedulers need the video appointment workflow streamlined. Resolution: ---------- Modified the VS GUI to launch VCM after creating a video appointment using the correct stop code. The "Print patient letter" prompt is suppressed when the video appointment is created and VCM launches. 4. JIRA #VSE-74 - Users are getting an 'APP SLOT ERROR' error when a Multiple Return to Clinic (MRTC) appointment is scheduled before the Patient Indicated Date (PID) in the MRTC booking window. Problem: ------- When users create a new MRTC request that has a PID in the past, they receive a pop-up message that reads 'APP SLOT ERROR'. Once the user clicks out of the message, the appointment is scheduled as requested. Resolution: ---------- The VS GUI was adjusted for better error handling so that users will not receive an error message. MRTCs will be scheduled and displayed in the Pending Appointments List. 5. JIRA #VSE-39 - Remove the Electronic Wait List (EWL) menu option from the RM Grid. Problem: ------- Use of the EWL will be discontinued as of November 2020. The first step in this process was to remove the EWL menu option from the RM Grid. Resolution: ---------- The GUI code was amended to comment out the Transfer to EWL menu option in the RM Grid. 6. JIRA #VSE-75 - Contact Attempts (CAs) entered for the first day of the month (ex., 09/01) are not displaying on the RM Grid. Problem: ------- CAs are not populating the CA LETTER and CA PHONE columns when PIDs are dated the first day of any month. Resolution: ---------- Updated the SDECAR1A routine to call a date conversion that subtracts one day from the PID entered. This allows the PID to match the data stored in the SDEC CONTACT File (#409.86). 7. JIRA #VSE-40 - Query by Request Type Problem: ------- The RTC, EWL, and VETERAN request types are either returned with other request type queries (as is the case for RTC) or they are not request types currently in use (as is the case for EWL and VETERAN). Resolution: ---------- A change was made to the GUI to remove EWL, VETERAN, and RTC from the request type filter in the query tool. 8. GUI-ONLY CHANGE - FOR INFORMATIONAL PURPOSES ONLY JIRA #VSE-104 - User Preference Conflict Closes the VS GUI Problem: ------- The addition of the COVID PRIORITY column is causing a mismatch (conflict) that results in the VS GUI crashing/closing. The temporary remedy is to skip over the stored column setting preference if the column is not in the same location. The issue will be permanently remedied when the User Preference logic is refactored. Resolution: ---------- A change was made to VS GUI logic within the SchedulePresentationModel class file that checks the RM Grid for custom column order. If a custom column order is detected, and a new column has been placed in one of the defined columns' spot, the new column is skipped to prevent an error. Test Sites: ----------- Detroit (DET) Fayetteville (FNC) Martinsburg (MWV) North Texas (NTX) Software and Documentation Retrieval Instructions: ------------------------------------------------- The software for this patch is being released in a PackMan message. NOTE: There are two installation files. The file titled ...1_7_2_1_P.MSI is the production installation file. The file titled ...1_7_2_1_T.MSI is the preproduction file. Other Software Files: This release also includes documentation and other software files. They can be obtained at: https://download.vista.domain.ext/index.html/SOFTWARE/ Documentation Title File Name FTP Mode -------------------------------------------------------------------------- VS GUI R1.7.2.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_2_1_P.MSI Binary VS GUI R1.7.2.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_2_1_T.MSI Binary VS GUI R1.7.2.1 VDD VS_GUI_1_7_2_1_VDD Binary VS GUI R1.7.2.1 DIBR VS_GUI_1_7_2_1_DIBR Binary VS GUI R1.7.2.1 Release VS_GUI_1_7_2_1_RN Binary Notes VS GUI R1.7.2.1 Technical VS_GUI_1_7_2_1_TM Binary Manual VS GUI R1.7.2.1 User VS_GUI_1_7_2_1_UG_ADD Binary Guide Addendum 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 FTP Mode -------------------------------------------------------------------------- VS GUI R1.7.2.1 VDD VS_GUI_1_7_2_1_VDD Binary VS GUI R1.7.2.1 DIBR VS_GUI_1_7_2_1_DIBR Binary VS GUI R1.7.2.1 Release VS_GUI_1_7_2_1_RN Binary Notes VS GUI R1.7.2.1 Technical VS_GUI_1_7_2_1_TM Binary Manual VS GUI R1.7.2.1 User Guide VS_GUI_1_7_2_1_UG_ADD Binary Addendum Patch Installation: Pre/Post Installation Overview ------------------------------ 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 ------------------------- 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the Kernel Installation and Distribution System (KIDS) Menu, select the Installation Menu. From this menu, you may elect to use the following option. When prompted for the INSTALL enter the patch # (SD*5.3*756): a. Backup a Transport Global - When prompted choose B (Build). This option will create a backup message of the entire Build (files/fields, options, protocols, templates, routines). b. 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 components of this patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install. 5. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', respond YES. 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', respond NO. 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. 8. If prompted 'Delay Install (Minutes): (0 - 60): 0//', respond 0. Post-Installation Instructions: ------------------------------ NO USER INTERACTION REQUIRED for post-install routine SDEC756P. This routine updates the CURRENT GUI VERSION Field (#2) and the GUI VERSION EFFECTIVE DATE Field (#3) in the SDEC SETTINGS File (#409.98) to reflect the new GUI version 1.7.2.1. Post-install also populates the new VVC APP URL Field (#6) with "https://www.mobile.domain.ext/app/virtual-care-manager" and adds the National VVC stop codes 179 and 225 to the VVC STOP CODES multiple (#409.987) of the SDEC SETTINGS File (#409.98), NAME Field (#.01). Backout Plan: ------------ Please see the VS GUI Release 1.7.2.1 DIBR on the VDL for instructions on how to back out the GUI. For VistA patch backout assistance, please submit a ServiceNow ticket to the VSE GUI T3 group. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 43 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC Before:B136404289 After:B136461024 **627,643,642,651,658,665,672, 679,686,694,745,756** Routine Name: SDEC08 Before:B208402907 After:B191154844 **627,651,658,665,722,740,744, 694,745,756** Routine Name: SDEC08A Before: B5555377 After: B15102733 **745,756** Routine Name: SDEC45 Before:B119865655 After:B155963257 **627,642,658,756** Routine Name: SDEC51 Before:B188351010 After:B203707691 **627,642,651,658,686,745,756** Routine Name: SDEC756P Before: n/a After: B3234995 **756** Routine Name: SDECAR1A Before: B50599861 After: B54841087 **658,745,756** Routine Name: SDECSTNG Before: B8146496 After: B33274213 **694,756** Routine Name: SDECVVC Before: n/a After: B4065498 **756** Routine list of preceding patches: 745 ============================================================================= User Information: Entered By : Date Entered : JUN 08, 2020 Completed By: Date Completed: DEC 08, 2020 Released By : Date Released : DEC 09, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT