$TXT Created by G at CHY0034.FO-BAYPINES.DOMAIN.EXT (KIDS) on Monday, 03/07/22 at 18:54 ============================================================================= Run Date: MAR 22, 2022 Designation: SD*5.3*807 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #661 Status: Released Compliance Date: APR 04, 2022 ============================================================================= Associated patches: (v)SD*5.3*658 <<= must be installed BEFORE `SD*5.3*807' (v)SD*5.3*805 <<= must be installed BEFORE `SD*5.3*807' Subject: VS GUI VERSION 1.7.20.1 Category: - Routine - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.20.1 and SD*5.3*807 make several defect corrections and enhancements, including updates to the Tasks Tab in the Appointment Calendar, the Patient Information and Patient Eligibility forms to make them 508 compliant. The calculation of "inactive" in the SDEC RESOURCE file was updated so that a clinic with a future inactivation date and future reactivation date is considered "active." The SDES GET APPTS BY PATIENT RPC was updated to return the Appt Type string in addition to the IEN. The SDEC GETVVSMAKEINFO JSON RPC was updated to return a single offset for a time zone to resolve an issue with VVS appointments converting to incorrect time zones. The logic for the Insurance Verification Process was updated to review the past 6 months for any accepted insurance in the Insurance Verification Processor file (#355.33). The SDES GET USRPROFILE RPC was added to the SDECRPC Menu option. The SDES SET APPT CHECK-IN STEP RPC was updated to comply with the latest business rules. Several of the SDES name spaced RPCs were updated to pass back an empty JSON array, not an empty string when no matching data was found. The new SDES GET PATCH NUMBER RPC was created to pass back the latest installed Scheduling patch number. The SDES GET USER PROFILE RPC BY DUZ was created to return a user's current profile information. Fixes null reference exception when using Trace Log Viewer search. Adds "Philippines" as an option to the VVS time zone dropdown, fixes an issue where a user was unable to update the PID on a consult which was previously no-showed, and Creates a READ RPC for the Credit Stop File. The Block and Move functionality was updated to store the PID date from the original appointment on the newly created appointment. The View Appointment from Calendar Grid was updated to display the PID and the Cancel Appointment from Calendar Grid was updated to display the PID instead of the date of the appointment. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.20.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.20.1 and VistA patch * * SD*5.3*807 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 ------------- ----------------------- -------------------- Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC EDIT PAT PRE-REGISTRATION Modified SDEC GETVVSMAKEINFO JSON Modified SDES GET PATCH NUMBER New SDES GET STOPCD DETAIL New SDES GET USER PROFILE BY DUZ Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-178: - Tasks Tab - Appointment Calendar. Problem: Address 508 requirements for the Appointment Calendar on the Tasks tab. Resolution: Addressed 508 audit findings in the Appointment Calendar on the Tasks tab. 2) VSE-179: - Tasks Tab - Calendar Appointment Selected Item. Problem: Address 508 requirements for Calendar Appointment Selected Item on the Tasks tab. Resolution: Addressed 508 audit findings in the Calendar Appointment Selected Item on the Tasks tab. 3) VSE-182: - .NET: Patient Information - Remediate 508 findings in Patient Information form. Problem: The Patient Information form needs to be 508-compliant, so that users can easily use assistive technology to manage appointments in VS GUI. Resolution: Addressed 508 audit findings in the Patient Information form. 4) VSE-183: - .NET: Patient Eligibility - Remediate 508 findings in Patient Eligibility form. Problem: The Patient Eligibility window to be 508-compliant, so that users can easily use assistive technology to manage appointments in VS GUI. Resolution: Addressed 508 audit findings in the Patient Eligibility window. 5) VSE-264: - .NET: Discovery: Special Needs/Preferences not updating Problem: Patients' special needs/preferences do not update if you do not toggle from "both" to AM or PM and then back again. Resolution: Fixed the crash. Updated the Search offset calculations and removed the formatting when an element is no longer matching the search words. 6) VSE-294: - .NET Discovery: Null Reference Exception when using Trace Log Viewer Search. Problem: When using the search bar in the upper-right of the Trace Log viewer in the GUI, system gets a null reference exception and the application closes. Resolution: Added UpdateSourceTrigger to ensure Remarks are always updated, added OnPropertyChanged to SpecialNeeds attributes, always call the RPC to save Special Prefs in PatientInfo Presentation Model. 7) VSE-1705: - VistA: INC19650386 Issue with Clinic Activation/Reactivation Dates. Problem: Local ADPAC/PAS unable to remove the date from the clinic in VISTA using the INACTIVATE A CLINIC. The inactivation state is still displaying in VISTA in the clinic. This issue is preventing the clinic from being seen in VSE. Resolution: Routine SDEC03, tag XRC1 was modified to correct how the computed field, INACTIVE was being calculated. 8) VSE-2114: - .NET GUI; VVS appointments converting to incorrect time zones. Problem: Needs VistA time zone to be passed in. Then AppointmentDateTime must be converted from VistA time zone to local time and then converted to zulu. Resolution: Renamed facilityId to StationId and added the timezone info (offset/offsetdst/exemption) to the return of Getvvsmakeinfo. The actual adjustments will happen in an RPC in a future release. 9) VSE-2262: - VistA: Create READ RPC for CLINIC STOP (#40.7) File. Problem: Create a new Read RPC for CLINIC STOP (#40.7) File. Resolution: The new SDES GET STOPCD DETAIL RPC was created to return the following fields from the CLINIC STOP (#40.7) File: NAME (#.01), Internal Entry Number (IEN), INACTIVE DATE (#2), COST DISTRIBUTION CENTER (#4), RESTRICTION TYPE (#5) and RESTRICTION DATE (#6) for a given IEN. 10) VSE-2263: - VistA: Update SDES GET APPTS BY PATIENT RPC. Problem: Need to update the SDES GET APPTS BY PATIENT RPC. Currently the SDES GET APPTS BY PATIENT RPC is returning the IEN of the appointment type. The RPC should return the Appt Type string in addition to the IEN. Resolution: The following 4 RPCs return the Appointment Type Name and Appointment IEN. 11) VSE-2312: - VistA: Update SDEC GETVVSMAKEINFO JSON to return single offset for time zone. Problem: Need to update the SDEC GETVVSMAKEINFO JSON RPC to calculate and return a single offset for time zone in ISO 8601 format. Resolution: The SDEC GETVVSMAKEINFO JSON RPC was updated to calculate and return a single offset for time zone in ISO 8601 format. 12) VSE-2315: - .NET: Update front end to use SDEC GETVVSMAKEINFO JSON single offset for time zone. Problem: The VS GUI needs to be updated to accept and process the new single offset for time zone in ISO 8601 format from the SDEC GETVVSMAKEINFO JSON RPC. Resolution: The VS GUI was updated to accept the return value for the single offset time zone in ISO 8601 format. 13) VSE-2319: - VistA: Update SDES GET INSURANCE VERIFY REQ RPC. Problem: Need to Update SDES GET INSURANCE VERIFY REQ RPT to look back 6 months in the Insurance Verification Process file. If the person is present with a status of accepted then there is no need to verify the insurance. Resolution: Routine SDESPATRPC was updated to include logic to review the past 6 months for any accepted insurance in the Insurance Verification Processor file (#355.33). 14) VSE-2327: - VistA: Add SDES GET USER INFO to SDECRPC menu option. Problem: Need to add the SDES GET USER INFO RPC to SDECRPC menu option. It should be in both SDESRPC and SDECRPC options. CHIP will be using this RPC to validate that a user has the SDSUP key (requirement for creating clinic list). Resolution: The SDES GET USER INFO RPC was added to both the SDESRPC and SDECRPC options. 15) VSE-2341: - VistA: Update SDES SET APPT CHECK-IN STEP RPC. Problem: The SDES SET APPT CHECK-IN STEP RPC needs to be updated as follows: * Don't allow a check in step to be added when the appt is cancelled. * The Input transformation of the CHECK-IN STEP STATUS (#.01) in the SDES CHECK IN STEP STATUS (#409.842) file needs to match the pattern validation of the SDES SET CHECK-IN STEP and SDES EDIT CHECK-IN STEP RPCs. * Status has to have at least 1 letter * Status can not begin with a punctuation Resolution: The SDES SET APPT CHECK-IN STEP RPC was updated to match the criteria noted above. 16) VSE-2350: - VistA: RPCs should return empty array. Problem: JSON RPCs currently return an empty string if there is no data. This needs to be updated to return an empty JSON array not an empty string. Resolution: Output updated to return empty array. 17) VSE-2351: - VistA: Create an SDES RPC to return current patch number. Problem: Create a new SDES RPC to return the current SD patch number. Resolution: Created new RPC to return current SD patch. 18) VSE-2354: - VistA: Create new RPC to get User Profile by DUZ. Problem: Create a new RPC to get User Profile by DUZ. Resolution: Created new RPC to get User Profile by DUZ. 19) VSE-2370: - .NET GUI - Unhandled Exception Crashes GUI on Checkin. Problem: When checking in a patient, when prompted for PIV and canceling out, an unhandled exception crashes the GUI. Resolution: The demographics indicator set to gray with message "UNDETERMINED. PIV/PIN NOT PROVIDED". 20) VSE-2552: Block and Move - Expand Entry of New APPT shows incorrect PID Problem: When block and move is used to move an appointment from one day to another, the EP of the new appointment shows the incorrect PID. Cancellation screen will show the correct PID. Resolution: The SDESBLKANDMOVE routine was updated to load the PID value from the correct file and store it in the newly created appointment. 21) VSE-2560: Block and Move: When using Block and Move on a Recall Request, the PID does not populate in the Make Appointment window for the moved appointment. Problem: When using Block and Move on a Recall Request, the PID does not populate in the Make Appointment window for the moved appointment. Resolution: The VS GUI was updated to check for the PID date in both the RECALL REMINDERS (#403.5) and the RECALL REMINDERS REMOVED (#403.56) files. 22) VSE-2577: View Appointment from Calendar Grid does not display PID. Problem: PID Date field is showing as blank for View Appointment from the Calendar Grid. This is happening for all appt types. Resolution: The View Appointment screen was updated to display the PID Date field when displaying an appointment. 23) VSE-2578: Recall Appointments: Cancel Appointment from Calendar Grid shows date of appointment as PID, rather than PID. Problem: Recall Appointments: Cancel Appointment from Calendar Grid shows date of appointment in the PID field in GUI, rather than the PID. Resolution: The Cancel Appointment from the Calendar Grid was updated to display the PID instead of the date of the appointment. Test Sites: ----------- Orlando, FL Martinsburg, WV 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_20_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_20_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.20.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_20_1_P.MSI Binary VS GUI R1.7.20.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_20_1_T.MSI Binary VS GUI R1.7.20.1 VDD VS_GUI_1_7_20_1 VDD Binary VS GUI R1.7.20.1 DIBR VS_GUI_1_7_20_1 DIBR Binary VS GUI R1.7.20.1 Release Notes VS_GUI_1_7_20_1 RN Binary VS GUI R1.7.20.1 Technical Manual VS_GUI_1_7_20_1 TM Binary VS GUI R1.7.20.1 User Guide Addendum VS_GUI_1_7_20_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: ------------------------- This patch serves as notification that the new VS GUI associated with this patch is available for installation. Please refer to the VS GUI DIBR for instructions on 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 Release Manager Point of Contact: Name: Stevens Jack Phone: 772-646-2303 Email: jack.stevens1@domain.ext Pre/Post Installation Overview: ------------------------------- Routine SDEC807P 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*807. 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*807. 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 SDEC807P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC807P 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*807. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.19. If 1.7.20.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.19.1. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_20_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 5 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC03 Before: B12782184 After: B17021762 **627,642,658,807** Routine Name: SDEC1 Before: B13220103 After: B13428022 **774,781,784,785,797,800,803,807** Routine Name: SDEC807P Before: n/a After: B2328287 **807** Routine Name: SDECCONSJSON Before: B37663476 After: B38202800 **784,785,788,805,807** Routine Name: SDECVVSJSON Before: B17111301 After: B20003745 **797,801,804,805,807** Routine Name: SDES Before: B51321606 After: B53411184 **788,790,792,794,797,799,800, 801,803,804,805,807** Routine Name: SDES01C Before: B8699364 After: B10168681 **790,807** Routine Name: SDESAPPT Before: B30103059 After: B31919483 **788,805,807** Routine Name: SDESBLKANDMOVE Before:B161097023 After:B161133376 **797,799,800,801,803,804,805,807** Routine Name: SDESCKNSTEP Before: B63763776 After: B64223185 **788,790,792,800,805,807** Routine Name: SDESGETSTOPCODE Before: n/a After: B5904554 **807** Routine Name: SDESGETUDDUZ Before: n/a After: B9688277 **807** Routine Name: SDESJSON Before: B69391825 After: B69804754 **788,794,797,799,800,801,803, 805,807** Routine Name: SDESPATCHINFO Before: n/a After: B1512849 **807** Routine Name: SDESPATRPC Before: B6681657 After: B8227942 **792,804,805,807** Routine Name: SDESRTVCLN Before: B57719322 After: B57735157 **799,805,807** Routine list of preceding patches: 658, 805 ============================================================================= User Information: Entered By : Date Entered : JAN 19, 2022 Completed By: Date Completed: MAR 22, 2022 Released By : Date Released : MAR 22, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT