$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Wednesday, 08/03/22 at 12:13 ============================================================================= Run Date: AUG 24, 2022 Designation: SD*5.3*820 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #673 Status: Released Compliance Date: SEP 07, 2022 ============================================================================= Associated patches: (v)SD*5.3*819 <<= must be installed BEFORE `SD*5.3*820' (v)VPS*1*21 <<= must be installed BEFORE `SD*5.3*820' Subject: VS GUI VERSION 1.7.28.0 Category: - Routine Description: ============ ***IMPORTANT NOTE: *** ************************************************************************** * This patch will add two new Stop Codes to the CLINIC STOP (#40.7) * * file in support of the newly passed legislation to support Airborne * * Hazards Open Burn Pit Registry (AHOBPR) law. * * * * Stop Code Name * * 497 REGISTRY EXAM CVT PT SITE * * 498 REGISTRY EXAM CVT PROV SITE * * * ************************************************************************** VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.28.0 and SD*5.3*820 includes several defect corrections and enhancements including updates to the Availability Selection window in the VS GUI to be 508 compliant. SDES RPCs were updated to so that "null" status is never sent back for an appointment. The post-install routine was deployed to correct MRTC child request sequence numbers and MRTC intervals. The post-install routine will also identify and clean up data created by VetLink so that both the CHECKIN and CHECK IN TIME ENTERED fields will both be populated. The VS GUI was updated to pull the same interval number and store the child request sequence number in the new child request field. The SDES GET CLINIC INFO RPC was updated to include the CHAR4 data in the return JSON Object. The SDESCHKAPPTOVP routine was created to check for overlapping appointments. Routines supporting EAS validation were updated to perform a character based comparison. The RPC SDES GET USRPROFILE RPC was updated to be more descriptive. The SDES GET APPTS BY CLINIC LIST RPC was updated to include 3 additional fields. The SDEC APPADD RPC was updated to include logic to check for a lock on the appointment level of the file. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.28.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.28.0 and VistA patch * * SD*5.3*820 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- SDEC APPT REQUEST MULT CHILD SEQUENCE NUMBER New (#409.85) (#43.1) 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 ----------- ---- -------------------- 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 GET USRPROFILE Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-199: Availability Selection - Remediate 508 findings in Availability Selection form. Problem: As a user, I want the Availability Selection window to be 508-compliant, so that I can easily use assistive technology to manage appointments in VS GUI. Resolution: The Availability Selection window was updated to utilize Update DataAccessService.cs to incorporate assistive technology to assist users. 2) VSE-3079: VistA: Update appointment object to include appointment status logic Problem: Need to update SDES RPCs that return appointment object to include appointment status logic so that "null" status is never sent back for an appointment. Resolution: The SDESAPPTDATA routine was updated and all RPCs that call this will now properly return the status. 3) VSE-3245: VistA: Create a post install routine to correct MRTC child request sequence numbers. Problem: Create a post install return that will: 1. Identify all child MRTC requests. 2. Verify if new MRTC sequence number field is populated. If it is skip this MRTC request and move to the next request. 3. If the new MRTC sequence number field is not populated then copy the data in field 42 of the MRTC child request to the new MRTC request sequence number field. 4. Copy MULT APPT RTC INTERVAL field (field 42) of the MRTC Parent Request to the MULT APPT RTC INTERVAL field (field 42) of the MRTC Child Request. Resolution: Logic was added to the SDEC820P post-install routine to correct MRTC child request sequence numbers and MRTC intervals. 4) VSE-3250: VS GUI: Update GUI logic to correct MRTC child request sequence numbers. Problem: Need to update logic for MRTC child requests in VS GUI to not send the child request sequence number for the interval field. 1. The interval field should pull the same interval number that was used to create the child requests. 2. VS GUI should write all the MRTC child requests and store the child request sequence number in the new child request field being created. Resolution: The VS GUI was updated to pull the same interval number and store the child request sequence number in the new child request field. 5) VSE-3263: VistA: Create a read RPC to return the Clinic Object including CHAR4 field from file #724. Problem: Need to update RPCs that return the Clinic Object and include CHAR4 field from file 724. CHAR4 is a pointer to the National Clinic File (#728.441). Resolution: The SDES GET CLINIC INFO RPC was updated to include the CHAR4 data in the return JSON Object. 6) VSE-3321: VistA: Create a new routine to check for overlapping appointments. Problem: Need to create a new routine to check for overlapping appointments. Resolution: The SDESCHKAPPTOVP routine was created to check for overlapping appointments. The RPC to utilize this functionality will be deployed in a future patch. 7) VSE-3326: Vista Error Processing EAS Tracking Number. Problem: Need to update the EAS Validation logic to prevent Maximum Number errors. Resolution: Routine supporting EAS validation were updated to perform a character based comparison. 8) VSE-3334: VistA: Create a Post-Install Routine to Clean Up VetLink Check-in Issue. Problem: Need a post-install routine created to clean up issues related to VetLink. Resolution: Logic was added to the SDEC820P post install to identify and clean up data created by VetLink so that both the CHECKIN and CHECK IN TIME ENTERED fields will both be populated. 9) VSE-3349: VistA: Update description and return parameter for SDES GET USRPROFILE. Problem: Need to update the description and return parameter for SDES GET USRPROFILE. Resolution: Updated the verbiage in RPC SDES GET USRPROFILE to not say Scheduling in the output parameter, the return value will return all of a users OPTIONS and keys, not just scheduling. 10) VSE-3393: VistA: Update SDES GET APPTS BY CLINIC LIST. Problem: Need to update the SDES GET APPTS BY CLINIC LIST RPC to include: .12 CANCEL DATETIME .121 CANCELLED BY USER .122 CANCELLATION REASON Resolution: The SDES GET APPTS BY CLINIC LIST RPC was updated to include these additional fields in the JSON Return Object. 11) VSE-3454: VistA: Update Order lock check logic to check for lock on specific order. Problem: Order lock check in SDEC APPADD RPC is checking for order lock by patient DFN. Update to check for lower-level lock on order itself. Update wording of message returned to user to remove "Error". Resolution: The SDEC APPADD RPC was updated to include logic to check for a lock on the appointment level of the file. 12) VSE-3571: VistA: Add two new stop codes to file (#40.7) Problem: Add two new stop codes to file (#40.7). Per the attached Undersecretary of Health memo from April 2022, VA facilities must resolve pending Airborne Hazards Open Burn Pit Registry (AHOBPR) exams at a rate of 15% per month. The inability to perform registry exams via CVT hampers facility efforts to comply with this order, particularly for Veterans in rural areas. In fact, all VA facilities have been instructed NOT to perform registry exams via CVT pending the creation of these stop codes because otherwise Veterans will be billed for what should be a free service. 497 REGISTRY EXAM CVT PT SITE 498 REGISTRY EXAM CVT PROV SITE Resolution: The SDEC820P post install routine will run automatically at the conclusion of the patch installation and will add these 2 new Stop Codes to the CLINIC STOP (#40.7) file. Test Sites: ----------- Martinsburg, WV (MWV) Fort Harrison, MT (FHM) 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_28_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_28_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.28.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_28_0_P.MSI Binary VS GUI R1.7.28.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_28_0_T.MSI Binary VS GUI R1.7.28.0 VDD VS_GUI_1_7_28_0 VDD Binary VS GUI R1.7.28.0 DIBR VS_GUI_1_7_28_0 DIBR Binary VS GUI R1.7.28.0 Release Notes VS_GUI_1_7_28_0 RN Binary VS GUI R1.7.28.0 Technical Manual VS_GUI_1_7_28_0 TM Binary VS GUI R1.7.28.0 User Guide Addendum VS_GUI_1_7_28_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 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 SDEC820P 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. ************************************************************************** * INSTALL NOTICE * * ---------------------------------------------------------------------- * * SD*5.3*820 includes a post install routine that will review and * * correct data. It is recommended to install this patch after duty * * hours when it will have the least impact on the users. The VS GUI * * v 1.7.28.0 will need to be installed as soon as the SD*5.3*820 * * patch installation is complete to keep the two systems in sync. * * * * It is recommended that this patch NOT 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*820. 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*820. 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 SDEC820P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC820P 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*820. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.27. If 1.7.28.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.27.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_28_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 10 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC07C Before: B20121471 After: B20177277 **686,694,816,820** Routine Name: SDEC820P Before: n/a After: B50363882 **820** Routine Name: SDECAR2 Before:B213318205 After:B215792982 **627,642,658,671,686,694,745, 799,805,820** Routine Name: SDES2 Before: B2882991 After: B3549659 **816,818,819,820** Routine Name: SDESAPPT Before: B61686228 After: B63878850 **788,805,807,809,815,819,820** Routine Name: SDESAPPTDATA Before: B45543548 After: B47791212 **788,814,815,820** Routine Name: SDESAPTREQSET Before:B215775986 After:B214451555 **794,799,805,809,815,818,819,820** Routine Name: SDESARCLOSE Before: B11219832 After: B11219832 **794,799,805,809,815,818,819,820** Routine Name: SDESBLKANDMOVE Before:B161127299 After:B161127299 **797,799,800,801,803,804,805, 807,819,820** Routine Name: SDESCANCELAPPTS Before: B56296199 After: B56296199 **818,820** Routine Name: SDESCCAVAIL Before: B43562977 After: B43695265 **800,805,809,813,819,820** Routine Name: SDESCHKAPPTOVP Before: n/a After: B14162548 **820** Routine Name: SDESCKNSTEP Before: B64172393 After: B66280415 **788,790,792,800,805,807,819,820** Routine Name: SDESCLINICAVAIL Before: B23828228 After: B24173871 **800,805,809,816,820** Routine Name: SDESCLINICSET Before:B165828222 After:B165832866 **799,805,820** Routine Name: SDESCLNSETAVAIL Before:B101345291 After:B101339000 **800,803,805,809,818,820** Routine Name: SDESDISPRECALL Before: B11666285 After: B11666285 **803,805,815,819,820** Routine Name: SDESGETAPPTWRAP2 Before: B65496508 After: B67156976 **815,820** Routine Name: SDESGETCONSULTS Before: B49420918 After: B49738220 **815,820** Routine Name: SDESGETRECALL Before: B24050687 After: B24338785 **803,805,809,813,815,820** Routine Name: SDESGETREGA Before: B86128131 After: B86142599 **799,804,805,809,814,820** Routine Name: SDESGETREQWRAPPR Before: B64371630 After: B64676216 **815,818,820** Routine Name: SDESGETUD Before: B18545013 After: B18545013 **801,805,809,814,819,820** Routine Name: SDESINACTCLINIC Before: B3830394 After: B3884454 **799,805,820** Routine Name: SDESMISSIONELG Before: B45400827 After: B45400827 **814,815,818,820** Routine Name: SDESPATRPC Before: B25661355 After: B25655924 **792,804,805,807,809,814,816,820** Routine Name: SDESPRINTPATAPPT Before: B11642913 After: B15687874 **813,820** Routine Name: SDESRTVCLN Before: B59323522 After: B66664901 **799,805,807,813,820** Routine Name: SDESUPDRECREQ Before: B28717858 After: B28721630 **803,805,809,820** Routine Name: SDESUTIL Before: B25923097 After: B27774787 **801,804,805,814,816,818,820** Routine list of preceding patches: 819 ============================================================================= User Information: Entered By : Date Entered : JUN 22, 2022 Completed By: Date Completed: AUG 24, 2022 Released By : Date Released : AUG 24, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT