$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Wednesday, 05/22/24 at 11:52 ============================================================================= Run Date: JUN 26, 2024 Designation: SD*5.3*878 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #728 Status: Released Compliance Date: JUL 10, 2024 ============================================================================= Associated patches: (v)SD*5.3*867 <<= must be installed BEFORE `SD*5.3*878' (v)SD*5.3*877 <<= must be installed BEFORE `SD*5.3*878' Subject: VS GUI VERSION 1.7.56.1 Category: - Routine - Data Dictionary - Enhancement (Mandatory) Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.56.1 and patch SD*5.3*878 includes several defect corrections and enhancements including: The SDES2CONTACTS routine that supports the SDES2 GET CONTACT ATTEMPT RPC was modified to correctly specify RESULT as the output name for the JSON object to be returned from build JSON process. The SDES2 GET EXPANDED ENTRY 2 RPC was updated to return the IsClassificationActive value in the JSON object with values of either Yes, No or Not Applicable. The SDESUTIL routine was updated to include additional logic to check the INACTIVE DATE field (#2) in the CLINIC STOP file (#40.7) when determining the status of an AMIS Stop Codes. The logic from several older SDEC* routines were migrated into the SDES2* Namespace and brought up to current coding standards to support the retirement Of the VS GUI. The existing SDES2CHECKIN was updated to utilize this new code. The new SDES2APPTUTIL routine was created and includes the logic from the REQSET^SDEC07A. This is for the preparation to shut down the VS GUI. The SDES2QRYAPREQSB routine was updated to prevent a subscript error when sorting. A copy of the SD PURGE menu option from a GOLD account was created and the SD PURGE option will be deleted when the SD*5.3*878 patch is installed. SD PURGE will be removed from the SDSUP menu option. The new SDES2 GET APPT REQ BY TYP VET RPC returns up to 200 veteran appointment requests and includes a sensitive record flag in its JSON object. The new SDES2 GET APPT REQ BY TYP VET RPC returns up to 200 veteran appointment requests. The SDES2 CREATE CONTACT ATTEMPT and SDES2 GET CONTACT ATTEMPTS RPCs were updated to not pass in the clinic IEN when determine the date/time which will return the system time without the possible time offset associated with the clinic. The SDES2 CANCEL APPOINTMENT RPC was updated to correctly update recall request pointers. The Privileged User validation was updated skip the check for active user when the Privileged User is being deleted from a clinic. The SDES2 EDIT PAT DEMOGRAPHIC RPC was updated to allow for the adding of an ethnicity when the patient currently doesn't have an ethnicity defined. The SDES2 GET DEMOGRAPHICS RPC was updated to only send active race and ethnicity values. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.56.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.56.1 and VistA patch * * SD*5.3*878 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 SD PURGE Run Routine 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 --------------------- -------------------- SDES2 GET APPT REQ BY TYP VET New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-7631: VistA: Modify SDES2 GET CONTACT ATTEMPT RPC to correct an issue with the error return. Problem: As a MUMPs developer I want to modify SDES2 GET CONTACT ATTEMPT RPC to correct an issue with the error return. Currently when the USER DUZ is invalid the return returns back blank because the return says RESULTS instead of RESULT. Resolution: The SDES2CONTACTS routine that supports the SDES2 GET CONTACT ATTEMPT RPC was modified to correctly specify RESULT as the output name for the JSON object to be returned from build JSON process. 2) VSE-7648: VistA: Modify SDES2 GET EXPANDED ENTRY 2 to return Yes/No/NA for IsClassificationActive. Problem: As a MUMPS developer I want to modify SDES2 GET EXPANDED ENTRY 2 to return Yes/No/NA for the IsClassificationActive return parameter. Resolution: The SDES2 GET EXPANDED ENTRY 2 RPC was updated to return the IsClassificationActive value in the JSON object with values of either Yes, No or Not Applicable. 3) VSE-7666: VistA: Modify SDESUTIL to recognize that there may be times when there are both active and inactive AMIS stop codes. Problem: As a MUMPS developer I want to modify AMIS stop code logic to recognize that there may be times when there is an inactive stop code associated with the same AMIS code as an active stop code. This affects SDESUTIL. I want to identify all of the calling routines and the test scenarios. Resolution: The SDESUTIL routine was updated to include additional logic to check the INACTIVE DATE field (#2) in the CLINIC STOP file (#40.7) when determining the status of an AMIS Stop Codes. 4) VSE-7680: VistA: Create 2 new routines in the SDES2 namespace to assist with the VS GUI retirement. Problem: As a MUMPS developer I want to create 2 new routines in the SDES2 namespace: 1. SDECALV and SDECALV1 2. SDECAPI and SDECAPI4 Resolution: The logic from several older SDEC* routines were migrated into the SDES2* Namespace and brought up to current coding standards to support the retirement Of the VS GUI. The existing SDES2CHECKIN was updated to utilize this new code. 5) VSE-7692: [11:28 AM] Barber, Lori A. (Booz Allen Hamilton)VistA: Create an SDES2 version of the REQSET tag line from SDEC07A. Problem: As a MUMPS developer I want to modify SDEC07A routine to correct the logic around consults and update the code to SDES Standards. Resolution: The new SDES2APPTUTIL routine was created and includes the logic from the REQSET^SDEC07A. This is for the preparation to shut down the VS GUI. 6) VSE-7712: VistA: Fix an issue with the query tool. Problem: As a MUMPS developer I want to fix a subscript error with the query tool that occurs at SETDATA+21^SDES2QRYAPREQSB when sorting. Resolution: The SDES2QRYAPREQSB routine was updated to prevent a subscript error when sorting. 7) VSE-7739: VistA: Backup SD PURGE menu option and then remove it form the menu. Problem: As a MUMPS developer I want to make a backup of the SD PURGE menu option and once complete, remove the SD PURGE menu option from the menu. Resolution: A copy of the SD PURGE menu option from a GOLD account was created and the SD PURGE option will be deleted when the SD*5.3*878 patch is installed. SD PURGE will be removed from the SDSUP menu option. 8) VSE-7862: VistA: Rewrite SDES GET APPT REQ BY TYPE VET into the SDES2 namespace. Problem: As a MUMPS developer I want to rewrite SDES GET APPT REQ BY TYPE VET into the SDES2 namespace. I also want to add the sensitive record flag to the return so that the veteran report can obfuscate sensitive data. Resolution: The new SDES2 GET APPT REQ BY TYP VET RPC returns up to 200 veteran appointment requests and includes a sensitive record flag in its JSON object. 9) VSE-7862: VistA: Rewrite SDES GET APPT REQ BY TYPE VET into the SDES2 namespace. Problem: As a MUMPS developer I want to rewrite SDES GET APPT REQ BY TYPE VET into the SDES2 namespace. I also want to add the sensitive record flag to the return so that the veteran report can obfuscate sensitive data. Resolution: The new SDES2 GET APPT REQ BY TYP VET RPC returns up to 200 veteran appointment requests. 10) VSE-7867: VistA: Modify SDES2 ADD CONTACT ATTEMPT and SDES2 GET CONTACT ATTEMPTS so that date time entered is in system time. Problem: As a MUMPS developer I want to Modify SDES2 CREATE CONTACT ATTEMPT and SDES2 GET CONTACT ATTEMPTS so that date time entered is in system time not clinic based. When the date time is entered the DATE/TIME ENTERED should be stored in system time and when it is displayed it should be displayed in system time. Resolution: The SDES2 CREATE CONTACT ATTEMPT and SDES2 GET CONTACT ATTEMPTS RPCs were updated to not pass in the clinic IEN when determine the date/time which will return the system time without the possible time offset associated with the clinic. 11) VSE-7869: LB - VistA: Modify SDES2 CANCEL APPOINTMENT RPC to correctly update recall request pointers. Problem: As a MUMPS developer I want to Modify SDES2 CANCEL APPOINTMENT RPC to correctly update the recall request pointers. Resolution: The SDES2 CANCEL APPOINTMENT RPC was updated to correctly update recall request pointers. 12) VSE-7876: MD - VistA: Update the Privileged User validation in routine SDES2VAL44A. Problem: As a MUMPS developer I want to update the Privileged User validation in routine SDES2VAL44A to include the privileged user's IEN to load and then check the action for the user. Resolution: The Privileged User validation was updated skip the check for active user when the Privileged User is being deleted from a clinic. 13) VSE-7900: VistA: SDES2 EDIT PAT DEMOGRAPHIC RPC is not updating ethnicity. Problem: As a MUMPS developer I want to modify the SDES2 EDIT PAT DEMOGRAPHICS RPC to update ethnicity logic so then when the patient does not have a current ethnicity one can be added. Resolution: The SDES2 EDIT PAT DEMOGRAPHIC RPC was updated to allow for the adding of an ethnicity when the patient currently doesn't have an ethnicity defined. 14) VSE-7943: VistA: Modify SDES2 GET DEMOGRAPHICS to only send active race and ethnicity values. Problem: As a MUMPS developer I want to Modify SDES2 GET DEMOGRAPHICS to only send active race and ethnicity values. Resolution: The SDES2 GET DEMOGRAPHICS RPC was updated to only send active race and ethnicity values. Test Sites: ----------- Bay Pines, FL (BAY) 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_56_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_56_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.56.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_56_1_P.MSI Binary VS GUI R1.7.56.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_56_1_T.MSI Binary VS GUI R1.7.56.1 VDD VS_GUI_1_7_56_1 VDD Binary VS GUI R1.7.56.1 DIBR VS_GUI_1_7_56_1 DIBR Binary VS GUI R1.7.56.1 Release Notes VS_GUI_1_7_56_1 RN Binary VS GUI R1.7.56.1 Technical Manual VS_GUI_1_7_56_1 TM Binary VS GUI R1.7.56.1 User Guide Addendum VS_GUI_1_7_56_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) 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 SDES878P 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*878. 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*878. 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 SDES878P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES878P 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*878b. 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*878b 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.55. If 1.7.56.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.55.0. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 11 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDES2APPTUTIL Before:B119908973 After:B130216706 **866,871,875,877,878** Routine Name: SDES2CANCELAPPT Before:B201603339 After:B201603433 **869,871,873,875,877,878** Routine Name: SDES2CHECKIN Before: B35666783 After: B35740589 **866,878** Routine Name: SDES2CONTACTS Before: B87484941 After: B87033509 **860,873,878** Routine Name: SDES2CRTVISIT Before: n/a After: B61343722 **878** Routine Name: SDES2EDITPATDEMO Before: B11704942 After: B16749220 **877,878** Routine Name: SDES2GETAPPTREQ Before:B154793981 After:B160768573 **873,877,878** Routine Name: SDES2GETDEMOS Before: B5966176 After: B6739043 **877,878** Routine Name: SDES2GETVISIT Before: n/a After:B189851343 **878** Routine Name: SDES2GETXPENTRY2 Before: B37622894 After: B37840134 **867,878** Routine Name: SDES2QRYAPREQSB Before: B47043527 After: B47771247 **869,873,875,877,878** Routine Name: SDES2VAL44A Before: B8865445 After: B8926105 **853,857,869,878** Routine Name: SDES878P Before: n/a After: B2543676 **878** Routine Name: SDESUTIL Before:B129453912 After:B135181872 **801,804,805,814,816,818,820, 823,824,825,831,836,838,845, 851,877,878** Routine list of preceding patches: 867, 877 ============================================================================= User Information: Entered By : Date Entered : MAR 06, 2024 Completed By: Date Completed: JUN 26, 2024 Released By : Date Released : JUN 26, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT