$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Wednesday, 08/11/21 at 13:15 ============================================================================= Run Date: AUG 16, 2021 Designation: SD*5.3*790 Package : SD - SCHEDULING Priority: EMERGENCY Version : 5.3 SEQ #643 Status: Released Compliance Date: AUG 27, 2021 ============================================================================= Associated patches: (v)SD*5.3*788 <<= must be installed BEFORE `SD*5.3*790' Subject: VS GUI VERSION 1.7.9 Category: - Routine - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.9 and SD*5.3*790 include various enhancements and defect fixes. This release addresses several defects, including parent Multiple Return to Clinics (MRTCs) returning to the Request Management (RM) grid when a user closes a child request, the GUI crashing when taking an action on an appointment with no resource, the Patient Indicated Date (PID) not updating appropriately when changed during Cancel by Patient, clinic name truncation on clinic search for clinics with an abbreviation that matches the clinic name, and issues with Contact Attempt (CA) calculation for reopened Patient Centered Scheduling (PtCSch) requests. This release also begins Veterans Scheduling Interoperability Platform (VSIP) changes in VS GUI and VSE for clinical staff. Additionally, the release ensures that appointments cannot be created without a resource, and that requests are only reopened when certain cancellation reasons are used. Lastly, the release includes several Remote Procedure Call (RPC) updates to improve efficiency and provide returns in JSON format. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.9 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.9 and VistA patch * * SD*5.3*790 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- SDEC SETTINGS (#409.98) CURRENT GUI VERSION (#2) Modified GUI VERSION EFFECTIVE DATE (#3) Modified 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 ----------- ---- -------------------- SDECRPC Broker (Client/Server) Modified SDRR CLEAN-UP Run Routine 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 (Number) New/Modified/Deleted ------------- ----------------------- -------------------- N/A Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC APPDEL Modified SDEC GET RECALLRMV BY DFN JSON New SDES CLINIC RSC SEARCH JSON New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) Jira #VSE-232: Parent MRTC returns to RM Grid when user selects for child request to be closed. Problem: When you cancel a MRTC appointment and select to not have the request repopulate into the RM grid, it removes the child request but puts the parent request back into the grid. Resolution: When selected to not have the request repopulate into the RM grid, it removes the child request and the parent request from RM grid. 2) Jira #VSE-940: GUI crashes when action is taken on an appointment with no resource. Problem: If a user tries to select from the action menu in the pending appointments list for an appointment with no resource (shows as *CORRUPT DATA), the GUI crashes. Resolution: The following was completed to resolve this defect: Removed SDEC ELIG RETURN call (depends on update to SDEC FAPPTGET to include eligibility) - Null checks for Video Visit Service (VVS) queries on missing resource on view/edit of appointment. This is in GroupPresentationModel.cs. - Null check on cancel appointment in cancelApptPresentationModel. - Updated mapper for SDEC FAPPGET call to parse eligibilities. - Added error handling for when resource is missing 1. Added popup on view/edit of appointment explaining a resource is missing and provide options to the user. 2. Added error message on Clinic field in View/Edit screen if missing, to further indicate to the user there is an issue. 3) Jira #VSE-946: Update error messages for JSON RPC calls. Problem: There are a handful of JSON RPCs that we are using on the .NET side in the GUI. This story is to update the error handling to use the new way the team decided on (.Net and MUMPS). It should also use the new error window that was created to display the errors to the user. Resolution: The error handling was updated for JSON RPC calls. 4) Jira #VSE-978: Updated PID is not displaying on the request after changing the PID date on the cancellation window. Problem: Updated PID is not displaying on the request. Resolution: Updated PID will display on the request. 5) Jira #VSE-979: RECALL - Drag and drop writes the request to the RM Grid. Problem: When doing a drag and drop with a recall appointment, the request is created on the RM Grid and not removed when the appointment is made. This should be a behind the scene action; it shouldn't display on the RM Grid. Resolution: When a new appointment is created in the background, it will not be visible on the RM Grid. 6) Jira #VSE-985: E-Checkin Indicator. Problem: As a staff member, I want to know whether a patient in my queue has completed e-check-in, so that I can ensure I have all required information. Resolution: Added an indicator to time slot viewer and pending appointments list. 7) Jira #VSE-1024: Redesign User Preferences. Problem: Rework the User Preferences user interface (UI) to be more user-friendly. Resolution: The UI was redesigned to be more user-friendly. 8) Jira #VSE-1037: Disable SDRR CLEANUP job Problem: The job SDRR CLEANUP needs to be disabled so that it cannot be set up to run as a nightly job at sites. Follow the same pattern that Brian Rene did for the EWL option. Resolution: Update OPTION SDRR CLEAN-UP to include OUT OF ORDER MESSAGE so that it will not be available. Also update routine SDRRCLR to QUIT at the top of the routine so that it will not run. These updates disable the menu option from being run manually or called from the nightly Schedule/Unschedule Option under the TASKMAN MANAGEMENT option. 9) Jira #VSE-1076: Clinic Search: Clinic name truncation when abbreviation matches. Problem: When a clinic's abbreviation matches the first part of the clinic's name, the clinic name is truncated when auto filled. Resolution: Truncation of the clinic name was corrected in the Recall, APPT, and main clinic search. 10) Jira #VSE-1084: Update overbook dialog to use new VS window. Problem: Replace the Windows Message box dialog for overbook alerts with the new VS window created to allow for automated testing. The new dialog box should have the same functionality as the old Message box dialog. Resolution: A new VS window was created to allow for automated testing. 11) Jira #VSE-1093: Correct defect causing GUI to crash if action is taken on APPT missing resource. Problem: The GUI is crashing if action is taken on APPT missing resource. Resolution: The following was completed to resolve this defect: Removed SDEC ELIG RETURN call (depends on update to SDEC FAPPTGET to include eligibility) - Null checks for VVS queries on missing resource on view/edit of appointment. This is in GroupPresentationModel.cs. - Null check on cancel appointment in cancelApptPresentationModel. - Updated mapper for SDEC FAPPGET call to parse eligibilities. - Added error handling for when Resource is missing 1. Added popup on view/edit of appointment explaining a resource is missing and provide options to the user. 2. Added error message on Clinic field in View/Edit screen if missing, to further indicate to the user there is an issue. 12) Jira #VSE-1157: VistA: Ensure Contact Attempts for Recall Requests are included when converted to an appointment. Problem: Need to ensure that contact attempts logged on a Patient Centered Scheduling (PtCSch) request are also included on the appointment request when the PtCSch appointment is cancelled and the request is reopened as an appointment. Resolution: Updated SDEC08 to update the APPT REQUEST TYPE (#.22) field to have the correct pointer value for entries pointing to the SDEC APPT REQUEST (#409.85) file. 13) Jira #VSE-1166: Expand Entry for a cancellation does not show the right clinic and cancellation date/time. Problem: Expand Entry for a cancellation does not show the right clinic and cancellation date/time for an appointment that was entered at the same date and time as the one that was cancelled. Resolution: A new appointment is bumped up by one minute. 14) Jira #VSE-1204: Patient Search keyboard shortcuts do not work on new patient search. Problem: The following shortcuts do not work on the new patient search: - When using Alt+S or Ctrl+F: o Expected behavior: Launch search popup and focus on patient search input box. o Result: Nothing happens. - When using Alt+H: o Expected behavior: Focus on search hyperlink. o Result: Nothing happens. Resolution: The shortcuts were fixed to result in the expected behavior. Test Sites: ----------- North Texas Detroit, MI Software and Documentation Retrieval Instructions: ---------------------------------------------------- Software is distributed by PackMan message and MSI software. NOTE: There are two installation files. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_9_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_9_T.MSI is the preproduction VS GUI 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.9 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_9_P.MSI Binary VS GUI R1.7.9 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_9_T.MSI Binary VS GUI R1.7.9 VDD VS_GUI_1_7_9 VDD Binary VS GUI R1.7.9 DIBR VS_GUI_1_7_9 DIBR Binary VS GUI R1.7.9 Release Notes VS_GUI_1_7_9 RN Binary VS GUI R1.7.9 Technical Manual VS_GUI_1_7_9 TM Binary VS GUI R1.7.9 User Guide Addendum VS_GUI_1_7_9_UG_ADD Binary PIMS Technical Manual PIMS_TM Binary 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 ------------------------------------------------------------------------ Patch Installation: ------------------- GUI Installation Instructions: ------------------------- Sites using the System Center Configuration Manager (SCCM) push process for installations can find the build documents in the following locations: - CMCB Build Document (Production): https://vaww.eie.domain.ext/SysDesign/CS/DTStatus/SitePages/Build%20Documents. aspx?pid=216 - CMCB Build Document (Test): https://vaww.eie.domain.ext/SysDesign/CS/DTStatus/SitePages/Build%20Documents. aspx?pid=228 Sites that employ the VistA Consolidated Server (VACS) installation process will be alerted to the new GUI via an action item from Office of Information and Technology (OIT) Information Technology Operations and Services (ITOPS). Follow the detailed instructions in the Action Item email for VACS installation. The IO HBMC FO Application Division will lead and coordinate deployment activities with EUO, Client Technology, Citrix Back Office and Area Managers, and other OIT and business partners as required. The released software package is available at: https://download.vista.domain.ext/index.html/SOFTWARE Implementation Manager Point of Contact: Name: Yoojin Lee Phone: 206-277-4608 Email: Yoojin.Lee@domain.ext Pre/Post Installation Overview: ------------------------------- Routine SDEC790P will update SDEC SETTINGS (#409.98) FILE. Routine will run at the end of patch installation process. Pre-Installation Instructions: ------------------------------ N/A Setup/Configuration Instructions: --------------------------------- 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. It is not recommended that this patch be queued. 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the KIDS Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME, enter SD*5.3*790. a. Backup a Transport Global - This option will create a backup message of any components exported with this patch. You are prompted to select "R" for Routines or "B" for Build. For this patch, backing up the "B"uild is suggested. Select one of the following: B Build R Routines Enter response: Build 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 when prompted for the INSTALL NAME, enter SD*5.3*790. 5. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES//' respond YES. 6. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//" respond NO. 7. If prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//" respond NO. 8. If prompted "Delay Install (Minutes): (0 - 60): 0//" respond 0. Post-Installation Instructions: ------------------------------- Post install routine SDEC790P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC790P routine using the Delete Routines [XTRDEL] if they wish. Back-Out Plan/Roll Back Plan: ----------------------------- Install the backup message created during the installation of SD*5.3*790. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted back to 1.7.8. If 1.7.9 VS GUI was installed, it will need to be reverted back to VS GUI 1.7.8. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_9_ DIBR.pdf. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 11 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC Before:B136461024 After:B136529127 **627,643,642,651,658,665,672, 679,686,694,745,756,790** Routine Name: SDEC07 Before:B181314236 After:B182578667 **627,642,651,658,665,669,671, 672,701,686,740,694,785,788, 790** Routine Name: SDEC08 Before:B198721859 After:B180017805 **627,651,658,665,722,740,744, 694,745,756,774,781,785,790** Routine Name: SDEC50 Before:B189140313 After:B190831177 **627,658,665,672,722,723,737, 694,745,790** Routine Name: SDEC52CJSON Before: B43856140 After: B43237930 **784,785,788,790** Routine Name: SDEC52CRMVJSON Before: n/a After: B48950491 **790** Routine Name: SDEC55A Before: B98719180 After:B113154623 **627,671,701,722,734,694,790** Routine Name: SDEC790P Before: n/a After: B1888215 **790** Routine Name: SDECRECREQ Before: n/a After: B8673461 **790** Routine Name: SDECUTL Before:B101052538 After:B107666261 **627,658,665,790** Routine Name: SDECVVS Before: B36117901 After: B36137041 **781,784,785,788,790** Routine Name: SDES Before: B1116614 After: B3148087 **788,790** Routine Name: SDES01C Before: n/a After: B8699364 **790** Routine Name: SDES25 Before: n/a After:B144656924 **790** Routine Name: SDES30 Before: n/a After: B2568685 **790** Routine Name: SDESAPPTUTIL Before: n/a After: B3286700 **790** Routine Name: SDESCKNSTEP Before: B42608501 After: B44239090 **788,790** Routine Name: SDESSEARCH Before: n/a After: B3328090 **790** Routine Name: SDRRCLR Before: B15280543 After: B15573877 **536,642,790** Routine list of preceding patches: 788 ============================================================================= User Information: Entered By : Date Entered : JUN 17, 2021 Completed By: Date Completed: AUG 16, 2021 Released By : Date Released : AUG 16, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT