$TXT Created by G at CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 12/15/22 at 12:50 ============================================================================= Run Date: JAN 13, 2023 Designation: SD*5.3*831 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #686 Status: Released Compliance Date: JAN 27, 2023 ============================================================================= Associated patches: (v)SD*5.3*717 <<= must be installed BEFORE `SD*5.3*831' (v)SD*5.3*722 <<= must be installed BEFORE `SD*5.3*831' (v)SD*5.3*828 <<= must be installed BEFORE `SD*5.3*831' Subject: VS GUI VERSION 1.7.35.0 Category: - Routine - Enhancement (Mandatory) Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.35.0 and SD*5.3*831 includes several defect corrections and enhancements including the new SDES GET PATIENT PREF RPC was created to return the needed patient preferences data in JSON format. The new SDES GET PATIENT WARD RPC was created to return the ward that the patient is currently assigned to in JSON format. The VS GUI has been updated to always send the properly formatted phone number to VistA. The SDES UNDO CHECKOUT RPC was created to undo a check out and to reset the necessary fields back to their prior state. The National Flags, Fugitive Felon Flag and the Local Flags have been added to the return JSON object for the SDES GET PAT FLAGS RPC. The new SDES GET PATIENT PREF RPC was created to return the needed patient preferences data in JSON format. The new SDES GET PATIENT WARD RPC was created to return the ward that the patient is currently assigned to in JSON format. The new SDES NOSHOW RPC was created to update the status of appointments as NO-SHOW. The new VALIDATEAMIS^SDESUTIL utility was created to validate AMIS Stop Codes. The Contact Attempt RPCs were re-written to the new SDES RPC standards. The new SDES GET CLINICS BY CLIN LIST RPC was created and will allow for the processing of up to 50 clinics based on the list of clinic IENs passed in. The corresponding clinics details will be returned in JSON format. The SDES STUCK ORDER CLEANUP option was created and added to the SDSUP menu. The VS GUI was updated to de-activate the duration dropdown feature thereby preventing them from being able to extend the timeslots for fixed timeslot clinics. The VS GUI was updated to interpret | as a line break as it processes the Patient Comment field. The scroll bar feature will be enabled when the data in the Patient Comment field cannot be fully displayed within the window. The SERVICE CONNECTED PERCENTAGE (#14) field from the SDEC APPT REQUEST (#409.85) file was added to the SDES GET APPT REQ BY* RPCs. The SDES PCESAVE RPC was removed from the SDESRPC option and from the REMOTE PROCEDURE (#8994) file. The VS GUI was checked and updated to ensure the display and scroll bars are set to the top of the display boxes. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.35.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.35.0 and VistA patch * * SD*5.3*831 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- SDES ERROR CODES New errors being Modified (#409.93) deployed 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 ------------- ----------------------- -------------------- Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC EDITAPPT Modified SDES GET APPT BY REQ/APPT TYP2 Modified SDES GET APPTS BY CLIN IEN 3 New SDES GET APPTS BY CLIN LIST2 Modified SDES GET APPTS BY IEN 2 Modified SDES GET APPTS BY PATIENT DFN3 Modified SDES GET APPTS BY RESOURCE Modified SDES GET CANCMTS New SDES GET CLINICS BY CLIN LIST New SDES GET PATIENT PREF New SDES GET PATIENT WARD New SDES NOSHOW New SDES PCESAVE Deleted SDES UNDO CHECKOUT New SDES UNDO NOSHOW New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-3017: VistA: Add clinic time zone field to appointment object. Problem: The CHIP team requests addition of clinic time zone to appointment object in SDES GET APPTS BY PATIENT DFN3. The following RPCs call into the same appointment object so will also be affected by the change: SDES GET APPTS BY IEN 2 SDES GET APPT BY REQ/APPT TYP2 SDES GET APPTS BY CLIN IEN 3 SDES GET APPTS BY CLIN LIST2 SDES GET APPTS BY RESOURCE Resolution: The routines that support the creation of the appointment object was updated to include the TIMEFRAME (#.01), OFFSET (#.02) and the CODE (#.03) fields from the TIMEFRAME (#1) multiple in the WORLD TIMEZONES (#1.71) file. 2) VSE-3453: UI: Fix Phone Number Formatting in Patient Info. Problem: The phone number formatting under patient info needs to be updated so the VS GUI displays and sends the correctly formatted number to VistA. Currently, if you put a number into patient info in VS GUI, GUI sends it to VistA formatted as 123-1231234, although to the user it appears to be in the proper format. Currently, if you try to delete the space after the close parenthesis from the GUI ((123) 123-1234), then the GUI will send the number as (123) 123-1234, not (123)123-1234, as one might expect. Resolution: The VS GUI has been updated to always send the properly formatted phone number to VistA. 3) VSE-3854: VistA: Create a SDES RPC to undo Check-Out for an appointment. Problem: Please create a RPC in the SDES menu option to undo Check-Out for an appointment. Resolution: The SDES UNDO CHECKOUT RPC was created to undo a check out and to reset the necessary fields back to their prior state. 4) VSE-4118: VistA: Modify SDES GET PAT FLAGS to return local patient flags. Problem: Please modify SDES GET PAT FLAGS so that it returns the following flags: * National Flags * Fugitive Felon Flag * Local Flags Resolution: The National Flags, Fugitive Felon Flag and the Local Flags have been added to the return JSON object for the SDES GET PAT FLAGS RPC. 5) VSE-4148: VistA: Write SDES RPCs for profile service gaps. Problem: A new RPC is needed to return the following data: * Patient's primary care physician * Patient's mental health physician * Patient warning flags (fugitive felon, restricted record, controlled substance) * Patient ward * Hearing impaired * Gender specific provider preference * Needs escort * Special mode of transportation * On stretcher * Day of week appointment preference * Time of day appointment preference Resolution: The new SDES GET PATIENT PREF RPC was created to return the needed patient preferences data in JSON format. The new SDES GET PATIENT WARD RPC was created to return the ward that the patient is currently assigned to in JSON format. 6) VSE-4149: VistA: Create SDES RPC to mark appt as No Show. Problem: Need to create a new SDES RPC that will update appointments as No Shows. Resolution: The new SDES NOSHOW RPC was created to update the status of appointments as NO-SHOW. 7) VSE-4150: VistA: Create SDES RPC to Undo No Show. Problem: Need to create a new SDES RPC that will update appointments that were previously updated to a status of NO-SHOW by removing the NO-SHOW status and allowing them to be updated as the appointment is processed. Resolution: The SDES UNDO NOSHOW RPC was created and will remove the NO-SHOW status from the appointment. 8) VSE-4152: VistA: Modify RPCs that utilize stop codes to put AMIS logic into a tag. Problem: All RPCs that utilize AMIS stop codes should call a single tag for AMIS stop code logic. Resolution: The new VALIDATEAMIS^SDESUTIL utility was created to validate AMIS Stop Codes. 9) VSE-4155: VistA: Rewrite Contact Attempt RPCs in the SDES menu option Problem: Rewrite Contact Attempt RPCs in the SDES menu option. * SDEC CONTACT DISPLAY * SDEC CONTACT DISPLAY SINGLE * SDEC CONTACT MULTI-DISPLAY * SDEC CONTACT SEQUENCE * SDEC CONTACT SEQUENCE SINGLE * SDEC CONTACT NEW * SDEC CONTACT UPDATE * SDEC CONTACT STOP CODE Resolution: The Contact Attempt RPCs were re-written to match our current Scheduling standards. 10) VSE-4267: VistA: Create an SDES RPC to batch retrieve clinic information. Problem: Need to create a new SDES RPC that will perform a batch retrieval of clinic information. The RPC would accept a list of clinic IENs for retrieval and return the clinic details for all of the clinic IENs provided as input. Resolution: The new SDES GET CLINICS BY CLIN LIST RPC was created and will allow for the processing of up to 50 clinics based on the list of clinic IENs passed in. The corresponding clinics details will be returned in JSON format. 11) VSE-4299: VistA: Create a tool to clean up stuck orders. Problem: Need to create another orders-related tool to go in the SDSUP menu to help sites address orders stuck in pending status. The user would input an order number (or many), and check the PACKAGE REFERENCE field in the ORDER file against the associated entry in 409.85. If the associated entry is a child, grab the parent IEN, if it is not a child then use reference number. If that request is dispositioned, then based on the disposition 'discontinue' or complete the order. This would automate the steps that we and the CPRS team have been doing on our own, and empower the sites to check/update these orders on their own using the same VSSC reports they export and send to us now. It would be an improvement over the existing options, as those don't update child MRTCs, and many of the orders we hear about are stuck in partial status. Resolution: The SDES STUCK ORDER CLEANUP option was created and added to the SDSUP menu. 12) VSE-4301: UI: Disable the Duration Field in the New Appt Dialog for Fixed Timeslot Clinics. Problem: When users are scheduling a new appointment in a fixed timeslot clinic, disable the duration dropdown so that the clinic timeslots cannot be extended. Resolution: The VS GUI was updated to de-activate the duration dropdown feature thereby preventing them from being able to extend the timeslots for fixed timeslot clinics. 13) VSE-4380: UI: Modify Patient Comments to Include Line Breaks. Problem: The VAOS team is populating the Patient Comment field with several values and has delineated them using the | symbol. In GUI, the patient comments field for Veteran requests needs to be modified to interpret the | as a line break to better display the information provided. Need to ensure all text is visible which may require a scroll bar so the user can see all the text. But the Patient comments box should remain disabled. Resolution: The VS GUI was updated to interpret | as a line break as it processes the Patient Comment field. The scroll bar feature will be enabled when the data in the Patient Comment field cannot be fully displayed within the window. 14) VSE-4449: VistA: Modify SDES GET APPT REQ BY * RPCs to return Service Connected Percentage. Problem: Modify SDES GET APPT REQ BY * RPCs to return Service Connected Percentage (#409.85, field 14). Add new data return to SDES REQ Wrapper. The following RPCs should be modified: SDES GET APPT REQ BY APPT IEN 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 LIST BY DFN Resolution: The SERVICE CONNECTED PERCENTAGE (#14) field from the SDEC APPT REQUEST (#409.85) file was added to the listed RPCs. 15) VSE-4477: VistA: SDES RPC to return local and national canned cancellation comments. Problem: Need to create an SDES version of the SDEC CANCMT RPC to return national and local cancellation comments. Comments are stored in the SDEC CANCELLATION COMMENT file. National or Local is indicated by the NATIONAL NOTE? field (Y/N). Resolution: The new SDES GET CANCMTS was created based off of the existing SDEC CANCMT and updated to our existing SDES RPC standards. 14) VSE-4557: VistA: Remove SDES PCESAVE. Problem: SDESPCESAVE made it through SQA as part of SD*5.3*828. Need remove SDES PCESAVE including any reference to the ticket/RPC from the Patch Description and remove SDES PCESAVE from the OPTIONS file and delete it from the RPC file as part of SD*5.3*831. Resolution: The SDES PCESAVE RPC was removed from the SDESRPC option and from the REMOTE PROCEDURE (#8994) file. 15) VSE-4563: VS GUI: Patient Record Flag Scrolling to the Bottom. Problem: When accessing a veteran with a patient record flag in VS GUI, the display box opens scrolled to the bottom which forces users to scroll up to read the message. This occurs on Patient Inquiry as well. Resolution: The VS GUI was updated to the display and scroll bar are set to the top of the display box for patients with a record flags. Test Sites: ----------- Fort Harrison, MT (FHM) San Diego, CA (SDC) 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_35_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_35_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.35.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_35_0_P.MSI Binary VS GUI R1.7.35.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_35_0_T.MSI Binary VS GUI R1.7.35.0 VDD VS_GUI_1_7_35_0 VDD Binary VS GUI R1.7.35.0 DIBR VS_GUI_1_7_35_0 DIBR Binary VS GUI R1.7.35.0 Release Notes VS_GUI_1_7_35_0 RN Binary VS GUI R1.7.35.0 Technical Manual VS_GUI_1_7_35_0 TM Binary VS GUI R1.7.35.0 User Guide Addendum VS_GUI_1_7_35_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 SDES831P 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. 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*831. 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*831. 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 SDES831P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES831P 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*831. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.34. If 1.7.35.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.34.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_35_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 4 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDCODEL Before: B14749068 After: B14815155 **20,27,44,97,105,110,132,257, 627,717,831** Routine Name: SDEC26 Before: B17286312 After: B13550247 **627,658,722,831** Routine Name: SDES2 Before: B5291710 After: B6125801 **816,818,819,820,823,825,826,831** Routine Name: SDES831P Before: n/a After: B2328998 **831** Routine Name: SDESCLINICAVAIL Before: B31113269 After: B35474236 **800,805,809,816,820,823,826, 827,828,831** Routine Name: SDESCLINICDATA Before: B3279922 After: B7557689 **788,823,825,828,831** Routine Name: SDESCLINICSET Before:B219070518 After:B212673293 **799,805,820,824,825,831** Routine Name: SDESGETAPPTREQ Before:B204460220 After:B206712180 **815,818,819,823,824,825,828,831** Routine Name: SDESGETCANCMT Before: n/a After: B5816220 **831** Routine Name: SDESGETCLINSIEN Before: n/a After: B3310060 **831** Routine Name: SDESGETPRFGAPS Before: n/a After: B20332771 **831** Routine Name: SDESGETREQWRAPPR Before: B73209401 After: B74362994 **815,818,820,823,825,831** Routine Name: SDESNOSHOW Before: n/a After: B62188321 **831** Routine Name: SDESORDCLEAN Before: n/a After: B32043003 **831** Routine Name: SDESPATFLAGS Before: B7271900 After: B8713230 **818,831** Routine Name: SDESUNDOCHECKOUT Before: n/a After: B15251040 **831** Routine Name: SDESUTIL Before: B47340300 After: B63229611 **801,804,805,814,816,818,820, 823,824,825,831** Routine list of preceding patches: 717, 722, 828 ============================================================================= User Information: Entered By : Date Entered : OCT 25, 2022 Completed By: Date Completed: JAN 13, 2023 Released By : Date Released : JAN 13, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT