$TXT Created by G at CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 09/15/22 at 09:02 ============================================================================= Run Date: OCT 21, 2022 Designation: SD*5.3*825 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #677 Status: Released Compliance Date: NOV 03, 2022 ============================================================================= Associated patches: (v)SD*5.3*686 <<= must be installed BEFORE `SD*5.3*825' (v)SD*5.3*824 <<= must be installed BEFORE `SD*5.3*825' Subject: VS GUI VERSION 1.7.31.2 Category: - Routine Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.31.2 and SD*5.3*825 includes several defect corrections and enhancements including updating several SDES RPCs to include STATION NUMBER into the JSON object. The SDEC RESCE and supporting routine were updated to document and utilize the eCheck-in Allowed, Pre-Checkin Allowed, and time zone. The SDES GET CLINIC INFO2 and supporting routine were updated to accept a new input parameter which will trigger an update to the CLINIC HASH after the updates have been made. The SDES GET CLINIC INFO2 RPC and supporting routine were updated to document and return the station number of the institution associated with the division. Logic was added to the VS GUI to check the "DISPLAY CLIN APPT TO PATIENTS" property of a clinic to check if the clinic is able to print appointments. The routine supporting the Cancel Clinic Availability option was updated to allow the output to be directed to a printer. The SDES CREATE CLINIC and SDES EDIT CLINIC were updated to accept the Primary AMIS Stop Code and the Credit AMIS Stop Code and additional validation logic was also added. The SDES ADDEDIT CLINIC GRP RPC was added to create or edit clinic groups in the SDEC RESOURCE GROUP (#409.832) file. To better support the appointment dispositioning process two new error messages were added to the SDES ERROR CODES (#409.93) file and the SDESARCLOSE routine was updated to utilize these two new messages. The SDES name spaced RPCs were reviewed and updated to prevent a FileMan date from being returned in their JSON object. The SDEC28L routine was updated to restrict lookup to 30 characters to prevent error for extremely long values. The VS GUI Expanded Entry screen was updated to correct the typo: "Radiattion". Two comments fields were added to the return JSON object for several of the RPCs that return appointment request data. The SDES CANCEL CLIN PRECAN LIST RPC was updated to utilize the latest business rules in SDESGETAPPTWRAP4. Routine SDESCCAVAIL was updated to properly reference the correct template in the HOSPITAL LOCATION file (#44). Updates were made to the VS GUI for 508 compliance and the developers verified that the VA.VSE.CS.Presentation.MVC/ could be safely removed from the VS GUI, and they have removed it from the source code. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.31.2 of VS is installed. * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI V1.7.31.2 and VistA patch * * SD*5.3*825 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 --------------------- -------------------- SDEC RESCE Modified SDES ADDEDIT CLINIC GRP New SDES CANCEL CLIN PRECAN LIST Modified SDES CREATE CLINIC Modified SDES EDIT CLINIC Modified SDES GET APPT BY IEN Modified SDES GET APPT BY REQ/APPT TYP2 Modified SDES GET APPT BY REQ/APPT TYPE Modified SDES GET APPT REQ BY IEN Modified SDES GET APPT REQ BY PAT ALL Modified SDES GET APPT REQ BY PAT OPEN Modified SDES GET APPT REQ BY PATIENT Modified SDES GET APPT REQ LIST BY DFN Modified SDES GET APPTS BY CLIN IEN Modified SDES GET APPTS BY CLIN IEN 2 Modified SDES GET APPTS BY CLIN IEN 3 Modified SDES GET APPTS BY CLINIC Modified SDES GET APPTS BY CLINIC LIST Modified SDES GET APPTS BY IEN Modified SDES GET APPTS BY IEN 2 Modified SDES GET APPTS BY PATIENT Modified SDES GET APPTS BY PATIENT DFN Modified SDES GET APPTS BY PATIENT DFN2 Modified SDES GET APPTS BY PATIENT DFN3 Modified SDES GET APPTS BY RESOURCE Modified SDES GET CLINIC INFO2 Modified SDES GET VISTA DEVICES New SDES PRINT APPT LETTER VISTA New SDES PRINT APPT LETTERS VISTA New SDES SEARCH CLINIC GRP New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-2567 - I-0001259 Display appointment type in calendar grid. Problem: Update the VS GUI to see what type of appt the vet has (either a follow up or consult) when hovering over a vet's appointment in the daily schedule, without having to expand every appt. Resolution: The daily schedule in the VS GUI was updated to allow the display the type of appointment information when hovering over an individual item. 2) VSE-2856: SDES GET APPT BY *: Requesting the addition of the division STATION NUMBER in the Appointment object. Problem: The Appointment object in the response includes 'Clinic.Division'. The value is the division name. The clinic division STATION NUMBER is much more useful to us. Can the division station number be included? Medical division station number associated with that clinic. Resolution: The following RPC's has been modified to add STATION NUMBER into the JSON RETURN: SDES GET APPT BY IEN SDES GET APPT BY REQ/APPT TYPE SDES GET APPT BY REQ/APPT TYP2 SDES GET APPTS BY CLIN IEN SDES GET APPTS BY CLIN IEN 2 SDES GET APPTS BY CLIN IEN 3 SDES GET APPTS BY CLINIC LIST SDES GET APPTS BY CLINIC SDES GET APPTS BY IEN SDES GET APPTS BY IEN 2 SDES GET APPTS BY PATIENT SDES GET APPTS BY PATIEN DFN SDES GET APPTS BY PATIENT DFN2 SDES GET APPTS BY PATIENT DFN3 SDES GET APPTS BY RESOURCE SDES CANCEL CLIN PRECAN LIST --though this RPC does not start with SDES GET APPT* as per requested, however, the JSONRETURN returns the APPOINTMENT object 3) VSE-3428: VistA: Add eCheck-in Allowed, Pre-Checkin Allowed, and time zone to SDEC RESCE. Problem: Need to add eCheck-in Allowed, Pre-Checkin Allowed, and time zone to SDEC RESCE. Resolution: The SDEC RESCE and supporting routine were updated to document and utilize these three fields. 4) VSE-3584: VistA: Modify SDES GET CLINIC INFO2 to trigger update to hash file. Problem: Add logic to SDES GET CLINIC INFO2 to add new input parameter as a flag to trigger update to hash file - this will allow the time stamp to update when Acheron calls get clinic info. Send back hash with output. This would allow ZZ clinics to be passed in and returned values. Resolution: The SDES GET CLINIC INFO2 and supporting routine were updated to accept a new input parameter. When passed in the new UPDATEHASHFLG input parameter will trigger an update to the CLINIC HASH after the updates have been made. 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: The RM Grid was updated to allow navigation with keyboard controls. 6) VSE-3634: VistA: Modify SDES GET CLINIC INFO2. Problem: Please modify SDES GET CLINIC INFO2 to return the station number of the institution associated with the division instead of the Division IEN. Resolution: The SDES GET CLINIC INFO2 RPC and supporting routine were updated to document and return the station number of the institution associated with the division. 7) VSE-3699: Getting a service error for printing all clinics that is set to "DISPLAY CLIN APPT TO PATIENTS?: NO// ". Problem: Steps to reproduce: Schedule a future appointment for a clinic That is set to "DISPLAY CLIN APPT TO PATIENTS?: NO// " Right click on the future appointment and select "patient friendly print" option. Expected result: User should receive the field is set to not display. Actual result: user is receiving a service error. Resolution: Logic was added to the VS GUI to check the "DISPLAY CLIN APPT TO PATIENTS" property of a clinic to check if the clinic can print appointments. If the clinic has that flag set to false or no, we display a message: "Please ensure the \"DISPLAY CLIN APPT TO PATIENTS\" flag is set to YES for the targeted clinic." 8) VSE-3704: VistA: Add VistA print capability to the Cancel Clinic Availability option (SDES). Problem: Need to add VistA print capability to the Cancel Clinic Availability option (SDES). Resolution: The routine supporting the Cancel Clinic Availability option was updated to allow the output to be directed to a printer. 9) VSE-3738: VistA: Update SDES CREATE CLINIC and SDES EDIT CLINIC. Problem: Update SDES CREATE CLINIC and SDES EDIT CLINIC to take the primary AMIS stop code number and credit AMIS stop code number instead of the primary stop code IEN and credit stop code IEN as input parameters. Resolution: The SDES CREATE CLINIC and SDES EDIT CLINIC were updated to accept the Primary AMIS Stop Code and the Credit AMIS Stop Code. The following business rules were also implemented as part of this update: 1. If both a Primary Stop Code and a Primary AMIS Stop Code are passed in, the Primary AMIS Stop Code will take precedence. 2. If both a Credit Stop Code and a Credit AMIS Stop Code are passed in, the Credit AMIS Stop Code will take precedence. 3. A validation check was added for Primary Stop Code passed in to validate that it is categorized as either Primary or Either. 4. A validation check was added for Primary AMIS Stop Code passed in to validate that it is categorized as either Primary or Either. 5. A validation check was added for Credit Stop Code passed in to validate that it is categorized as either Secondary or Either. 6. A validation check was added for Credit AMIS Stop Code passed in to validate that it is categorized as either Secondary or Either. 7. A validation check was added to prevent Stop Code 900 from being accepted for any of the four Stop Code related inputs. 10) VSE-3757: VistA: SDES RPC to Create Clinic Group. Problem: Need to create a new SDES RPC to create a clinic group. Resolution: The SDES ADDEDIT CLINIC GRP RPC was added to create or edit clinic groups in the SDEC RESOURCE GROUP (#409.832) file. 11) VSE-3759: VistA: SDES Search Clinic Group RPC. Problem: Need to create a new SDES RPC to search clinic groups. Resolution: The new SDES SEARCH CLINIC GRP RPC was created to search for clinic groups in the SDEC RESOURCE GROUP (#409.832) file. 12) VSE-3761: VistA: Update SDES DISPOSITION APPT REQ - Change Error Message Returned. Problem: Update SDES DISPOSITION APPT REQ so that error returned when there is an invalid 'Dispositioned By' ID clearly represents the error. Resolution: Two new error messages were added to the SDES ERROR CODES (#409.93) file and the SDESARCLOSE routine was updated to utilize these two new messages. 13) VSE-3762: VistA: Ensure FM datetime is not being appended to cancelled by clinic status. Problem: Need to review the SDES* name spaced RPCs to ensure that they aren't returning a FileMan date in their JSON object. Resolution: The following RPCs were updated to prevent a FileMan date from being returned in their JSON object: SDES GET APPT BY IEN SDES GET APPT BY REQ/APPT TYPE SDES GET APPT BY REQ/APPT TYP2 SDES GET APPTS BY CLIN IEN SDES GET APPTS BY CLIN IEN 2 SDES GET APPTS BY CLIN IEN 3 SDES GET APPTS BY CLINIC LIST SDES GET APPTS BY CLINIC SDES GET APPTS BY IEN SDES GET APPTS BY IEN 2 SDES GET APPTS BY PATIENT SDES GET APPTS BY PATIEN DFN SDES GET APPTS BY PATIENT DFN2 SDES GET APPTS BY PATIENT DFN3 SDES GET APPTS BY RESOURCE SDES CANCEL CLIN PRECAN LIST 14) VSE-3768: INC23935053 - VistA: <>DOB+58^SDEC28L appearing. Problem: Routine SDEC28L is erroring out with the following subscript error: SUBSCRIPT>DOB+58^SDEC28L. Need to review and address this issue. Resolution: The SDEC28L routine was updated to restrict lookup to 30 characters to prevent error for extremely long values. 15) VSE-3774: VS GUI: CVE-2021-21252 Remediation. Problem: Dev needs to go in and view VA.VSE.CS.Presentation.MVC/ and make sure there are no dependencies used by live code. Determine if Presentation.MVC project can go away. Unload project Presentation.MVC, build application, see if it builds. If it builds we can remove from source Resolution: Developers verified that the VA.VSE.CS.Presentation.MVC/ could be safely removed from the VS GUI, and they have removed it from the source code. 16) VSE-3781: VS GUI: Correct Spelling of Radiation in Expanded Entry. Problem: Radiation is spelled "Radiattion" in the Expanded Entry field in VS GUI. The spelling needs to be corrected to "Radiation". Resolution: The VS GUI Expanded Entry screen was updated to correct the typo: "Radiattion". 17) VSE-3790: VistA: Add 2 comment fields from file 409.85 to the JSON return. Problem: The following two fields need to be added to the return JSON Object for the following list of RPCs: 1. COMMENTS (#25) - This is 80 character max. 2. COMMENTS (#26) - This is a multiple field and can be as long as needed. List of RPCs: 1. SDES GET APPT REQ BY IEN 2. SDES GET APPT REQ BY PAT ALL 3. SDES GET APPT REQ BY PAT OPEN 4. SDES GET APPT REQ BY PATIENT 5. SDES GET APPT REQ LIST BY DFN Resolution: The RPC definition was updated to show the newly added COMMENTS fields and the supporting software was updated to retrieve and include the COMMENTS in the return JSON object. 18) VSE-3846: VistA: Fix null results in SDES CANCEL CLIN PRECAN LIST. Problem: Fix null results in SDES CANCEL CLIN PRECAN LIST and update to use SDESAPPTWRAP4. Resolution: The SDES CANCEL CLIN PRECAN LIST RPC was updated to utilize the latest business rules in SDESGETAPPTWRAP4. 19) VSE-3847 VistA: Fix incorrect file number reference to master pattern (44.08). Problem: SDES CANCEL CLIN AVAILABILITY - Fix incorrect file number reference to master pattern (44.08). Resolution: Routine SDESCCAVAIL was updated to properly reference the correct template subfile in the HOSPITAL LOCATION file (#44). Test Sites: ----------- San Diego, CA (SDC) Wilkes-Barre, PA (WBP) 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_31_2_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_31_2_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.31.2 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_31_2_P.MSI Binary VS GUI R1.7.31.2 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_31_2_T.MSI Binary VS GUI R1.7.31.2 VDD VS_GUI_1_7_31_2 VDD Binary VS GUI R1.7.31.2 DIBR VS_GUI_1_7_31_2 DIBR Binary VS GUI R1.7.31.2 Release Notes VS_GUI_1_7_31_2 RN Binary VS GUI R1.7.31.2 Technical Manual VS_GUI_1_7_31_2 TM Binary VS GUI R1.7.31.2 User Guide Addendum VS_GUI_1_7_31_2_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 SDEC825P 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*825. 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*825. 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 SDEC825P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC825P 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*825. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.30. If 1.7.31.2 VS GUI was installed, it will need to be reverted to VS GUI 1.7.30.1. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_31_2_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC01C Before: B69927064 After: B77298578 **686,825** Routine Name: SDEC28L Before: B54184100 After: B56144195 **785,823,825** Routine Name: SDEC825P Before: n/a After: B2328503 **825** Routine Name: SDES Before:B114336785 After:B115334482 **788,790,792,794,797,799,800, 801,803,804,805,807,809,813, 814,815,818,819,824,825** Routine Name: SDES2 Before: B3856891 After: B4064513 **816,818,819,820,823,825** Routine Name: SDESADDRG Before: n/a After: B8809046 **825** Routine Name: SDESAPPTLETTERSV Before: n/a After: B48937810 **825** Routine Name: SDESARCLOSE Before: B11219832 After: B12163919 **794,799,805,809,815,818,819, 820,825** Routine Name: SDESCCAVAIL Before:B184479431 After:B186282162 **800,805,809,813,819,820,824,825** Routine Name: SDESCLINICDATA Before: B2279673 After: B2834740 **788,823,825** Routine Name: SDESCLINICSET Before:B188102413 After:B219070518 **799,805,820,824,825** Routine Name: SDESCLINPRECAN Before: B7966169 After: B7858622 **824,825** Routine Name: SDESCLNGRP Before: n/a After: B8777792 **825** Routine Name: SDESGETAPPTREQ Before:B187766300 After:B204460220 **815,818,819,823,824,825** Routine Name: SDESGETAPPTWRAP3 Before:B122930731 After:B123788588 **815,823,824,825** Routine Name: SDESGETAPPTWRAP5 Before:B131256159 After:B132152663 **823,824,825** Routine Name: SDESGETDEVICES Before: n/a After: B2589888 **825** Routine Name: SDESGETREQWRAPPR Before: B67182554 After: B73209401 **815,818,820,823,825** Routine Name: SDESRTVCLN2 Before: B78541570 After: B97930720 **823,825** Routine Name: SDESUTIL Before: B36529691 After: B47340300 **801,804,805,814,816,818,820, 823,824,825** Routine list of preceding patches: 686, 824 ============================================================================= User Information: Entered By : Date Entered : AUG 23, 2022 Completed By: Date Completed: OCT 20, 2022 Released By : Date Released : OCT 21, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT