$TXT Created by G at CHY0034.FO-BAYPINES.DOMAIN.EXT (KIDS) on Tuesday, 02/22/22 at 18:26 ============================================================================= Run Date: MAR 04, 2022 Designation: SD*5.3*805 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #660 Status: Released Compliance Date: MAR 17, 2022 ============================================================================= Associated patches: (v)SD*5.3*266 <<= must be installed BEFORE `SD*5.3*805' (v)SD*5.3*804 <<= must be installed BEFORE `SD*5.3*805' Subject: VS GUI VERSION 1.7.19.1 Category: - Routine - Data Dictionary - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.19.1 and SD*5.3*805 includes several defect corrections and enhancements including an update to the VS GUI Help section on the Tasks tab, an update to the Pending Appointment Letter and the Reports Tab in order to be 508 compliant, a series of new Create, Read, Update or Delete (CRUD) Remote Procedure Calls (RPC) to maintain appointments in the HOSPITAL LOCATION (#44) file, an update to the VS GUI to allow users to modify the Patient Indicated Date (PID) when rescheduling an appointment that was cancelled by patient or no-showed, and an update to all the SDES name spaced RPCs to accept the optional Enterprise Appointment Services (EAS) number. Additionally, the release includes an update to the SDES Get User Profile RPC to receive Security ID (SECID) instead of VA Person ID (VPID), and an update to the code to include a time zone utility and adjust a field name from FacilityCode to StationID to support future work on Video Visit Service (VVS) time zone conversion. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.19.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.19.1 and VistA patch * * SD*5.3*805 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- RECALL REMINDERS (#403.5) EAS TRACKING NUMBER (#100) Modified RECALL REMINDERS REMOVED EAS TRACKING NUMBER (#100) Modified (#403.56) SDEC APPOINTMENT (#409.84) EAS TRACKING NUMBER (#100) Modified SDEC APPT REQUEST EAS TRACKING NUMBER (#100) Modified (#409.85) PID CHANGE ALLOWED (#49) New PID HISTORY (#409.854) New SDEC CONSULT PID HISTORY (#409.87) FULL FILE New 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 CANCEL APPT Modified SDES CANCEL APPT #44 New SDES CANCEL CLIN AVAILABILITY Modified SDES CREATE APPT #44 New SDES CREATE APPT BLK AND MOVE Modified SDES CREATE APPT REQ Modified SDES CREATE CLIN AVAILABILITY Modified SDES CREATE CLINIC Modified SDES CREATE RECALL REQ Modified SDES DISPOSITION APPT REQ Modified SDES DISPOSITION RECALL REQ Modified SDES EDIT APPT #44 New SDES EDIT APPT REQ Modified SDES EDIT CHECK-IN STEP Modified SDES EDIT CLINIC Modified SDES EDIT CLINIC AVAILABILITY Modified SDES EDIT RECALL REQ Modified SDES GET APPT #44 New SDES GET APPT BY IEN Modified SDES GET APPT CHECK-IN STEP Modified SDES GET APPT CHECK-IN STEPS Modified SDES GET APPT REQ BY IEN Modified SDES GET APPT REQ BY PATIENT Modified SDES GET APPTS BY CLINIC Modified SDES GET APPTS BY PATIENT Modified SDES GET APPTS BY RESOURCE Modified SDES GET CHECK-IN STEP Modified SDES GET CHECK-IN STEPS Modified SDES GET CLIN AVAILABILITY Modified SDES GET CLINIC INFO Modified SDES GET INSURANCE VERIFY REQ Modified SDES GET PATIENT REGISTRATION Modified SDES GET RECALL BY IEN Modified SDES GET RECALLS BY DFN Modified SDES GET USRPROFILE Modified SDES INACTIVATE/ZZ CLINIC Modified SDES SET APPT CHECK-IN STEP Modified SDES SET CHECK-IN STEP Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-175: Tasks Tab - Help section. Problem: Address 508 requirements in the Help section on the Tasks tab. Resolution: Addressed 508 audit findings in the Help section of the Tasks ribbon. 2) VSE-191: Pending Appointment Letter - Remediate 508 findings in Pending Appointment Letter form. Problem: For the user to easily use assistive technology to manage appointments in VS GUI, the Pending Appointment Letter window needs to be 508-compliant. Resolution: All 508 findings are addressed in the Pending Appointment Letter form in VS GUI. 3) VSE-201: Reports Tab - Remediate 508 findings in Reports Tab form. Problem: Remediate 508 findings in Reports Tab form. Resolution: For the user to easily use assistive technology to manage appointments in VS GUI, the Reports Tab needs to be 508-compliant. 4) VSE-1941: VistA: SDES RPC to create appointment in HOSPITAL LOCATION file (#44). Problem: Develop routine to create appointment in HOSPITAL LOCATION file (#44). Resolution: The new SDES CREATE APPT #44 RPC was created to address this request. 5) VSE-1942: VistA: SDES RPC to update/edit appointment in HOSPITAL LOCATION file (#44). Problem: Develop routine to update/edit appointment in HOSPITAL LOCATION file (#44). Resolution: The new SDES EDIT APPT #44 RPC was created to address this request. 6) VSE-1943: VistA: SDES RPC to read appointment in HOSPITAL LOCATION file (#44). Problem: Develop routine to read appointment in HOSPITAL LOCATION file (#44) (return a list of appointments in multiple). Resolution: The new SDES GET APPT #44 RPC was created to address this request. 7) VSE-1944: VistA: SDES RPC to delete appointment in HOSPITAL LOCATION file (#44). Problem: Develop routine to cancel appointment in HOSPITAL LOCATION file (#44)-determine what "delete" means for cancel node, if given appt date/time and DFN. Resolution: The new SDES CANCEL APPT #44 RPC was created to address this request. 8) VSE-1945: Allow users to update PID when no-showing an appointment. Problem: Update VSE to allow users to update the PID when no-showing an appointment (similar, to Cancelled by Patient). Resolution: The flag is flipped when the appointment is no showed, then when the data is pulled back as an appointment request, the flag indicates to allow updating on the Make New Appointment screen. 9) VSE-2074: .NET: Allow user to update PID when rescheduling an appointment that was cancelled by patient. Problem: The scheduler wants to update the PID when rescheduling an appointment that was canceled by the patient, so that wait times are calculated correctly. Resolution: Updating the PID is now allowed during the creation of a new appointment by using a new field returned by the respective appointment request get RPC call that indicates whether PID updating is allowed. 10) VSE-2107: VistA: Add EAS Tracking Number to all SDES RPCs. Problem: Add EAS Tracking Number parameter to all SDES RPCs (including Read). Update EAS file definition to all EAS number up to 40 characters. Resolution: All existing SDES name spaced RPCs were updated to accept an optional EAS parameter. The four files that can store EAS tracking numbers were updated to allow for the storage of EAS tracking numbers up to 40 characters in length. 11) VSE-2223: VistA: Update SDES GET USER PROFILE RPC to receive SECID rather than VPID. Problem: The SDES GET USER PROFILE RPC needs to be updated to receive Security ID (SECID) instead of VA Person ID (VPID). Resolution: The SDES GET USER PROFILE RPC was updated to utilize the SECID instead of the VPID. 12) VSE-2226: VistA: Updates to support VVS time zone correction. Problem: The SDEC GETVVSMAKEINFO and SDEC GETVVSMAKEINFO JSON RPCs will be updated as follows: Return Station ID No longer return Facility Code Include: Time Zone Exception from Institution File Time Zone offset for standard time from World Time Zone File Daylight savings Time Zone offset for standard time from World Time Zone File Resolution: The SDEC GETVVSMAKEINFO and SDEC GETVVSMAKEINFO JSON RPCs were updated to correctly identify the time zone for the station and adjust the time as needed. Note: If a user attempts to schedule a VVS appointment through VS GUI and gets the below error, they should have their local VistA administrator confirm that the INSTITUTION file (#4) has a Location Time Zone assigned. 13) VSE-2371: .NET: Rename facilityId to StationId and add the timezone info (offset/offsetdst/exemption) to the return of Getvvsmakeinfo to make time zone determination more accurate. Problem: The SDEC GETVVSMAKEINFO RPC needs to be updated to rename facilityId to StationId and to add the timezone info (offset/offsetdst/exemption) in order to made the time zone determination more accurate. Resolution: The SDEC GETVVSMAKEINFO RPC was updated to include the timezone info (offset/offsetdst/exemption) to the the time zone determination and to rename facilityId to StationId. 14) VSE-2382: VistA: SDES SET APPT CHECKIN STEP is missing from SDECRPC option. Problem: Need to add the SDES SET APPT CHECKIN STEP RPC to the SDECRPC option. Resolution: The following RPCs were added to the SDECRPC option and deployed in SD*5.3*805 v5: SDES SET APPT CHECKIN STEP SDES GET USRPROFILE SDES SET CHECK-IN STEP Test Sites: ----------- El Paso, TX 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_19_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_19_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.19.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_19_1_P.MSI Binary VS GUI R1.7.19.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_19_1_T.MSI Binary VS GUI R1.7.19.1 VDD VS_GUI_1_7_19_1 VDD Binary VS GUI R1.7.19.1 DIBR VS_GUI_1_7_19_1 DIBR Binary VS GUI R1.7.19.1 Release Notes VS_GUI_1_7_19_1 RN Binary VS GUI R1.7.19.1 Technical Manual VS_GUI_1_7_19_1 TM Binary VS GUI R1.7.19.1 User Guide Addendum VS_GUI_1_7_19_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 Release Manager Point of Contact: Name: Jack Stevens Phone: 772-646-2303 Email: jack.stevens1@domain.ext Pre/Post Installation Overview: ------------------------------- Routine SDEC805P 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*805. 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*805. 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 SDEC805P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC805P 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*805. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.18. If 1.7.19.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.18.1. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_19_1_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;13 Aug 1993;Build 9 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDAMUTDT Before: B9921068 After: B46311532 **266,805** Routine Name: SDEC Before:B136558013 After:B136542757 **627,643,642,651,658,665,672, 679,686,694,745,756,790,799, 805** Routine Name: SDEC07 Before:B179347370 After:B180328576 **627,642,651,658,665,669,671, 672,701,686,740,694,785,788, 790,799,801,805** Routine Name: SDEC07PID Before: n/a After: B3154294 **805** Routine Name: SDEC08 Before:B186981445 After:B200745537 **627,651,658,665,722,740,744, 694,745,756,774,781,785,790, 792,796,797,799,801,805** Routine Name: SDEC31 Before: B42058535 After: B44957325 **627,683,717,740,694,792,794,805** Routine Name: SDEC805P Before: n/a After: B2329153 **805** Routine Name: SDECAR Before: B93128026 After: B93182894 **627,642,671,745,792,797,805** Routine Name: SDECAR2 Before:B204137546 After:B213318205 **627,642,658,671,686,694,745, 799,805** Routine Name: SDECAR4 Before:B127585078 After:B129709695 **784,785,788,805** Routine Name: SDECCONSJSON Before: B29675665 After: B37663476 **784,785,788,805** Routine Name: SDECDATE Before: B3036435 After: B9653243 **694,805** Routine Name: SDECDUZ Before: B1197507 After: B1197507 **803,804,805** Routine Name: SDECRECREQ Before: B8670325 After: B10883727 **790,792,805** Routine Name: SDECVVS Before: B44383755 After: B53522578 **781,784,785,788,790,792,800, 801,804,805** Routine Name: SDECVVSJSON Before: B14953828 After: B17111301 **797,801,804,805** Routine Name: SDES Before: B42267482 After: B51321606 **788,790,792,794,797,799,800, 801,803,804,805** Routine Name: SDESAPPT Before: B24560891 After: B30103059 **788,805** Routine Name: SDESAPTREQ44 Before: n/a After: B22239909 **805** Routine Name: SDESAPTREQSET Before:B172941127 After:B175699985 **794,799,805** Routine Name: SDESARCLOSE Before: B7891139 After: B8714831 **794,799,805** Routine Name: SDESARGET Before: B93986949 After: B98126417 **794,799,805** Routine Name: SDESBLKANDMOVE Before:B158970139 After:B161097023 **797,799,800,801,803,804,805** Routine Name: SDESCANCELAPPT Before: B5796653 After: B6224069 **801,804,805** Routine Name: SDESCANCELAPPT44 Before: n/a After: B5182587 **805** Routine Name: SDESCCAVAIL Before: B41159275 After: B43467402 **800,805** Routine Name: SDESCKNSTEP Before: B53138846 After: B63763776 **788,790,792,800,805** Routine Name: SDESCLINICAVAIL Before: B22975441 After: B24322500 **800,805** Routine Name: SDESCLINICSET Before:B162040270 After:B165828222 **799,805** Routine Name: SDESCLNSETAVAIL Before: B97503931 After:B100206409 **800,803,805** Routine Name: SDESDISPRECALL Before: B10506339 After: B11149763 **803,805** Routine Name: SDESGETCLINAPPT Before: n/a After: B45823175 **805** Routine Name: SDESGETRECALL Before: B45237321 After: B49095781 **803,805** Routine Name: SDESGETREGA Before: B76533980 After: B79018362 **799,804,805** Routine Name: SDESGETUD Before: B9543466 After: B10449662 **801,805** Routine Name: SDESINACTCLINIC Before: B3178351 After: B3830394 **799,805** Routine Name: SDESJSON Before: B68122053 After: B69391825 **788,794,797,799,800,801,803,805** Routine Name: SDESPATRPC Before: B6129180 After: B6681657 **792,804,805** Routine Name: SDESRTVCLN Before: B55469323 After: B57719322 **799,805** Routine Name: SDESUPDRECREQ Before: B27566645 After: B28455492 **803,805** Routine Name: SDESUTIL Before: B941046 After: B15644745 **801,804,805** Routine list of preceding patches: 266, 804 ============================================================================= User Information: Entered By : Date Entered : DEC 16, 2021 Completed By: Date Completed: MAR 04, 2022 Released By : Date Released : MAR 04, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT