$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Friday, 01/06/23 at 12:03 ============================================================================= Run Date: JAN 31, 2023 Designation: SD*5.3*833 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #687 Status: Released Compliance Date: FEB 13, 2023 ============================================================================= Associated patches: (v)SD*5.3*820 <<= must be installed BEFORE `SD*5.3*833' (v)SD*5.3*826 <<= must be installed BEFORE `SD*5.3*833' (v)SD*5.3*831 <<= must be installed BEFORE `SD*5.3*833' Subject: VS GUI VERSION 1.7.36.0 Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.36.0 and SD*5.3*833 includes several defect corrections and enhancements including the creation of the new SDES PATIENT SEARCH Remote Procedure Call (RPC) which returns a JavaScript Object Notation (JSON) object and was added to the SDESRPC option. Older outdated RPCs were deleted now that they have newer, more updated RPCs to replace them. The VS GUI and corresponding Veterans Health Information Systems and Technology Architecture (VistA) routines were updated to correct the indexing of the list of Multiple Return To Clinics (MRTCs). The Video Visit Service (VVS) and Video Visit Clinic (VVC) related RPCs were updated to return their data in JSON format. The SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST RPCs were updated to include the TIMEZONE EXCEPTION (#802) field from the INSTITUTION (#4) file in their return JSON Object. The VS GUI was updated to handle patient searches where the gender field is empty without causing a hard error. The SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST RPCs were updated to return both the Internal Entry Number (IEN) and the AMIS REPORTING STOP CODE (#1) fields for both the Primary and Credit Stop codes associated with a clinic. The SDES CREATE APPT REQ RPC logic was updated to prevent errors when setting the priority to FUTURE. The SDES GET APPT REQ BY TYPE VET RPC was created to only return appointment requests of sub-type "VETERAN" in a JSON object. The SDESGETAPPTREQ routine was updated to properly handle appointments that have contact attempts without a contact type. The SDESCLNSETAVAIL routine was updated to allow for time slot values up to 26. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.36.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.36.0 and VistA patch * * SD*5.3*833 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 ------------------ ---------- -------------------- SDEC APPT REQUEST REQUEST TYPE Modified (#409.85) (#4) 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 ----------- ---- -------------------- SDECRPC Broker Modified 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 ------------- ----------------------- -------------------- Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDES CREATE CLIN AVAILABILITY Modified SDES CREATE RECALL REQ Deleted SDES DELETE VVS ID New SDES EDIT CLINIC AVAILABILITY Modified SDES EDIT RECALL REQ Deleted SDES GET APPT BY REQ/APPT TYPE Deleted SDES GET APPT REQ BY TYPE VET New SDES GET APPTS BY CLIN IEN 2 Deleted SDES GET CLINIC INFO Deleted SDES GET CLINIC INFO2 Modified SDES GET CLINICS BY CLIN LIST Modified SDES GET PATIENT REGISTRATION Deleted SDES GET VVS APPT New SDES GET VVS ID New SDES PATIENT SEARCH New SDES SAVE VVS ID New SDES SPACEBAR VVS PRO Modified SDES VVC APPT Deleted SDES VVS DELETE ID Deleted SDES VVS GET ID Deleted SDES VVS SAVE ID Deleted Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-2404 - VistA: Create SDES RPC to Search Patient. Problem: Need to create an SDES RPC to lookup a patient. Modular format, based on SDEC GET PATIENT DEMOG, JSON return. Input criteria includes: DFN - IEN of Patient DOB - Date of Birth SSN - Social Security Number First Letter of Last Name followed by last 4 digits of their SSN Partial Name Null for ALL Add RPC to Menu Option: SDESRPC Resolution: The SDES PATIENT SEARCH RPC was created and added to the SDESRPC option. 2) VSE-4156 - VistA: Retire RPCs post release of SD*5.3*823. Problem: Need to retire the following list of RPCs post release of SD*5.3*823: SDES CREATE RECALL REQ SDES EDIT RECALL REQ SDES GET APPT BY REQ/APPT TYPE SDES GET APPTS BY CLIN IEN 2 SDES GET CLINIC INFO SDES GET PATIENT REGISTRATION Resolution: The listed RPCs were added to the SD*5.3*833 KIDS build marked as Delete At Site. 3) VSE-4501 - RTC's are showing in the RM Grid inaccurately numbered. The number order starts with 2 instead of 1 and ends with 1 more number than the number or RTC's requested. Problem: The RTC's are still showing in the RM Grid inaccurately numbered. Resolution: The SDECAR and SDECAR4 routines that support this logic were updated to return the MRTC sequence number and the VS GUI was updated to utilize these sequence numbers when displaying the RTC list and corresponding index in the VS GUI. 4) VSE-4525 - VistA: Modify SDES VVS RPCs to return JSON output. Problem: Need to modify the following VVS RPCs to return JSON output: SDES VVC APPT SDES VVS DELETE ID SDES VVS GET ID SDES SPACEBAR VVS PRO SDES VVS SAVE ID Resolution: The listed VVS related RPCs were updated to return their data in JSON format. 5) VSE-4556 - VistA: Modify SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST to include #4 INSTITUTION field 802. Problem: Need to modify SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST to include #4 INSTITUTION field 802 (TIMEZONE EXCEPTION). The new TIMEZONE EXCEPTION field should NOT be included in the data that is sent to generate the HASH for the clinic. Resolution: The SDES GET CLINIC INFO2 and SDES GET CLINICS BY CLIN LIST RPCs were updated to include the TIMEZONE EXCEPTION (#802) field from the INSTITUTION (#4) file in their return JSON Object. 6) VSE-4583 - UI: GUI Crashes When Searching a Patient and Gender is Empty. Problem: In VSE GUI, if a user searches for a patient and their gender is empty it causes GUI to crash. Resolution: The VS GUI was updated to handle patient searches where the gender field is empty without causing a hard error. 7) VSE-4592 - VistA: Modify SDES GET CLINIC INFO2 to include IEN and stop code. Problem: Need to modify the SDES GET CLINIC INFO2 and the SDES GET CLINICS BY CLIN LIST RPCs to include both the IEN and the Stop Code Number. This request was received from the VEText team. We are currently returning the IEN in the StopCodeNum field. Add 2 new fields, Stop Code AMIS number and Credit Stop Code AMIS number to the output of SDES GET CLINIC INFO2. Resolution: The SDES GET CLINIC INFO2 RPC was updated return both the IEN and the AMIS REPORTING STOP CODE (#1) fields for both the Primary and Credit Stop codes associated with a clinic. 8) VSE-4598 - VistA: SDES CREATE APPT REQ errors when setting priority to FUTURE. Problem: The SDES CREATE APPT REQ errors when setting priority to FUTURE at VALIDATEPRIORITY+2^SDESCREATEAPPREQ. Resolution: The SDESCREATEAPPREQ routine was updated to address this issue and to prevent hard errors. 9) VSE-4605 - VistA: Return MRTC sequence number to GUI. Problem: Need to return MRTC sequence number to GUI. Resolution: The SDECAR and SDECAR4 routines that support this logic were updated to return the MRTC sequence number. 10) VSE-4622 - VistA: RPC to return "VETERAN" type APPT requests. Problem: Create RPC to return only appointment requests of sub-type "VETERAN". This is to populate a list of requests for a facility. This new RPC should be in both the SDECRPC and SDESRPC options. Resolution: The SDES GET APPT REQ BY TYPE VET RPC was created to only return appointment requests of sub-type "VETERAN" in a JSON object. This RPC utilizes the new TYPE x-ref which is built off the REQUEST TYPE (#4) field in the SDEC APPT REQUEST (#409.85) file to expedite its processing and will return a maximum of 200 records with a status of OPEN. The SDES GET APPT REQ BY TYPE VET RPC was created to only return appointment requests of sub-type "VETERAN" in a JSON object. 11) VSE-4671 - VistA: Create Check for Contact Type to Avoid Syntax Error. Problem: When pulling the appointment resource record and it goes through the contacts a data issue is causing a syntax error. Patients have contact attempts without a contact type. Need to create a check for contact type to ensure a syntax error is not received. Resolution: The SDESGETAPPTREQ routine was updated to properly handle appointments that have contact attempts without a contact type. 12) VSE-4700 - VistA: Correct issue with SDES EDIT CLINIC AVAILABILITY. Problem: Correct issue with SDES EDIT CLINIC AVAILABILITY: When a clinic slot has a slot count of 10 or greater the value will be returned from SDES GET CLIN AVAILABILITY as a lowercase character instead of a number. This is due to the RPC returning the underlying representation of the count in VistA, which is a single character. A single time slot may have up to 26 ('z') available slots, although SDES CREATE CLIN AVAILABILITY and SDES EDIT CLINIC AVAILABILITY only support slot counts of up to 20. Additionally, if there are multiple overbooks outside of a clinic time slot then a symbol other than asterisk may be returned. The full set of symbols used to convey overbooks outside of a slot are: *, $, !, @, and #. These changes to how availability is parsed can and should be fixed with a new Acheron-utils release. Resolution: The SDESCLNSETAVAIL routine was updated to allow for time slot values up to 26. Test Sites: ----------- Bay Pines, FL (BAY) North Texas (NTX) 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_36_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_36_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.36.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_36_0_P.MSI Binary VS GUI R1.7.36.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_36_0_T.MSI Binary VS GUI R1.7.36.0 VDD VS_GUI_1_7_36_0 VDD Binary VS GUI R1.7.36.0 DIBR VS_GUI_1_7_36_0 DIBR Binary VS GUI R1.7.36.0 Release Notes VS_GUI_1_7_36_0 RN Binary VS GUI R1.7.36.0 Technical Manual VS_GUI_1_7_36_0 TM Binary VS GUI R1.7.36.0 User Guide Addendum VS_GUI_1_7_36_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 SDES833P 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 10 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*833. 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*833. 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 SDES833P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES833P routine using the Delete Routines [XTRDEL] if they wish. Back-Out Plan/Roll Back Plan: ----------------------------- Install the backup message created during the installation of SD*5.3*833. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.35. If 1.7.36.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.35.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_36_0_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 9 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDECAR Before: B95035759 After:B110136573 **627,642,671,745,792,797,805, 815,833** Routine Name: SDECAR4 Before:B141272711 After:B145299300 **784,785,788,805,813,826,833** Routine Name: SDES833P Before: n/a After: B3472927 **833** Routine Name: SDESCLNSETAVAIL Before:B101339000 After:B101339606 **800,803,805,809,818,820,833** Routine Name: SDESCREATEAPPREQ Before:B167919702 After:B167875599 **823,826,833** Routine Name: SDESGETAPPTREQ Before:B206712180 After:B224997352 **815,818,819,823,824,825,828, 831,833** Routine Name: SDESPATSEARCH Before: n/a After: B36787460 **833** Routine Name: SDESRTVCLN2 Before:B107605586 After:B115455228 **823,825,827,828,833** Routine Name: SDESVVC Before: B4045712 After: B7105032 **828,833** Routine Name: SDESVVS Before: B54129356 After:B138882063 **781,784,785,788,790,792,800, 801,804,805,818,823,828,833** Routine list of preceding patches: 820, 826, 831 ============================================================================= User Information: Entered By : Date Entered : NOV 29, 2022 Completed By: Date Completed: JAN 31, 2023 Released By : Date Released : JAN 31, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT