$TXT Created by G at CHY0034.FO-BAYPINES.DOMAIN.EXT (KIDS) on Monday, 05/16/22 at 12:24 ============================================================================= Run Date: JUN 07, 2022 Designation: SD*5.3*815 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #667 Status: Released Compliance Date: JUN 21, 2022 ============================================================================= Associated patches: (v)SD*5.3*814 <<= must be installed BEFORE `SD*5.3*815' Subject: VS GUI VERSION 1.7.24.1 Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.24.1 and SD*5.3*815 includes several defect corrections and enhancements including updates to the New SDES GET CONSULTS BY IEN RPC was created to get a single consult request by IEN and multiple consult requests by DFN. Improves error handling for calls to demographics web service-address as well as improvements in the case a user selects an incorrect certificate. The VS GUI was updated to Clear patient appointment records on refresh thereby eliminating the duplicate information in the RM Grid. Additional cancellation reasons were added to support VEText Veteran's Choice Proposal. The new SDES GET APPT BY REQ/APPT TYPE RPC was created to return appointment object when given request IEN and appointment type of Consult or Appointment. The new SDES GET APPT REQ LIST BY DFN RPC was created as a wrapper around several RPCs to return one large request object. Refinements were made to the wrapper RPC around SDES GET APPTS BY DFN #2 and SDES GET APPTS BY CLINIC #44 to return an appointment object. A new "Atlantic" time zone was created so that appointments scheduled in Puerto Rico from VS GUI are scheduled at the correct time. A disposition warning was added for contact attempts on MRTC/RTC when "Removed/No Longer Necessary" is selected. The SDEC STOP CODE FILE (#409.89) file was created to store the stop codes that indicate Primary Care/Mental Health for Mission Act. A SDES Wrapper RPC was created to return a single appointment by IEN. The SDES CREATE APPT REQ was updated to accept stop code number for "service" rather than IEN of stop code. A new field for patient comments was added to the SDEC APPT REQUEST (#409.85) file. The RETURN VALUE TYPE field for the SDES DISPOSITION RECALL REQ RPC was updated to be ARRAY. The input parameter naming convention was standardized for all SDES name spaced RPCs. Additional SDES RPCs were updated to utilize dates in the ISO 8601 format. The VS GUI was updated to Hide the system cancellation reasons from the user. The SDES GET APPT REQ BY PATIENT, SDES GET APPT REQ BY IEN, SDES GET APPTS BY RESOURCE, SDES GET APPTS BY IEN, SDES GET APPTS BY PATIENT and SDES GET APPTS BY RESOURCE RPCs were updated to include the Provider SECID in their JSON return object. The release adds patient self-cancel disposition reason for appointment requests. Additionally, the release fixes an issue where parent request was not removed from RM Grid when dispositioning MRTC and RTC requests. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.24.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.24.1 and VistA patch * * SD*5.3*815 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- RECALL REMINDERS REMOVED DELETE REASON (#203) Modified (#403.56) CANCELLATION REASONS New Entries Deployed Modified (#409.2) SDEC APPT REQUEST Modified (#409.85) PATIENT COMMENTS (#60) mult. New PATIENT COMMENTS (#.01) New SDEC DISPOSITION REASON DISPOSITION REASON (#.01) New (#409.853) SDEC STOP CODE (#409.89) NAME (#.01) New STOP CODE (#1) New TYPE (#2) New ACTIVE (#3) New 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 (Client/Server) 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 --------------------- -------------------- SDEC RECDSET Modified SDES CANCEL APPT Modified SDES CREATE APPT REQ Modified SDES DISPOSITION APPT REQ Modified SDES DISPOSITION RECALL REQ Modified SDES EDIT APPT REQ Modified SDES EDIT RECALL REQ Modified SDES GET APPT BY REQ/APPT TYPE New SDES GET APPT REQ BY IEN Modified SDES GET APPT REQ BY PATIENT Modified SDES GET APPT REQ LIST BY DFN New SDES GET APPTS BY CLIN IEN 2 New SDES GET APPTS BY IEN New SDES GET APPTS BY PATIENT Modified SDES GET APPTS BY PATIENT DFN2 New SDES GET APPTS BY RESOURCE Modified SDES GET CONSULTS BY DFN New SDES GET CONSULTS BY IEN New SDES GET RECALL BY IEN Modified SDES GET RECALLS BY DFN Modified SDES SET APPT CHECK-IN STEP Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-178: Discovery: Tasks Tab - Appointment Calendar. Problem: Address 508 requirements for the Appointment Calendar on the Tasks tab. Resolution: The Appointment Calendar on the Tasks tab was updated to the address the reported 508 compliance issues. 2) VSE-1936: VistA: Create SDES get consult request RPCs. Problem: Create SDES RPCs to get a single consult request by IEN and multiple consult requests by DFN. Rewrite SDEC get consult RPC in SDES namespace, following established SDES standards. Resolution: The New SDES GET CONSULTS BY IEN RPC was created get a single consult request by IEN and multiple consult requests by DFN. 3) VSE-2589: Fix code to handle 503 error message for the application/GUI to exit gracefully. Problem: Improve error handling for calls to demographics web service-address as well as incorrect cert selection, division issue, etc. Resolution: Added try/catch so app does not break on 503 error, and display an error message on the check in screen if an error occurs in demographics service. 4) VSE-2737: Duplicate records appear in the RM Grid. Problem: When loading a patient from the RM Grid on startup and then using the Clear button. The row that was used to load the patient into context becomes a duplicate in the RM Grid. If you continue to do this you get triplicate, quadruplicate, etc. Resolution: The VS GUI was updated to Clear patient appointment records on refresh thereby eliminating the duplicate information in the RM Grid. 5) VSE-2781: VistA: Add VEText Cancellation Reasons. Problem: Add CP cancellation reasons to support VEText Veteran's Choice Proposal (text does not have to be exactly as below). * Patient requests call to reschedule * Patient will call to reschedule * Patient does not wish to reschedule Update cancellation RPCs so that requests are only reopened for the first cancellation reason. Resolution: The following updates were made to address this issue: 1. Add the 3 identified Choice Plus (CP) cancellation reasons. This to the CANCELLATION REASONS (#409.2) file pointed to by the CANCELLATION (#.122) field of the SDEC APPOINTMENT (#409.84) file. 2. This is for RECALLS, APPTS, and CONSULTS. 3. Make the modifications to AROPEN^SDECAR for appt requests and RECREQ^SDECRECREQ for recall requests. 4. Test the SDEC APPDEL RPC that performs cancellation to an entry in file 409.84 and opens the corresponding request entry in file 409.85 when the patient wants someone to call to reschedule. 6) VSE-2799: VistA: Create RPC to return appointment object when given request IEN and appointment type of Consult or Appointment. Problem: Create SDES RPC to return appointment object when given request IEN and appointment request type of Consult or Appointment. Resolution: The following VistA components were created or updated to address this issue: * Created APPTBYRIENAPTYP tag/functionality in SDESAPPT * Added line tag GETAPTBYRIENAPTP to SDES * Added RPC SDES GET APPT BY REQ/APPT TYPE to RPC file * Added RPC SDES GET APPT BY REQ/APPT TYPE to SDESRPC option 7) VSE-2804: VistA: SDES Wrapper RPC for getting appointment requests. Problem: Need to create a wrapper SDES RPC for all appointment request GET RPCs. Resolution: The new SDES GET APPT REQ LIST BY DFN RPC was created as a wrapper around the following RPCs to return one large request object: SDES GET APPT REQ BY IEN SDES GET APPT REQ BY PATIENT SDES GET RECALL BY IEN SDES GET RECALLS BY DFN SDES GET CONSULTS BY IEN SDES GET CONSULTS BY DFN 8) VSE-2821: VistA: Define combined appointment object and update SDES GET APPT wrapper RPC. Problem: Refine the wrapper RPC around SDES GET APPTS BY DFN #2 and SDES GET APPTS BY CLINIC #44. We need to define the appointment object (which fields from which files comprise an "appointment") then return only those values with no duplicate fields. Resolution: 1. Modified the two RPC's SDES GET APPTS BY PATIENT DFN and SDES GET APPTS BY CLIN IEN. 2. For a given CLINIC IEN or PATIENT DFN, retrieve all appointments from SDEC APPOINTMENT File #409.84, HOSPITAL LOCATION File #44, and the Appointment Multiple Patient File #2. 3. Encapsulate all the appointments retrieved into an appointment object without duplicate fields. 9) VSE-2822: .NET: Add "Atlantic" time zone for VVC appointments (not available in VistA). Problem: Need to add "Atlantic" time zone so that appointments scheduled in Puerto Rico from VS GUI are scheduled at the correct time. Resolution: Removing America/Cuiaba from switch statement. Cuiaba will now map to GREENWICH on edit if saved before, which a scheduler will see as incorrect and change to Atlantic and send the updated appt to VVS with correct America_Puerto_Rico value. 10) VSE-2831: New contact attempt methods error message, when dispositioning MRTC & RTC requests does not appear. Problem: When dispositioning child of MRTC and RTC requests from APPT/VETERAN Disposition with Removed No Longer Necessary option, user needs to receive new created CA Error Message box, but it does not appear on the screen. Resolution: Show disposition warning for contact attempts on MRTC/RTC when "Removed/No Longer Necessary" is selected. 11) VSE-2843: VistA: Create a file to contain Primary Care/Mental Health stop codes. Problem: Currently the stop codes that indicate Primary Care/Mental Health for Mission Act are stored in a routine. Convert these stop codes to be in a file that can be edited when the stop codes change. Resolution: The SDEC STOP CODE FILE (#409.89) file was created to store the stop codes that indicate Primary Care/Mental Health for Mission Act. 12) VSE-2850: VistA: SDES Wrapper RPC to return a single appointment by IEN. Problem: Need to a SDES Wrapper RPC to return a single appointment by IEN. Resolution: 1. Created new RPC SDES GET APPTS BY IEN. 2. For a given appointment IEN, retrieve all appointments from SDEC APPOINTMENT (#409.84), HOSPITAL LOCATION (#44), and the Appointment Multiple PATIENT (#2) Files. 3. Encapsulate all the appointments retrieved into an appointment object without duplicate fields. 13) VSE-2851: VistA: Update create appointment request RPC to use stop code number rather than IEN of stop code. Problem: Update the SDES CREATE APPT REQ RPC to accept stop code number for "service" rather than IEN of stop code. Resolution: The SDES CREATE APPT REQ was updated to accept stop code number for "service" rather than IEN of stop code. 14) VSE-2852: VistA: Add patient self-cancel disposition reason for appointment requests. Problem: For Appointment and Recall requests, need a disposition reason of patient self-cancel. Resolution: 1. Added a disposition reason for patient self-cancel to the SDEC DISPOSITION REASON (#409.853) file which is pointed to by the DISPOSITION field (21) of the SDEC APPT REQUEST (#409.85) file. 2. Added a delete reason for patient self-cancel in the DELETE REASON (#203) field of the RECALL REMINDERS REMOVED (#403.56) file. 15) VSE-2853: VistA: Create new field for patient comments in 409.85. Problem: Need to create new word processing field for patient comments in the SDEC APPT REQUEST (#409.85) file. Alter CRUD RPCs to allow for creating/updating/returning this field. Resolution: 1. Added a new word processing field to SDEC APPT REQUEST (#409.85) file to store the patient comments. 2. Updated the following RPC to allow for creating/updating/returning the patient comments: SDES CREATE APPT REQ SDES EDIT APPT REQ SDES DISPOSITION APPT REQ 16) VSE-2860: Disposition recall appointment returns empty set/string. Problem: The SDES DISPOSITION RECALL REQ RPC is not returning the JSON object. Resolution: The RETURN VALUE TYPE field for this RPC was SINGLE VALUE and it was updated to be ARRAY. 17) VSE-2862: Narrow down the parameter names for EAS tracking number. Problem: The input parameter for the EAS tracking number needs to be consistent among all SDES name spaced RPCs. Resolution: The following SDES name spaced RPCs were updated to have the input parameter for the EAS tracking number to match the naming convention used in the other SDES name spaced RPCs. SDES CANCEL APPT SDES DISPOSITION RECALL REQ SDES EDIT RECALL REQ SDES SET APPT CHECK-IN STEP 18) VSE-2881 & VSE-2882: VistA: ApptReq: return the provider SecID. Problem: The SECID needs to be added to the return JSON object for the following RPCs: SDES GET APPT REQ BY PATIENT SDES GET APPT REQ BY IEN SDES GET APPTS BY RESOURCE SDES GET APPTS BY IEN SDES GET APPTS BY PATIENT SDES GET APPTS BY RESOURCE Resolution: The SDES GET APPT REQ BY PATIENT, SDES GET APPT REQ BY IEN and SDES GET APPTS BY RESOURCE were updated to include the Provider SECID in their JSON return object. 19) VSE-2904: VistA: Modify routine SDESAPPTDATA. Problem: Modify routine SDESAPPTDATA as follows: 1. Add an ISO8601 date field for every existing date field. 2. Remove the use of $I which is in the code and is not SACC compliant. 3. Add a new logic to provide needed Provider Info. Resolution: Created tag SUMMARY2 in SDESAPPTDATA, which returns the ISO date, removes $I and adds provider ID and Name. 20) VSE-2929: .NET: Update GUI to hide automated cancellation reasons. Problem: Hide the following cancellation reasons from users: Block and Move: 15 RESCHEDULE - CALL BACK: 16 RESCHEDULE - VET WILL CALL: 17 DO NOT RESCHEDULE: 18 Resolution: The VS GUI was updated to Hide the system cancellation reasons from the user. Test Sites: ----------- Tomah, WI (TOM) Wichita, Kansas (WIC) 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_24_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_24_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.24.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_24_1_P.MSI Binary VS GUI R1.7.24.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_24_1_T.MSI Binary VS GUI R1.7.24.1 VDD VS_GUI_1_7_24_1 VDD Binary VS GUI R1.7.24.1 DIBR VS_GUI_1_7_24_1 DIBR Binary VS GUI R1.7.24.1 Release Notes VS_GUI_1_7_24_1 RN Binary VS GUI R1.7.24.1 Technical Manual VS_GUI_1_7_24_1 TM Binary VS GUI R1.7.24.1 User Guide Addendum VS_GUI_1_7_24_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 VACS installation. The IO HBMC 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 SDEC815P 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. It is not recommended that this patch be queued. 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*815. 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*815. 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 SDEC815P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC815P 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*815. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.23. If 1.7.24.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.23.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_24_1_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 4 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC52A Before: B60099552 After: B60043758 **627,658,694,745,774,799,815** Routine Name: SDEC815P Before: n/a After: B2328718 **815** Routine Name: SDECAR Before: B93182894 After: B95035759 **627,642,671,745,792,797,805,815** Routine Name: SDECRECREQ Before: B10883727 After: B11117880 **790,792,805,815** Routine Name: SDES Before: B90920854 After:B103760954 **788,790,792,794,797,799,800, 801,803,804,805,807,809,813, 814,815** Routine Name: SDESAPPT Before: B42845815 After: B61763042 **788,805,807,809,815** Routine Name: SDESAPPTDATA Before: B12687619 After: B45543548 **788,814,815** Routine Name: SDESAPTREQSET Before:B174020318 After:B185557618 **794,799,805,809,815** Routine Name: SDESARCLOSE Before: B8781906 After: B10652720 **794,799,805,809,815** Routine Name: SDESDISPRECALL Before: B11149763 After: B11671969 **803,805,815** Routine Name: SDESGETAPPTREQ Before: n/a After:B125026832 **815** Routine Name: SDESGETAPPTWRAP2 Before: n/a After: B65496508 **815** Routine Name: SDESGETAPPTWRAP3 Before: n/a After:B119143572 **815** Routine Name: SDESGETCONSULTS Before: n/a After: B49420918 **815** Routine Name: SDESGETRECALL Before: B56525175 After: B24050687 **803,805,809,813,815** Routine Name: SDESGETREQWRAPPR Before: n/a After: B65931891 **815** Routine Name: SDESJSON Before:B104073591 After:B107561776 **788,794,797,799,800,801,803, 805,807,809,813,814,815** Routine Name: SDESMISSIONELG Before: B41751347 After: B41656328 **814,815** Routine list of preceding patches: 814 ============================================================================= User Information: Entered By : Date Entered : APR 13, 2022 Completed By: Date Completed: JUN 07, 2022 Released By : Date Released : JUN 07, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT