$TXT Created by CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Friday, 07/28/23 at 10:37 ============================================================================= Run Date: AUG 29, 2023 Designation: SD*5.3*851 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #706 Status: Released Compliance Date: SEP 13, 2023 ============================================================================= Associated patches: (v)SD*5.3*832 <<= must be installed BEFORE `SD*5.3*851' (v)SD*5.3*847 <<= must be installed BEFORE `SD*5.3*851' Subject: VS GUI VERSION 1.7.45.0 Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.45.0 includes the following defect corrections and enhancements: A variable wasn't be newed and was leaking in the SDES DISPLAY CONTACT which was causing the contacts attempts to be returned on the wrong appointment request. The SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST RPCs were updated to include the clinic status in their returned JSON object. The following RPC were updated to return the PID CHANGE ALLOWED field (#49) from the SDEC APPT REQUEST file (#409.85). SDES GET APPTREQ BY INST SDES GET APPT REQ BY IEN SDES GET APPT REQ BY PAT ALL SDES GET APPT REQ BY PAT OPEN SDES GET APPT REQ LIST BY DFN SDES GET APPT REQS BY IENS The SDES SEARCH CLINIC ATTRIBUTES RPC was updated to return the clinic abbreviation field (#1) and the PROVIDER subfield (#.01) from the PROVIDER multiple (#44.1) in the HOSPITAL LOCATION file (#44). The Resource Status was backwards and has now been updated to return the following: Status = 1:"INACTIVE", otherwise the RPC will return 0. The logic associated with cancelling an appointment was updated to prevent storing the PID in the PID field (#1) of the SDEC CONSULT PID HISTORY file (#409.87). The VS GUI was updated to prevent the user from being able to edit the PID for the Edit Request when the prior appt was canceled by patient or no-showed. On the Cancellation screen the user selects canceled by patient, the PID field is inactivated to prevent editing. On the Create appointment screen if prior appointment was canceled by patient or no-showed, the PID field is inactivated to prevent editing. The VS GUI provides a report of the first 200 veteran requests. Many/most sites have more than this. The patient comments in the VistA Open Veteran Request reports wraps in almost every case, and there is not programmatic way to prevent this other than limiting the character counts, which is not doable. The solution proposed by the business office is to remove the patient comments column from the report. Also, determine why the PID field on this report is coming back blank for so many requests in production. The appointment slot calculation logic in the SDES CANCEL APPOINTMENT2 and SDES CREATE APPOINTMENTS RPCs was updated to the SDES* coding standards. The Patient Info screen in the VS GUI was updated to change the "Permanent Address" label to "Mailing Address". The logic to review the patient appointment in the SDES GET APPTS BY PATIENT DFN3 RPC was updated to prevent null subscript errors. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.45.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.45.0 and VistA patch * * SD*5.3*851 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 ------------------ ---------- -------------------- N/A 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 ----------- ---- -------------------- N/A Protocols Associated: --------------------- Protocol Name New/Modified/Deleted ------------- -------------------- N/A 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 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 BY TYPE VET Modified SDES GET APPT REQ LIST BY DFN Modified SDES GET APPT REQS BY IENS Modified SDES GET APPT REQS BY IENS2 Modified SDES GET CLINIC INFO2 Modified SDES GET CLINICS BY CLIN LIST Modified SDES GET CONSULTS BY DFN Modified SDES GET CONSULTS BY IEN Modified SDES SEARCH CLINIC ATTRIBUTES Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1. VSE-5491: VistA: Contact attempts are being returned for incorrect appointment request. Problem: The Acheron team identified an issue where Contact Attempts are being returned for an incorrect Appointment Request. Resolution: A variable wasn't be newed and was leaking in the SDES DISPLAY CONTACT which was causing the contacts attempts to be returned on the wrong appointment request. 2. VSE-5545: VistA: Modify SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST to return clinic status. Problem: Need to modify SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST to return clinic status. Resolution: The SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST RPCs were updated to include the clinic status in their returned JSON object. 3. VSE-5565: VistA: Modify SDES GET APPT REQ RPCs to return PID CHANGE ALLOWED (#49) field value. Problem: Need to update all SDES GET APPT REQ* RPCs to return the PID CHANGE ALLOWED field (#49) from the SDEC APPT REQUEST file (#409.85). Resolution: The following RPC were updated to return the PID CHANGE ALLOWED field (#49) from the SDEC APPT REQUEST file (#409.85). SDES GET APPTREQ BY INST SDES GET APPT REQ BY IEN SDES GET APPT REQ BY PAT ALL SDES GET APPT REQ BY PAT OPEN SDES GET APPT REQ LIST BY DFN SDES GET APPT REQS BY IENS 4. VSE-5670: VistA: Modify SDES SEARCH CLINIC ATTRIBUTES to return clinic abbreviation and array of provider names. Problem: Requesting two changes to the SDES SEARCH CLINIC ATTRIBUTES RPC: 1. Return the clinic abbreviation field (#1) from the HOSPITAL LOCATION file (#44). 2. Return the array of PROVIDER subfield (#.01) from the PROVIDER multiple (#44.1) in the HOSPITAL LOCATION file (#44). Resolution: The SDES SEARCH CLINIC ATTRIBUTES RPC was updated to return the clinic abbreviation field (#1) and the PROVIDER subfield (#.01) from the PROVIDER multiple (#44.1) in the HOSPITAL LOCATION file (#44). 5. VSE-5736: VistA: Update SDES SEARCH CLINIC to return correct Resource Status. Problem: The SDES SEARCH CLINIC RPC is returning the incorrect value for the Resource Status. Resolution: The Resource Status was backwards and has now been updated to return the following: Status = 1:"INACTIVE", otherwise the RPC will return 0. 6. VSE-5770: VistA: Do not allow the PID to be edited in VistA and VSE GUI for a consult or procedure. Problem: Do not allow entries to be stored in the CONSULT PID HISTORY file (#409.87). Resolution: The logic associated with cancelling an appointment was updated to prevent storing the PID in the PID field (#1) of the SDEC CONSULT PID HISTORY file (#409.87). 7. VSE-5771: GUI: Do not allow editing of PID for consults or procedures. Problem: The VS GUI should not allow editing of the PID for consults or procedures. This includes removing the ability to edit in the following scenarios: 1. Edit Request (if prior appt was canceled by patient or no-showed). 2. Cancellation screen (if canceled by patient is selected, PID field should NOT be editable). 3. Create appointment screen (if prior appointment was canceled by patient or no-showed, PID should NOT be editable). Resolution: The VS GUI was updated to prevent the user from being able to edit the PID for the Edit Request when the prior appt was canceled by patient or no-showed. On the Cancellation screen the user selects canceled by patient, the PID field is inactivated to prevent editing. On the Create appointment screen if prior appointment was canceled by patient or no-showed, the PID field is inactivated to prevent editing. 8. VSE-5775: VistA: Modify VistA open Veteran requests report to remove Patient Comments column. Problem: The VS GUI provides a report of the first 200 veteran requests. Many/most sites have more than this. The patient comments in the VistA Open Veteran Request reports wraps in almost every case, and there is not programmatic way to prevent this other than limiting the character counts, which is not doable. The solution proposed by the business office is to remove the patient comments column from the report. Also, determine why the PID field on this report is coming back blank for so many requests in production. Resolution: The patient comments column was removed from the VistA Open Veteran Requests report. In addition, a logic flaw was identified and remedied to prevent the PID from coming back blank. 9. VSE-5818: VistA: Update the slot logic within SDES CANCEL APPOINTMENT2 and SDES CREATE APPOINTMENTS RPCs. Problem: Need to update appointment slot calculation logic in the SDES CANCEL APPOINTMENT2 and SDES CREATE APPOINTMENTS RPCs to the follow the current SDES* coding standards. Resolution: The appointment slot calculation logic in the SDES CANCEL APPOINTMENT2 and SDES CREATE APPOINTMENTS RPCs was updated to the SDES* coding standards. 10. VSE-5891: UI: Update Permanent Address Label to Mailing Address. Problem: Need to change the label of "Permanent Address" to "Mailing Address" on the Patient Info screen in the VS GUI. Resolution: The Patient Info screen in the VS GUI was updated to change the "Permanent Address" label to "Mailing Address". 11. VSE-5896: VistA: SDES GET APPTS BY PATIENT DFN3 is giving errors. Problem: Need to fix the subscript error being reported in the SDES GET APPTS BY PATIENT DFN3 RPC. Resolution: The logic to review the patient appointment in the SDES GET APPTS BY PATIENT DFN3 RPC was updated to prevent null subscript errors. Test Sites: ----------- Altoona, PA (ALT) Columbia, SC (CMS) 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_45_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_45_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.45.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_45_0_P.MSI Binary VS GUI R1.7.45.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_45_0_T.MSI Binary VS GUI R1.7.45.0 VDD VS_GUI_1_7_45_0 VDD Binary VS GUI R1.7.45.0 DIBR VS_GUI_1_7_45_0 DIBR Binary VS GUI R1.7.45.0 Release Notes VS_GUI_1_7_45_0 RN Binary VS GUI R1.7.45.0 Technical Manual VS_GUI_1_7_45_0 TM Binary VS GUI R1.7.45.0 User Guide Addendum VS_GUI_1_7_45_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 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 Phone: 772-646-2303 Email: jack.stevens1@domain.ext Pre/Post Installation Overview: ------------------------------- Routine SDES851P 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 highly 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*851. 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*851. 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 SDES851P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES851P 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*851b. 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*851b 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.44. If 1.7.45.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.44.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: SDEC07 Before:B183859950 After:B183774663 **627,642,651,658,665,669,671, 672,701,686,740,694,785,788, 790,799,801,805,816,819,842, 843,847,851** Routine Name: SDEC08 Before:B207956203 After:B199606428 **627,651,658,665,722,740,744, 694,745,756,774,781,785,790, 792,796,797,799,801,805,819, 842,832,851** Routine Name: SDES01C Before: B23276788 After: B23244718 **790,807,836,837,851** Routine Name: SDES851P Before: n/a After: B2543372 **851** Routine Name: SDESCANAPPT2 Before:B213646737 After:B201664073 **838,842,844,845,847,851** Routine Name: SDESCLNSEARCH Before: B25451549 After: B36405435 **824,851** Routine Name: SDESCONTACTS Before:B159734713 After:B159891123 **835,837,845,851** Routine Name: SDESCREATEAPPT Before: B86207416 After: B88260579 **814,823,826,827,828,842,843, 846,847,851** Routine Name: SDESCREATEAPPT44 Before: B18019542 After: B48844732 **814,823,827,851** Routine Name: SDESGETAPPTREQ Before:B214063953 After:B216293125 **815,818,819,823,824,825,828, 831,833,837,838,839,845,847, 851** Routine Name: SDESGETAPPTWRAP5 Before:B143260090 After:B144218344 **823,824,825,838,851** Routine Name: SDESGETREQWRAPPR Before: B96075459 After: B97520190 **815,818,820,823,825,831,838, 842,843,847,851** Routine Name: SDESOPENVETREQS Before: B21477220 After: B21666622 **843,851** Routine Name: SDESRTVCLN2 Before:B117996215 After:B121865898 **823,825,827,828,833,836,851** Routine Name: SDESUTIL Before: B85240213 After:B128906984 **801,804,805,814,816,818,820, 823,824,825,831,836,838,845, 851** Routine list of preceding patches: 832, 847 ============================================================================= User Information: Entered By : Date Entered : MAY 19, 2023 Completed By: Date Completed: AUG 29, 2023 Released By : Date Released : AUG 29, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT