$TXT Created by CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Wednesday, 08/25/21 at 12:07 ============================================================================= Run Date: SEP 22, 2021 Designation: SD*5.3*794 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #646 Status: Released Compliance Date: OCT 05, 2021 ============================================================================= Associated patches: (v)SD*5.3*792 <<= must be installed BEFORE `SD*5.3*794' Subject: VS GUI VERSION 1.7.11 Category: - Routine - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.11 includes several defect corrections and enhancements. This version fixes an issue where undoing a 'no-show' on a Consult was leaving the request in the Request Management (RM) grid, improves the RM grid so that requests with bad or missing data are excluded when loading requests to the RM grid, rather than ALL appointment requests in the case that one of the requests has missing or bad data, resolves a benign error that occurs when canceling a consult, and addresses an issue with redundant data on no-show for consults/procedures. This release also adds check-in steps completed to the Expand Entry view of an appointment, and adds logic so that if there are two cancelled appointments at the same date/time for the same patient, only the newest cancelled appointment will have Expand Entry available, and if there is a cancelled and scheduled appointment at the same date and time, then only the scheduled appointment will have Expand Entry available. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.11 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.11 and VistA patch * * SD*5.3*794 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 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 EP DEMOGRAPHICS Modified SDES DISPOSITION APPT REQ New SDES GET APPT REQ BY IEN New SDES GET APPT REQ BY PATIENT New SDES SET APPT REQ CREATE New SDES SET APPT REQ UPDATE New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) VSE-1240: .NET GUI: Display all checkin steps for an appointment. Problem: All checkin steps that have been logged for an appointment in the VS GUI need to be displayed so that schedulers can ensure care is provided efficiently. Resolution: The VS GUI was updated so that all checkin steps and now visible to assist the scheduler in determining what action needs to be taken next. 2) VSE-1278: VistA: CONSULT - NO SHOW- Undoing No Show request still on Request Management (RM) Grid. Problem: After undoing a No Show for a Consult, the Request stays on the RM Grid. Resolution: The activity logic of a consult upon undoing a no-show has been modified to update the consult file and set the field CURRENT STATUS (Field #23) back to "SCHEDULED", removing the consult from the RM Grid. 3) VSE-1307: .NET: CONSULT - NO SHOW- Undoing No Show request still on RM Grid. Problem: After undoing a No Show for a Consult, the Request stays on the RM Grid. Resolution: Updated the NEXT AVA. APPT. INDICATOR: 'NEXT AVA.' APPT. INDICATED BY USER in the VS GUI. This change added to the patient appointment multiple, and the original request remains in the grid and must later be cancelled by the user. 4) VSE-1327: .NET: Redundant data on no show for Consults/Procedures. Problem: When performing a no show for a consult/procedure, an RM grid refresh occurs that brings in a new request from the no-show Remote Procedure Call (RPC), then the GUI creates an in-memory record with a modified requested by field and requestor field that is placed in the RM grid. If this in-memory request is used, the requested by becomes provider, and the requestor becomes the clinic name. Appointments made off this get NEXT AVA. APPT. INDICATOR: 'NEXT AVA.' APPT. INDICATED BY USER which is added to the patient appointment multiple. The original request remains in the grid and must later be cancelled by the user. Resolution: In the logic flow, moved where the grid refresh occurs, and avoided a code branch when dealing with Consults and Procedures. 5) VSE-1328: INC18922837 - Consult Internal Entry Number (IEN) does not belong to Table Error. Problem: An error is occurring when a CONSULT appointment is cancelled. The return value of the RPC SDEC GET PATIENT CONSULTS JSON is returning a name value of back named "ConsultIEN" which seems to not be defined within the schema on the .NET side. Resolution: The GUI logic was modified to have a slightly different flow for consults and procedures. A RM grid refresh event was also added in a code path. Additionally, unnecessary code was removed that could cause benign errors. 6) VSE-1354: .NET: Appointment (APPT) request DateTime error prevents requests displaying in RM grid. Problem: When a patient has an appointment request with an invalid datetime format (in all cases so far observed, issue has been a '00' day value e.g. 3170300), then the user gets an error saying request has an invalid datetime, and with the new JavaScript Object Notation (JSON) RPC the affected record and any records coming after it in the json return do not display in GUI. Resolution: The expected result is the patient requests display. 7) VSE-1367: VistA: Update data returned/displayed in expand entry for Appts at same date/time. Problem: If there have been two appointments scheduled for a patient for the same date and time, the VS GUI needs to only allow the Expand Entry to be run as noted below. If there are two cancelled appointments at the same date/time for the same patient, only the newest cancelled appointment will be able to have Expanded Entry. If there is a cancelled and a scheduled appointment at the same date/time for the same patient only the scheduled appointment will be able to show Expanded Entry. Resolution: The SDEC EP DEMOGRAPHICS Remote Procedure Call (RPC) was updated to pass back a -1 value and the text to display in the GUI when the Expand Entry cannot be shown for the selected appointment. 8) VSE-1368: .NET: Expand entry - display error message when appt data is no longer Available. Problem: If there have been two appointments scheduled for a patient for the same date and time, the VS GUI needs to only allow the Expand Entry to be run as noted below. If there are 2 cancelled appointments at the same date/time for the same patient only the newest cancelled appointment will be able to have Expand Entry. If there is a cancelled and a scheduled appointment at the same date/time for the same patient, only the scheduled appointment will be able to show Expand Entry. Resolution: The VS GUI was updated to receive an error message from the updated SDEC EP DEMOGRAPHICS Remote Procedure Call (RPC) noting that the currently selected appointment cannot have the Expanded Entry shown. The GUI takes the text from the returned VistA data and displays this text to the user. 9) VSE-1370: VistA: SDES RPC to create appointment request entry. Problem: A new RPC is needed that will be used by all consumers to create a new Appointment Request. Resolution: New SDES SET APT REQ CREATE RPC was created. It accepts 27 different data elements to create a new Appointment Request. 10) VSE-1371: VistA: SDES RPC to read an appointment request entry. Problem: There is a need for two new JSON RPCs in the SDES namespace. The first RPC is needed to return a single appointment request based off an appointment request IEN. The second RPC is needed to return a list of appointment requests based off a patient Data File Number (DFN). Resolution: Two new JSON RPCs were created. The first, SDES GET APPT REQ BY IEN, returns a single appointment request based off an appointment request IEN. The second, SDES GET APPT REQ BY PATIENT, returns a list of appointment requests based off a patient DFN. 11) VSE-1372: VistA: SDES RPC to update an appointment request entry. Problem: A new RPC is needed that will be used by all consumers to update and existing Appointment Request. Resolution: New SDES SET APT REQ UPDATE RPC was created. It accepts 26 different data elements to modify an Appointment Request. 12) VSE-1373: VistA: SDES RPC to disposition an appointment request entry. Problem: There is a need for a new JSON RPC in the SDES namespace that will allow the user to disposition an appointment request entry. Resolution: A new JSON RPC in the SDES namespace, SDES DISPOSITION APPT REQ, has been created to allow the user to disposition an appointment request. 13) VSE-1403: .NET: Exclude appointment requests with bad/missing data from RM grid. Problem: After user selects a patient GUI fetches appointment requests from VistA and displays them in the RM grid. Today if one of the appointment requests have missing or bad data in one of the fields that breaks data mapping, the entire set of requests gets discarded and the user gets an error message. Resolution: The VS GUI has been updated to reject just the problematic appointment requests, but display the rest of the appointment requests that are well defined. The user will get an error message that some appointment requests could not load. Test Sites: ----------- Martinsburg, WV (WWV) Orlando, FL (ORL) Providence, RI (PRO) 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_11_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_11_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.11 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_11_P.MSI Binary VS GUI R1.7.11 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_11_T.MSI Binary VS GUI R1.7.11 VDD VS_GUI_1_7_11 VDD Binary VS GUI R1.7.11 DIBR VS_GUI_1_7_11 DIBR Binary VS GUI R1.7.11 Release Notes VS_GUI_1_7_11 RN Binary VS GUI R1.7.11 Technical Manual VS_GUI_1_7_11 TM Binary VS GUI R1.7.11 User Guide Addendum VS_GUI_1_7_11_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 SDEC794P 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*794. 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*794. 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 SDEC794P will automatically run at the end of the installation process. It will update the CURRENT GUI VERSION (#2) field in the SDEC SETTINGS (#409.98) file to version 1.7.11 and the GUI VERSION EFFECTIVE DATE (#3) field will be updated to the date the site installed SD*5.3*794. After the post install has finished running, sites can delete the SDEC794P 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*794. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.10. If 1.7.11 VS GUI was installed, it will need to be reverted to VS GUI 1.7.10 See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_11_ DIBR.pdf. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC31 Before: B36578315 After: B42058535 **627,683,717,740,694,792,794** Routine Name: SDEC794P Before: n/a After: B1897862 **794** Routine Name: SDECEPT Before:B142375915 After:B161174536 **669,671,694,794** Routine Name: SDES Before: B2374991 After: B16481556 **788,790,792,794** Routine Name: SDESAPTREQSET Before: n/a After:B168400571 **794** Routine Name: SDESARCLOSE Before: n/a After: B7247105 **794** Routine Name: SDESARGET Before: n/a After: B90865906 **794** Routine Name: SDESJSON Before: B10818891 After: B17395672 **788,794**Aug 13, 1993 Routine list of preceding patches: 792 ============================================================================= User Information: Entered By : Date Entered : AUG 13, 2021 Completed By: Date Completed: SEP 22, 2021 Released By : Date Released : SEP 22, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT