$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Wednesday, 04/06/22 at 12:19 ============================================================================= Run Date: APR 26, 2022 Designation: SD*5.3*813 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #665 Status: Released Compliance Date: MAY 09, 2022 ============================================================================= Associated patches: (v)SD*5.3*781 <<= must be installed BEFORE `SD*5.3*813' (v)SD*5.3*809 <<= must be installed BEFORE `SD*5.3*813' Subject: VS GUI VERSION 1.7.22.0 Category: - Routine Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.22.0 and SD*5.3*813 includes several defect corrections and enhancements including updates to the Calendar Appointment Selected Item to make them 508 compliant. The tabbing logic on the Cancel Appointment dialog box was updated to follow the necessary business flow. The tabbing on the Temporary Address was updated to follow the necessary business flow. The new SDES CREATE APPT #409.84 RPC was created to add new appointments to the SDEC APPOINTMENT (#409.84) file. The new SDES EDIT APPT #409.84 RPC was created to allow editing of the Notes and Appointment Length fields in the SDEC APPOINTMENT (#409.84) file. The User Preferences in the VS GUI was updated to account for new CA columns for text, email, secure messaging. The VS GUI was updated to allow for the printing of a patient-friendly appointment based on input from the PI Planning board. Several RPCs were updated to include CA counts for text message, secure messaging, and email. The VS GUI was updated to include the time zone information for all the Patient letters and to the Expand Entry screen. The SDES GET CLINIC INFO RPC was updated to return the time zone information. A new tool tip was added to the clinic calendar noting instances where the time zone could not be determined for a selected clinic and info on how to submit a YourIT ticket to remedy this situation. The VS GUI was updated to not store the certificate information if the selected certificate fails the authentication process. The ISO 8601 to FileMan conversion API was updated to return and error when an invalid ISO 8601 formatted date is passed in. The main entry point routine for the SDES* name spaced RPCs was updated to include additional Quit statements were added to prevent unwanted code execution. Logic was added to the SDES CREATE CLIN RPC logic to create a corresponding entry in the SDEC RESOURCE (#409.831) file. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.22.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.22.0 and VistA patch * * SD*5.3*813 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- 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 ----------- ---- -------------------- SDECRPC Broker (Client/Server) Modified 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 ARGET Modified SDEC GET PATIENT APPT REQ JSON Modified SDEC GET PATIENT CONSULT JSON Modified SDEC GET PATIENT RECALLS JSON Modified SDEC GET RECALLRMV BY DFN JSON Modified SDEC RECGET Modified SDEC REQGET Modified SDES CREATE APPT #409.84 New SDES EDIT APPT #409.84 New SDES PRINT PATIENT APPTS New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-179: - Tasks Tab - Calendar Appointment Selected Item. Problem: Address 508 requirements for Calendar Appointment Selected Item on the Tasks tab or Slot View. Resolution: The Calendar Appointment Selected Item on the Tasks tab and Slot View were reviewed and updated to be 508 compliant. 2) VSE-827: 508 - Tabbing on Cancel Appointment is not correct. Problem: The tabbing on the Cancel Appointment dialog box is incorrect. It goes to the OK button before it goes to National and doesn't include the Local area at all. Resolution: The tabbing logic on the Cancel Appointment dialog box was updated to follow the correct business flow. 3) VSE-1315: 508 - Demographics - Tabbing on Temp Address. Problem: The VS GUI is not going to the correct next prompt under the following situation: Bring patient into context Right mouse click on Patient information Open Temporary address Click on Address Active? Checkbox Enter a date into Start date of T-5 Tab goes to Address Information not End Date Resolution: The VS GUI was updated to properly process Start Dates that use the T-# of days input and to direct the user to the End Date prompt. 4) VSE-1898: - VistA: SDES routine to add appointment to 409.84 - CREATE. Problem: Create SDES RPC to add an appointment to 409.84 (if this does not already exist). Resolution: The new SDES CREATE APPT #409.84 RPC was created to add new appointments to the SDEC APPOINTMENT (#409.84) file. 5) VSE-1899: - VistA: Create routine to update appointment entry in 409.84 - UPDATE. Problem: Create RPC to update an appointment in 409.84. The editable fields should be: Notes, Appointment Length. Resolution: The new SDES EDIT APPT #409.84 RPC was created to allow editing of the Notes and Appointment Length fields in the SDEC APPOINTMENT (#409.84) file. 6) VSE-2586: .NET: Update User Preferences to account for new CA columns for text, email, secure messaging. Problem: User preferences needs to be updated to account for the three new columns added for secure messaging, and email. Users should be able to drag and drop these columns into preferred order, as with existing columns in user preferences. Resolution: The VS GUI was updated to allow for the selection and ordering of the 3 new columns that are now available to help the user uniquely identify the patient. 7) VSE-2601: .NET: Appointment List Print. Problem: Users would like the ability to print a patient-friendly appointment list. (from PI Planning board) Displays only active appointments (not cancelled, not no-shows) Appointment list is based on field in hospital location file (display to patients) List includes time zone List displays appointments from current time forward - T+90 - this is consistent with existing print pending Resolution: The VS GUI was updated to allow for the printing of a patient-friendly appointment based on input from the PI Planning board. 8) VSE-2606: VistA: Update or Create RPC to return CA count for new CA methods. Problem: In order to display CA counts for text message, secure messaging, and email in columns in the RM grid, UI needs an RPC to return those counts. Provide RPC that returns # of CAs for text, email, and secure messaging (separate sums) for a request. Resolution: The following RPCs were updated to return the counts noted above: SDES REQGET SDEC RECGET SDEC ARGET SDEC GET PATIENT APPT BY REQ JSON SDEC GET RECALLRMV BY DFN JSON SDEC GET PATIENT RECALLS JSON SDEC GET PATIENT CONSULT JSON SDES PRINT PATIENT APPTS 9) VSE-2609: .NET: Add Time Zone Entry to Print Letter and Expand Entry. Problem: Add time zone entry to 2 additional strings - Patient Letter and Expand Entry. All Patient Letters (No show, cancel) Resolution: The VS GUI was updated to include the time zone information on all the Patient letters and to the Expand Entry screen. 10) VSE-2610: VistA: Add Time Zone Entry to Print Letter and Expand Entry. Problem: Add time zone entry to 2 additional strings - Patient Letter and Expand Entry. All Patient Letters (No show, cancel) Resolution: The SDEC40 and SDECEPT routines were updated to return the time zone information. 11) VSE-2612: VistA: Update SDES GET CLINIC INFO to return time zone. Problem: Update SDES GET CLINIC INFO to return clinic's time zone. Resolution: The SDESRTVCLN was updated to return the time zone information. 12) VSE-2621: VistA: Appointment List Print. Problem: Users would like the ability to print a patient-friendly appointment list. Displays only active appointments (not cancelled, not no-shows) Appointment list is based on field in hospital location file (display to patients) List includes time zone List displays appointments from today forward (clarify with OVAC if this is T+30, 90, user-defined). Resolution: The SDES and SDESPRINTPATAPPT were updated to screen and return the data for a patient-friendly appointment list based on input from the PI Planning board. 13) VSE-2639: .NET: Add tool tip to calendar regarding clinic time zone. Problem: Need to add a tool tip to the clinic calendar to advise the user that if time zone shows as "undefined," they should submit a YourIT ticket. Resolution: A new tool tip was added to the clinic calendar noting instances where the time zone could not be determined for a selected clinic and info on how to submit a YourIT ticket to remedy this situation. 14) VSE-2640: .NET: Add CA columns for text, secure message, email. Problem: Add CA columns for text, secure message, email to RM grid. Resolution: The VS GUI was updated to allow for the selection and ordering of the 3 new columns that are now available to help the user uniquely identify the patient. 15) VSE-2641: .NET: Do not store cert if wrong certificate is selected on demographics endpoint auth. Problem: .NET: Do not store cert if wrong certificate is selected on demographics endpoint auth-user should have the opportunity to select the correct certificate (currently, they will continue to get the same error because the selected cert is stored). Resolution: The VS GUI was updated to not store the certificate information if the selected certificate fails the authentication process. 16) VSE-2645: VistA: Update SDAMUTDT to return error on a bad date. Problem: Currently if an invalid date/time, (i.e. 4/31/2022T08:00-0500) is passed into $$ISOTFM^SDAMUTDT no error is returned. Please update the $$ISOTFM^SDAMUTDT function to return an error if a bad date/time is passed in. Resolution: The $$ISOTFM^SDAMUTDT was updated to return and error when an invalid ISO 8601 formatted date is passed in. 17) VSE-2664: VistA: Add QUITS to SDES. Problem: Several of the RPC entry points in the SDES routines needed Quit statements to prevent the execution from dropping into the next RPC code. Resolution: Additional Quit statements were added to prevent unwanted code execution. 18) VSE-2769: VistA: Update SDEC RESOURCE file when a clinic is created using SDES namespace. Problem: When creating a new clinic using the SDES CREATE CLIN RPC a corresponding entry also needs to be created in the SDEC RESOURCE (#409.831) file. Resolution: The existing logic from the SDBUILD option was added to the SDES CREATE CLIN RPC logic so that both entries are created during the same process. Test Sites: ----------- Detroit, MI (DET) North Texas (NTX) 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_22_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_22_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.22.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_22_0_P.MSI Binary VS GUI R1.7.22.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_22_0_T.MSI Binary VS GUI R1.7.22.0 VDD VS_GUI_1_7_22_0 VDD Binary VS GUI R1.7.22.0 DIBR VS_GUI_1_7_22_0 DIBR Binary VS GUI R1.7.22.0 Release Notes VS_GUI_1_7_22_0 RN Binary VS GUI R1.7.22.0 Technical Manual VS_GUI_1_7_22_0 TM Binary VS GUI R1.7.22.0 User Guide Addendum VS_GUI_1_7_22_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: ------------------------- This patch serves as notification that the new VS GUI associated with this patch is available for installation. Please refer to the VS GUI DIBR for instructions on 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 SDEC813P 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*813. 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*813. 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 SDEC813P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC813P 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*805. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.21. If 1.7.22.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.21.1. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_22_0_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;13 Aug 1993;Build 6 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDAMUTDT Before: B48314741 After: B49653370 **266,805,809,813** Routine Name: SDEC40 Before: B76900731 After: B78135295 **627,665,694,785,813** Routine Name: SDEC51 Before:B203707691 After:B195285057 **627,642,651,658,686,745,756,813** Routine Name: SDEC52 Before:B184547232 After:B188796403 **627,642,651,658,745,813** Routine Name: SDEC52CJSON Before: B45484245 After: B52218491 **784,785,788,790,799,813** Routine Name: SDEC52CRMVJSON Before: B50579327 After: B57303052 **790,799,813** Routine Name: SDEC813P Before: n/a After: B2328482 **813** Routine Name: SDECAR1 Before:B187704855 After:B192065966 **627,642,658,686,694,745,813** Routine Name: SDECAR1A Before: B50641289 After: B57788494 **658,745,756,781,813** Routine Name: SDECAR4 Before:B129709695 After:B134299297 **784,785,788,805,813** Routine Name: SDECCONSJSON Before: B38202800 After: B41924440 **784,785,788,805,807,813** Routine Name: SDECEPT Before:B160045264 After:B162553255 **669,671,694,794,809,813** Routine Name: SDES Before: B68447669 After: B80563301 **788,790,792,794,797,799,800, 801,803,804,805,807,809,813** Routine Name: SDESAPPTEDIT Before: n/a After: B15353418 **813** Routine Name: SDESAPPTREQ40984 Before: n/a After: B60059499 **813** Routine Name: SDESARGET Before:B107746639 After:B111928516 **794,799,805,809,813** Routine Name: SDESCCAVAIL Before: B45013192 After: B45175425 **800,805,809,813** Routine Name: SDESCLINICSET2 Before: B80897923 After: B95716906 **799,813** Routine Name: SDESGETRECALL Before: B49623541 After: B56525175 **803,805,809,813** Routine Name: SDESJSON Before: B83530197 After: B87852471 **788,794,797,799,800,801,803, 805,807,809,813** Routine Name: SDESPRINTPATAPPT Before: n/a After: B11642913 **813** Routine Name: SDESRTVCLN Before: B57735157 After: B59323522 **799,805,807,813** Routine list of preceding patches: 781, 809 ============================================================================= User Information: Entered By : Date Entered : FEB 25, 2022 Completed By: Date Completed: APR 26, 2022 Released By : Date Released : APR 26, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT