$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Tuesday, 12/28/21 at 19:16 ============================================================================= Run Date: JAN 24, 2022 Designation: SD*5.3*803 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #657 Status: Released Compliance Date: FEB 04, 2022 ============================================================================= Associated patches: (v)SD*5.3*801 <<= must be installed BEFORE `SD*5.3*803' Subject: VS GUI VERSION 1.7.17.2 Category: - Routine - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.17.2 and SD*5.3*803 includes several defect corrections and enhancements. The release addresses a front-end fix to midnight timestamp conversion of cancel datetime, adds Arizona time zone to VA Video Connect (VVC) time zone options, updates established. Additionally, the release creates SDES Remote Procedure Calls (RPCs) to Create, Read, Update, and Delete RECALL requests, adds SDEC RPC to return a user's station ID, creates an SDES RPC to edit availability for a clinic in HOSPITAL LOCATION file (44), adds additional logic to the MBAA APPOINTMENT MAKE RPC, and addresses 508 fixes to Clinics and Users Message form, Clinic Groups Message form, and Print Letter form. The release also addresses a fix for when pending Return To Clinic (RTC) Order Cleanup Tool incorrectly dispositions pending orders, and updates Veterans Health Information Systems and Technology Architecture (VistA) so that a user cannot cancel an appointment in "checked-in" status. Printed letters after performing a Block and Move was correctled to note the Date and Time of the new appointment. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.17.2 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.17.2 and VistA patch * * SD*5.3*803 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- 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 SDESRPC Broker (Client/Server) 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 ------------- ----------------------- -------------------- Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC GET STATION ID JSON New SDES CANCEL CLIN AVAILABILITY Modified SDES CREATE RECALL REQ Modified SDES DISPOSITION RECALL REQ New SDES EDIT CLINIC AVAILABILITY New SDES EDIT RECALL REQ New SDES GET CLINIC INFO Modified SDES GET RECALL BY IEN New SDES GET RECALLS BY DFN New SDES GET USRPROFILE Modified SDES INACTIVATE/ZZ CLINIC Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) VSE-189: Print Letter Message - Remediate 508 findings in Print Letter form. Problem: The VS GUI Print Letter form needs to be 508 compliant so that users can easily use assistive technology to manage appointments in VS GUI. Resolution: The VS GUI Print Letter form was updated to be 508 compliant. 2) VSE-196: Clinics and Users Message - Remediate 508 findings in Clinics and Users Message form. Problem: For the user to easily use assistive technology to manage appointments in VS GUI, ensure the Clinics and Users Message window is 508-compliant. Resolution: The Clinics and Users Message window is tested to be 508-compliant. 3) VSE-198: Clinic Groups Message - Remediate 508 findings in Clinic Groups Message form. Problem: For the user to easily use assistive technology to manage appointments in VS GUI, ensure the Clinic Groups Message window is 508-compliant. Resolution: The Clinic Groups Message window is tested to be 508-compliant. 4) VSE-207: .NET: Midnight timestamp for DateTime fields in SDEC APPOINTMENT (#409.84) file causes error in VS GUI. Problem: If the datetime field for appointment actions is set to midnight (e.g. DEC 11,2020@24:00), then when the patient with the affected appointment is brought into context in VS GUI, the GUI will present a DateTime error. Pending appointments will not display past the appointment with the midnight timestamp on it. Resolution: NOSHOW and CANCEL both used the CANDATE field in the data table returned by SDEC FAPPTGET. The issue was that the RPC was returning an '@' symbol in the case of a midnight Datetime, causing the Convert library to fail. NOSHOW and CANCEL both used the CANDATE field in the data table returned by SDEC FAPPTGET. The '@' symbol is replaced with a space and Convert is able to work. 5) VSE-1467: VVC - Arizona time zone is not an option when creating a VVC appointment, resulting in links sent at the incorrect time. Problem: Time zone options in VS GUI for Virtual Connect Manager (VCM) link creation is incorrect for the entire state. The only option is Mountain. It is running as Mountain Daylight and Arizona Time is not an option. Every link from GUI is incorrect for Arizona. All links sent are displaying as an hour later because Arizona does not honor daylight savings time. Resolution: Arizona time zone added. 6) VSE-1567: VistA: Create RPC to edit availability for a clinic in HOSPITAL LOCATION (#44) file. Problem: Create new RPC to edit availability for a clinic in HOSPITAL LOCATION (#44) file. Note: RPC should not include business logic/validations-this will occur at business domain layer Enterprise Appointment Services (EAS) and/or at the application level. Resolution: The SDES EDIT CLINIC AVAILABILITY RPC was created to allow users to edit the clinic's availability via the VS GUI. 7) VSE-1937: SDES RECALL Create, Read, Update or Delete (CRUD) RPCs - Create. Problem: A new SDES Remote Procedure Code (RPC) is needed to Create RECALL Requests. Resolution: The new SDES CREATE RECALL REQ RPC was created to create new RECALL Request Records in the RECALL REMINDERS (#403.5) file. 8) VSE-1938: Create SDES RPC to Read a Recall request. Problem: Create SDES RPC to read/get a Recall request. 1) by Internal Entry Number (IEN) 2) by Patient (list) Resolution: The new SDES GET RECALL BY IEN and SDES GET RECALLS BY DFN RPCs were created to read/get a Recall request in the VS GUI. 9) VSE-1939: Create SDES RPC to Update a RECALL request. Problem: Create SDES RPC to Update/edit (not disposition) a RECALL request. Resolution: The new SDES EDIT RECALL REQ RPC created to update/edit RECALL requests. 10) VSE-1940: Create SDES RPC to delete (disposition) a Recall request. Problem: Create SDES RPC to set delete reason (disposition) for a Recall request and move the entry from the RECALL REMINDERS (#403.5) file to the RECALL REMINDERS REMOVED (#403.56) file. Set APP PROXY ALLOWED field to Yes. Add EAS Tracking number as an optional input parameter. Resolution: The new SDES DISPOSITION RECALL REQ RPC was created to set delete reason (disposition) for a Recall request and move the entry from the RECALL REMINDERS (#403.5) file to the RECALL REMINDERS REMOVED (#403.56) file. 11) VSE-1948: VistA: User is able to cancel an appointment (from VistA) that is in "checked in" status Problem: Users are able to cancel appointments from VistA that are in a "checked-in" status. Resolution: Updated routine SDCPN0 to check for the checkin date and return an error message as needed. 12) VSE-1974: VistA: Change MBAAMDA3. Problem: When making a new appointment, the software checks to see if the Patient already has an appointment that has been cancelled for that time. Logic is missing fields that need to be updated. These fields are: 14 - NO-SHOW/CANCELLED BY 15 - NO-SHOW/CANCEL DATE/TIME 16 - CANCELLATION REASON 19 - DATA ENTRY CLERK Resolution: Routine MBAAMDA3 was updated to update these additional fields. 13) VSE-2011: VistA: Pending RTC Order Cleanup Tool incorrectly dispositions pending orders. Problem: The pending RTC cleanup tool closes open RTCs in CPRS. If disposition code REMOVED/SCHEDULED-ASSIGNED (3) or MRTC PARENT CLOSED (9) is used for the request in the SDEC APPT REQUEST (#409.85) file, the order in CPRS is erroneously showing as discontinued. Resolution: Modified logic to update the order in CPRS with a "COMPLETE" when disposition is REMOVED/SCHEDULED-ASSIGNED (3) or MRTC PARENT CLOSED (9). This is the same as it did prior to the disposition codes being converted to a file versus a set of codes. 14) VSE-2046: VistA: Create SDEC RPC to return a user's Station ID. Problem: Create an SDEC RPC to return a user's Station ID. Resolution: The SDEC GET STATION ID JSON RPC was created to return the Station ID based on the DUZ(2) variable. 15) VSE-2049: VistA: Update system to count established patients at 3 years. Problem: Update VistA to change "established patient" calculation to look back 3 years instead of 2 years. Resolution: The SDEC50 routine was updated to have use a 3 year window instead of a 2 year window in its "established patient" calculation. 16) VSE-2185: VistA: Block and Move on Clinics Starting at Midnight freezes GUI. Problem: When you do a Block & Move on an appointment that starts at midnight, the GUI freezes and you have to stop and re-start it. Resolution: Routines SDESBLKANDMOVE and SDESBLKANDMOVE1 were updated to handle appointments starting at midnight. 17) VSE-2280: Block and Move letters Problem: After performing a Block and Move, if you print the letters, they are showing the cancelled date and time not the new date and time. Resolution: The VS GUI was updated to print letters for the new appointment that was created after performing a Block and Move. Test Sites: ----------- Martinsburg, WV (MWV) North Texas (NTX) 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_17_2_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_17_2_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.17.2 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_17_2_P.MSI Binary VS GUI R1.7.17.2 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_17_2_T.MSI Binary VS GUI R1.7.17.2 VDD VS_GUI_1_7_17_2 VDD Binary VS GUI R1.7.17.2 DIBR VS_GUI_1_7_17_2 DIBR Binary VS GUI R1.7.17.2 Release Notes VS_GUI_1_7_17_2 RN Binary VS GUI R1.7.17.2 Technical Manual VS_GUI_1_7_17_2 TM 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 SDEC803P 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*803. 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*803. 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 SDEC803P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC803P 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*803. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.16.2. If 1.7.17.2 VS GUI was installed, it will need to be reverted to VS GUI 1.7.16.2. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_17_2_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 10 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDCNP0 Before: B42684732 After: B45470695 **132,167,478,517,572,592,627, 658,801,803** Routine Name: SDEC1 Before: B12798421 After: B13220103 **774,781,784,785,797,800,803** Routine Name: SDEC50 Before:B190829933 After:B190845810 **627,658,665,672,722,723,737, 694,745,790,792,803** Routine Name: SDEC803P Before: n/a After: B2328917 **803** Routine Name: SDECDUZ Before: n/a After: B456494 **803** Routine Name: SDECRTCF Before: B74862583 After: B76451670 **745,785,803** Routine Name: SDES Before: B32834915 After: B42373817 **788,790,792,794,797,799,800, 801,803** Routine Name: SDESBLKANDMOVE Before:B205490208 After:B212180904 **797,799,800,801,803** Routine Name: SDESBLKANDMOVE1 Before: B35273397 After: B37231888 **800,801,803** Routine Name: SDESCLNSETAVAIL Before: B88111309 After: B97503931 **800,803** Routine Name: SDESDISPRECALL Before: n/a After: B10506339 **803** Routine Name: SDESGETRECALL Before: n/a After: B45237321 **803** Routine Name: SDESJSON Before: B57827676 After: B68122053 **788,794,797,799,800,801,803** Routine Name: SDESUPDRECREQ Before: n/a After: B27566645 **803** Routine list of preceding patches: 801 ============================================================================= User Information: Entered By : Date Entered : NOV 18, 2021 Completed By: Date Completed: JAN 24, 2022 Released By : Date Released : JAN 24, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT