$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Friday, 10/08/21 at 12:33 ============================================================================= Run Date: OCT 25, 2021 Designation: SD*5.3*797 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #649 Status: Released Compliance Date: NOV 05, 2021 ============================================================================= Associated patches: (v)SD*5.3*794 <<= must be installed BEFORE `SD*5.3*797' (v)SD*5.3*796 <<= must be installed BEFORE `SD*5.3*797' Subject: VS GUI VERSION 1.7.13 Category: - Routine Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.13 and SD*5.3*797 includes several defect corrections and enhancements. The release updates the SDES Remote Procedure Call (RPCs) to follow standard naming convention and creates a new RPC based on SDEC SEARCH Video Visit Service (VVS) PROVIDERS RPC to return JSON. Additionally, the release creates a "Block and Move" RPC and adds a "Block and Move" cancellation reason in preparation for future Block and Move functionality, updates routine SDECAR to allow accepting either the old Disposition code (1 or 2 characters) or the new Disposition pointer value and improves GUI handling of bad JSON returns and logs more data about the error that occurred for better debugging. This release also addresses several defects including an issue with tabbing on the Patient Centered Scheduling (PtCSch) Request window where it skips the Clinic field and the PtCSch Provider field name, and fixes a defect when a provider has a -1 in their phone number (e.g. 304123-1234) resulting in the provider not showing up in the Provider Search when making a VVS appointment. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.13 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.13 and VistA patch * * SD*5.3*797 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 ------------- ----------------------- -------------------- N/A Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC GETVVSMAKEINFO JSON New SDEC SEARCH VVS PROVIDERS JSON New SDES MAKE APPT BLOCK AND MOVE New SDES SEARCH CLINIC Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) VSE-1407: .NET: Validate VistA data using JSON schema before mapping to model. Problem: Bad VistA data is passed to the object mapping code without filtering out problematic records. Resolution: A JSON schema validation was developed to reject and prevent bad data from passing to the object mapping code. Validation problems are logged using TraceLog and the user is informed. 2) VSE-1431: .NET: Cannot Schedule VA Video Connect (VVC) in VS GUI - Must Schedule in Virtual Care Manager (VCM) - use new RPC returning JSON Problem: Update .NET to use new SDEC GETVVSMAKEINFO JSON RPC to address this defect. Several Service Now (SNow) tickets (post-1.7.9) reporting that when Affected End Users (AEU) try to schedule a VA Video Connect (VVC) appointment in VS GUI, they receive a message that says: There was a problem making the Video Appointment. Please go to the VCM website to make this VVC Appointment. Resolution: The handling of data being communicated between VistA and GUI was changed to prevent errors from being mishandled, which was preventing VVS appointments from being made. 3) VSE-1434: VistA: SDEC GETVVSMAKEINFO RPC Contains -1 Problem: There are cases where RPC SDEC GETVVSMAKEINFO can return a -1 when not an error, such as when a phone number is 555-555-1111. Resolution: The new JSON RPC SDEC GETVVSMAKEINFO JSON was created to address this issue. 4) VSE-1444: 508 - .NET: Tabbing Incorrect Function on PtCSch Request Problem: Tabbing on the PtCSch Request window skips the Clinic field and PtCSch Provider directly goes straight to Labs Field. Resolution: Made changes to the IncrementalSearchBox user control to use build in tabbing. 5) VSE-1463: VistA: Create Block and Move RPC Problem: Need to create a new RPC for block and move. 1) Check if attempting to block a single appointment. 2) If not a single appointment, do not allow block and move. 3) New duration cannot be longer than the time slot being blocked (ex. can move a 30 min appt to 15 min, but not the reverse). 4) For now, only allow movement from current Date/Time to another clinic for the same Date/Time. Resolution: The new SDES MAKE APPT BLOCK AND MOVE RPC was created to address this request. For now, the RPC will only allow the user to Block and Move an appointment from one clinic to another, the Date and Start time must be the same. Additional functionality will be coming in future releases. 6) VSE-1464: VistA: Add "BLOCK AND MOVE" Cancellation Reason Problem: Need to add "BLOCK AND MOVE" as a new cancellation reason. Resolution: Logic was added to the post install routine that will add the new "BLOCK AND MOVE" cancellation reason to the CANCELLATION REASONS File #409.2. 7) VSE-1474: .NET: -1 in provider phone number results in provider not displaying in search Problem: If a provider has a -1 in their phone number (e.g. 304123-1234), the provider will not show up in provider search when making a VVS appointment. Resolution: The VS GUI was updated to utilize the new SDEC SEARCH VVS PROVIDERS JSON RPC to correctly display providers with a -1 in their phone number. 8) VSE-1509: VistA: Create new RPC based on SDEC SEARCH VVS PROVIDERS RPC to return JSON Problem: To address the issue where VVS providers are not coming up in search, when they have a 1 in their phone number, create a new RPC based on SDEC SEARCH VVS PROVIDERS to return the data in JSON format. Resolution: The new SDEC SEARCH VVS PROVIDERS JSON RPC was created to return providers, including providers with a 1 in their phone number. 9) VSE-1559: VistA: Update SDES RPCs to follow standard naming convention Problem: The SDES RPCs need to follow standard naming conventions to make them easier to triage. Resolution: The existing RPCs and the new RPCs in this patch were reviewed and updated as needed to match the standard naming conventions. 10) VSE-1600: VistA: Research on Disposition Codes Problem: The VS GUI software needs to be able to utilize the old 1 or 2 character Disposition codes or the new pointer value Disposition codes. Resolution: Routine SDECAR was updated to allow for the processing of either Disposition code set. Test Sites: ----------- Providence, RI (PRO) Pittsburgh, PA (PTH) El Paso, TX (ELP) 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_13_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_13_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.13 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_13_P.MSI Binary VS GUI R1.7.13 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_13_T.MSI Binary VS GUI R1.7.13 VDD VS_GUI_1_7_13 VDD Binary VS GUI R1.7.13 DIBR VS_GUI_1_7_13 DIBR Binary VS GUI R1.7.13 Release Notes VS_GUI_1_7_13 RN Binary VS GUI R1.7.13 Technical Manual VS_GUI_1_7_13 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 SDEC797P 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*797. 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*797. 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 SDEC797P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC797P 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*797. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.12. If 1.7.13 VS GUI was installed, it will need to be reverted to VS GUI 1.7.12. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_13_ DIBR.pdf. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 8 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC08 Before:B182201486 After:B182181620 **627,651,658,665,722,740,744, 694,745,756,774,781,785,790, 792,796,797** Routine Name: SDEC1 Before: B9928206 After: B12073914 **774,781,784,785,797** Routine Name: SDEC32 Before:B127218939 After:B127199073 **627,643,642,658,665,672,679, 781,796,797** Routine Name: SDEC52B Before: B21704341 After: B22077700 **627,796,797** Routine Name: SDEC797P Before: n/a After: B10229208 **797** Routine Name: SDECAR Before: B91790925 After: B93128026 **627,642,671,745,792,797** Routine Name: SDECPRVSRCHJSON Before: n/a After: B7828205 **797** Routine Name: SDECVVSJSON Before: n/a After: B14869168 **797** Routine Name: SDES Before: B16481556 After: B17156529 **788,790,792,794,797** Routine Name: SDESBLKANDMOVE Before: n/a After:B162734102 **797** Routine Name: SDESJSON Before: B17395672 After: B28507962 **788,794,797**Aug 13, 1993 Routine Name: SDM0 Before:B106931874 After:B107738621 **140,167,206,186,223,237,241, 384,334,547,621,622,645,674, 726,796,797** Routine list of preceding patches: 794, 796 ============================================================================= User Information: Entered By : Date Entered : SEP 07, 2021 Completed By: Date Completed: OCT 25, 2021 Released By : Date Released : OCT 25, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT