$TXT Created by CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 09/09/21 at 11:48 ============================================================================= Run Date: OCT 07, 2021 Designation: SD*5.3*796 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #647 Status: Released Compliance Date: NOV 07, 2021 ============================================================================= Associated patches: (v)SD*5.3*792 <<= must be installed BEFORE `SD*5.3*796' (v)SD*5.3*726 <<= must be installed BEFORE `SD*5.3*796' Subject: VS GUI VERSION 1.7.12 Category: - Routine - Other - Data Dictionary - Input Template Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.12 and SD*5.3*796 includes several defect corrections and enhancements. This release implements a Check-In window and indicators on the Check-In screen to display an insurance change, and pre-Check-In and e-Check-In completion, ensures the "REQUESTOR" field shows "PROVIDER" and the "REQUESTED BY" field shows the Provider Name for "CONSULTS" and "PROCEDURES", a post-install routine to clean up Clinically Indicated Date (CID)/Preferred Date, a post-install routine correcting the provider on appointments scheduled from requests opened as a result of cancelled Recall appointments, and a post-install routine to clear old User Preferences. The release also ensures the Patient Indicated Date (PID) of appointments completed through VistA Scheduling are the day the appointment is created, so that the PID and associated metrics are accurate. Additionally, the release enables printing of a patient's medication list, modifies so that control characters are excluded from the patient input search field so that the Remote Procedure Call (RPC) works normally, and finally, creates an E-Check-In "Allowed" field in VistA for clinic setup supporting improved Veteran Check-In experience. This version corrects an issue where the Video Visit Service (VVS) appointment ID field was not deleted from the SDEC APPOINTMENT (#409.84) file when cancelling a VVS appointment, a tabbing fix on Make Appointment (APPT) Request screen resulting in a skipped PID field, and lastly, corrects a defect where the GUI crashes when a user tries to load the clinic schedule of a clinic for a scheduled appointment after the clinic's reactivation date. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.12 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.12 and VistA patch * * SD*5.3*796 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- HOSPITAL LOCATION (#44) E-CHECKIN ALLOWED (#20) New PRE-CHECKIN ALLOWED (#21) New 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 ----------- ---- -------------------- 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 ------------- ----------------------- -------------------- SDB INPUT Modified HOSPITAL LOCATION (#44) Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) VSE-761: VistA: VVS - Cancellation of a VVS appointment from "SDCANCEL/SDAM" VistA, VVS appointment ID field is not deleted from the SDEC APPOINTMENT file. Problem: The VVS APPOINTMENT (#2) field is not being deleted from the SDEC APPOINTMENT (#409.84) file when a VVS appointment in VistA is cancelled using the Cancel Appointment (CA) action when in the SDAM APPT MGT option. Resolution: Line tag SDECCAN in the SDEC08 routine was updated to correctly delete the VVS APPOINTMENT (#2) field when a VVS appointment in VistA is cancelled using the Cancel Appointment (CA) action when in the SDAM APPT MGT option. 2) VSE-1006: VS GUI: Display Check-In Indicators View Model. Problem: The Display view model needs to include indicators on the Check-In screen to address the following (original stories below): * insurance change * pre-checkin completed * e-checkin completed Resolution: 3) VSE-1018: TELERIK: Update "Print the Patient Letter." message to new format. Problem: When appointment is cancelled, application displays user message "Print the Patient Letter?", the dialog box is not recognized by the automation tool and needs to be replaced with dialog box used for the same dialog box used in VVS appointment creation. Resolution: There are about 30 places in VSE GUI where this type of message box gets displayed. The resolution was to replace all the Keys methods that currently open a Windows.System.MessageBox with opening the VSE message window instead and make sure the software can do that in the worker threads. 4) VSE-1203: 508 - .NET: Tabbing on Make Appt Request screen skips Patient Identified Date (PID). Problem: Tabbing on the Appointment Request window skips the PID field and goes straight to appointment type field. Resolution: There was an issue with the DatePicker user control that was interfering with the TabIndex. Changes were made to the user control to fix the issue. 5) VSE-1267: RECALL - Editing an Appt Request that was previously a Recall you have to add Provider Problem: Under certain conditions the Provider Information was not being returned from VistA to the VS GUI. Resolution: The SDEC RECPRGET Remote Procedure Call (RPC) was also updated to verify that the Provider is an active user on the system. The VS GUI was updated to properly populate the Provider information for Recalls. 6) VSE-1306: VistA: Post Install Routine to correct Recalls with incorrect provider. Problem: When a Recall Appointment is created, the Provider information is required before the Appointment can be saved. If this Recall Appointment is scheduled and then cancelled, the Scheduling software opens a new Appointment request, but the Provider information was not being set correctly on the new Appointment Request. The fix for this was released in SD*5.3*785. Resolution: The SDEC796P post install routine will now go and correct the erroneous Provider data for all Recall Appointments that were created prior to the installation of SD*5.3*785. 7) VSE-1353: .NET GUI: Print medication list. Problem: The staff members need to be able to print a patient's medication list, so they can better manage their patient's care. Resolution: The ability to print a patient's medication list is available. 8) VSE-1355: VistA: Veterans Scheduling Interoperability Platform (VSIP) - Create E-Checkin Allowed field in clinic setup. Problem: Need two fields that control if a clinic allows E-checkin or Pre-checkin. Resolution: Add 2 new fields to HOSPITAL LOCATION FILE (#44). One field E-Checkin Allowed field #20 and PRE-Checkin Allowed field #21 are both Yes/No fields 9) VSE-1375: VistA: Create Post-install Routine (Clean up Clinically Indicated Date (CID)). Problem: CID/PREFERRED DATE OF APPT field missing day or date. Resolution: Created post install to clean up CID/PREFERRED DATE OF APPT field with a missing day or date. 10) VSE-1395: VistA: Prevent Back-Dating PID. Problem: User shouldn't be able to back-date PID in VistA. Resolution: In SDAM APPT MGT for the prompt PID, change to the date the appointment was made and remove the prompt for PID. 11) VSE-1405: Test VSE report features after removal of report file. Problem: During the process of submitting 1.7.10, Office of Information and Technology (OIT) flagged a file (SDEC_VSE_ReportConsole.jar) in the application as having a security risk. Resolution: Investigation showed that this file is not being used by VSE, so it was deleted. 12) VSE-1406: .NET sanitize user input in patient search. Problem: Control characters included in input. Resolution: .NET sanitize user input in patient search 13) VSE-1413: .NET: Display PROVIDER for "REQUESTOR" for consults and procedures. Problem: VS GUI needs to display PROVIDER for "REQUESTOR" for consults & procedures. Resolution: VS GUI modified to display PROVIDER for "REQUESTOR" for consults & procedures. 14) VSE-1437: VistA: User Preferences - Post Install routine to clear old user preferences. Problem: Users who have saved USER PREFERENCES that were saved prior to the COVID PRIORITY, CA PHONE, or CA LETTER columns being created are causing issues within the VS GUI. Resolution: Post-install routine to check for outdated user preferences (missing columns, for example), and if preferences are old, clear the preferences. 15) VSE-1459: GUI is crashing when user tries to load the inactive clinic appointment from the pending appointment list. Problem: While the clinic is inactive, schedule an appointment after reactivation date from the option SDAM APPT MANAGEMENT in Vista. Resolution: Code was modified to display the inactive clinic. Test Sites: ----------- North Texas (NTX) Martinsburg, WV (MWV) Orlando, FL (ORL) 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_12_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_12_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.12 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_12_P.MSI Binary VS GUI R1.7.12 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_12_T.MSI Binary VS GUI R1.7.12 VDD VS_GUI_1_7_12 VDD Binary VS GUI R1.7.12 DIBR VS_GUI_1_7_12 DIBR Binary VS GUI R1.7.12 Release Notes VS_GUI_1_7_12 RN Binary VS GUI R1.7.12 Technical Manual VS_GUI_1_7_12 TM Binary VS GUI R1.7.12 User Guide Addendum VS_GUI_1_7_12_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/ 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 SDEC796P 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*796. 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*796. 5. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' respond NO. 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 SDEC796P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC796P 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*796. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.11. If 1.7.12 VS GUI was installed, it will need to be reverted to VS GUI 1.7.11 See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_12_ DIBR.pdf. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC08 Before:B180017805 After:B182201486 **627,651,658,665,722,740,744, 694,745,756,774,781,785,790, 792,796** Routine Name: SDEC32 Before:B127517661 After:B127218939 **627,643,642,658,665,672,679, 781,796** Routine Name: SDEC52B Before: B20509023 After: B21704341 **627,796** Routine Name: SDEC796P Before: n/a After: B26583101 **796** Routine Name: SDM0 Before:B105227522 After:B106931874 **140,167,206,186,223,237,241, 384,334,547,621,622,645,674, 726,796** Routine list of preceding patches: 726, 792 ============================================================================= User Information: Entered By : Date Entered : AUG 27, 2021 Completed By: Date Completed: OCT 07, 2021 Released By : Date Released : OCT 07, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT