$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Tuesday, 07/16/24 at 15:33 ============================================================================= Run Date: JUL 31, 2024 Designation: SD*5.3*881 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #730 Status: Released Compliance Date: AUG 14, 2024 ============================================================================= Associated patches: (v)SD*5.3*825 <<= must be installed BEFORE `SD*5.3*881' (v)DG*5.3*1098 <<= must be installed BEFORE `SD*5.3*881' (v)SD*5.3*880 <<= must be installed BEFORE `SD*5.3*881' Subject: VS GUI VERSION 1.7.58.0 Category: - Routine - Enhancement (Mandatory) Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.58.0 and patch SD*5.3*880 includes several defect corrections and enhancements including: The new appointment type World War II was added to the APPOINTMENT TYPE file (#409.1). The SDES2 EDIT PAT DEMOGRAPHICS RPC was updated to have a consistent return element name for both successful and unsuccessful returns. An additional logic check was also added to prevent the addition of a null subscript in the RACE fields. The following RPCs were updated by renaming the ACHERON ID input element in the SDCONTEXT input array to ACHERON AUDIT ID: SDES2 ADD CONTACT ATTEMPT SDES2 BLOCK AND MOVE SDES2 CANCEL CLINIC AVAIL SDES2 CHECK CLIN AVAIL DEFINED SDES2 CREATE CLINIC SDES2 CREATE PROVIDER RESOURCE SDES2 CREATE SPEC NEEDS PREFS SDES2 EDIT PAT DEMOGRAPHICS SDES2 EDIT PROVIDER RESOURCE SDES2 EDIT SPEC NEEDS PREFS SDES2 GET CONSULT CLINIC INFO SDES2 GET CONTACT ATTEMPTS SDES2 GET DEMOGRAPHICS SDES2 GET ELIGIBILITY CODES SDES2 GET PATIENT CLIN STATUS SDES2 GET PATIENT INFO SDES2 GET RESOURCE IEN SDES2 GET SCHEDULING USERS SDES2 GET SPEC NEEDS PREFS SDES2 INACTIVATE CLINIC SDES2 NO-SHOW SDES2 REACTIVATE CLINIC SDES2 RESTORE CLIN AVAIL SDES2 SEARCH RECALL PROVIDERS SDES2 UNDO NO-SHOW The SDES PATIENT SEARCH RPC was updated to -1 to 4 rather than the Boolean flag to indicate sensitive patient. The routines supporting the create appointment RPCs were updated so the Appointment Length validation was increased from 120 minutes to 240 minutes. The APP PROXY ALLOWED field (#.11) in the REMOTE PROCEDURE file (#8994) was set to Yes for the SDES GETVVSMAKEINFO JSON and SDES SEARCH VVS PROVIDERS JSON RPCs. The SDESCLINICAVAIL routine was updated to correct an issue where it was failing to return the midnight timeslots for the clinic for Monday. The SDES GET VISTA DEVICES logic was updated so that the passed in search string will be included in the returned data in addition to all of the other matches that contain the search string. The SDES2 CREATE APPOINTMENT RPC has been updated to prevent duplicate appointments for the same date and time when the user attempts to schedule an appointment for a clinic in a different time zone as long as the former appointments are cancelled. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.58.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.58.0 and VistA patch * * SD*5.3*880 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 ------------------ ---------- -------------------- 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 ----------- ---- -------------------- Protocols Associated: --------------------- Protocol Name New/Modified/Deleted ------------- -------------------- Security Keys Associated: ------------------------- Security Key Name ----------------- N/A Templates Associated: --------------------- Template Name Type File Name (Number) New/Modified/Deleted ------------- ----------------------- -------------------- N/A Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDES GET APPT TYPES Modified SDES GET VISTA DEVICES Modified SDES GETVVSMAKEINFO JSON Modified SDES PATIENT SEARCH 2 Modified SDES SEARCH VVS PROVIDERS JSON Modified SDES2 ADD CONTACT ATTEMPT Modified SDES2 BLOCK AND MOVE Modified SDES2 CANCEL CLINIC AVAIL Modified SDES2 CHECK CLIN AVAIL DEFINED Modified SDES2 CREATE CLINIC Modified SDES2 CREATE PROVIDER RESOURCE Modified SDES2 CREATE SPEC NEEDS PREFS Modified SDES2 EDIT PAT DEMOGRAPHICS Modified SDES2 EDIT PROVIDER RESOURCE Modified SDES2 EDIT SPEC NEEDS PREFS Modified SDES2 GET APPTS BY CLN RES IEN Modified SDES2 GET CONSULT CLINIC INFO Modified SDES2 GET CONTACT ATTEMPTS Modified SDES2 GET DEMOGRAPHICS Modified SDES2 GET ELIGIBILITY CODES Modified SDES2 GET PATIENT CLIN STATUS Modified SDES2 GET PATIENT INFO Modified SDES2 GET RESOURCE IEN Modified SDES2 GET SCHEDULING USERS Modified SDES2 GET SPEC NEEDS PREFS Modified SDES2 INACTIVATE CLINIC Modified SDES2 NO-SHOW Modified SDES2 REACTIVATE CLINIC Modified SDES2 RESTORE CLIN AVAIL Modified SDES2 UNDO NO-SHOW Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-7988: VistA: Create a new appointment type, World War II. Problem: As a MUMPS developer I want to create a new appointment type, World War II so that this can be set as the default appointment type to exempt the veteran from copays for his visits. Also verify the appointment RPCs return the WWII appointment type. Resolution: The new appointment type World War II was added to the APPOINTMENT TYPE file (#409.1). 2) VSE-8050: VistA: Modify SDES2 EDIT PAT DEMOGRAPHICS to fix an inconsistent response. Problem: As a MUMPS developer I want to Modify SDES2 EDIT PAT DEMOGRAPHICS to fix an inconsistent response. When the RPC errors out, the object is named differently then when it runs successfully. I also want to introduce a logic check to prevent the addition of a null subscript in the RACE fields. Resolution: The SDES2 EDIT PAT DEMOGRAPHICS RPC was updated to have a consistent return element name for both successful and unsuccessful returns. An additional logic check was also added to prevent the addition of a null subscript in the RACE fields. 3) VSE-8074: VistA: Update existing SDES2 RPCs so that the ACHERON AUDIT ID is in the input parameter description. Problem: As a MUMPS developer I want to update existing SDES2 RPCs so that the ACHERON AUDIT ID is in the input parameter description. Currently, ACHERON ID is listed. Resolution: The following RPCs were updated by renaming the ACHERON ID input element in the SDCONTEXT input array to ACHERON AUDIT ID: SDES2 ADD CONTACT ATTEMPT SDES2 BLOCK AND MOVE SDES2 CANCEL CLINIC AVAIL SDES2 CHECK CLIN AVAIL DEFINED SDES2 CREATE CLINIC SDES2 CREATE PROVIDER RESOURCE SDES2 CREATE SPEC NEEDS PREFS SDES2 EDIT PAT DEMOGRAPHICS SDES2 EDIT PROVIDER RESOURCE SDES2 EDIT SPEC NEEDS PREFS SDES2 GET CONSULT CLINIC INFO SDES2 GET CONTACT ATTEMPTS SDES2 GET DEMOGRAPHICS SDES2 GET ELIGIBILITY CODES SDES2 GET PATIENT CLIN STATUS SDES2 GET PATIENT INFO SDES2 GET RESOURCE IEN SDES2 GET SCHEDULING USERS SDES2 GET SPEC NEEDS PREFS SDES2 INACTIVATE CLINIC SDES2 NO-SHOW SDES2 REACTIVATE CLINIC SDES2 RESTORE CLIN AVAIL SDES2 SEARCH RECALL PROVIDERS SDES2 UNDO NO-SHOW 4) VSE-8079: VistA: Update Patient Search RPC to return -1 to 4. Problem: As a MUMPS developer I want to modify the Patient Search RPC to return -1 to 4 rather than the Boolean flag to indicate sensitive patient. Resolution: The SDES PATIENT SEARCH RPC was updated to -1 to 4 rather than the Boolean flag to indicate sensitive patient. 5) VSE-8080: VistA: Modify create appointment RPCs to change the validation on the maximum appointment length from 120 to 240. Problem: As a MUMPS developer I want to Modify create appointment RPCs to change the validation on the maximum appointment length from 120 to 240. Modifications are needed so that the validation is done in all create appointment routines to allow for an appointment length to be up to 240. Resolution: The routines supporting the create appointment RPCs were updated so the Appointment Length validation was increased from from 120 minutes to 240 minutes: 6) VSE-8095: VistA: Update SDES GETVVSMAKEINFO JSON and SDES SEARCH VVS PROVIDERS JSON so that the APP PROXY ALLOWED field is set to Yes. Problem: As a MUMPS developer I want to update SDES GETVVSMAKEINFO JSON and SDES SEARCH VVS PROVIDERS JSON RPC definitions so that the APP PROXY ALLOWED field is set to Yes. Resolution: The APP PROXY ALLOWED field (#.11) in the REMOTE PROCEDURE file (#8994) was set to Yes for the SDES GETVVSMAKEINFO JSON and SDES SEARCH VVS PROVIDERS JSON RPCs. 7) VSE-8106: VistA: Modify SDESCLINICAVAIL so that it is returning back the midnight timeslots for the clinic for Monday. Problem: As a MUMPS developer I want to figure out why SDESCLINICAVAIL is not returning back the midnight timeslots for the clinic for Monday. Resolution: The SDESCLINICAVAIL routine was updated to correct an issue where it was failing to return the midnight timeslots for the clinic for Monday. 8) VSE-8156: VistA: Modify SDES GET VISTA DEVICES RPC to be updated to return all matches for the search string passed in. Problem: As a MUMPS Developer I want to Modify SDES GET VISTA DEVICES RPC so that it returns all matches for the search string passed in. The RPC needs to strip off the last character of the search string that was passed in prior to calling the Kernel API to return the matches. The API $O from the passed in search string so it won't return the passed in search value in the list of matches. Resolution: The SDES GET VISTA DEVICES logic was updated so that the passed in search string will be included in the returned data in addition to all of the other matches that contain the search string. 9) VSE-8226: VistA: Modify the check in SDES2 CREATE APPOINTMENT RPC to verify that appointment is not cancelled. Problem: As a MUMPS developer I want to modify SDES2 CREATE APPOINTMENT so that the system is not allowing two appointments that are converted to the same FileMan date.time to be entered in for a patient. Need to modify the check to verify that appointment is not cancelled. We only care if it is an active clinic. Resolution: The SDES2 CREATE APPOINTMENT RPC has been updated to prevent duplicate appointments for the same date and time when the user attempts to schedule an appointment for a clinic in a different time zone as long as the former appointments are cancelled. Test Sites: ----------- Orlando, FL (ORL) Salt Lake City, UT (SLC) 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_58_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_58_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.58.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_58_0_P.MSI Binary VS GUI R1.7.58.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_58_0_T.MSI Binary VS GUI R1.7.58.0 VDD VS_GUI_1_7_58_0 VDD Binary VS GUI R1.7.58.0 DIBR VS_GUI_1_7_58_0 DIBR Binary VS GUI R1.7.58.0 Release Notes VS_GUI_1_7_58_0 RN Binary VS GUI R1.7.58.0 Technical Manual VS_GUI_1_7_58_0 TM Binary VS GUI R1.7.58.0 User Guide Addendum VS_GUI_1_7_58_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) Software Product Management (SPM) Services. Follow the detailed instructions in the Action Item email for VistA Consolidated Server (VACS) installation. The Information Operations (IO) HBMC Field Operations (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 Email: jack.stevens1@domain.ext Pre/Post Installation Overview: ------------------------------- Routine SDES881P 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. 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*881. 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*881. 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 SDES881P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES881P routine using the Delete Routines [XTRDEL] if they wish. Back-Out Plan/Roll Back Plan: ----------------------------- 1. Load the Backup MailMan Message a. Go into MailMan and find the backup message created in step 3a of the installation process and read that message. b. At the "Type to continue or '^' to exit:" prompt enter ^ to get to the command prompt. c. At the command prompt enter X for eXtract and press enter. d. At the "Select PackMan function:" prompt enter 6 for INSTALL/CHECK MESSAGE and press enter. e. At the "OK to Continue with Load? NO//" prompt, type YES and press enter. f. At the "Want to Continue with Load? YES//" prompt, press enter. g. Exit MailMan. 2. Go Into the Kernel Installation & Distribution System (KIDS) and load and install the backup like you would a regular patch. a. Enter D ^XUP at the command prompt. b. At the "Select OPTION NAME:" prompt, enter Kernel Installation & Distribution System" and press enter. c. From the main KIDS menu, select the Installation ... option. d. From the Installation ... option, select 6 Install Package(s). e. At the "Select INSTALL NAME:" prompt enter SD*5.3*881b. f. If prompted for "Want KIDS to INHIBIT LOGONs during the install? NO//" take the default by pressing enter. g. If prompted for "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//" take the default by pressing enter. h. At the DEVICE: prompt, enter the output device of your choice. i. Verify that the SD*5.3*881b backup installs without any issues. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.57. If 1.7.58.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.57.0. 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: SDES2APPTUTIL Before:B138034887 After:B138788042 **866,871,875,877,878,880,881** Routine Name: SDES2CREATEAPPT Before:B147018086 After:B147035229 **866,869,873,875,877,880,881** Routine Name: SDES2CRTVETAPPT Before: B47453616 After: B47453616 **867,869,877,881** Routine Name: SDES2EDITPATDEMO Before: B16749220 After: B17806380 **877,878,881** Routine Name: SDES2GETVISIT Before:B189851343 After:B189851343 **878,881** Routine Name: SDES2PATSEARCH Before:B101627108 After:B108492622 **864,866,881** Routine Name: SDES2RECLLREQ Before: B81047809 After: B81048540 **866,881** Routine Name: SDES881P Before: n/a After: B5936916 **881** Routine Name: SDESCHKAPPTOVP Before: B14162548 After: B14162787 **820,881** Routine Name: SDESCLINICAVAIL Before: B35989138 After: B36778178 **800,805,809,816,820,823,826, 827,828,831,864,881** Routine Name: SDESCREATEAPPT Before: B98381065 After: B98413873 **814,823,826,827,828,842,843, 846,847,851,853,869,877,881** Routine Name: SDESCREATEAPPT44 Before: B48903331 After: B48903684 **814,823,827,851,877,881** Routine Name: SDESGETDEVICES Before: B2589888 After: B3432076 **825,881** Routine list of preceding patches: 825, 880 ============================================================================= User Information: Entered By : Date Entered : APR 10, 2024 Completed By: Date Completed: JUL 31, 2024 Released By : Date Released : JUL 31, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT