$TXT Created by CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Tuesday, 06/15/21 at 08:37 ============================================================================= Run Date: JUL 06, 2021 Designation: SD*5.3*785 Package : SD - SCHEDULING Priority: EMERGENCY Version : 5.3 SEQ #637 Status: Released Compliance Date: JUL 20, 2021 ============================================================================= Associated patches: (v)SD*5.3*679 <<= must be installed BEFORE `SD*5.3*785' (v)SD*5.3*784 <<= must be installed BEFORE `SD*5.3*785' Subject: VSE ENHANCEMENTS VS GUI RELEASE 1.7.7.4 Category: - Routine - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.7.4 and SD*5.3*785 include various enhancements and defect fixes. The release includes Remote Procedure Call (RPC) updates to optimize Request Management (RM) grid functionality, pending Return to Clinic (RTC) Order Cleanup Option enhancements, enhancements to PtCSch Workflow, enhancements to APPT workflow, and addresses an issue where recalls being cancelled by the clinic would not return the request to the RM grid. The release also addresses the patient letter to remove (Mr/Ms) titles and 508 issue fixes. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.7.4 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.7.4 and VistA patch * * SD*5.3*785 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- SDEC SETTINGS (#409.98) CURRENT GUI VERSION (#2) Modified GUI VERSION EFFECTIVE DATE (#3) Modified 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 (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 ------------- ----------------------- -------------------- N/A Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC GET APPT REQ BY IEN JSON New SDEC GET PAT CONSULT BY IEN New SDEC GET PATIENT CONSULT JSON New SDEC GET PATIENT DEMOG New SDEC GET PATIENT RECALL BY IEN New SDEC GET PATIENT RECALLS Modified SDEC GET PATIENT RECALLS JSON Modified SDEC GET RECALL BY IEN JSON New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) Jira #VSE-635 - Review Consults/Procedure RPCs Problem: The VS GUIs RPCs related to Consults/Procedures need to be reviewed to determine what optimizations can be made to help improve the response time of the VS GUI while processing these records. Resolution: The VS GUI Trace Logs were reviewed and the new SDEC GET PAT CONSULT BY Internal Entry Number (IEN) RPC was created to return 17 key fields needed to help populate the VS GUI screens related to the review and processing of the Consults and Procedures. 2) Jira #VSE-717 - Create new RPC to return a single Consult in JavaScript Object Notation (JSON) format. Problem: The VS GUI is being updated to utilize RPCs returning data in JSON format. Create new SDEC GET PAT CONSULT BY IEN RPC in JSON format. Resolution: The new SDEC GET PATIENT CONSULT JSON RPC was created to return the 17 key fields needed to help populate the VS GUI screens related to the review and processing of the Consults and Procedures. 3) Jira #VSE-664 - Create Patient Search RPC to return basic Patient information Problem: a) Although the Social Security Number (SSN) that is passed in uses the 9N format identifier, those SSNs that contained Hyphens ("-") were not being recognized properly (i.e. nnn-nn-nnnn). b) Modification was needed to only allow four numerics (4N) to be passed in with Alpha last name. c) Patients with a SENSITIVE data flag were not being marked with the "Sensitive" message. d) A space was missing between the type of letter and the "Letter not defined" message. Resolution: a) Modifications were made to recognize the hyphen within the SSN. b) The passing in of a format of First Alpha of Last Name concatenated with Numerics has changed from its prior functionality. Now, only A4N format is valid, as we have invalidated the A1N, A2N, A3N formatted type entries. c) Modifications were made to add the Patient Sensitivity Flag as the 8th piece of data in the returned string of the RPC SDEC GET PATIENT DEMOG. d) Added a missing "space" in the Warning message for "letter not defined" (i.e. from "Pre-AppointmentLetter not defined for Clinic." to "Pre-Appointment Letter not defined for Clinic.") 4) Jira #VSE-663 - Create new RPC in JSON format to send the list of recalls associated with a given patient. Problem: The VS GUI is being updated to utilize RPCs returning data in JSON format. Create new, trimmed version of SDEC RECGET in JSON format. Resolution: The new SDEC GET PATIENT RECALLS JSON RPC was created to return the 20 key fields needed to help populate the VS GUI screens related to the review and processing of Recalls. 5) Jira #VSE-724 - Create new RPC to return a single Appointment Request in JSON format. Problem: The VS GUI is being updated to utilize RPCs returning data in JSON format. Create new SDEC GET APPT REQ BY IEN JSON format. Resolution: The new SDEC GET APPT REQ BY IEN JSON RPC was created to return the 39 key fields needed to help populate the VS GUI screens related to the review and processing of the Appointment Requests. 6) Jira #VSE-634 - Create new RPC that will return a single recall Problem: The VS GUI needs an RPC that will return a single Recall based on the IEN being passed to VistA. Resolution: The new SDEC GET PATIENT RECALL BY IEN was created to return the 20 key fields needed to help populate the VS GUI screens related to the review and processing of a single Recall. 7) Jira #VSE-684 - Pending RTC Order Cleanup Option Enhancement: Confirmation Message Problem: Request an enhancement to the RTC Cleanup tool to have it present with user with a confirmation message before it runs. This will allow the user to change their mind after selecting the OPTION. Resolution: Both SDEC PENDING RTC - FULL and SDEC PENDING RTC - DATE options were modified to include a confirmation message to ensure that the user wants to run the cleanup tool. 8) Jira #VSE-685 - Pending RTC Order Cleanup Option Enhancement: Date Clarification Problem: Request an enhancement to the RTC Cleanup tool (SDEC PENDING RTC - DATE) to define that the date being prompted for is the Create date. Resolution: SDEC PENDING RTC - DATE was modified to present the user with a prompt for what SDEC REQUEST Create dates should be searched on. The information prior to the prompt also informs the user that the Cleanup Tool will select RTCs based on create date. 9) Jira # VSE-686 - Pending RTC Order Cleanup Option Enhancement: Print Results Problem: Request an enhancement for the RTC Order Cleanup Options to return a report of the RTC and Orders that were updated via the tool. Resolution: Added a report to both the SDEC PENDING RTC - FULL and SDEC PENDING RTC - DATE OPTION. The user will now be prompted for a DEVICE and a report with information regarding both the ORDER and the RTC will be printed for any RTC that was selected and cleaned up. 10) Jira # VSE-734 - Create new RPC that will return, in JSON format, a single recall based on the IEN being passed to VistA Problem: VS GUI needs an RPC that will return a single Recall in JSON format based on the IEN being passed into VistA. Resolution: The new SDEC GET PATIENT RECALL BY IEN JSON RPC was created to return the 20 key fields needed to help populate the VS GUI screens related to the review and processing of Recalls. This RPC passes back a single record to the GUI based on the IEN being passed into VistA. 11) Jira #VSE-728 - Correct defect with new contact creation Problem: If a Service (Field 1.1) is passed into the RPC SDEC NEW CONTACT, it will be concatenated with the Main Sequence (Field 2.2). Resolution: When setting into the global, include the system delimiter (^) in front of the service. 12) Jira #VSE-730 - Prevent appointment cancelation if it is in a Checked-In status. Problem: When canceling an appointment, the SDEC APPOINTMENT File (#409.84) would have its status changed to Cancel prior to performing all validation. This would cause the appointment to become stuck. Resolution: Ensure all validation is complete prior to updating any files. 13) Jira #VSE-693 - Modify Patient Letter to Remove Title (Mr/Ms) Problem: Requested modification to patient letters printed from VS GUI to print name only (with no title/prefix) in the salutation Resolution: Modifications were completed to eliminate the Title of Mr/Ms from the following letters: APPOINTMENT CANCELLED, CLINIC CANCELLED, NO-SHOW and PRE-APPOINTMENT. 14) Jira #VSE-168 - Tasks Tab - Patient Search Functionality Problem: Patient Search was not 508 compliant. Resolution: Replaced Patient Search function with pop-up search. Addressed all 508 requirements for the Patient Search function in the tasks tab. 15) Jira #VSE-188 - New Appointment - Remediate 508 findings in New Appointment form Problem: New Appointment Form was not 508 compliant. Resolution: Addressed all 508 findings in the New Appointment form in VS GUI. 16) Jira #VSE-718 - Update GUI to use new SDEC GET PAT CONSULT BY IEN RPC Problem: GUI needed to be updated to use new SDEC GET PAT CONSULT BY IEN RPC. Resolution: Updated the GUI to use SDEC GET PAT CONSULT BY IEN RPC when selecting an appointment from the pending appointments list. 17) Jira #VSE-719 - Update GUI to use new SDEC GET PAT CONSULT RPC Problem: GUI needed to be updated to use new SDEC GET PAT CONSUL RPC. Resolution: Updated the GUI to use SDEC GET PAT CONSUL RPC. 18) Jira #VSE-725 - Remove unnecessary RPC calls Problem: There are 4 RPC calls made every time the context menu is opened in the pending appointments list. Remove these calls, as they are unnecessary. Resolution: Removed the 4 unnecessary RPC calls made when opening the context menu in the pending appointments list. 19) Jira #VSE-726 - Updates to GUI to support new SDEC ARGET RPC Problem: Update GUI to use the new SDEC ARGET RPC that returns only needed data for a specific appointment. Resolution: The GUI was updated to use the new SDEC ARGET RPC which returns only needed data for a specific appointment and includes incorporating the data into the service layer that sits between the VS GUI and VistA. 20) Jira #VSE-735 - Update GUI to use new SDEC GET PATIENT RECALL BY IEN RPC Problem: Update the GUI to use the new SDEC GET PATIENT RECALL BY IEN RPC. Resolution: The GUI was updated to include the new SDEC GET PATIENT RECALL BY IEN RPC. 21) Jira #VSE-741 - Update GUI to use new SDEC GET PATIENT RECALL RPC Problem: Update the GUI to use the new SDEC GET PATIENT RECALL RPC. Resolution: The GUI was updated to include the new SDEC GET PATIENT RECALL RPC. 22) Jira #VSE-786 - Speed up processing of JSON RPC Problem: Current VSE Broker code that processes JSON responses from RPCs is slow. If the JSON response contains a few hundred records, it can take minutes to parse all the data. That is because instead of parsing the data stream as an array of strings, which is how VistA returns JSON, the VSE Broker uses the code intended for single string value RPCs, which checks each character for the end of transmission. Resolution: Modified ADTDataRepository.validateGenericRPCCall() to test for the presence of "JSON" in the RPC name and then if found, use ARRAY for the RPC return type, which results in more efficient parsing. For this to work, JSON RPC's must begin with the SDEC namespace and have "JSON" somewhere in the name. 23) VSE-984: Update Recall Code to Open APPT Request when appointment is cancelled Problem: Modify PtCSch workflow so that an appointment request is opened and displays in the RM grid if an appointment scheduled from a PtCSch request is cancelled. Resolution: Updated the Recall code to open appointment request when appointment is cancelled. Test Sites: ----------- Hines, IL Martinsburg, WV North Texas 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_7_4_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_7_4_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.7.4 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_7_4_P.MSI Binary VS GUI R1.7.7.4 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_7_4_T.MSI Binary VS GUI R1.7.7.4 VDD VS_GUI_1_7_7_4 VDD Binary VS GUI R1.7.7.4 DIBR VS_GUI_1_7_7_4 DIBR Binary VS GUI R1.7.7.4 Release Notes VS_GUI_1_7_7_4 RN Binary VS GUI R1.7.7.4 Technical Manual VS_GUI_1_7_7_4 TM Binary VS GUI R1.7.7.4 User Guide Addendum VS_GUI_1_7_7_4_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/ Documentation Title File Name FTP Mode ------------------------------------------------------------------------ Patch Installation: ------------------- GUI Installation Instructions: ------------------------- Sites using the System Center Configuration Manager (SCCM) push process for installations can find the build documents in the following locations: - CMCB Build Document (Production): https://vaww.eie.domain.ext/SysDesign/CS/DTStatus/SitePages/Build%20Documents. aspx?pid=216 - CMCB Build Document (Test): https://vaww.eie.domain.ext/SysDesign/CS/DTStatus/SitePages/Build%20Documents. aspx?pid=228 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 Implementation Manager Point of Contact: Name: Yoojin Lee Phone: 206-277-4608 Email: Yoojin.Lee@domain.ext Pre/Post Installation Overview: ------------------------------- Routine SDEC785P 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*785. 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*785. 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 SDEC785P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC785P 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*785. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted back to 1.7.6. If 1.7.7.4 VS GUI was installed, it will need to be reverted back to VS GUI 1.7.6. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_7_4_ DIBR.pdf. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 14 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC07 Before:B174269903 After:B176113316 **627,642,651,658,665,669,671, 672,701,686,740,694,785** Routine Name: SDEC08 Before:B173425633 After:B198721859 **627,651,658,665,722,740,744, 694,745,756,774,781,785** Routine Name: SDEC1 Before: B7644254 After: B9928206 **774,781,784,785** Routine Name: SDEC28 Before:B114287193 After:B119593503 **627,642,658,679,785** Routine Name: SDEC28L Before: n/a After: B53017766 **785** Routine Name: SDEC40 Before: B76069863 After: B76900731 **627,665,694,785** Routine Name: SDEC51B Before: B26110756 After: B35649021 **784,785** Routine Name: SDEC52C Before: B16825874 After: B46253345 **784,785** Routine Name: SDEC52CJSON Before: B14945210 After: B45928218 **784,785** Routine Name: SDEC785P Before: n/a After: B1888048 **785** Routine Name: SDECAR4 Before:B108530298 After:B117464535 **784,785** Routine Name: SDECCON Before: B47683442 After: B47792154 **669,686,781,785** Routine Name: SDECCONSJSON Before: B19916985 After: B30391755 **784,785** Routine Name: SDECRRCLEANUP Before: n/a After: B63865712 **785** Routine Name: SDECRTCF Before: B41223478 After: B74862583 **745,785** Routine Name: SDECVVS Before: B26993565 After: B30381980 **781,784,785** Routine list of preceding patches: 679, 784 ============================================================================= User Information: Entered By : Date Entered : APR 22, 2021 Completed By: Date Completed: JUL 06, 2021 Released By : Date Released : JUL 06, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT