$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Friday, 01/21/22 at 15:30 ============================================================================= Run Date: FEB 08, 2022 Designation: SD*5.3*804 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #658 Status: Released Compliance Date: FEB 22, 2022 ============================================================================= Associated patches: (v)SD*5.3*803 <<= must be installed BEFORE `SD*5.3*804' Subject: VS GUI VERSION 1.7.18.1 Category: - Routine Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.18.1 and SD*5.3*804 includes several defect corrections and enhancements. The release updates the demographics indicator use Check-in Integration Point (CHIP) web services, updates SDES GET PATIENT REGISTRATION Remote Procedure Call (RPC) to reformat JSON returns, assigns SDES RPCs to the correct menu options, adds RPC wrapper to send null SDIEN, updates SDEC GET STATIONID JSON, SDEC GETVVSMAKEINFO to return station number, and updates SDES CANCEL RPC to not remove the Video Visit Service (VVS) link from file 409.84. Additionally, the release adds logging of VVS web service calls when cancelling an appointment, and updates VistA roll and scroll to move injected code for deleting VVSID to after SDCAN. The release addresses several defects; fixes VVS Provider search termination date issue, fixes crashing of VS GUI if web service to cancel VVS appointment fails, a correction to remove VVS ID from appointment after VVS appointment is cancelled and fixes the Personal Identity Verification (PIV) login help link on the login window. The release also addresses VVS appointments converting to incorrect time zones, includes a change so that VVS Appointment cancellation during Block and Move/Drag and Drop and a change so that VVS ID is removed from VistA AFTER the VVS appointment is cancelled. The Insurance Verification Logic was updated to work correctly for insurance policies that didn't have an expiration date. The Block and Move logic was updated to store the cancellation reason Block and Move on the appointment that was cancelled during this process. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.18.1 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.18.1 and VistA patch * * SD*5.3*804 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 --------------------- -------------------- SDES CREATE CLINIC Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) VSE-2038: NET GUI: Wire up demographics endpoint to demographics indicator Problem: Need to wire up demographics endpoint provided by CHIP to demographics indicator in VS GUI. Resolution: VS GUI was updated to utilize demographic data provided by CHIP. 2) VSE-2095: VistA: Update RPC SDES GET PATIENT REGISTRATION Problem: Need to re-organize the output of the SDES GET PATIENT REGISTRATION RPC and add some additional data in the return string. Resolution: Routine SDESGETREGA was updated to provide the return data in the requested order and the additional data items were added. 3) VSE-2096: VistA: Assign SDES RPCs to appropriate menu options Problem: The SDECRPC and SDESRPC options need to be cleaned up so that the appropriate RPCs are listed in each option. Resolution: The RPCs assigned to each of these options was reviewed and updated to match the proper namespaces for each option. 4) VSE-2106: .NET GUI: VVS Appointment cancellation during Block and Move/Drag and Drop Problem: When performing a block and move or a drag and drop operation in VS GUI on a VistA appointment with a corresponding VVS appointment, a cancellation is not occurring on the existing VVS appointment, nor is the removal of the ID from VistA occurring. The expected behavior is that when either of these events occur, the existing VVS appointment should be cancelled, the existing VVS ID should be removed from VistA, a new VVS appointment should be created, and then that new appointment ID should be associated to the VistA Appointment. As a side note, the block and move call from the future appointments area and the scheduler view should both be tested as often these areas follow different code flows. Resolution: The delete Video Visit ID RPC was simply not getting called during a Block and Move event. Logic was added to make a call to the delete Video Visit ID RPC. 5) VSE-2108: VistA: Create SDES RPC wrapper to send null SDIEN Problem: Need to create a wrapper to send in a null SDIEN to the SDES CREATEEDIT RPC. Resolution: Routine SDES was modified to not pass in a value for SDIEN for the SDES CREATEEDIT RPC. 6) VSE-2109: Vista: Update SDES CANCEL RPC to not remove VVS link Problem: Need to update SDES CANCEL RPC to not remove VVS link from the SDEC APPOINTMENT (#409.84) file. Resolution: Routine SDESCANCELAPPT was updated to not remove the VVS link from the SDEC APPOINTMENT (#409.84) file. 7) VSE-2114: .NET GUI; VVS appointments converting to incorrect time zones. Problem: VVS appointments are converting to incorrect time zones. Resolution: Actual offset values were needed for the time zones, which meant they had to be mapped to TimeZoneInfo objects that contained them as ENUMS to VVS. 8) VSE-2121: .NET GUI; VVS crashing if Web Service to cancel VVS fails. Problem: VVS is crashing if Web Service to cancel VVS fails. Resolution: The whole method was wrapped in a try catch block. An error tracking and exception handling was added to display to the user if something went wrong when cancelling a VVS appointment. 9) VSE-2123: Swap methods in CancelApptPresentationModel lines 200/201 so that VVS ID is removed from VistA after the VVS appointment is cancelled. Problem: Swap methods in CancelApptPresentationModel lines 200/201 so that VVS ID is removed from VistA AFTER the VVS appointment is cancelled. Resolution: The flow of logic was changed so that when there is a successful attempt to cancel the VVS appointment, the ID is deleted from VistA. 10) VSE-2124: Log VVS Web Service call when cancelling an appt. Problem: Log VVS Web Service call when cancelling an appointment. Identify all code paths where web service is called and log info for all paths. Resolution: VS GUI was updated to log the needed information in the trace log for VVS Web Service calls that cancel an appointment. 11) VSE-2126: Vista: Update roll and scroll to move injected code for deleting VVS ID to after the SDCAN comes back with success and not error. Problem: Need to move the code to delete the VVS ID to after the appointment has been successfully cancelled. Resolution: Routine SDCNP0 was updated to delete the VVS ID only after the appointment was successfully cancelled. 12) VSE-2143: VistA: Provider does not show up in lookup Problem: Provider is not returned in search when the provider has a future termination date. Todd found that the external date is in the format of 12/17/21 so when it is compared to the internal date format (3211217), it thinks the termination date is prior to today. Resolution: Routine SDECPRVSRCHJSON was updated to convert the termination date to an internal format prior to comparisons. 13) VSE-2200: .NET GUI: Update PIV login help link Problem: The current For Help with PIV login, click here link on the VSE GUI login screen is outdated and per, IAM team should be updated with https://yourit.domain.ext/kb_view.do?sysparm_article=KB0013359. Resolution: Per IAM team's guidance, modified the For Help with PIV login, click here link to point to: https://yourit.domain.ext/kb_view.do?sysparm_article=KB0013359 Also added a "For additional help, open a YourIT ticket" link to point to https://yourit.domain.ext. 14) VSE-2208: VistA: RPCs need to return station number Problem: The following RPCs need to return station number instead of institution number: SDEC GET STATIONID JSON SDEC GETVVSMAKEINFO Resolution: Routines SDECVVS and SDECDUZ were updated to return the station number instead of the institution number. 15) VSE-2231: VistA: Update the Insurance Verification Logic in the SDES GET INSURANCE VERIFY REQ RPC Problem: There was an existing but in the insurance verification logic when the expiration date field was blank. Resolution: The insurance verification logic was updated to work correctly when the expiration date field is blank. 16) VSE-2264: VistA: Block and Move requires cancel reason Problem: When performing a Block and Move, the cancelled Appointment requires a cancellation reason of Block and Move. The cancellation reason is not being stored. Resolution: Routine SDESBLKANDMOVE was updated to store the cancellation reason on the cancelled Appointment. Test Sites: ----------- Orlando, FL St. Louis, MO 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_18_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_18_1_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.18.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_18_1_P.MSI Binary VS GUI R1.7.18.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_18_1_T.MSI Binary VS GUI R1.7.18.1 VDD VS_GUI_1_7_18_1 VDD Binary VS GUI R1.7.18.1 DIBR VS_GUI_1_7_18_1 DIBR Binary VS GUI R1.7.18.1 Release Notes VS_GUI_1_7_18_1 RN Binary VS GUI R1.7.18.1 Technical Manual VS_GUI_1_7_18_1 TM Binary VS GUI R1.7.18.1 User Guide Addendum VS_GUI_1_7_18_1_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 SDEC804P 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*804. 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*804. 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 SDEC804P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC804P 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*804. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.17. If 1.7.18.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.17.2. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_18_1_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 9 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDCNP0 Before: B45470695 After: B46431610 **132,167,478,517,572,592,627, 658,801,803,804** Routine Name: SDEC804P Before: n/a After: B2329035 **804** Routine Name: SDECDUZ Before: B456494 After: B1197507 **803,804** Routine Name: SDECPRVSRCHJSON Before: B9955693 After: B9956117 **797,800,804** Routine Name: SDECVVS Before: B40914392 After: B44383755 **781,784,785,788,790,792,800, 801,804** Routine Name: SDECVVSJSON Before: B14869168 After: B14953828 **797,801,804** Routine Name: SDES Before: B42373817 After: B42267482 **788,790,792,794,797,799,800, 801,803,804** Routine Name: SDESBLKANDMOVE Before:B212180904 After:B158970139 **797,799,800,801,803,804** Routine Name: SDESBLKANDMOVE1 Before: B37231888 After: B68596684 **800,801,803,804** Routine Name: SDESCANCELAPPT Before: B5353569 After: B5796653 **801,804** Routine Name: SDESGETREGA Before: B50470187 After: B76533980 **799,804** Routine Name: SDESPATRPC Before: B6226119 After: B6129180 **792,804** Routine list of preceding patches: 803 ============================================================================= User Information: Entered By : Date Entered : DEC 01, 2021 Completed By: Date Completed: FEB 08, 2022 Released By : Date Released : FEB 08, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT