$TXT Created by G at CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 06/23/22 at 23:22 ============================================================================= Run Date: AUG 01, 2022 Designation: SD*5.3*819 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #672 Status: Released Compliance Date: AUG 12, 2022 ============================================================================= Associated patches: (v)SD*5.3*818 <<= must be installed BEFORE `SD*5.3*819' Subject: VS GUI VERSION 1.7.27.1 Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.27.1 and SD*5.3*819 includes several defect corrections and enhancements including updating the SDES GET USRPROFILE Remote Procedure Call (RPC) to include the user's security keys and menu options. The Enterprise Appointment Services (EAS) validation was updated in the RPCs to address a reported maximum number error. The VS GUI was updated with keyboard shortcuts to allow the user to open the appointment Context with keyboard input. Four new RPCs in the SDES name space were created and will return JSON output for all privileged users, delete all privileged users, add one privileged user and to delete one privileged user. A new field was added in the SDEC APPT REQUEST (#409.85) file to store the Modality. The User Preferences in the VS GUI was updated to include a "Day" view which can be selected as the default view when opening the VS GUI. The VS GUI was updated to add the Scheduler_OnLoaded to announce to the user that "the calendar is loading" as the calendar loads, sorts and displays the calendar. The VS GUI was updated to allow JAWS to read calendar view mode on pressing the defined hotkey. Four new SDES RPCs were created to search for the following letter types: No-show, Pre-Appointment, Clinic Cancellation, Appointment Cancellation. The SDES SEARCH PROVIDERS RPC was created and will return provider data in a JSON formatted object. The new SDES SEARCH PRIVILEGED USER RPC was created and it returns a list of ACTIVE users from the NEW PERSON (#200) File. The new SDES GET DIVISION LIST RPC was created to return a list of division, given search the search text provided. The method to allow VSE-CS to bypass the Vista Instance Selection in SSOi login was causing unexpected results in other applications that use the same login. The cookie that VSE-CS uses will no longer overwrite or prevent other apps from properly logging in within the same browser session. Five additional RPCs were added to the SDECRPC option. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.27.1 of VS is installed. * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI V1.7.27.1 and VistA patch * * SD*5.3*819 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 MODALITY New (#409.85) (#6) SDES ERROR CODES Modified (#409.93) 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 --------------------- -------------------- SDES ADD PRIV USER New SDES CREATE APPT REQ Modified SDES DELETE PRIV USER New SDES DELETE PRIV USERS New SDES EDIT APPT REQ Modified SDES GET DIVISION LIST New SDES GET LETTER BY IEN New SDES GET LETTER TYPES New SDES GET LETTERS BY TYPE New SDES READ PRIV USERS New SDES SEARCH PRIVILEGED USER New SDES SEARCH PROVIDERS New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-2865: SDES GET USRPROFILE missing security keys and menu options. Problem: Get user profile response is missing user's security keys and menu options. Resolution: The SDESGETUD routine was updated to send all security keys and menu options in the JSON return object. 2) VSE-2869: 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. 3) VSE-3082: Context Menu - 508 - Keyboard Navigation for Context Menu. Problem: As a 508 user, I want the ability to open the appointment Context Menu from the keyboard. Resolution: The VS GUI was updated to with keyboard shortcuts to allow the user to open the appointment Context with keyboard input. 4) VSE-3127: VistA: Fix slowness caused by large list of privileged users for a restricted clinic. Problem: Need to create four new RPCs in the SDES name space which will return JSON output for the following data: Return all privileged users. Delete all privileged users. Add one privileged user. Delete one privileged user. Resolution: The following RPC were created in the SDES name space to return the requested data as a JSON object. Return all privileged users - SDES READ PRIV USERS Delete all privileged users - SDES DELETE PRIV USERS Add one privileged user - SDES ADD PRIV USER Delete one privileged user - SDES DELETE PRIV USER 5) VSE-3155: VistA: Create a new "modality" field in SDEC APPT REQUEST (#409.85) file. Problem: Need to create a new field in the SDEC APPT REQUEST (#409.85) file to store the Modality, which is a set of codes: Face to Face Telephone Video Resolution: The MODALITY (#6) field as created as a set of codes to store the Modality data in the SDEC APPT REQUEST (#409.85) file. The SDES CREATE APPT REQ and SDES EDIT APPT REQ RPCs were updated to include the Modality as an input parameter. Routines SDESGETAPPTREQ and the SDESAPTREQSET were updated to include the Modality data in the JSON return object. 6) VSE-3160: VS GUI: Add "Day" View to User Preferences. Problem: As a user, I want "Day" view added to User Preferences so that I can set this view as the default view to be loaded in the scheduling section of VS GUI. Resolution: The User Preferences in the VS GUI was updated to include a "Day" view which can be selected as the default view when opening the VS GUI. 7) VSE-3161: UI: Add Loading Indicator to Calendar for Visually Impaired User. Problem: As a visually impaired user, I want there to be a loading indicator when I key in the shortcut to go to the calendar so that I am notified if the section is still loading or has not loaded in VS GUI. Resolution: Added Scheduler_OnLoaded to announce to the user that "the calendar is loading" as the calendar loads, sorts and displays the calendar. 8) VSE-3162: UI: Enable JAWS to Read Specific Calendar View. Problem: As a visually impaired user, I want JAWS to read which calendar view I am in so that I can have a better frame of reference while analyzing the data and performing tasks in the VS GUI. Resolution: The VS GUI was updated to allow JAWS to read calendar view mode on pressing the defined hotkey. 9) VSE-3198: VistA: Create a search RPC for Letter. Problem: Need to create new SDES RPCs to search for the following letter types: * No-show * Pre-Appointment * Clinic Cancellation * Appointment Cancellation Resolution: The following SDES RPCS were created to return the requested letter types: SDES GET LETTER BY IEN SDES GET LETTER TYPES SDES GET LETTERS BY TYPE 10) VSE-3199: VistA: Create RPC to search for Provider. Problem: Need to create a new RPC to search for Provider. Model on search in the SET UP A CLINIC option. Add this RPC to the SDESRPC menu option. Resolution: The SDES SEARCH PROVIDERS RPC was created and will return the following data in a JSON formatted object: (1) Provider Name (2) Provider IEN (3) Office Phone (4) Email Address (5) Title (6) Provider Class (7) Security ID (SECID) (8) Fax (9) Home Phone (10) Commercial Phone (11) Digital Pager (12) Voice Pager (13) Person Class (14) Provider Class (15) User Class 11) VSE-3211: VistA: Create a new RPC for privileged user search. Problem: Need to create a new search RPC to get IEN from NEW PERSON (#200) File when adding or removing a new privileged user. Follow rules of search when adding privileged user in SET UP A CLINIC. Resolution: The new SDES SEARCH PRIVILEGED USER RPC was created that allows users to search a person's name either partially or fully. The RPC will perform a search that matches the search criteria (3-35 characters), and then, retrieves and returns a list of ACTIVE users from the NEW PERSON File #200 regardless if they are already a privileged user or not. Users that are DISUSER and TERMINATED will be skipped. 12) VSE-3212: VistA: Create new RPC to get Division. Problem: Need to create a new search RPC to get 'Division' for Hospital Location (#44) field 3.5. Model on SET UP A CLINIC Division search. This should look at MEDICAL CENTER DIVISION (#40.8) file. Return name and IEN with search results. Resolution: The new SDES GET DIVISION LIST RPC was created to return a list of divisions, given search the search text provided. The division list comes from the MEDICAL CENTER DIVISION (#40.8) file. 13) VSE-3239: VSECS: Modify IAM Login Cookie After Authentication. Problem: Need to Modify IAM Login Cookie After Authentication per issue found in MAPSUP-2220. Resolution: The method to allow VSE-CS to bypass the Vista Instance Selection in SSOi login was causing unexpected results in other applications that use the same login. The cookie that VSE-CS uses will no longer overwrite or prevent other apps from properly logging in within the same browser session. 14) VSE-3337: VistA: Add RPCs to the SDECRPC menu option. Problem: The following RPCs need to be added to the SDECRPC option: SDES GET APPT CHECK-IN STEP 2 SDES GET APPT CHECK-IN STEPS 2 SDES GET APPTS BY PATIENT DFN2 SDES GET APPTS BY CLIN IEN 2 SDES GET APPTS BY IEN Resolution: The five RPCs noted in the ticket were added to the SDECRPC option. Test Sites: ----------- San Diego (SDC) Pittsburgh (PTH) 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_27_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_27_1_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.27.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_27_1_P.MSI Binary VS GUI R1.7.27.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_27_1_T.MSI Binary VS GUI R1.7.27.1 VDD VS_GUI_1_7_27_1 VDD Binary VS GUI R1.7.27.1 DIBR VS_GUI_1_7_27_1 DIBR Binary VS GUI R1.7.27.1 Release Notes VS_GUI_1_7_27_1 RN Binary VS GUI R1.7.27.1 Technical Manual VS_GUI_1_7_27_1 TM Binary VS GUI R1.7.27.1 User Guide Addendum VS_GUI_1_7_27_1_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 SDEC819P 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*819. 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*819. 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 SDEC819P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC819P 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*819. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.26. If 1.7.27.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.26.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_27_1_ DIBR.PDF. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 5 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC07 Before:B178991579 After:B178980649 **627,642,651,658,665,669,671, 672,701,686,740,694,785,788, 790,799,801,805,816,819** Routine Name: SDEC08 Before:B200745537 After:B200713709 **627,651,658,665,722,740,744, 694,745,756,774,781,785,790, 792,796,797,799,801,805,819** Routine Name: SDEC819P Before: n/a After: B2329080 **819** Routine Name: SDES Before:B112808460 After:B118820206 **788,790,792,794,797,799,800, 801,803,804,805,807,809,813, 814,815,818,819** Routine Name: SDES2 Before: B1185623 After: B2882991 **816,818,819** Routine Name: SDESAPPT Before: B61763042 After: B61686228 **788,805,807,809,815,819** Routine Name: SDESAPPTREQ40984 Before: B60059499 After: B58904997 **813,819** Routine Name: SDESAPTREQSET Before:B244087016 After:B215775986 **794,799,805,809,815,818,819** Routine Name: SDESARCLOSE Before: B11225889 After: B11219832 **794,799,805,809,815,818,819** Routine Name: SDESARSETDESC Before: n/a After: B326310 **819** Routine Name: SDESBLKANDMOVE Before:B161133376 After:B161127299 **797,799,800,801,803,804,805, 807,819** Routine Name: SDESCANCELAPPT Before: B6224069 After: B6219629 **801,804,805,819** Routine Name: SDESCCAVAIL Before: B45175425 After: B43562977 **800,805,809,813,819** Routine Name: SDESCKNSTEP Before: B64223185 After: B64172393 **788,790,792,800,805,807,819** Routine Name: SDESDISPRECALL Before: B11671969 After: B11666285 **803,805,815,819** Routine Name: SDESGETAPPTREQ Before:B161586714 After:B164734765 **815,818,819** Routine Name: SDESGETDIVISION Before: n/a After: B2555915 **819** Routine Name: SDESGETLETTERS Before: n/a After: B13934842 **819** Routine Name: SDESGETUD Before: B14150215 After: B18545013 **801,805,809,814,819** Routine Name: SDESINPUTVALUTL Before: n/a After: B1660353 **819** Routine Name: SDESLOC Before: n/a After: B28870871 **819** Routine Name: SDESPRIVUSRSRCH Before: n/a After: B68649996 **819** Routine Name: SDESPROVSEARCH Before: n/a After: B26174476 **819** Routine list of preceding patches: 818 ============================================================================= User Information: Entered By : Date Entered : JUN 08, 2022 Completed By: Date Completed: AUG 01, 2022 Released By : Date Released : AUG 01, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT