$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Monday, 11/01/21 at 08:58 ============================================================================= Run Date: NOV 15, 2021 Designation: SD*5.3*799 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #650 Status: Released Compliance Date: NOV 30, 2021 ============================================================================= Associated patches: (v)SD*5.3*797 <<= must be installed BEFORE `SD*5.3*799' (v)SD*5.3*648 <<= must be installed BEFORE `SD*5.3*799' Subject: VS GUI VERSION 1.7.14 Category: - Routine - Data Dictionary - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.14 and SD*5.3*799 includes several defect corrections and enhancements. This release adds a Demographics indicator on the VS GUI check-in window that will be exposed in a future release, adds new Remote Procedure Calls (RPC) to Add, Modify, View/Get, and Remove a clinic from HOSPITAL LOCATION file (44), a new PRC to return patient demographics with residential address and cell phone, with city and state separated, in JSON format, and adds clinic name and Internal Entry Number (IEN) to Video Visit Service (VVS) create/edit requests. Additionally, the release modifies SDES RPCs to accept an Enterprise Appointment Scheduling (EAS) transaction ID, adds EAS Tracking number field to SDEC files, improves Single Sign-On Internal (SSOi) certificate selection on login, fixes an issue where no-showing an Multiple Return to Clinic (MRTC) appointment resulted in a "stuck" MRTC child request, and fixes an issue on initial Request Management (RM) Grid load where requests were displayed with missing data, corrects a data issue causing an error message for certain appointment requests. This release also corrects an issue where no-showing MRTC appointment resulted in a "stuck" MRTC child request. ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.14 of VS is installed. * * * * * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI v1.7.14 and VistA patch * * SD*5.3*799 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** Patch Components: ----------------- Files & Fields Associated: -------------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- RECALL REMINDERS (#403.5) EAS TRACKING NUMBER (#100) New RECALL REMINDERS REMOVED EAS TRACKING NUMBER (#100) New (#403.56) SDEC APPOINTMENT (#409.84) EAS TRACKING NUMBER (#100) New SDEC APPT REQUEST EAS TRACKING NUMBER (#100) New (#409.85) 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 APPADD Modified SDEC APPDEL Modified SDEC RECSET Modified SDES CREATE CLINIC New SDES DISPOSITION APPT REQ Modified SDES EDIT CLINIC New SDES GET CLINIC INFO New SDES GET PATIENT REGISTRATION New SDES INACTIVATE/ZZ CLINIC New SDES MAKE APPT BLOCK AND MOVE Modified SDES SET APPT REQ CREATE Modified SDES SET APPT REQ UPDATE Modified Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: ----------- 1) VSE-1282: .NET: Update editing an appointment request to not reference the type specific wait list tables in Keys. Problem: An issue was found when a user edits an existing appointment request. The first time a request is edited and saved, the code looks at the old specific WaitList tables to remove the one the user is updating and include the updated one. However, since those individual lists are no longer populated, the code does not find the original request, and the logic that exists will add the new one to the table in Keys using ImportRow(). The second time the user edits the request and all times after that, there is an exception trying to access the Internal Entry Number (IEN) field. This is because the WaitList table does not have any column definitions, so when it saves off the data after the first edit, it does not have columns to line them up with (The schema was never defined for that table). When the code tries to access the IEN field, it throws an exception saying "No IEN field in table". Resolution: The code throwing the error was unnecessary and from an older implementation, therefore, it was removed. Now, same requests are editable as many times without an error. 2) VSE-1340: .NET: No-Showing Child MRTC results in lost parent link. Problem: If you no-show a child MRTC, then the link from the request to the parent MRTC is lost and the Return to Clinic (RTC) request gets "stuck" in the Request Management (RM) Grid and cannot be dispositioned/removed by the user. Resolution: VS GUI was updated to prevent the loss of the link from the child MRTC request to the parent MRTC. 3) VSE-1411: .NET GUI: Add Demographics indicator on check-in screen. Problem: The staff members need the ability to know whether a patient has made any demographics changes, so that they can ensure all required information is known. Resolution: A demographics indicator was added to the check-in screen. 4) VSE-1539: .NET Use AssemblyInfo version string for everything Problem: AssemblyInfo.cs is a standard Microsoft one and is accessible via some of the Visual Studio tools. The Keys.ApplicationVersion is a custom duplicate. There is a static Assembly object in the reflection namespace that can get all info from AssemblyInfo.cs. If memory serves that * at the end of the one in AssemblyInfo.cs is also what appends the build version to the assembly, something that Jack really wanting a while back. Figure out where the Keys one is used and then use the one from Assembly and just format the version to how we want, and get rid of the Keys one. Resolution: When building the VS GUI, versioning information was kept in two files, which increased the odds of human error when creating new versions. We removed one of the areas in code this information was kept and now derive it from the standard location. From a user and management perspective, nothing changed, this just simplifies code and potential error from a developer's perspective. 5) VSE-1540: .NET: Simplify and standardize usage of VSEMessageWindow. Problem: Simplify and standardize usage of VSEMessageWindow. Resolution: The following list includes the new message boxes that have replaced the old style: 1. Cancel Appointment without selecting reason 2. Cancel Appointment, comment length exceeds 160 characters (changed text to reflect yes/no vs ok/cancel) 3. Cancel Appointment, Error from ARClose method 4. Contact Attempts invalid characters (caret (^) and semicolon (;)) 5. RM Grid data mapping error 6. MRTC Dialog Open without selected appt 7. Error Opening Find Appointment Dialog 8. New Contact Attempt in Future 9. Update Contact Attempt in Future 6) VSE-1562: VistA: Create RPC to add new clinic to HOSPITAL LOCATION file (44) Problem: Need to create a new RPC to add a new clinic to the HOSPITAL LOCATION (#44) file. Resolution: The new SDES CREATE CLINIC RPC was created to add new clinics to the HOSPITAL LOCATION (#44) file. 7) VSE-1563: VistA: Create RPC to modify existing clinic in HOSPITAL LOCATION file (44) Problem: Need to create a new RPC to edit an existing clinic in the HOSPITAL LOCATION (#44) file. Resolution: The new SDES EDIT CLINIC RPC was created to edit an existing clinic in the HOSPITAL LOCATION (#44) file. 8) VSE-1564: VistA: Create RPC to get clinic information from HOSPITAL LOCATION file (44) Problem: Create new RPC to Read clinic information from HOSPITAL LOCATION (#44) file. * Individual Read (IEN) * List Read (string) Resolution: The new SDES GET CLINIC INFO RPC was created to read clinic information from the HOSPITAL LOCATION (#44) file. 9) VSE-1565: VistA: Create RPC to remove a clinic from HOSPITAL LOCATION file (44) Problem: Need to create new RPC to delete a clinic from HOSPITAL LOCATION (#44) file when provided the IEN of the clinic. In this case, "delete" is ZZ-ing a clinic. Resolution: The new SDES INACTIVATE/ZZ CLINIC RPC was created to "delete" a clinic in the HOSPITAL LOCATION (#44) file. 10) VSE-1580: VistA: Create EAS Tracking Number field Problem: Need to create a new EAS Tracking Number field with auditing turned on in the following files: RECALL REMINDERS (#403.5) RECALL REMINDERS REMOVED (#403.56) SDEC APPOINTMENT (#409.84) SDEC APPT REQUEST (#409.85) Resolution: The new EAS TRACKING NUMBER (#100) field was created and added to each of the specified files with auditing turned on. 11) VSE-1581: VistA: Adjust current SDES RPCs to accept EAS transaction ID Problem: Current SDES and some SDEC RPCs do not accept or return the EAS transaction ID. Resolution: Existing SDES and SDEC RPCs that are required to handle the EAS Tracking Number have been updated to accept the EAS Tracking Number. These following RPC's were updated: SDEC APPADD SDEC APPDEL SDEC RECSET SDEC RECDSET SDEC GET PATIENT RECALLS JSON SDEC GET RECALL BY IEN JSON SDEC GET RECALLRMV BY DFN JSON SDES GET APPT REQ BY IEN SDES GET APPT REQ BY PATIENT SDES SET APPT REQ CREATE SDES SET APPT REQ UPDATE SDES DISPOSITION APPT REQ SDES MAKE APPT BLOCK AND MOVE. 12) VSE-1592: .NET: .NET GUI: Update certificate selection on VS GUI login. Problem: Update certificate selection on logon to use the same format/method as VA Video Connect (VVC). Resolution: Updated certificate selection on VS GUI login to use the same format/method as VA Video Connect (VVC). 13) VSE-1606: VistA: Create new RPC based on SDEC GETREGA Problem: A new RPC based on existing RPC, SDEC GETREGA, needs to be created to return patient registration in a JSON format. Solution: A new RPC, SDES GET PATIENT REGISTRATION, was created using SDEC GETREGA as a starting point. Additional fields were added and the code was optimized. 14) VSE-1714: .NET: RM Grid display is missing data for initial RM grid load Problem: When RM grid initially loads for a site, requests are displayed with missing data. This is only for "site-wide" RM grid. Requests display appropriately when patient is in context. Resolution: Updated initial appt request pull to use old RPC method as the json version was relying on keys having a selected patient when mapping data. 15) VSE-1717: Must push Enter twice to log in after entering access / verify Problem: Changes implemented in VSE-1592 prevent log in occurring after pressing enter. Resolution: Removed IsDefault from BtnPiv so BtnOk is triggered on Enter key press. 16) VSE-1755: .NET GUI - Gather and include clinic name and Internal Entry Number (IEN) on Video Visit Service (VVS) create/edit requests. Problem: Include the ClinicIEN and Clinic Name in the Location object in both Patient and Provider. Resolution: The fix adds the clinic information (Name and IEN) to the VVS create/edit web service request. 17) VSE-1877: Undefined error occurs when SDCANCEL is run to cancel a clinic's availability Problem: Undefined error occurs when SDCANCEL is run to cancel a clinic's availability. Resolution: Logic was added to set the EAS tracking number to null if it is not passed in. Test Sites: ----------- Hines, IL (HIN) 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_14_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_14_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.14 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_14_P.MSI Binary VS GUI R1.7.14 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_14_T.MSI Binary VS GUI R1.7.14 VDD VS_GUI_1_7_14 VDD Binary VS GUI R1.7.14 DIBR VS_GUI_1_7_14 DIBR Binary VS GUI R1.7.14 Release Notes VS_GUI_1_7_14 RN Binary VS GUI R1.7.14 Technical Manual VS_GUI_1_7_14 TM Binary VS GUI R1.7.14 User Guide Addendum VS_GUI_1_7_14_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 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 SDEC799P 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*799. 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*799. 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 SDEC799P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC799P 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*799. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.13. If 1.7.14 VS GUI was installed, it will need to be reverted to VS GUI 1.7.13. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_14_ DIBR.pdf. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 7 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC Before:B136529127 After:B136558013 **627,643,642,651,658,665,672, 679,686,694,745,756,790,799** Routine Name: SDEC07 Before:B182578667 After:B176107133 **627,642,651,658,665,669,671, 672,701,686,740,694,785,788, 790,799** Routine Name: SDEC08 Before:B182181620 After:B188278472 **627,651,658,665,722,740,744, 694,745,756,774,781,785,790, 792,796,797,799** Routine Name: SDEC52A Before: B58946534 After: B60099552 **627,658,694,745,774,799** Routine Name: SDEC52CJSON Before: B43237930 After: B45484245 **784,785,788,790,799** Routine Name: SDEC52CRMVJSON Before: B48950491 After: B50579327 **790,799** Routine Name: SDEC799P Before: n/a After: B1898208 **799** Routine Name: SDECAR2 Before:B205445845 After:B204137546 **627,642,658,671,686,694,745,799** Routine Name: SDES Before: B17156529 After: B28104915 **788,790,792,794,797,799** Routine Name: SDESAPTREQSET Before:B168400571 After:B172941127 **794,799** Routine Name: SDESARCLOSE Before: B7247105 After: B7891139 **794,799** Routine Name: SDESARGET Before: B90865906 After: B93986949 **794,799** Routine Name: SDESBLKANDMOVE Before:B162734102 After:B187797322 **797,799** Routine Name: SDESCLINICSET Before: n/a After:B162040270 **799** Routine Name: SDESCLINICSET2 Before: n/a After: B80897923 **799** Routine Name: SDESGETREGA Before: n/a After: B50470187 **799** Routine Name: SDESINACTCLINIC Before: n/a After: B3178351 **799** Routine Name: SDESJSON Before: B28507962 After: B55062550 **788,794,797,799**Aug 13, 1993 Routine Name: SDESRTVCLN Before: n/a After: B55469323 **799** Routine Name: SDRRISRU Before: B15714753 After: B16810800 **536,627,648,799** Routine list of preceding patches: 648, 797 ============================================================================= User Information: Entered By : Date Entered : SEP 23, 2021 Completed By: Date Completed: NOV 15, 2021 Released By : Date Released : NOV 15, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT