$TXT Created by G at CHY0034.FO-BAYPINES.DOMAIN.EXT (KIDS) on Tuesday, 10/03/23 at 18:19 ============================================================================= Run Date: OCT 17, 2023 Designation: SD*5.3*857 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #710 Status: Released Compliance Date: OCT 31, 2023 ============================================================================= Associated patches: (v)SD*5.3*836 <<= must be installed BEFORE `SD*5.3*857' (v)SD*5.3*847 <<= must be installed BEFORE `SD*5.3*857' (v)SD*5.3*853 <<= must be installed BEFORE `SD*5.3*857' Subject: VS GUI VERSION 1.7.47.1 Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.47.1 and patch SD*5.3*857 includes several defect corrections and enhancements including: The SDES GET APPT REQS BY IENS, SDES CONTACT ADD/UPDATE, SDES CONTACT DISPLAY, and SDES GET APPTS BY IENS Remote Procedure Calls (RPC) will be removed from the site during the installation of the patch. The SDBUILD option was updated to remove the prompt for START TIME FOR AUTO REBOOK and MAX# DAYS FOR AUTO-REBOOK. The ALLOWABLE CONSECUTIVE NO-SHOWS prompt was set to default to zero. The SDESGETCONSULTS routine was updated by correcting a misspelled input parameter that was resulting in a leaking variable. The VistA Scheduling (VS) Graphical User Interface (GUI) was updated to correctly display contacts attempts that have comments that contain a semicolon. The VS GUI was updated to look for device name as opposed to just the Boolean since it includes non-applicable device types. The Primary and Credit stop code validators used by the SDES2 CREATE CLINIC RPC were updated to only allow for active Primary or Credit stop codes. The Length of Appointment, Division, Default Appointment Type, and Principal Clinic field validators were updated to always store a validated entry. The Primary and Credit stop code validators used by the SDES2 EDIT CLINIC RPC were updated to only allow for active Primary or Credit stop codes. The Clinic Hash value was added as an input parameter. The Division, Default Appointment Type, and Principal Clinic field validators were updated to always store a validated entry. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.47.1 of VS is installed. * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI V1.7.47.1 and VistA patch * * SD*5.3*857 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 ----------- ---- -------------------- 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 ------------- ----------------------- -------------------- SDB HOSPITAL LOCATION (#44) Modified Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDES CONTACT ADD/UPDATE Deleted SDES CONTACT DISPLAY Deleted SDES GET APPT REQS BY IENS Deleted SDES GET APPTS BY IENS Deleted SDES2 EDIT CLINIC Modified SDES EDIT CLINIC Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-5499: VistA: Retire RPCs 90 days post release of patch 845. Problem: Need to retire the following RPCs: SDES GET APPT REQS BY IENS SDES CONTACT ADD/UPDATE SDES CONTACT DISPLAY SDES GET APPTS BY IENS Resolution: The SDES GET APPT REQS BY IENS, SDES CONTACT ADD/UPDATE, SDES CONTACT DISPLAY, and SDES GET APPTS BY IENS RPCs will be removed from the site during the installation of the patch. 2) VSE-5823: Update SDBUILD to have default values for auto rebook, consecutive no-shows. Problem: As a clinic profiler, I would like to remove prompts for START TIME FOR AUTO REBOOK, MAX # DAYS FOR AUTO-REBOOK from SDBUILD. ALLOWABLE CONSECUTIVE NO-SHOWS prompt will default to 0. *Acceptance Criteria:* # START TIME FOR AUTO REBOOK prompt does not display # MAX# DAYS FOR AUTO-REBOOK prompt does not display # ALLOWABLE CONSECUTIVE NO-SHOWS Defaults to 999 # The above is true when editing a clinic or creating a new clinic Resolution: The SDBUILD option was updated to remove the prompt for START TIME FOR AUTO REBOOK and MAX# DAYS FOR AUTO-REBOOK. The ALLOWABLE CONSECUTIVE NO-SHOWS prompt was set to default to zero. 3) VSE-5982: VistA: Calling SDESGETCONSULTS expects REQUEST as 1st input parameter. Problem: Calling SDESGETCONSULTS expects REQUEST as 1st input parameter. However, REQUEST is misspelled causing a leaking variable. GETCONSULT(REQUSET,CONSULTIEN) Please correct spelling to REQUEST. Resolution: The SDESGETCONSULTS routine was updated by correcting a misspelled input parameter that was resulting in a leaking variable. 4) VSE-6046: GUI: CA containing semicolons do not display in contact attempts list view. Problem: Defect identified through SNOW ticket. Steps to reproduce: Right-click request and select contact attempts Type comments into new contact attempt containing ";" Click Submit. Expected Behavior: Submitted contact attempt is added to list of contact attempts in contact attempts window. Actual Behavior: Submitted contact attempt does not display, although it is returned by the RPC and the count on the RM grid is incremented. Resolution: The VS GUI was updated to correctly display contacts attempts that have comments that contain a semicolon. 5) VSE-6086: VSE GUI: Update VA Loaned Device Logic can Look at Device Name. Problem: Appointment details in VCM indicate a Veteran has a VA Loaned iPad, however the Veteran does not, nor ever had a VA Loaned iPad (confirmed by ROES data). The hasMobileGFE Boolean flag is showing even if a patient has a peripheral (scale) which should not count as a VA Loaned Device for VCM purposes. Update VALD to look for device name as opposed to just the Boolean since it includes non-applicable device types. Computer Hardware and Tablet Telehealth are the applicable devices that should return as TRUE. Resolution: The VS GUI was updated to look for device name as opposed to just the Boolean since it includes non-applicable device types. 6) VSE-6158: VistA: Modify SDES2 CREATE CLINIC to only accept active stop codes. Problem: Need to update SDES2 CREATE CLINIC RPC to only accept active stop codes. Resolution: The Primary and Credit stop code validators were updated to only allow for active Primary or Credit stop codes. 7) VSE-6159: VistA: Modify SDES2 EDIT CLINIC to only accept active stop codes. Problem: Need to update SDES2 EDIT CLINIC RPC to only accept active stop codes. Resolution: The Primary and Credit stop code validators were updated to only allow for active Primary or Credit stop codes. Test Sites: ----------- Altoona, PA (ALT) 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_47_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_47_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.47.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_47_1_P.MSI Binary VS GUI R1.7.47.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_47_1_T.MSI Binary VS GUI R1.7.47.1 VDD VS_GUI_1_7_47_1 VDD Binary VS GUI R1.7.47.1 DIBR VS_GUI_1_7_47_1 DIBR Binary VS GUI R1.7.47.1 Release Notes VS_GUI_1_7_47_1 RN Binary VS GUI R1.7.47.1 Technical Manual VS_GUI_1_7_47_1 TM Binary VS GUI R1.7.47.1 User Guide Addendum VS_GUI_1_7_47_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 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 SDES857P 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*857. 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*857. 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 SDES857P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES857P 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*857b. 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*857b 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.46. If 1.7.47.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.46.0. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 14 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDES2CLINUT Before:B133398915 After:B133417975 **853,857** Routine Name: SDES2EDITCLIN Before:B118566462 After:B123780361 **853,857** Routine Name: SDES2UTIL Before:B102836187 After:B110206423 **853,857** Routine Name: SDES2VAL44 Before:B180079487 After:B184760439 **853,857** Routine Name: SDES2VAL44A Before: B8128660 After: B8859350 **853,857** Routine Name: SDES2VALCRTCLIN1 Before: B44435746 After: B43502982 **853,857** Routine Name: SDES857P Before: n/a After: B2543656 **857** Routine Name: SDESCLINICSET Before:B217550860 After:B217554625 **799,805,820,824,825,831,835, 836,857** Routine Name: SDESGETCONSULTS Before: B51190596 After: B51190610 **815,820,824,837,842,847,857** Routine list of preceding patches: 836, 847, 853 ============================================================================= User Information: Entered By : Date Entered : JUL 25, 2023 Completed By: Date Completed: OCT 17, 2023 Released By : Date Released : OCT 17, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT