$TXT Created by A at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Friday, 11/19/21 at 12:06 ============================================================================= Run Date: DEC 03, 2021 Designation: SD*5.3*800 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #652 Status: Released Compliance Date: DEC 17, 2021 ============================================================================= Associated patches: (v)SD*5.3*799 <<= must be installed BEFORE `SD*5.3*800' (v)SD*5.3*694 <<= must be installed BEFORE `SD*5.3*800' Subject: VS GUI VERSION 1.7.15.0 Category: - Routine - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.15.0 and SD*5.3*800 includes several defect corrections and enhancements. This release includes new Remote Procedure Calls (RPCs) to Add, View/Get, and Delete clinic availability in the HOSPITAL LOCATION file (44), a new SDEC RPC for Patient Registration, implements new JSON mapping model on APPT request Low-code Software Development (LSD) services, includes a change to wrap Veteran Point of Service (VPS) Patient Registration PRC in SDEC RPC, and includes a front-end fix for orphaned child Multiple Return to Clinics (MRTC). Additionally, this release adds Title to VVS Provider Search results, addresses Provider Search dialog cosmetic cleanup, updates SDEC Settings VA Video Connect (VVC) stop codes to include 648 and 679, and remove 225, and updates VVS Provider Search to display email addresses. The release also ensures patients are checked in if e-check-in is complete, updates EAS tracking ID to Check-in RPCs to accept and store EAS Transaction ID for each check-in step, and remediates 508 issues. Lastly, the release corrects a defect where providers with matching names returned incorrect data in VVS provider search, and corrects a defect so that eligibility displays for appointments in currently inactive clinics, and fixes an issue where No-Showing an MRTC appointment would not return the Parent appointment request to the RM grid. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.15.0 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.15.0 and VistA patch * * SD*5.3*800 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 UPD PAT PRE-REGISTRATION New SDES CANCEL CLIN AVAILABILITY New SDES CREATE CLIN AVAILABILITY New SDES GET CLINIC AVAILABILITY New SDES MAKE APPT BLOCK AND MOVE Modified SDES SET APPT CHECK-IN STEP Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) VSE-187: Overbook Message window needs to be 508-compliant Problem: As a user, I want the Overbook Message window to be 508-compliant, so that I can easily use assistive technology to manage appointments in VS GUI. Resolution: Overbook Message window was updated to be 508-compliant. 2) VSE-190: Close Request Message - Remediate 508 findings in Close Request form. Problem: Close Request Message needs to be 508-compliant. Resolution: The Close Request form was updated to be 508-compliant. 3) VSE-1457: Parent MRTC is removing from the Request Management (RM) Grid, when child request associated with that parent are still in the RM grid. Problem: The parent MRTC is being removed from the RM grid when a child request associated with that parent is still in the RM grid. Resolution: Only the scheduled Child request will be removed from the RM grid, because there is another child request associated with parent in the RM Grid. 4) VSE-1495: .NET: View/Edit Appointment not Displaying Eligibility for Appointments at Inactive Clinics Problem: When viewing or editing an appointment from the scheduler that is scheduled in an inactive clinic, the eligibility field shows up empty. The correct eligibility seems to be displayed in View/Edit from pending appointments and expand entry in both the Scheduler and Pending Appointments. This field should be consistently set and viewable in all aforementioned areas. Resolution: The scheduler logic for viewing or editing an appointment was updated so, the eligibility field will display the correct eligibility. 5) VSE-1566: VistA: Create RPC to add availability for a clinic in HOSPITAL LOCATION file (44) Problem: A new RPC is needed for the VS GUI to allow the user to define the availability for a selected clinic. Resolution: The new SDES GET CLINIC AVAILABILITY RPC was created based off the existing logic in the Set up a Clinic [SDBUILD] option in VistA. 6) VSE-1568: VistA: Create RPC to view/get availability for a clinic in HOSPITAL LOCATION file (44) Problem: A new RPC is needed to view/get availability for a clinic in HOSPITAL LOCATION (#44) file: * based on start date/end date (nothing less than a day) * follow pattern for current view availability call * return in JSON format Resolution: The new SDES GET CLINIC AVAILABILITY RPC was created to view/get availability for a clinic in HOSPITAL LOCATION (#44) file. 7) VSE-1569: VistA: Create RPC to cancel availability for a clinic in HOSPITAL LOCATION file (44) Problem: A new RPC is needed to cancel the availability for a clinic in HOSPITAL LOCATION (#44) file. Resolution: The new SDES CANCEL CLIN AVAILABILITY RPC was created to cancel the availability for a clinic in HOSPITAL LOCATION (#44) file. 8) VSE-1598: NET GUI: Implement new JSON mapping model on appt request LSD Services Problem: Implement a new JSON mapping model on appt request LSD Services. Resolution: Implemented a new JSON mapping model on appt request LSD Services. 9) VSE-1616: VistA: Wrap VPS Patient Registration RPC in SDEC RPC Problem: Wrap VHA VPS Patient Registration RPC (VPS PATIENT PRE-REGISTRATION) in SDEC RPC. Resolution: The new SDEC UPD PAT PRE-REGISTRATION RPC was created to encapsulate the VPS Patient Registration RPC. 10) VSE-1629: .NET: Check For and Fix Orphaned MRTC Children Problem: When an MRTC child gets orphaned from its parent, it enters a state that it and its appointment cannot be affected (check in, no-show, dispositioned, etc.). Resolution: This issue is resolved by attaching a check and fix to the methods that affect the potentially orphaned MRTC Child prior to it going into the process. Orphaned requests should now behave as expected essentially solving dozens of ServiceNow (SNow) tickets. 11) VSE-1630: VistA: Check in patient when E-checkin is complete Problem: When web service is called to set "e-check-in complete" check-in step status, patient should be checked in for that appointment. Resolution: Two routines were updated to address this issue: SDEC25: Modified to prevent errors upon checkin in patient SDESCKNSTEP: Modified to call SDEC CHECKIN upon an appointment receiving a check-in step status of "E-CHECK-IN COMPLETE". 12) VSE-1652: VistA: INC19671287 Coding Change Incorrect Provider Email in VVC appointment Problem: When creating a VVC appointment, the user noticed that the provider's email was incorrect. After researching, it was found that there are 3 people in the 200 File that have the same exact name. The cross reference accounts for this, but the VistA code is not taking that possibility into account and just takes the top IEN and goes with it. Resolution: The code was updated to implement the same logic as the SDEC SEARCH VVS PROVIDER logic and will now return the correct provider based on the enhanced matching criteria. 13) VSE-1670: .NET: Update VVS Provider Search to display email address Problem: - Implement "striped" table look like patient search. - Reduce left and right margin width. - Change the Cancel button size to be the same as in other dialogs. - Remove the resizable attribute on the dialog. Resolution: The Provider Search dialog cosmetic cleanup addressed the list above. 14) VSE-1729: VistA: Rename SDES GET APPT to SDES GET APPT BY IEN Problem: Need to update the SDES GET APPT to be more descriptive by adding "BY IEN" to its name. Resolution: The SDEC800P post install includes logic to rename this RPC at the sites. 15) VSE-1730: VistA: Rename SDES SET APPT REQ CREATE and SDES SET APPT REQ UPDATE Problem: Need to rename SDES SET APPT REQ CREATE and SDES SET APPT REQ UPDATE RPCs to follow standard SDES naming conventions. Resolution: The SDEC800P post install includes logic to rename these two RPCs to match the naming conventions for the new JSON formatted RPCs. 16) VSE-1732: .NET GUI: MRTC No-Show Doesn't Return Parent to RM Grid Problem: MRTC NoShow does not return Parent to RM Grid. Resolution: NoShowing a Child appointment request will return both Child and Parent to RM Grid. 17) VSE-1742: VistA: Update SDEC SETTINGS VVC stop codes to add 648 and 679, remove 225 Problem: The SDEC SETTINGS National entry needs to be updated to add 648 and 679 as VVC stop codes and to remove 225. Resolution: Logic was added to the SDEC800P post install to add stop codes 648 and 679 and to remove stop code 225 from the VS GUI NATIONAL entry in the SDEC SETTINGS (#409.98) file. 18) VSE-1760: .NET GUI: Provider Search dialog cosmetic cleanup Problem: The Provider Search dialog window needs to be updated to: * Implement "striped" table look like patient search. * Reduce left and right margin width. * Change the Cancel button size to be the same as in other dialogs. * Remove the resizable attribute on the dialog. Resolution: VS GUI Provider Search dialog window was updated to include new formatting for user readability. 19) VSE-1775: .NET GUI: Add Title to VVS Provider Search Results Problem: List of providers in VVS provider search do not all have email addresses, so a field needs to be added that is unique and required, so users are certain they are selecting the right provider (use "title"). Resolution: Title was added to VVS Provider Search Results. 20) VSE-1776: VistA: Return Title in VVS provider search RPC Problem: Need to modify VVS provider search RPCs to include the TITLE (#8) field from the NEW PERSON (#200) file. Resolution: Return value was changed to also include Title and Provider class. 21) VSE-1777: VistA: Add Enterprise Appointment Services (EAS) Transaction ID to Check-In RPCs Problem: Need to update Check-In RPCs to accept and store EAS Transaction ID for each checkin step. Resolution: Modified routine SDESCKNSTEP to add EAS Number to Check-in RPCs. Test Sites: ----------- Detroit, MI (DET) 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_15_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_15_0_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.15.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_15_0_P.MSI Binary VS GUI R1.7.15.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_15_0_T.MSI Binary VS GUI R1.7.15.0 VDD VS_GUI_1_7_15_0 VDD Binary VS GUI R1.7.15.0 DIBR VS_GUI_1_7_15_0 DIBR Binary VS GUI R1.7.15.0 Release Notes VS_GUI_1_7_15_0 RN Binary VS GUI R1.7.15.0 Technical Manual VS_GUI_1_7_15_0 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 SDEC800P will update SDEC SETTINGS (#409.98) FILE. Post install includes logic to rename RPC's SDES GET APPT to SDES GET APPT BY IEN and SDES SET APPT REQ CREATE and SDES SET APPT REQ UPDATE. 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*800. 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*800. 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 SDEC800P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC800P 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*800. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.14.1. If 1.7.15.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.14.1. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_15_0_ DIBR.pdf. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 23 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC1 Before: B12073914 After: B12798421 **774,781,784,785,797,800** Routine Name: SDEC25 Before:B157030281 After:B157100221 **627,665,671,717,694,800** Routine Name: SDEC800P Before: n/a After: B15258014 **800** Routine Name: SDECPRVSRCHJSON Before: B7828205 After: B9955693 **797,800** Routine Name: SDECUPDPATPREREG Before: n/a After: B103865 **800** Routine Name: SDECVVS Before: B37426884 After: B40914392 **781,784,785,788,790,792,800** Routine Name: SDES Before: B28104915 After: B31317363 **788,790,792,794,797,799,800** Routine Name: SDESBLKANDMOVE Before:B187797322 After:B233574443 **797,799,800** Routine Name: SDESBLKANDMOVE1 Before: n/a After: B23739419 **800** Routine Name: SDESCCAVAIL Before: n/a After: B41159275 **800** Routine Name: SDESCKNSTEP Before: B46242804 After: B53138846 **788,790,792,800** Routine Name: SDESCLINICAVAIL Before: n/a After: B22975441 **800** Routine Name: SDESCLNSETAVAIL Before: n/a After: B88111309 **800** Routine Name: SDESJSON Before: B55062550 After: B56037873 **788,794,797,799,800**Aug 13, 1993 Routine list of preceding patches: 694, 799 ============================================================================= User Information: Entered By : Date Entered : OCT 07, 2021 Completed By: Date Completed: DEC 03, 2021 Released By : Date Released : DEC 03, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT