$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 11/10/22 at 16:47 ============================================================================= Run Date: DEC 06, 2022 Designation: SD*5.3*827 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #680 Status: Released Compliance Date: DEC 19, 2022 ============================================================================= Associated patches: (v)SD*5.3*797 <<= must be installed BEFORE `SD*5.3*827' (v)SD*5.3*785 <<= must be installed BEFORE `SD*5.3*827' (v)SD*5.3*813 <<= must be installed BEFORE `SD*5.3*827' (v)SD*5.3*824 <<= must be installed BEFORE `SD*5.3*827' (v)SD*5.3*825 <<= must be installed BEFORE `SD*5.3*827' (v)SD*5.3*826 <<= must be installed BEFORE `SD*5.3*827' Subject: VS GUI VERSION 1.7.33.1 Category: - Routine - Enhancement (Mandatory) Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.33.1 and SD*5.3*827 includes several defect corrections and enhancements including updates to the Tasks tab and to the DateTimePickers to be 508 compliant. The SDES GET APPTS BY IEN2 and SDES GET APPT BY REQ/APPT TYP2 RPCs were updated to store pointer linking the appointment to the video visit appointment. The SDES GET APPT BY PATIENT, SDES GET APPT BY IEN and SDES GET APPT BY RESOURCE RPCs were updated to return the Appt Request PATIENT-ENTERED COMMENTS field for the associated request. The VS GUI was updated so that on the onselect event when the user single clicks a record it will clear out the patient in context. The SDES CHECKIN RPC was created and is used to check in a single appointment. The SDES CANCEL CHECKIN RPC was created and is used to cancel a check-in for a single appointment. A new splash screen with the supplied message was added to the VS GUI 1.7.33.1. to Enable Notifications of Changes in Application Behavior. The SDES CREATE APPOINTMENTS RPC was updated to allow the user to schedule in the past. The SDES CREATE CLINIC RPC was updated to calculate and store a hash value upon new clinic creation. The VS GUI was updated to only display non-expired authentication certificates. The new SDES GET TIU DOC BY CONTEXT RPC was created and returns the same data as with TIU DOCUMENTS BY CONTEXT but with the additional elements. The SDES GET CLIN AVAILABILITY RPC was updated to accept either an ISO 8601 timestamp for the from date and to date or just a date (YYYY-MM-DD). If just a date is passed in, the software will default to the 1st minute of the from date and the last minute of the to date. The VS GUI was updated to require a double-click to put request in context and the splash page notification of changes in application behavior. The VS GUI was updated to clear the previous request from context when a user tabs or clicks on record in the RM grid. The patient information screen in VS GUI was updated by renaming the existing Gender Identity label to Birth Sex. The SDECCON and SDECAR1A were updated to retrieve the contact attempts for appointment request equals to 'VETERAN'. The SDVATS security key was created and deployed by this patch and will be utilized by future software updates. The VS GUI code has been updated to no longer cut off availability in "Day" view in Clinic Groups and Provider Schedules. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.33.1 of VS GUI is installed. * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI V1.7.33.1 and VistA patch * * SD*5.3*827 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- SDES ERROR CODES New errors being Modified (#409.93) deployed 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 ----------- ---- -------------------- SDESRPC Broker 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 CHECKIN New SDES CHECKIN New SDES GET APPT BY REQ/APPT TYP2 Modified SDES GET APPTS BY IEN 2 Modified SDES GET CLIN AVAILABILITY Modified SDES GET TIU DOC BY CONTEXT New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-177 - VS GUI: Tasks Tab - RM Grid 508 fixes. Problem: Need to address 508 requirements for the RM Grid on the Tasks tab. Resolution: The list of reported 508 issues were addressed and will be deployed in VS GUI 1.7.33.1. 2) VSE-205 - Remediate 508 findings in all DateTimePickers. Problem: As a user, I want Date/Time pickers to be 508-compliant, so that I can easily use assistive technology to manage appointments in VS GUI. Resolution: The following issues have been addressed: 1. Make sure that information, structure, and relationships conveyed through presentation can be understood (programmatically determined). 2. Make sure that color is not used as the only visual means of conveying, indicating an action, prompting a response, or distinguishing a visual element. 3. Make sure that the color contrast ratio for text or images of text is at least 4.5:1. 4. Make sure that functionality of content is operable through a keyboard interface. 5. Make sure that focusable components in the content receive focus in an order that preserves meaning and operability. 6. Make sure that no change of context is initiated solely by a component receiving focus. 7. Make sure one of the following is true: 8. A change of context is not initiated simply by an input receiving focus. 9. If an input receiving focus initiates a change of context, a user must be advised of this behavior. 10. Make sure that error messages are described to the user in text. 11. Make sure that labels and instructions are provided when content requires user input. 12. Make sure that error messages provide appropriate suggestions for the correction of an input error. 13. Make sure that content is properly encoded and can convey correct information to assistive technology. 14. Make sure that the name, role, state or value of user interface elements in the product can be understood (programmatically determined). 15. Make sure at least one mode of operation that enables users to make use of limited vision is provided. 16. Make sure documentation in electronic format, including Web-based self-service support, conform to Level A and Level AA Success Criteria and Conformance Requirements in WCAG 2.0. 3) VSE-2857 - RPC: SDES GET APPT BY * The Appointment object does not contain a field linking to a video visit appointment. Problem: The Appointment object does not contain a field linking to a video visit appointment. Resolution: The SDES GET APPTS BY IEN2 and SDES GET APPT BY REQ/APPT TYP2 RPCs were updated to store pointer linking the appointment to the video visit appointment. 4) VSE-2883 - SDES GET APPT BY *: return the Appt Request PATIENT-ENTERED COMMENTS field for the associated request. Problem: The veteran's reason for the appointment is stored in the "PATIENT-ENTERED COMMENTS " field on the associated appointment request. We want it returned with each appointment. Resolution: The following RPCs were updated: 1. SDES GET APPT BY PATIENT returns the new "PATIENT-ENTERED COMMENTS" field for the associated appointment request. 2. SDES GET APPT BY IEN returns the new "PATIENT-ENTERED COMMENTS" field for the associated appointment request. 3. SDES GET APPT BY RESOURCE returns the new "PATIENT-ENTERED COMMENTS" field for the associated appointment request. 5) VSE-3586 - VS GUI: 508 - RM Grid Navigation - I-001325 Problem: As a user, I want to be able to navigate between appointment requests in the RM grid using the keyboard so that I can move through the RM grid without selecting a record and loading the calendar until I hit enter or click on a request. Resolution: On the onselect event when the user single clicks a record it will clear out the patient in context. 6) VSE-3851 - VistA: Create a SDES RPC to Check-in for an appointment Problem: Need to create a RPC in the SDES menu option to Check-In a veteran for an appointment. Resolution: The SDES CHECKIN RPC was created and is used to check in a single appointment. 7) VSE-3853 - VistA: Create a SDES RPC to undo Check-In for an appointment Problem: Need create a RPC in the SDES menu option to undo Check-In for an appointment. Resolution: The SDES CANCEL CHECKIN RPC was created and is used to cancel a check-in for a single appointment. 8) VSE-3896 - VS GUI: Create Splash Screen to Enable Notifications of Changes in Application Behavior. Problem: Create a splash screen that can be disabled per version. The splash screen should have a checkbox for the user to select they do not want to receive the notification again. For 1.7.33.1, the splash page will need to advise the user of the change in behavior of the RM grid. Message: "Due to an effort to meet 508 requirements, appointment requests in the RM grid will now load the calendar upon a double-click or by hitting enter. Please acknowledge this change to continue." This notification should be specific to 1.7.33.1 so that users don't continue to see it in future versions. Resolution: A new splash screen with the supplied message was added to the VS GUI 1.7.33.1. 9) VSE-3935 - VistA: Update contact attempt RPCs to account for "VETERAN" appointment requests. Problem: Need to update contact attempt RPCs to account for "VETERAN" appointment requests. Resolution: The SDECCON and SDECAR1A were updated to retrieve the contact attempts for appointment request equals to 'VETERAN'. 10) VSE-3937 - VistA: Modify SDES CREATE APPOINTMENTS to schedule in the past. Problem: Need to update SDES CREATE APPOINTMENTS to allow the user to schedule in the past. Resolution: The SDES CREATE APPOINTMENTS RPC was updated to allow the user to schedule in the past. 11) VSE-3964 - VistA: Add hash to SDES CREATE CLINIC. Problem: Need to modify SDES CREATE CLINIC to calculate a hash on the newly created clinic and return it in the result set. Resolution: The SDES CREATE CLINIC RPC was updated to calculate and store a hash value upon new clinic creation. 12) VSE-3993 - VS GUI: Filter out expired, non-authentication PIV certs. Problem: Currently, all available PIV certificates display when a VS GUI user uses PIV authentication for login, demographics, VVC appointment. Update GUI to filter out any certs other than non-expired authentication certificates. Resolution: The VS GUI was updated to only display non-expired authentication certificates. 13) VSE-3998 - VistA: RPC for Mobile to use that returns Clinic Name and Clinic ID. Problem: Mobile needs an RPC that provides the clinic ID associated with a TIU note without the use of SC LISTER. Ideally that would be a mobile-specific copy of the existing TIU DOCUMENTS BY CONTEXT RPC that also provides the associated clinic ID. Alternatively, a new (limited) RPC that allows for a simple TIU Note IEN » Clinic ID lookup would likely also work. Resolution: A copy of the existing TIU DOCUMENTS BY CONTEXT RPC was made and named SDES GET TIU DOC BY CONTEXT RPC. SDES GET TIU DOC BY CONTEXT RPC returns the same data as with TIU DOCUMENTS BY CONTEXT but with the additional elements such as the HospitalLocationIEN, VisitLocationName, VisitLocationIEN. 14) VSE-4004 - VistA: Modify SDES GET CLIN AVAILABILITY. Problem: Some of the services using Acheron (VCAS) need SDES GET CLIN AVAILABILITY to additionally support a from date and to date that is just a date (with no timestamp and offset). This is an exception to the previously established pattern of always using full ISO 8601 timestamps with offsets. Need to update the RPC be updated to take either an ISO 8601 timestamp (current behavior), or a local date ("2022-12-25"). If a local date is given, the RPC should turn it into the start of the day in the clinic offset. Resolution: The SDES GET CLIN AVAILABILITY RPC was updated to accept either an ISO 8601 timestamp for the from date and to date or just a date (YYYY-MM-DD). If just a date is passed in, the software will default to the 1st minute of the from date and the last minute of the to date. 15) VSE-4008 - VS GUI: Reinstate double-click to put request in context and splash page. Problem: Need to reinstate double-click to put request in context and the splash page notification of changes in application behavior. Resolution: The VS GUI was updated to require a double-click to put request in context and the splash page notification of changes in application behavior. 16) VSE-4015 - VS GUI: Clear Context When Navigating RM Grid. Problem: Need to update the VS GUI so that tabbing or clicking on a record in the RM it will clear the previous request from context. Resolution: The VS GUI was updated to clear the previous request from context when a user tabs or clicks on record in the RM grid. 17) VSE-4062 - VS GUI: Change Gender Identity to Birth Sex in Patient Info. Problem: The patient information screen in VS GUI has a field labeled "Gender Identity" that is displaying the information for "Birth Sex." This field needs to be labeled "Birth Sex" to match the information pulled. Resolution: The patient information screen in VS GUI was updated by renaming the existing Gender Identity label to Birth Sex. 18) VSE-4143 - VistA: Add key SDVATS. Problem: Need to create a new security key to be used by Vista Scheduling to identify select Scheduling users. Resolution: The SDVATS security key was created and deployed by this patch. It will be utilized by future software updates. 19) VSE-4286 - VistA: Modify SDEC GET PATIENT APPT REQ JSON to return Contact Attempts. Problem: Need to update the SDEC GET PATIENT APPT REQ JSON to return the Contact Attempts. Resolution: The SDECAR1A routine that supports the DEC GET PATIENT APPT REQ JSON was updated and the contact attempts will not be returned. 20) VSE-4433 - VS GUI: "Day" View in Clinic Groups and Provider Schedules cuts off availability. Problem: In the "Day" view when using Clinic Groups or Provider Schedules calendar views, availability is cut off when the left-most clinic starts later than other clinics in the view. For example, a 9 AM clinic is on the left, in a group with a 6 AM clinic. Calendar display will start at 9 AM, and users cannot see the availability between 6 AM and 9 AM for the 6 AM clinic. Resolution: The GUI code has been updated to no longer cut off availability in "Day" view in Clinic Groups and Provider Schedules. Test Sites: ----------- El Paso, TX (ELP) Tomah, WI (TOM) 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_33_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_33_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.33.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_33_1_P.MSI Binary VS GUI R1.7.33.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_33_1_T.MSI Binary VS GUI R1.7.33.1 VDD VS_GUI_1_7_33_1 VDD Binary VS GUI R1.7.33.1 DIBR VS_GUI_1_7_33_1 DIBR Binary VS GUI R1.7.33.1 Release Notes VS_GUI_1_7_33_1 RN Binary VS GUI R1.7.33.1 Technical Manual VS_GUI_1_7_33_1 TM Binary VS GUI R1.7.33.1 User Guide Addendum VS_GUI_1_7_33_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 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: Stevens Jack Phone: 772-646-2303 Email: jack.stevens1@domain.ext Pre/Post Installation Overview: ------------------------------- Routine SDEC827P 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. 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*827. 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*827. 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 SDEC827P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC827P 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*827. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.32. If 1.7.33.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.32.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_33_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 10 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC52 Before:B188796403 After:B192020229 **627,642,651,658,745,813,827** Routine Name: SDEC52B Before: B22077700 After: B22309978 **627,796,797,827** Routine Name: SDEC827P Before: n/a After: B2328739 **827** Routine Name: SDECAR1A Before: B57788494 After: B57048195 **658,745,756,781,813,827** Routine Name: SDECCON Before: B47792154 After: B48535110 **669,686,781,785,827** Routine Name: SDESAPPTDATA Before: B47791682 After: B52979601 **788,814,815,820,823,827** Routine Name: SDESCANCHECKIN Before: n/a After: B7825078 **827** Routine Name: SDESCHECKIN Before: n/a After: B26348689 **827** Routine Name: SDESCHECKOUT Before:B192834318 After:B190353992 **826,827** Routine Name: SDESCLINICAVAIL Before: B25537644 After: B31611069 **800,805,809,816,820,823,826,827** Routine Name: SDESCLINICSET2 Before: B95716906 After: B96312853 **799,813,827** Routine Name: SDESCREATEAPPT Before: B63270079 After: B65506931 **814,823,826,827** Routine Name: SDESCREATEAPPT2 Before: B28131524 After: B27817199 **814,823,826,827** Routine Name: SDESCREATEAPPT44 Before: B18521682 After: B18019542 **814,823,827** Routine Name: SDESCRTAPPTWRAP Before: B62534284 After: B68442028 **814,816,823,826,827** Routine Name: SDESGETTIUDOC Before: n/a After: B44376932 **827** Routine Name: SDESINPUTVALUTL Before: B5254518 After: B5950847 **819,823,824,827** Routine Name: SDESPATIENTDATA2 Before: B2594258 After: B24561008 **823,824,827** Routine Name: SDESRECPROVSRCH Before: B27083366 After: B32100073 **823,827** Routine Name: SDESRTVCLN2 Before: B97930720 After:B102878838 **823,825,827** Routine list of preceding patches: 785, 797, 813, 824, 825, 826 ============================================================================= User Information: Entered By : Date Entered : SEP 13, 2022 Completed By: Date Completed: DEC 06, 2022 Released By : Date Released : DEC 06, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT