$TXT Created by G at CHY0034.FO-BAYPINES.DOMAIN.EXT (KIDS) on Wednesday, 08/02/23 at 17:35 ============================================================================= Run Date: AUG 16, 2023 Designation: SD*5.3*847 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #704 Status: Released Compliance Date: AUG 29, 2023 ============================================================================= Associated patches: (v)SD*5.3*809 <<= must be installed BEFORE `SD*5.3*847' (v)SD*5.3*846 <<= must be installed BEFORE `SD*5.3*847' Subject: VistA Scheduling RPC Updates Category: - Routine - Enhancement (Mandatory) - Other Description: ============ VistA Scheduling patch SD*5.3*847 includes several defect corrections and enhancements including updating the SDES GET APPT* Remote Procedure Calls (RPCs) to include the STATUS (#.17) field from the SDEC APPOINTMENT (#409.84) file in their JavaScript Object Notation (JSON) object. The SDEC APPADD and SDES CREATE APPOINTMENTS RPCs were updated to ensure that the patient on the Appointment matches the patient on the associated Appointment Request. The SDES CANCEL APPOINTMENT2 RPC was modified to update all the same data elements that are currently supported by the SDEC APPDEL RPC. The SDES CREATE APPOINTMENTS RPC was updated to remove the array field 20. The RPC was updated to store the note from APPTARRAY(11) into the NOTE (#1) field in the SDEC APPOINTMENT (#409.84) file. The logic was also updated to store the Disposition related data into the DATE DISPOSITIONED (#19), DISPOSITIONED BY (#20) and DISPOSITION (#21) fields in the SDEC APPT REQUEST (#409.85) file. The following SDES* routines were updated to include the PIDDATE logic: SDESCANAPPT2, SDESRECALLREQ, SDESCREATEAPPT, SDESCREATEAPPREQ, SDESCRTAPPTWRAP, SDESNOSHOW, SDESGETAPPTREQ, SDESGETCONSULTS. The logic supporting the following RPCs was updated to address the issues related to the letter counts and dates: SDES GET APPT REQ BY IEN, SDES GET APPT REQ BY PAT ALL, SDES GET APPT REQ BY PAT OPEN, SDES GET APPT REQ BY PATIENT, SDES GET APPT REQ BY TYPE VET, SDES GET APPT REQ LIST BY DFN, SDES GET APPT REQ BY IENS2, SDES GET APPT REQS BY IENS. 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 ----------- ---- -------------------- N/A 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 APPOINTMENTS Modified SDES GET APPT BY APPT IEN Modified SDES GET APPTS BY CLIN IEN 3 Modified SDES GET APPTS BY CLIN LIST2 Modified SDES GET APPTS BY CLINIEN LIST Modified SDES GET APPTS BY IENS2 Modified SDES GET APPTS BY PATIENT DFN3 Modified SDES GET APPTS BY RESOURCE Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-5515: VistA: Modify SDES GET APPT * RPCs to pull the CurrentStatus from 409.84. Problem: Need to modify SDES GET APPT* RPCs to pull the CurrentStatus from 409.84 vs Patient file. We should also look at the other data being pulled from the patient field because it is NEVER going to be correct for an appointment that was cancelled and overlaid by another appointment in the code. Resolution: The SDES GET APPT* RPCs were updated to include the STATUS (#.17) field from the SDEC APPOINTMENT (#409.84) file in their JSON object. 2) VSE-5549: VistA: Modify SDEC APPADD and SDES CREATE APPOINTMENTS RPCs to ensure patient on request matches the patient on the appointment. Problem: Need to modify SDEC APPADD and SDES CREATE APPOINTMENTS RPCs to ensure patient on request matches the patient on the appointment. Resolution: The SDEC APPADD and SDES CREATE APPOINTMENTS RPCs were updated to ensure that the patient on the Appointment matches the patient on the associated Appointment Request. 3) VSE-5609: VistA: Correct SDES CANCEL APPOINTMENT2 RPC to update all data elements in the SDEC APPDEL RPC. Problem: Need to correct SDES CANCEL APPOINTMENT2 RPC to update all data elements in the SDEC APPDEL RPC to include the outpatient encounters file. Resolution: The SDES CANCEL APPOINTMENT2 RPC was modified to update all the same data elements that are currently supported by the SDEC APPDEL RPC. 4) VSE-5623: VistA: Modify SDES CREATE APPOINTMENTS to remove the array field 20. Problem: A modification needs to be made to the current SDES CREATE APPOINTMENTS to remove the array field 20 ( ;(APPTARRAY(20)) APPT REASON - FREE TEXT (1-150)) field. This field was erroneously added. All appointment comments should be sent via array field 11 ;(APPTARRAY(11)= NOTE - FREE TEXT 1-150)). Logic should be modified to store the note from field 11 into file 44. Additionally, the logic calls BUILDAPPTDATA^SDESEDITAPPTREQ where the appointment request (409.85) is updated with the appointment information. It should also be updating the request with DISPOSITION, DISPOSITION BY, and DATE DISPOSITIONED. This will require a data fix as well. Currently any appointment made with SDES CREATE APPOINTMENTS is missing those fields. Resolution: The SDES CREATE APPOINTMENTS RPC was updated to remove the array field 20. The RPC was updated to store the note from APPTARRAY(11) into the NOTE (#1) field in the SDEC APPOINTMENT (#409.84) file. The logic was also updated to store the Disposition related data into the DATE DISPOSITIONED (#19), DISPOSITIONED BY (#20) and DISPOSITION (#21) fields in the SDEC APPT REQUEST (#409.85) file. 5) VSE-5732: VistA: Changes to PIDDATE added to SDEC need to be added to SDES. Problem: The PIDDATE logic needs to be added to all SDES appointment code (create request, create appointment, and cancel appointment. Resolution: The following SDES* routines were updated to include the PIDDATE logic: SDESCANAPPT2, SDESRECALLREQ, SDESCREATEAPPT, SDESCREATEAPPREQ, SDESCRTAPPTWRAP, SDESNOSHOW, SDESGETAPPTREQ, SDESGETCONSULTS. 6) VSE-5740: VistA: Correct SdecContactNumber calculations. Problem: Within RPC, SDES GET APPT REQ LIST BY DFN, there is an issue with the calculations for the SdecContactNumber..." calculations: 1. It was always sending a value in the SdecContactDateOfLastLetterSent field (even when there was not a letter sent) 2. The counts included the inactive and active. The GUI counts are always only the active. We would assume that is what we should have been calculating. Resolution: The logic supporting the following RPCs was updated to address the issues related to the letter counts and dates: SDES GET APPT REQ BY IEN, SDES GET APPT REQ BY PAT ALL, SDES GET APPT REQ BY PAT OPEN, SDES GET APPT REQ BY PATIENT, SDES GET APPT REQ BY TYPE VET, SDES GET APPT REQ LIST BY DFN, SDES GET APPT REQ BY IENS2, SDES GET APPT REQS BY IENS. Test Sites: ----------- Salt Lake City, UT (SLC) Tomah, WI (TOM) Software and Documentation Retrieval Instructions: ---------------------------------------------------- Software is distributed by PackMan message. 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 -------------------------------------------------------------------------- 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: ------------------------- N/A - No VS GUI updates related to this patch. Release Manager Point of Contact: Name: Stevens Jack Phone: 772-646-2303 Email: jack.stevens1@domain.ext Pre/Post Installation Overview: ------------------------------- N/A 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*847. 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*847. 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: ------------------------------- N/A Back-Out Plan/Roll Back Plan: ----------------------------- Install the backup message created during the installation of SD*5.3*847. 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: SDEC07 Before:B180209897 After:B183859950 **627,642,651,658,665,669,671, 672,701,686,740,694,785,788, 790,799,801,805,816,819,842, 843,847** Routine Name: SDESAPPTDATA Before: B76519558 After: B79202046 **788,814,815,820,823,827,837, 838,839,846,847** Routine Name: SDESCANAPPT2 Before: B95139364 After:B213646737 **838,842,844,845,847** Routine Name: SDESCLINICDATA Before: B9569458 After: B10475638 **788,823,825,828,831,844,847** Routine Name: SDESCREATEAPPREQ Before:B190031421 After:B199940108 **823,826,833,835,837,843,844, 846,847** Routine Name: SDESCREATEAPPT Before: B80936922 After: B86207416 **814,823,826,827,828,842,843, 846,847** Routine Name: SDESCRTAPPTWRAP Before: B66013368 After: B67645967 **814,816,823,826,827,828,843,847** Routine Name: SDESEDITAPPTREQ Before:B190162283 After:B188279660 **823,826,837,845,846,847** Routine Name: SDESGETAPPTREQ Before:B228384089 After:B214063953 **815,818,819,823,824,825,828, 831,833,837,838,839,845,847** Routine Name: SDESGETAPPTREQ2 Before: B7827275 After: B12028061 **839,847** Routine Name: SDESGETCONSULTS Before: B54511752 After: B51190596 **815,820,824,837,842,847** Routine Name: SDESGETPATAPPT Before: B37848270 After: B37071044 **809,847** Routine Name: SDESGETREQWRAPPR Before: B96080713 After: B96075459 **815,818,820,823,825,831,838, 842,843,847** Routine Name: SDESGREQSIENS Before: B3471044 After: B3490759 **845,847** Routine Name: SDESNOSHOW Before: B62382945 After: B66497801 **831,835,847** Routine Name: SDESRECALLREQ Before: B11196273 After: B8467854 **835,847** Routine list of preceding patches: 809, 846 ============================================================================= User Information: Entered By : Date Entered : APR 11, 2023 Completed By: Date Completed: AUG 16, 2023 Released By : Date Released : AUG 16, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT