$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Tuesday, 12/06/22 at 14:30 ============================================================================= Run Date: DEC 27, 2022 Designation: SD*5.3*828 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #683 Status: Released Compliance Date: JAN 11, 2023 ============================================================================= Associated patches: (v)SD*5.3*827 <<= must be installed BEFORE `SD*5.3*828' Subject: VS GUI VERSION 1.7.34.0 Category: - Routine - Enhancement (Mandatory) Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.34.0 and SD*5.3*828 includes several defect corrections and enhancements including creating VVS RPCs in the SDES menu option and updates to the VS GUI to address multiple 508 issues. The new SDES GET APPTS BY CLINIEN LIST was created to return the full Appointment Object. The new SDES GET APPT BY APPT IEN RPC was created to have a name that better represents what the RPC does. The SDES GET APPT REQ BY IEN RPC was updated to correctly return the Entered By name and IEN. The SDES CANCEL APPOINTMENT RPC was modified to process and update the corresponding files when an appointment request is cancelled. The SDES GET APPTS BY RPCS were updated to return the clinic institution station number along with the clinic IEN. The SDES EDIT CLINIC RPC was modified to update the diagnosis codes based on the list of diagnosis codes that are passed into the RPC. A check for the status of the diagnosis code was added and the default diagnosis code will be updated as well. The VS GUI was updated to correct this errant behavior in the clinic appointment window. The IS THIS A PBSP CLINIC? (#9.1) field was added to the HOSPITAL LOCATION (#44) to record whether the clinic is a PROVIDER BASED SCHEDULING PROFILE CLINIC (PBSP). The SDES GET CLIN AVAILABILITY RPC was updated to not allow an end date less than the start date. The KIDS build for SD*5.3*828 was configured to delete the specified list of RPCs during the patch installation. New SDES VVS RPCs were created and copy the existing SDEC VVS RPCs functionality. The SDES GET CLINIC INFO 2 was updated to return privileged user list in the JSON object. The SDES UPDATE CLINIC HASH RPC was updated to include the list of privileged user as part of the data to send into the HASHing algorithm. The Cancellation box on the Cancel Appointment screen was updated to have a fixed height and to include a scroll bar ease of use. The SDBUILD security key was created. This new key is needed in VistA for future use with CCM and future lock down of Set Up A Clinic option. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.34.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.34.0 and VistA patch * * SD*5.3*828 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: New/Modified/Deleted -------------------------- -------------------- SDES ERROR CODES New errors being Modified (#409.93) deployed File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- HOSPITAL LOCATION IS THIS A PBSP CLINIC? New (#44) (#9.1) 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 Modified SDESRPC Broker Modified Protocols Associated: --------------------- Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: ------------------------- Security Key Name ----------------- SDBUILD New Templates Associated: --------------------- Template Name Type File Name (Number) New/Modified/Deleted ------------- ----------------------- -------------------- Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDES GET APPT BY APPT IEN New SDES GET APPT BY IEN Deleted SDES GET APPT CHECK-IN STEP Deleted SDES GET APPT CHECK-IN STEPS Deleted SDES GET APPTS BY CLIN IEN Deleted SDES GET APPTS BY CLINIC Deleted SDES GET APPTS BY CLINIEN LIST New SDES GET APPTS BY IEN Deleted SDES GET APPTS BY PATIENT Deleted SDES GET APPTS BY PATIENT DFN Deleted SDES GET CLINIC INFO2 Modified SDES GET PAT APPT BY IEN #2 Deleted SDES GET PAT APPTS BY DFN #2 Deleted SDES GETVVSMAKEINFO JSON New SDES SEARCH VVS PROVIDERS JSON New SDES SPACEBAR VVS PRO New SDES VVC APPT New SDES VVS DELETE ID New SDES VVS GET ID New SDES VVS SAVE ID New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) 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. Address all 508 findings in the DateTimePicker forms in VS GUI. The recommendations below were prepared by the Enterprise Program Management Office (EPMO), Software Testing and 508 Division on July 23, 2019 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. Resolution: The VS GUI has been updated to address the issues noted by the Enterprise Program Management Office (EPMO), Software Testing and 508 Division. 2) VSE-3539: VistA: Create a new version of SDES GET APPT BY CLIN LIST2. Problem: Need to create a new version of SDES GET APPT BY CLIN LIST2 to return the full Appointment Object. The new RPC name will be SDES GET APPTS BY CLINIEN LIST. This RPC will call the appointment wrapper logic. Resolution: The new SDES GET APPTS BY CLINIEN LIST was created to return the full Appointment Object. 3) VSE-3594: VistA: Modify SDES GET APPTS BY PATIENT DFN3. Problem: Need to create a new RPC to replace the SDES GET APPTS BY IEN 2. New RPC will be a duplicate of the original RPC with a name that better reflects the RPC., SDES GET APPT BY APPT IEN. SDES GET APPTS BY IEN 2 will need to be marked as being retired. Resolution: The new SDES GET APPT BY APPT IEN RPC was created to have a name that better represents what the RPC does. 4) VSE-3596: VistA: Modify SDES GET APPT REQ BY IEN. Problem: Modify SDES GET APPT REQ BY IEN, SDES GET APPT REQ BY PAT ALL, SDES GET APPT REQ BY PAT OPEN, and SDES GET APPT REQ BY PATIENT to insert the user's name into the EnteredByName field and user's IEN into the EnteredByIEN field. The return is currently reversed. Resolution: The external and internal values for EnteredBy have been switched so that the EnteredByIEN uses the internal value and the EnteredByName uses the external value of this field. 5) VSE-3622: VistA: Modify SDES CANCEL APPOINTMENT RPC. Problem: Need to modify SDES CANCEL APPOINTMENT RPC to include the following functionality: Process Consult request when appointment is cancelled file (#123) Process Recall request when appointment is cancelled file (#403.5) Process Appointment request when appointment is cancelled file (#409.85) Resolution: The SDES CANCEL APPOINTMENT RPC was modified to process and update the corresponding files when an appointment request is cancelled. 6) VSE-3636: VistA: Modify SDES GET APPTS BY IEN. Problem: Need to modify all SDES GET APPTS BY RPCS to return the clinic institution station number along with the clinic IEN. Acheron is requesting this field be named "ClinicDivisionNumber". This will include the following RPCs: SDES GET APPTS BY CLIN IEN 3 SDES GET APPTS BY CLINIC SDES GET APPTS BY CLINIC LIST SDES GET APPTS BY IEN 2 SDES GET APPTS BY PATIENT SDES GET APPTS BY PATIENT DFN3 SDES GET APPTS BY RESOURCE Resolution: The listed RPCs were updated to return the clinic institution station number along with the clinic IEN. 7) VSE-3750: VistA: Modify SDES EDIT CLINIC. Problem: Need to modify SDES EDIT CLINIC to replace all diagnosis codes with the input list. The RPC should update the diagnosis list to be exactly what was passed in as input to the RPC: adding/removing what is needed, and setting the appropriate diagnosis code as the default. Add validation to not allow an inactive diagnosis code to be added. Resolution: The SDES EDIT CLINIC RPC was modified to update the diagnosis codes based on the list of diagnosis codes that are passed into the RPC. A check for the status of the diagnosis code was added and the default diagnosis code will be updated as well. 8) VSE-4100: INC24518877- VS GUI: Fix Clinic Switching Issue on Make Appointment. Problem: If a user searches a clinic schedule and attempts to schedule an appointment the make appointment window will display the clinic from the clinic schedule. However, if the user tabs through the clinic field it changes the clinic to whatever clinic is in the appointment request. When you tab to the clinic field in the Make Appointment window when scheduling, GUI sends the Specialty/Service name to the SDEC RESOURCE RPC Resolution: The VS GUI was updated to correct this errant behavior in the clinic appointment window. 9) VSE-4141: VistA: Create new field in HOSPITAL LOCATION (#44) file #44 IsPBSP Clinic (bool). Problem: Need to create a new field in the HOSPITAL LOCATION (#44) file that will indicate if this clinic is a PROVIDER BASED SCHEDULING PROFILE CLINIC (PBSP). Resolution: The IS THIS A PBSP CLINIC? (#9.1) field was added to the HOSPITAL LOCATION (#44) to record whether the clinic is a PROVIDER BASED SCHEDULING PROFILE CLINIC (PBSP). 10) VSE-4144: VistA: Modify SDES GET CLINIC AVAILABILITY. Problem: Modify SDES GET CLIN AVAILABILITY to not allow an end date less than the start date. Resolution: Add a check for end date/time less than the start date/time and generate an error if true. 11) VSE-4145: VistA: Retire RPCs post release of SD*5.3*815 and SD*5.3*816. Problem: The older versions of some existing RPCs need to be replaced to help ensure that only the current versions are being used. Delete the following list of obsolete RPCs: SDES GET APPTS BY CLIN IEN SDES GET APPTS BY PATIENT DFN SDES GET APPT BY IEN SDES GET APPTS BY IEN SDES GET APPTS BY PATIENT SDES GET APPTS BY CLINIC SDES GET PAT APPT BY IEN #2 SDES GET PAT APPTS BY DFN #2 SDES GET APPT CHECK-IN STEP SDES GET APPT CHECK-IN STEPS Resolution: The KIDS build for SD*5.3*828 was configured to delete the specified list of RPCs during the patch installation. 12) VSE-4154: VistA: Create VVS RPCs in the SDES menu option. Problem: Create VVS RPCs in the SDES menu option. Resolution: The following VVS RPCs were created in the SDES namespace and added to the SDESRPC menu option: SDES SEARCH VVS PROVIDERS SDES SEARCH VVS PROVIDERS JSON SDES SPACEBAR VVS PRO SDES VVS SAVE ID SDES VVS GET ID SDES VVS DELETE ID SDES VVC APPT SDES GETVVSMAKEINFO SDES GETVVSMAKEINFO JSON 13) VSE-4217: VistA: Modify SDES GET CLINIC INFO 2 to return privileged user list. Problem: Need to update the SDES GET CLINIC INFO 2 to return privileged user list. Resolution: The SDES GET CLINIC INFO 2 was updated to return privileged user list in the JSON object. 14) VSE-4220: VistA: Update Clinic Hash to include privileged users list. Problem: Need to update the SDES UPDATE CLINIC HASH RPC to include the list of privileged users. Resolution: The SDES UPDATE CLINIC HASH RPC was updated to include the list of privileged user as part of the data to send into the HASHing algorithm. 15) VSE-4268: VistA: Add SDBUILD key to VistA. Problem: Need to add SDBUILD key to VistA. Resolution: The SDBUILD security key was created. This new key is needed in VistA for future use with CCM and future lock down of Set Up A Clinic option. 16) VSE-4311: VS GUI: Implement Max Height for Reason for Cancellation Box. Problem: As a user, I want the Reason for Cancellation box on the Cancel Appointment screen to have a max height and become scrollable if necessary, so the PID date does not get pushed off the screen when there are several reasons for cancellation. Resolution: The Cancellation box on the Cancel Appointment screen was updated to have a fixed height and to include a scroll bar ease of use. Test Sites: ----------- Hines, IL (HIN) Martinsburg, WV (MWV) 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_34_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_34_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.34.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_34_0_P.MSI Binary VS GUI R1.7.34.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_34_0_T.MSI Binary VS GUI R1.7.34.0 VDD VS_GUI_1_7_34_0 VDD Binary VS GUI R1.7.34.0 DIBR VS_GUI_1_7_34_0 DIBR Binary VS GUI R1.7.34.0 Release Notes VS_GUI_1_7_34_0 RN Binary VS GUI R1.7.34.0 Technical Manual VS_GUI_1_7_34_0 TM Binary VS GUI R1.7.34.0 User Guide Addendum VS_GUI_1_7_34_0_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 SDES828P 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*828. 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*828. 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 SDES828P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES828P 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*828. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.33. If 1.7.34.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.33.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_34_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 8 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDES828P Before: n/a After: B2328937 **828** Routine Name: SDESAPPT4 Before: B91297874 After:B149023110 **824,828** Routine Name: SDESCANCELAPPTS Before: B56296199 After: B81285999 **818,820,828** Routine Name: SDESCLINICAVAIL Before: B31611069 After: B31113269 **800,805,809,816,820,823,826, 827,828** Routine Name: SDESCLINICDATA Before: B2834740 After: B3279922 **788,823,825,828** Routine Name: SDESCLINICSET2 Before: B96312853 After:B101522309 **799,813,827,828** Routine Name: SDESCREATEAPPT Before: B65506931 After: B69785145 **814,823,826,827,828** Routine Name: SDESCRTAPPTWRAP Before: B68442028 After: B68430725 **814,816,823,826,827,828** Routine Name: SDESGETAPPTREQ Before:B204460220 After:B204460220 **815,818,819,823,824,825,828** Routine Name: SDESHASHCLIN Before: B84361621 After:B102750797 **823,824,828** Routine Name: SDESINPUTVALUTL Before: B5950847 After: B7989792 **819,823,824,827,828** Routine Name: SDESPRVSRCHJSON Before: n/a After: B9956197 **828** Routine Name: SDESRTVCLN2 Before:B102878838 After:B107605586 **823,825,827,828** Routine Name: SDESVVC Before: n/a After: B4045712 **828** Routine Name: SDESVVS Before: n/a After: B54129356 **781,784,785,788,790,792,800, 801,804,805,818,823,828** Routine Name: SDESVVSJSON Before: n/a After: B20003825 **828** ============================================================================= User Information: Entered By : Date Entered : OCT 04, 2022 Completed By: Date Completed: DEC 27, 2022 Released By : Date Released : DEC 27, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT