$TXT Created by CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Tuesday, 04/20/21 at 14:46 ============================================================================= Run Date: MAY 10, 2021 Designation: SD*5.3*781 Package : SD - SCHEDULING Priority: EMERGENCY Version : 5.3 SEQ #632 Status: Released Compliance Date: MAY 21, 2021 ============================================================================= Associated patches: (v)SD*5.3*679 <<= must be installed BEFORE `SD*5.3*781' (v)SD*5.3*686 <<= must be installed BEFORE `SD*5.3*781' (v)SD*5.3*726 <<= must be installed BEFORE `SD*5.3*781' (v)SD*5.3*774 <<= must be installed BEFORE `SD*5.3*781' Subject: VSE ENHANCEMENTS VS GUI RELEASE 1.7.5 Category: - Routine - Other - Data Dictionary Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.5 and patch SD*5.3*781 includes several enhancements and defect corrections. There is no direct link between VS contact attempts and VS appointment requests. A congressional reporting mandate requires that a direct link be established so that contact attempts can be accurately reported. This patch accomplishes this by linking VS contact attempts to the appointment request. Also corrected in this patch is the issue occurring in production due to the Data File Number (DFN) being assigned to an external value of the Patient Name. When cancelling an appointment with a note and the patient has only a last name the code updating the note into the patient appointment continually errors out. The release contains an enhancement to record the system performing scheduling actions (e.g. VistA, VS GUI, VA Online Scheduling (VAOS)) and the software version of that system. The release also contains an enhancement to Contact Attempts code and lays the backend groundwork for VIDEO VISIT WEB SERVICE (VVS) enhancements. Defects corrected in the release include, correcting an issue where inactivate/reactivated dates were improperly excluding clinics from displaying in the VS GUI, fixes an issue where spaces in clinic group search would cause the VS GUI to crash, corrects a bug in SDEC RECGET and fixes the login screen so the 's' isn't cut off from 'Affairs'. Additionally, the release contains various 508 fixes. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the Graphical User Interface (GUI) * * update for release 1.7.5 of VistA Scheduling (VS) is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.5 and VistA patch * * SD*5.3*781 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------- ---------- -------------------- SDEC APPOINTMENT APPLICATION (#.24) New (#409.84) VERSION NUMBER (#.25) New VVS APPOINTMENT (#2) New SDEC CONTACT (#409.86) APPT REQUEST TYPE (#2.3) New 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 Menu 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 CLINSET Modified SDEC CONTACT DISPLAY SINGLE New SDEC CONTACT NEW New SDEC CONTACT SEQUENCE SINGLE New SDEC GETVVSMAKEINFO New SDEC SEARCH VVS PROVIDERS New SDEC SPACEBAR VVS PRO New SDEC VVS DELETE ID New SDEC VVS GET ID New SDEC VVS SAVE ID New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) Jira #VSE-399 - VistA: DFN is not set correctly when adding cancellation comments Problem: The issue occurs in Production because the DFN is assigned to the external value 'Patient Name'. When cancelling an appointment with a note using only the patient's last name, the code that updates the note into the patient appointment repeatedly errors out. Resolution: Modify logic to define the internal value of DFN vs. external DFN. The code can then update the NOTES into the patient file without error. 2) Jira #VSE-141 - Set Preferred Clinic Calendar Order Problem: As a Scheduler, I want the ability to rearrange the order of clinic calendars displayed in the Clinic Groups view, so that I can more easily schedule appointments within the group. Resolution: The Scheduler can move a clinic calendar from one position in the clinic group view to a different position (left or right of original position). The Scheduler can save their preferred view as default. 3) Jira #VSE-441 - Update Contact Attempt Code to Link to Appointment Requests Problem: Currently, there is no direct link between contact attempts and appointment requests. A congressional reporting mandate requires that a direct link be established so that contact attempts can be accurately reported by request. Resolution: Child stories accomplish this by linking contact attempts to the appointment request Internal Entry Number (IEN). 4) Jira #VSE-161 - Record Scheduling Actions Problem: Schedulers need additional detailed information related to the actions taken in the VS GUI to be stored in VistA for display and reporting. Resolution: VSE-411 Record Scheduling Actions - create field in 409.84. The APPLICATION (#.24) and VERSION NUMBER (#.25) fields were added to the SDEC APPOINTMENT (#409.84) file to help determine which application and version were used to create or update appointment records in VistA. 5) Jira #VSE-590 - Login Screen Display Issues Problem: There are some existing issues with the alignment of some of items on the login screen. The software needs to show the entire title of Department of Veteran Affairs. In previous versions the 's' is not displayed in Affairs. Resolution: The VS GUI login screen was updated to address the alignment issue and to include the 's' at the end of Department of Veteran Affairs. 6) Jira #VSE-580 - White space in clinic group search causes VS GUI to generate an error in error trap Problem: When a user enters multiple spaces in the search bar (lower left) for clinic groups, the GUI spins or crashes, and an error on SDEC63 is logged in the error trap. This is if only spaces are entered. Spaces followed by text will search. Resolution: The VS GUI search functionality was updated to strip off any trailing spaces from the user entered search string. 7) Jira #VSE-159 - Inactivate/Reactivate Dates Improperly Excluding Clinics from VS GUI Problem: Reactivated clinics are not coming up in clinic search. Correct issue with SDREACT and ensure VS GUI clinic search matches VistA clinic search. Resolution: The SDREACT routine was updated to correctly identify clinics that have been re-activated. 8) Jira #VSE-582 - Correct bug in SDEC RECGET Problem: There is an existing bug in RPC SDEC RECGET which can return an erroneous number of Call Contact attempts when there is more than one contact attempt record in file #409.86 with the same Patient, Clinic, Request Type and Preferred Date. Resolution: Add the new SDEC REQUEST POINTER field as additional validation check when determining the number of Call Contacts for a specific request. 9) Jira #VSE-561 - Create RPCs to support VVS in the VS GUI Problem: In the next version of the VS GUI 1.7.6, there will need to be several new RPCs to allow the user to perform various functions related to VVS appointments. Resolution: The following RPCs were created in preparation for the development and testing of the VS GUI 1.7.6: SDEC GETVVSMAKEINFO SDEC SEARCH VVS PROVIDERS SDEC SPACEBAR VVS PRO SDEC VVS DELETE ID SDEC VVS GET ID SDEC VVS SAVE ID 10) Jira #VSE-638 - 508-related updates for release 1.7.5 Problem: 508 audit findings need to be addressed. Resolution: Several updates were made to Telerik and to the Tasks Tab to address findings from a 508 audit. VSE-169, VSE-170, VSE-433 capture these changes. 11) Jira #VSE-530 .NET: Use MM/DD/YYYY date format for CA Problem: If a midnight time for CA is entered, the GUI crashes. Resolution: When storing and retrieving CA use MM/DD/YYYY date format. Test Sites: ----------- San Diego, CA (SDC) Sioux Falls, SD (SUX) Tomah, WI (TOM) 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_5_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_5_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.5 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_5_P.MSI Binary VS GUI R1.7.5 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_5_T.MSI Binary VS GUI R1.7.5 VDD VS_GUI_1_7_5 VDD Binary VS GUI R1.7.5 DIBR VS_GUI_1_7_5 DIBR Binary VS GUI R1.7.5 Release Notes VS_GUI_1_7_5 RN Binary VS GUI R1.7.5 Technical Manual VS_GUI_1_7_5 TM Binary VS GUI R1.7.5 User Guide Addendum VS_GUI_1_7_5_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 ------------------------------------------------------------------------ VS GUI R1.7.5 VDD VS_GUI_1_7_5_VDD Binary VS GUI R1.7.5 DIBR VS_GUI_1_7_5_DIBR Binary VS GUI R1.7.5 Release Notes VS_GUI_1_7_5_RN Binary VS GUI R1.7.5 Technical Manual VS_GUI_1_7_5_TM Binary VS GUI R1.7.5 User Guide Addendum VS_GUI_1_7_5_UG_ADD Binary PIMS Technical Manual PIMS_TM Binary 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: ------------------------------- Before installing SD*5.3*781, sites where patch SD*5.3*778 with a status of "ENTERED IN ERROR" was installed, we recommend rolling back the patch, in addition to the deletion of post install routine SDEC778P. Sites that do not roll back "ENTERED IN ERROR" patch SD*5.3*778 before installing SD*5.3*781 may have issues with before checksums for routines SDEC08, SDEC63, SDECCON and SDECAR1A. Routine SDEC781P will update the SDEC SETTINGS (#409.98) FILE. Post install routine SDEC781P will run at the end of the patch installation process and will perform the following actions: 1. Update the SDEC SETTINGS (#409.98) file to latest VS GUI version 1.7.5. 2. For existing entries in the SDEC CONTACT (#409.86) file the corresponding entries in the SDEC APPT REQUEST (#409.85), REQUEST/CONSULTATION (#123) or RECALL REMINDERS (#403.5) files will be updated to have a link back to the SDEC CONTACT (#409.86) file entry. 3. Entries in the SDEC RESOURCE (#409.831) file will be updated with the appropriate Inactivation or Reactivation dates based on the corresponding entries in the file or in the HOSPITAL LOCATION (#44) file. 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*781. a. Select the Backup a Transport Global option to create a backup message for this patch. For each patch you can specify what to backup; the entire Build or just Routines. When asked to specify what to backup, select Build. It is recommended to use this backup to restore the system as this should restore your system to the pre-patch condition. Select Installation Option: Backup a Transport Global Select INSTALL NAME: SD*5.3*781 4/28/21@17:03:49 => SD*5.3*781 TEST v7 This Distribution was loaded on Apr 28, 2021@17:03:49 with header of SD*5.3*781 TEST v7 It consisted of the following Install(s): SD*5.3*781 Subject: Backup of SD*5.3*781 on Apr 28, 2021 Replace Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// 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*781. 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 SDEC781P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC781P routine using the Delete Routines [XTRDEL] if they wish. Back-Out Plan/Roll Back Plan: ----------------------------- Install the Build style backup message created during the installation of SD*5.3*781. This will revert the changes to all of the VistA components included in patch SD*5.3*781 to pre-patch form. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted back to 1.7.3. If 1.7.5 VS GUI was installed, it will need to be reverted back to VS GUI 1.7.3. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_5_ 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: SDEC08 Before:B173119063 After:B173425633 **627,651,658,665,722,740,744, 694,745,756,774,781** Routine Name: SDEC1 Before: B283878 After: B5210857 **774,781** Routine Name: SDEC32 Before:B116278285 After:B127517661 **627,643,642,658,665,672,679,781** Routine Name: SDEC63 Before: B12529283 After: B12864388 **774,781** Routine Name: SDEC781P Before: n/a After: B16922723 **781** Routine Name: SDECAR1A Before: B54841087 After: B50641289 **658,745,756,781** Routine Name: SDECCON Before: B17988891 After: B47683442 **669,686,781** Routine Name: SDECVVS Before: n/a After: B27259080 **781** Routine Name: SDNACT Before: B33568630 After: B35322734 **63,380,549,568,622,627,726,781** Routine Name: SDNACT1 Before: B7173345 After: B8368683 **167,781** Routine Name: SDREACT Before: B21351976 After: B22851823 **63,167,380,568,627,781** Routine list of preceding patches: 679, 686, 726, 774 ============================================================================= User Information: Entered By : Date Entered : MAR 24, 2021 Completed By: Date Completed: MAY 07, 2021 Released By : Date Released : MAY 10, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT