$TXT Created by G at CHY0034.FO-BAYPINES.DOMAIN.EXT (KIDS) on Friday, 11/04/22 at 15:39 ============================================================================= Run Date: NOV 17, 2022 Designation: SD*5.3*826 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #679 Status: Released Compliance Date: NOV 30, 2022 ============================================================================= Associated patches: (v)SD*5.3*825 <<= must be installed BEFORE `SD*5.3*826' Subject: VS GUI VERSION 1.7.32.2 Category: - Routine - Enhancement (Mandatory) Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.32.2 and SD*5.3*826 includes several defect corrections and enhancements including updates the SDES CREATE APPT REQ, SDES EDIT APPT REQ and the SDES CREATE VET REQ SCHED APPT RPCs to accept the Appointment Type Name as an input parameter. The patient search field in the VS GUI was updated to be limited to 30 characters. The SDES SEARCH PRIVILEGED USER and SDES SEARCH PROVIDER RPCs were updated to not return an error when there is no data to return based on the input parameters provided. The VS GUI was updated to allow the user to view a veteran's appointment request including details that will assist in the scheduling of an appointment. The VS GUI was updated to allow the user to right click on the request in the RM grid and open the context menu which will allow the user to view, add contact attempts on the request or to disposition the request. The new SDES ADD CLNGRP ITEM RPC was created to add a clinic to a clinic group. The new SDES READ CLINIC GROUP RPC was created to read a single clinic group. The new SDES DELETE CLNGRP ITEM RPC was created to remove a clinic from a clinic group. The new SDES CHECKOUT RPC was created to Check-Out a veteran for an appointment. The new SDES DELETE CLINIC GROUP RPC was created to remove an entire clinic group. Logic was added to the SDEC826P post install routine to clean up data that occurred after the VPS*1*21 installation. The SDES GET CLIN AVAILABILITY RPC was updated to not return an error message when the clinic had no defined availability for the date specified. The SDES ADDEDIT CLINIC GRP RPC was updated to limit clinic group name to a maximum of 30 characters. The SDES GET CLIN AVAILABILITY was updated to allow the date combinations noted in the ticket. The hashed value for the remote application entry was updated and the SDES CREATE APPT REQ RPC was updated to accept AMIS Primary and Secondary stop codes and added additional validation checks appropriate for the AMIS based codes. The routine that supports the SDEC GET APPT REQ BY IEN JSON RPC was updated to return the patient comments. The SDES GET MISSION ACT ELG RPC was updated to include VETERAN request type. The SDES GET MISSION ACT ELG RPC was updated to include the input parameter "CLINIC" and modified the SDESMISSIONELG routine to accept and validate the CLINIC input parameter. The calendar display for the group view and provider schedules view in the VS GUI was updated to display all availability for clinics in a group even when the clinics don't have the same stop a start or end times. The VS GUI was updated to include VETERAN in the display the SERVICE/SPECIALTY information in the RM grid and in the View Request window. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.32.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.32.2 and VistA patch * * SD*5.3*826 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 ADD CLNGRP ITEM New SDES CHECKOUT New SDES CREATE APPT REQ Modified SDES CREATE VET REQ SCHED APPT Modified SDES DELETE CLINIC GROUP New SDES DELETE CLNGRP ITEM New SDES EDIT APPT REQ Modified SDES GET CLIN AVAILABILITY Modified SDES GET MISSION ACT ELG Modified SDES READ CLINIC GROUP New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-3767 - VistA: Update SDES CREATE APPT REQ to accept a 409.1 APPOINTMENT TYPE Name. Problem: Need to update the following RPCs to accept a 409.1 APPOINTMENT TYPE name, in addition to the appointment type IEN. SDES CREATE APPT REQ SDES EDIT APPT REQ SDES CREATE VET REQ SCHED APPT This will also need a new error code saying: Either Appointment Type Name or Appointment Type IEN must be defined. Resolution: The specified RPCs were updated to accept either the Appointment Type IEN or the Appointment Type Name. The Appointment Type Name is given precedence in cases where both the Appointment Type IEN and the Appointment Type Name are passed in but are for different entries in the APPOINTMENT TYPE (#409.1) file. 2) VSE-3769 - VS GUI: Limit Number of Characters Allowed in Patient Search to 30 characters. Problem: Need to update the VS GUI to limit the number of characters in the patient search field to 30 characters. Resolution: The patient search field in the VS GUI was updated to be limited to 30 characters. 3) VSE-3787 - VistA: Modify RPCs to return an empty data element rather than an error. Problem: If all of the input parameter are valid and no matching privileged users/providers are found then SDES SEARCH PRIVILEGED USER and SDES SEARCH PROVIDER should return an empty JSON array instead of an error. Currently these errors are returned: {"Error":["No records were found using the search criteria 'QUINCY'"],"NewPerson":[""]} {"Error":["No Providers found that match Search String."],"Provider":[""]} Resolution: The SDES SEARCH PRIVILEGED USER and SDES SEARCH PROVIDER RPCs were updated to not return an error when there is no data to return based on the input parameters provided. 4) VSE-3798 - VS GUI: Calendar in Group View or Provider Schedules view cuts off availability. Problem: The calendar display cuts off availability when the left-most clinic in group view or provider schedules view has a starting hour later than the other clinics in the group or for the provider. Resolution: The calendar display for the group view and provider schedules view in the VS GUI was updated to display all availability for clinics in a group even when the clinics don't have the same stop a start or end times. 5) VSE-3837 - VS GUI: View veteran appointment request. Problem: As a scheduler, I want to View a VETERAN appointment request, so that I can schedule according to details provided in the patient request. Appointment requests of request type VETERAN currently cannot be viewed from VS GUI Update VS GUI to display VETERAN appointment requests View should include PATIENT COMMENTS field-this allows up to 500 characters Appointment request information is not editable (view only) Resolution: The VS GUI was updated to allow the user to view a veteran's appointment request including details that will assist in the scheduling of an appointment. 6) VSE-3838 - VS GUI: Context menu display for VETERAN appointment requests. Problem: When a "Veteran" appointment request type is returned, users need the ability to right click on the request in the RM grid and open the context menu, so that they can then view, disposition, and add contact attempts on the request. Edit should be grayed out. Veteran appt request type should have the same disposition options as the APPT request type. Resolution: The VS GUI was updated to allow the user to right click on the request in the RM grid and open the context menu which will allow the user to view, add contact attempts on the request or to disposition the request. 7) VSE-3848 - VistA: Create SDES RPC to add clinic to clinic group. Problem: Need to create an RPC in the SDES menu option to add a clinic to a clinic group. Resolution: The new SDES ADD CLNGRP ITEM RPC was created to add a clinic to a clinic group. 8) VSE-3849 - VistA: Create a SDES RPC to read a single clinic group. Problem: Need to create an RPC in the SDES menu option to read a single clinic group. Resolution: The new SDES READ CLINIC GROUP RPC was created to read a single clinic group. 9) VSE-3850 - VistA: Create a SDES RPC to remove a clinic from a clinic group. Problem: Need to create a RPC in the SDES menu option to remove a clinic from a clinic group. Resolution: The new SDES DELETE CLNGRP ITEM RPC was created to remove a clinic from a clinic group. 10) VSE-3852 - VistA: Create a SDES RPC to Check-Out an appointment. Problem: Need to create a RPC in the SDES menu option to Check-Out a veteran for an appointment. Resolution: The new SDES CHECKOUT RPC was created to Check-Out a veteran for an appointment. 11) VSE-3856 - VistA: Create a SDES RPC to remove a clinic group. Problem: Need to create a RPC in the SDES menu option to remove an entire clinic group. Resolution: The new SDES DELETE CLINIC GROUP RPC was created to remove an entire clinic group. 12) VSE-3861 - VistA: Create post install routine to cleanup check-ins in VPS. Problem: Need to create post install routine to cleanup appointments that were checked-in after VPS*1*21 and prior to VPS*1.22. Use the check-in time entered in the HOSPITAL LOCATION file to correct the check-in time in the SDEC APPOINTMENT file. Resolution: Logic was added to the SDEC826P post install routine to clean up data that occurred after the VPS*1*21 installation. 13) VSE-3871 - VistA: Modify SDES GET CLIN AVAILABILITY to return an empty data element. Problem: Need to modify SDES GET CLIN AVAILABILITY to return an empty data element instead of an error when the clinic has no availability defined. Resolution: The SDES GET CLIN AVAILABILITY RPC was updated to not return an error message when the clinic had no defined availability for the date specified. 14) VSE-3874 - VistA: This defect was identified in SDES ADDEDIT CLINIC GRP RPC. Problem: Need to update the SDES ADDEDIT CLINIC GRP RPC to not allow a clinic group name of more than 30 characters. Resolution: The SDES ADDEDIT CLINIC GRP RPC was updated to limit clinic group name to a maximum of 30 characters. 15) VSE-3962 - VistA: Modify SDES GET CLIN AVAILABILITY to accept dates in the past. Problem: Need to modify SDES GET CLIN AVAILABILITY to accept dates in the past and the future covering these scenarios: STARTDATETIME and ENDDATETIME are both in the past STARTDATETIME is in the past and ENDDATETIME is in the future STARTDATETIME and ENDDATETIME are both in the future Resolution: The SDES GET CLIN AVAILABILITY was updated to allow the date combinations noted in the ticket. 16) VSE-4007 - Modify SDES GET MISSION ACT ELG include the "VETERAN" appointment request type as a possible input. Problem: Need to modify SDES GET MISSION ACT ELG include the "VETERAN" appointment request type as a possible input. Resolution: Edited RPC SDES GET MISSION ACT ELG to include VETERAN request type. 17) VSE-4065 - VistA: Update application code in remote application entry Problem: Need to update the hashed value for the remote application entry. Resolution: The hashed value for the remote application entry will be updated to the provided value. 18) VSE-4066 - VistA: Update SDES CREATE APPT REQ to add AMIS Primary and Secondary stop codes Problem: Need to update the SDES CREATE APPT REQ RPC to accept AMIS Primary and Secondary stop codes and to add additional validation checks. Resolution: The SDESCREATEAPPREQ routine was updated to accept AMIS Primary and Secondary stop codes and added additional validation checks appropriate for the AMIS based codes. 19) VSE-4181 VistA: Modify SDEC GET APPT REQ BY IEN JSON to return patient comments. Problem: Need to modify SDEC GET APPT REQ BY IEN JSON to return patient comments. Resolution: The routine that supports the SDEC GET APPT REQ BY IEN JSON RPC was updated to return the patient comments. 20) VSE-4281 - Service/Specialty Not Displaying for APPT/VETERAN Requests. Problem: The SERVICE/SPECIALTY for APPT requests (to include VETERAN) is not displaying in the RM grid in VS GUI or in the View Request window. The information is being returned by SDEC GET PATIENT APPT REQ JSON and SDEC GET APPT REQ BY IEN JSON. Resolution: The VS GUI was updated to include VETERAN in the display the SERVICE/SPECIALTY information in the RM grid and in the View Request window. 21) VSE-4283 - VistA: Modify RPC, SDES GET MISSION ACT ELIG, add required input parameter "CLINIC", and modify routine to no longer pull CLINIC from requests. Problem: Need to include the CLINIC IEN as an input parameter. Resolution: Updated the SDES GET MISSION ACT ELG RPC to include the input parameter "CLINIC" and modified the SDESMISSIONELG routine to accept and validate the CLINIC input parameter. and modify routine. Test Sites: ----------- North Texas (NTX) Orlando, FL (ORL) 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_32_2_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_32_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.32.2 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_32_2_P.MSI Binary VS GUI R1.7.32.2 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_32_2_T.MSI Binary VS GUI R1.7.32.2 VDD VS_GUI_1_7_32_2 VDD Binary VS GUI R1.7.32.2 DIBR VS_GUI_1_7_32_2 DIBR Binary VS GUI R1.7.32.2 Release Notes VS_GUI_1_7_32_2 RN Binary VS GUI R1.7.32.2 Technical Manual VS_GUI_1_7_32_2 TM Binary VS GUI R1.7.32.2 User Guide Addendum VS_GUI_1_7_32_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 SDEC826P 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*826. 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*826. 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 SDEC826P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC826P 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*826. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.31. If 1.7.32.2 VS GUI was installed, it will need to be reverted to VS GUI 1.7.31.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_32_2_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;SCHEDULING;**[Patch List]**;AUG 13, 1993;Build 18 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC826P Before: n/a After: B35109516 **826** Routine Name: SDECAR4 Before:B134299297 After:B141272711 **784,785,788,805,813,826** Routine Name: SDES Before:B115334482 After:B115642867 **788,790,792,794,797,799,800, 801,803,804,805,807,809,813, 814,815,818,819,824,825,826** Routine Name: SDES2 Before: B4064513 After: B5291710 **816,818,819,820,823,825,826** Routine Name: SDESADDDELCGI Before: n/a After: B19648701 **826** Routine Name: SDESADDRG Before: B8809046 After: B20902587 **825,826** Routine Name: SDESCHECKOUT Before: n/a After:B192834318 **826** Routine Name: SDESCLINICAVAIL Before: B27882218 After: B25537644 **800,805,809,816,820,823,826** Routine Name: SDESCREATEAPPREQ Before:B143092574 After:B167919702 **823,826** Routine Name: SDESCREATEAPPT Before: B57041641 After: B63270079 **814,823,826** Routine Name: SDESCREATEAPPT2 Before: B23961125 After: B28131524 **814,823,826** Routine Name: SDESCRTAPPTWRAP Before: B60525090 After: B62534284 **814,816,823,826** Routine Name: SDESEDITAPPTREQ Before:B189951748 After:B191445747 **823,826** Routine Name: SDESEDITAPPTREQ2 Before: B4163021 After: B5454408 **823,826** Routine Name: SDESMISSIONELG Before: B45400827 After: B43961305 **814,815,818,820,826** Routine Name: SDESPRIVUSRSRCH Before: B68649996 After: B67047655 **819,826** Routine Name: SDESPROVSEARCH Before: B26174476 After: B25617902 **819,826** Routine Name: SDESREQAPPCREATE Before: B70705119 After: B72332691 **823,826** Routine Name: SDESRTNRG Before: n/a After: B7578785 **826** Routine Name: SDESVALUTIL Before: n/a After: B1333437 **826** Routine list of preceding patches: 825 ============================================================================= User Information: Entered By : Date Entered : AUG 30, 2022 Completed By: Date Completed: NOV 17, 2022 Released By : Date Released : NOV 17, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT