$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Wednesday, 06/07/23 at 14:10 ============================================================================= Run Date: JUL 05, 2023 Designation: SD*5.3*845 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #702 Status: Released Compliance Date: JUL 18, 2023 ============================================================================= Associated patches: (v)SD*5.3*562 <<= must be installed BEFORE `SD*5.3*845' (v)SD*5.3*756 <<= must be installed BEFORE `SD*5.3*845' (v)SD*5.3*827 <<= must be installed BEFORE `SD*5.3*845' (v)SD*5.3*839 <<= must be installed BEFORE `SD*5.3*845' (v)SD*5.3*844 <<= must be installed BEFORE `SD*5.3*845' Subject: VS GUI VERSION 1.7.43.0 Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.43.0 includes several defect corrections and enhancements including the creation of the new SDES GET APPT REQS BY IENS2 which has its JavaScript Object Notation (JSON) object to be indexed by an integer, that contains each request array. Errors are now returned in an array of error strings like the other SDES* RPCs. The SCRPW3 routine was updated to include an additional input parameter for the appointment sub-file. Several RPCs were updated to include additional clinic data in their returned JSON objects. The SDES SEARCH RECALL PROVIDERS RPC was updated to return the RECALL REMINDERS PROVIDERS (#403.54) IEN in a new field in its JSON return. The SDES DISPLAY CONTACT and SDES ADD/UPDATE CONTACT RPCs were updated to have the CONTACT("CLINIC") input variable as optional. The SYSTEM USE ONLY (#6) field was added to the CANCELLATION REASONS (#409.2) file and the existing cancellation reasons were updated to populate this field based on input from the Business Office. The SDEC CANREAS and SDES GET CANCEL REASONS RPCs were modified to return the new SYSTEM USE ONLY (#6) field. The VS GUI was updated to read the new SYSTEM USE ONLY (#6) field to determine whether to display the cancellation reason. The SDES EDIT APPT REQ RPC was updated to accept an Automated Medical Information System (AMIS) stop code but to store the Internal Entry Number (IEN) for the AMIS stop code in the SDEC APPT REQUEST (#409.85) file. The logic supporting the SDES GET MISSION ACT ELIG RPC was updated to not return an error when the Patient Indicated Date (PID) is outside of the Wait Time Standard (WTS). The new SDES CREATE SPEC NEEDS PREFS RPC will create special needs and preferences for a given patient. The new SDES EDIT SPEC NEEDS PREFS will edit special needs and preferences for a given patient. The VS GUI was updated so that after switching patients all subsequent RPC calls utilize the Patient Name to determine the info needed to populate the Request Management (RM) grid. The supporting logic for the SDES CANCEL APPOINTMENT 2 RPC was updated to re-open the Parent PRTC if the cancellation reason allows the reopening of the child request. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.43.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.43.0 and VistA patch * * SD*5.3*845 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 ------------------ ---------- -------------------- CANCELLATION REASONS SYSTEM USE ONLY New (#409.2) (#6) 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 ------------- ----------------------- -------------------- N/A Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC CANREAS Modified SDES ADD/UPDATE CONTACT New SDES CREATE SPEC NEEDS PREFS New SDES DISPLAY CONTACT New SDES EDIT SPEC NEEDS PREFS New 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 TYPE VET Modified SDES GET APPT REQ LIST BY DFN Modified SDES GET APPT REQS BY IENS2 New SDES GET CANCEL REASONS Modified SDES GET RECALL BY IEN Modified SDES GET RECALLS BY DFN Modified SDES SEARCH RECALL PROVIDERS Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-5111: VistA - Modify SDES GET APPT REQS BY IENS to normalize responses. Problem: Need to create a new RPC based on the SDES GET APPT REQS BY IENS to normalize responses. Resolution: The SDES GET APPT REQS BY IENS2 was created and the JSON return was updated to be indexed by an integer, that contains each request array. Errors are now returned in an array of error strings like the other SDES* RPCs. 2) VSE-5162: VistA - Modify SCRPW3 routine to use an additional variable when searching the patient file, appointment sub-file. Problem: When running the Clinical Utilization Statistical Summary (CUSS) Report, users are receiving errors. Need to modify SCRPW3 routine to use an additional variable when searching the patient file, appointment sub-file. Resolution: The SCRPW3 routine was updated to include an additional input parameter for the appointment sub-file. 3) VSE-5256: VistA - Return additional clinic data for SDES GET APPT REQ* RPCs. Problem: Requesting that the following RPCs be updated to return additional clinic data for SDEC APPT REQUEST (#409.85) resources when the request has an associated clinic. SDES GET APPT REQ BY PAT ALL SDES GET APPT REQ BY PAT OPEN SDES GET APPT REQ BY IEN SDES GET APPT REQS BY IENS SDES GET APPT REQ BY TYPE VET SDES GET APPT REQ LIST BY DFN SDES GET RECALL BY IEN SDES GET RECALLS BY DFN Resolution: Summary of Changes: 1. Return the #44,62 DISPLAY CLIN APPT TO PATIENTS? field in the Request object for 409.85 requests with a clinic reference. 2. Return the #44,62 DISPLAY CLIN APPT TO PATIENTS? field in the Request object for 403.5 recall reminders. 3. Return the AMIS number (#40.7,1) of the #44,8 STOP CODE NUMBER field for 403.5 recall reminders (SDES GET RECALLS BY IEN and SDES GET RECALLS BY DFN are returning Secondary Stop Code which is pointed to Credit Stop Code field in file 44). 4. Return the AMIS number (#40.7,1) of the #44,2503 CREDIT STOP CODE NUMBER field for 403.5 recall reminders (SDES GET RECALLS BY IEN and SDES GET RECALLS BY DFN are returning Secondary Stop Code which is pointed to Credit Stop Code field in file 44). 5. Return the #44,62 DISPLAY CLIN APPT TO PATIENTS? field in the Request object for 409.85 requests with a clinic reference. 6. Return the #44,62 DISPLAY CLIN APPT TO PATIENTS? field in the Request object for 403.5 recall reminders. Resolution: The requested RPCs were updated to include the additional information in their returned JSON objects. 4) VSE-5264: VistA - Modify SDES SEARCH RECALL PROVIDERS to add the #403.54 IEN to the return. Problem: Need to modify SDES SEARCH RECALL PROVIDERS to add the RECALL REMINDERS PROVIDERS (#403.54) IEN in another field in the return. The #200 IEN should continue to be returned in the IEN field. Resolution: The SDES SEARCH RECALL PROVIDERS RPC was updated to return the RECALL REMINDERS PROVIDERS (#403.54) IEN a new field in its JSON return. 5) VSE-5324: VistA - Modify/New Version SDES CONTACT ADD/UPDATE to not require a Clinic. Problem: Veteran appointment requests generated by VAOS do not normally have a clinic associated with them. Need to update the SDES DISPLAY CONTACT and SDES ADD/UPDATE CONTACT RPCs to not return an error when the CONTACT("CLINIC") input variable is pass in as a null. Resolution: The SDES DISPLAY CONTACT and SDES ADD/UPDATE CONTACT RPCs were updated to have the CONTACT("CLINIC") input variable as optional. 6) VSE-5375: VistA - Modify: Can we modify the cancellation reason file without negative impact on others. Problem: Need to modify the cancellation reason file to add a "System Use Only" flag that the UI will read to determine if the cancellation reason should be displayed in the UI. Resolution: The SYSTEM USE ONLY (#6) field was added to the CANCELLATION REASONS (#409.2) file. In addition, the following cancellation reasons were updated to have the new AUTOMATED CANCELLATION (#6) field set to 1/yes: AUTOMATED CANCELLATION BLOCK AND MOVE DO NOT RESCHEDULE RESCHEDULE - CALL BACK RESCHEDULE - VET WILL CALL 7) VSE-5376: UI - Read new "System Use Only" flag to determine which cancellation reasons should be displayed in the UI. Problem: The UI will need to be updated to read the new SYSTEM USE ONLY (#6) field to determine whether to display the cancellation reason. Resolution: The UI was updated to read the new SYSTEM USE ONLY (#6) field to determine whether to display the cancellation reason. 8) VSE-5396: VistA - Issue with SDES EDIT APPT REQ. Problem: The SDES EDIT APPT REQ RPC correctly accepts the stop code as an AMIS stop code. However, when it is persisted it appears that the AMIS stop code is being used as the pointer instead of the IEN. This is leading to us getting the incorrect stop code returned on SDES GET APPT REQ BY IEN. Resolution: The SDES EDIT APPT REQ RPC was updated to accept an AMIS stop code but to store the Internal Entry Number (IEN) for the AMIS stop code in the SDEC APPT REQUEST (#409.85) file. 9) VSE-5423: VS GUI - Wrong Provider Info Displayed on PCI. Problem: The VS GUI logic needs to send the provider from the clinic NOT the provider from the Consult when a consult appointment is being made. Therefore, the wrong Provider is being displayed in PCI. Resolution: The VS GUI was updated to send the provider from the clinic and not the provider from the Consult when a consult appointment is being made 10) VSE-5431: VistA - Update SDES GET MISSION ACT ELIG to not return error message if Patient Indicated Date (PID) is outside the Wait Time Standard (WTS). Problem: Need to update SDES GET MISSION ACT ELIG to not return an error message if the PID is outside of the WTS. Resolution: The logic supporting the SDES GET MISSION ACT ELIG RPC was updated to not return an error when the PID is outside of the WTS. 11) VSE-5432: VistA - Create SDES RPC for Creating Special Needs and Preferences. Problem: Need to create RPC for Creating Special Needs and Preferences. Resolution: The new SDES CREATE SPEC NEEDS PREFS RPC will create special needs and preferences for a given patient. 12) VSE-5433: VistA - Create RPC for Editing Special Needs and Preferences. Problem: Need to create RPC for Editing Special Needs and Preferences. Resolution: The new SDES EDIT SPEC NEEDS PREFS will edit special needs and preferences for a given patient. 13) VSE-5438: UI: VS GUI RTCs are Reappearing in RM Grid After being scheduled. Problem: When a patient schedules an RTC and then goes to check in a different patient, and then returns to the original patient, the RTC reappears in the RM Grid. Resolution: The VS GUI was updated so that after switching patients all subsequent RPC calls utilize the Patient Name to determine the info needed to populate the RM Grid. 14) VSE-5656: VistA - When SDES CANCEL APPOINTMENT 2 RPC is called, Parent MRTC request is Closed and does not return to RM Grid. Problem: When the SDES CANCEL APPOINTMENT 2 RPC is called, Parent MRTC request is Closed and does not return to RM Grid. Resolution: The supporting logic for the SDES CANCEL APPOINTMENT 2 RPC was updated to re-open the Parent PRTC if the cancellation reason allows the reopening of the child request. Test Sites: ----------- Amarillo, TX (AMA) Hines, IL (HIN) 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_43_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_43_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.43.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_43_0_P.MSI Binary VS GUI R1.7.43.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_43_0_T.MSI Binary VS GUI R1.7.43.0 VDD VS_GUI_1_7_43_0 VDD Binary VS GUI R1.7.43.0 DIBR VS_GUI_1_7_43_0 DIBR Binary VS GUI R1.7.43.0 Release Notes VS_GUI_1_7_43_0 RN Binary VS GUI R1.7.43.0 Technical Manual VS_GUI_1_7_43_0 TM 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 SDES845P 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*845. 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*845. 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 SDES845P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES845P 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*844b. 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*845b 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.42. If 1.7.43.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.42.0. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;AUG 13, 1993;Build 8 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SCRPW3 Before: B55550828 After: B55602608 **139,144,184,194,540,562,845** Routine Name: SDEC45 Before:B155963257 After:B157388499 **627,642,658,756,845** Routine Name: SDES845P Before: n/a After: B7698186 **845** Routine Name: SDESCANAPPT2 Before: B90192387 After: B95139364 **838,842,844,845** Routine Name: SDESCANCELRSNS Before: B7573346 After: B8385911 **836,845** Routine Name: SDESCONTACTS Before:B160605728 After:B159734713 **835,837,845** Routine Name: SDESCRTNEEDPREFS Before: n/a After: B17540638 **845** Routine Name: SDESEDITAPPTREQ Before:B193199363 After:B193404610 **823,826,837,845** Routine Name: SDESEDITNEEDPREF Before: n/a After: B15591095 **845** Routine Name: SDESGETAPPTREQ Before:B227983710 After:B228384089 **815,818,819,823,824,825,828, 831,833,837,838,839,845** Routine Name: SDESGETRECALL Before: B36877334 After: B38008031 **803,805,809,813,815,820,824, 837,842,845** Routine Name: SDESGREQSIENS Before: n/a After: B3471044 **845** Routine Name: SDESMISSIONELG Before:B146838735 After:B147043364 **814,815,818,820,826,835,842, 844,845** Routine Name: SDESRECPROVSRCH Before: B32100073 After: B32393019 **823,827,845** Routine Name: SDESUTIL Before: B69081510 After: B85240213 **801,804,805,814,816,818,820, 823,824,825,831,836,838,845** Routine list of preceding patches: 562, 756, 827, 839, 844 ============================================================================= User Information: Entered By : Date Entered : MAR 27, 2023 Completed By: Date Completed: JUL 05, 2023 Released By : Date Released : JUL 05, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT