$TXT Created by G at CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Wednesday, 08/31/22 at 18:56 ============================================================================= Run Date: SEP 30, 2022 Designation: SD*5.3*824 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #675 Status: Released Compliance Date: OCT 14, 2022 ============================================================================= Associated patches: (v)SD*5.3*694 <<= must be installed BEFORE `SD*5.3*824' (v)SD*5.3*823 <<= must be installed BEFORE `SD*5.3*824' Subject: VS GUI VERSION 1.7.30.1 Category: - Routine - Enhancement (Mandatory) Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.30.1 and SD*5.3*824 includes several defect corrections and enhancements including updates to refactoring several SDES name spaced RPCs for performance, maintainability and to match current coding standards. The daily schedule in the VS GUI was updated to allow the display the type of appointment information when hovering over an individual item. New RPCs have been created to support the process of cancelling clinic availability. Updates were made to the VS GUI to address some issues related to the Arizona time zone. The SDES EDIT CLINIC RPC was updated to accept a hash from the calling application and compare it to the latest hash for this clinic and then determines is a warning message should be returned of if the edit can occur. The RM Grid was updated to allow navigation with keyboard controls. The last column label in the patient search pop-up was updated to show as Birth Sex. The appointment slots in the VS GUI were updated to remove the isOpen code so context menu opens on first right click. The SDES GET APPTS BY CLINIC LIST RPC was updated to return the specified JSON formatted object. All SDES RPCs that currently return the patient DFN were updated to also return the ICN. The SDEC CRSCHED was updated to return the REQUEST TYPE (#4) field from the RECALL REMINDERS (#403.5) file. The clinic hashing routine was modified to include its own build of the needed fields without having to call SDES GET CLINIC INFO. The new SDES SEARCH CLINIC ATTRIBUTES RPC was created to allow clinic searches with the return of a minimal set of clinic attributes. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.30.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.30.1 and VistA patch * * SD*5.3*824 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 ----------- ---- -------------------- SDECRPC Broker Modified 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 CRSCHED Modified SDES CANCEL CLIN AVAILABILITY Modified SDES CANCEL CLIN PRECAN LIST New SDES EDIT CLINIC Modified SDES GET APPT BY REQ/APPT TYP2 Modified SDES GET APPT REQ BY IEN Modified SDES GET APPT REQ BY PAT ALL Modified SDES GET APPT REQ BY PAT OPEN Modified SDES GET APPT REQ BY PATIENT Modified SDES GET APPT REQ LIST BY DFN Modified SDES GET APPTS BY CLIN IEN 2 Modified SDES GET APPTS BY CLIN IEN 3 Modified SDES GET APPTS BY CLIN LIST2 New SDES GET APPTS BY CLINIC LIST Modified SDES GET APPTS BY IEN 2 Modified SDES GET APPTS BY PATIENT DFN2 Modified SDES GET APPTS BY PATIENT DFN3 Modified SDES GET APPTS BY RESOURCE Modified SDES GET CLINIC STORED HASH Modified SDES GET CONSULTS BY DFN Modified SDES GET CONSULTS BY IEN Modified SDES GET INSURANCE VERIFY LIST Modified SDES GET PATIENT REGISTRATION Modified SDES GET PATIENT REGISTRATION2 Modified SDES GET RECALL BY IEN Modified SDES GET RECALLS BY DFN Modified SDES PRINT APPT LETTER New SDES PRINT APPT LETTERS New SDES SEARCH CLINIC ATTRIBUTES New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-2567 - I-0001259 Display appointment type in calendar grid. Problem: Update the VS GUI to see what type of appt the vet has (either a follow up or consult) when hovering over a vet's appointment in the daily schedule, without having to expand every appt. Resolution: The daily schedule in the VS GUI was updated to allow the display the type of appointment information when hovering over an individual item. 2) VSE-3388 - VistA: Update SDES CANCEL CLIN AVAILABILITY. Problem: Acheron would like the following Input Parameter Changes: Instead of three parameters (date, start time, end time), take two: StartDateTime and EndDateTime: StartDateTime = 2022-10-01T08:00:00-04:00 EndDateTime = 2022-10-01T09:00:00-04:00 Resolution: New RPCs have been created to support the process of cancelling clinic availability: SDES CANCEL CLIN PRECAN LIST - This RPC returns a list of appointments that would be cancelled PRIOR to cancelling the clinic availability. SDES PRINT APPT LETTER - Prints a single appointment letter SDES PRINT APPT LETTERS - Prints a list of appointment letters Here is how they tie in with SDES CANCEL CLIN AVAILABILITY: 1. SDES CANCEL CLIN PRECAN LIST is called to produce a pre-cancellation list (this returns the appointments that would be cancelled in the given timeframe). 2. SDES CANCEL CLIN AVAILABILTY is called to cancel clinic availability. This RPC has been enhanced to return a list of appointment IEN's that were cancelled (if applicable). 3. You would use the same start date/time and end date/time that was used in SDES CANCEL CLIN PRECAN LIST. That way the pre-cancellation list and the actual cancellation are for the same timeframe. 1. SDES PRINT APPT LETTERS can then be called, using the appointments returned from SDES CANCEL CLIN AVAILABILITY. 2. SDES PRINT APPT LETTER is used to print a single appointment. This isn't directly related, but since I had to create the ability to print a group of letters for cancellation, this was an easy implementation and will eventually be used. 3) VSE-3541: VS GUI: Discovery and implementation: solution for continued Arizona time zone/VVC problems. Problem: The recent update to add Arizona time zone to the drop-down in the Make Video Visit window works, in that when Arizona is selected, the correct time is sent in the VVC email. However, the time zone still defaults to MOUNTAIN, so users have to manually select Arizona each time, leaving quite a lot of room for human error. Is it feasible to either default the selection to Arizona when the clinic's institution has a time zone exception flag set? Or can we update the front end to always use the standard time offset if the exception flag is set? Resolution: Currently, the patient and provider VVS Time Zone dropdowns are set to the System time zone. Logic has been added to the gateway to change the time zone to ARIZONA if the time zone is MOUNTAIN with a time zone exception of "1". 4) VSE-3557: VistA: Modify SDES EDIT CLINIC. Problem: Modify SDES EDIT CLINIC to accept the clinic hash as an input parameter. Before returning the results create a hash on the clinic object and compare it with the hash that was received as an input parameter. If the hashes are the same, then update the record. If the hashes are different then return a message or indicator that the downstream system needs to update their locally cached clinic hash values. Resolution: The SDES EDIT CLINIC RPC was updated to accept a hash from the calling application and compare is to the latest hash for this clinic. If the hashes match, the clinic will be updated. If the hashes don't match, a message is returned to the calling application to update their local repository with the latest data for the clinic. 5) VSE-3623: VS GUI: Update Column Name in Patient Search. Problem: When searching patients in VS GUI, the last column in the patient search pop-up needs to be labeled "Birth Sex," Currently, the column is labeled "Gender Identity," but the data being returned correlates to birth sex. Resolution: The last column label in the patient search pop-up was updated to show as Birth Sex. 6) VSE-3641: INC23779393- UI: Context Menu on Appointment Slot Not showing from One Right Click. Problem: The calendar in VS GUI should allow the user to right click an appointment slot one time and have the context menu appear. However, this is currently requiring a double right click to make the context menu appear. In recreating the issue, it seems this is true for the first right click on the calendar following the calendar being loaded. Any time a selection is made that reloads the calendar a double right click is needed on the first attempt to open the context menu on the calendar. Resolution: The appointment slots in the VS GUI were updated to remove the isOpen code so context menu opens on first right click. 7) VSE-3643: VistA: Modify SDES GET APPTS BY CLINIC LIST. Problem: Need to modify the SDES GET APPTS BY CLINIC LIST RPC the return JSON object shown below. Clinics: [ { sta3n:500, ien: 195, appts:[...] }, { sta3n:500, ien: 68, appts:[...] } ] Resolution: The SDES GET APPTS BY CLINIC LIST RPC was updated to return the specified JSON formatted object. 8) VSE-3648: VistA: Add ICN variable everywhere DFN is returned. Problem: Please add ICN variable everywhere DFN is returned. Resolution: The following RPCs were updated to include in the ICN variable in their JSON return Object: SDES GET APPT BY REQ/APPT TYP2 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 SDES GET APPTS BY CLIN IEN 2 SDES GET APPTS BY CLIN IEN 3 SDES GET APPTS BY CLINIC LIST SDES GET APPTS BY IEN 2 SDES GET APPTS BY PATIENT DFN2 SDES GET APPTS BY PATIENT DFN3 SDES GET APPTS BY RESOURCE SDES GET CONSULTS BY DFN SDES GET CONSULTS BY IEN SDES GET INSURANCE VERIFY LIST SDES GET PATIENT REGISTRATION SDES GET PATIENT REGISTRATION2 SDES GET RECALL BY IEN SDES GET RECALLS BY DFN 9) VSE-3658: VistA: Retrieve appointment request type. Problem: When getting appointments, add the appointment request type to the return values. This is needed by GUI to display the appointment type when the end user hovers over the appointment. Resolution: The SDEC CRSCHED was updated to return the REQUEST TYPE (#4) field from the RECALL REMINDERS (#403.5) file. 10) VSE-3675: VistA: Modify OPTION: SDES HASH ALL CLINIC. Problem: Modify hashing logic to be flexible with fields to be hashed. Resolution: The hashing routine was modified to include its own build of the needed fields without having to call SDES GET CLINIC INFO. 11) VSE-3680: VistA: Create a new RPC to return a small subset of clinic attributes. Problem: To support CCM requirements we need an RPC to search for clinics by name that returns a small subset of clinic attributes for any matches. RPC input parameters: 1. clinic name substring (required): 3+ characters. 2. institution station number (optional): If present, the search would be limited to matching clinics at the given institution. If absent, the search would take place across all divisions/institutions. Example values: 534, 534GB. RPC output fields: 1. Clinic name 2. Patient friendly name 3. Default provider name 4. Stop code number 5. Credit stop code number 6. Status (active or inactive) 7. Non-count (Y or N) Resolution: The new SDES SEARCH CLINIC ATTRIBUTES RPC was created to address this request. Test Sites: ----------- Hines, IL (HIN) Salt Lake, UT (SLC) 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_30_1_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_30_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.30.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_30_1_P.MSI Binary VS GUI R1.7.30.1 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_30_1_T.MSI Binary VS GUI R1.7.30.1 VDD VS_GUI_1_7_30_1 VDD Binary VS GUI R1.7.30.1 DIBR VS_GUI_1_7_30_1 DIBR Binary VS GUI R1.7.30.1 Release Notes VS_GUI_1_7_30_1 RN Binary VS GUI R1.7.30.1 Technical Manual VS_GUI_1_7_30_1 TM Binary VS GUI R1.7.30.1 User Guide Addendum VS_GUI_1_7_30_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 SDEC824P 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*824. 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*824. 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 SDEC824P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDEC824P 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*824. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.29. If 1.7.30.1 VS GUI was installed, it will need to be reverted to VS GUI 1.7.29.0. See Deployment, Installation, Back Out and Rollback Guide (DIBR) https://download.vista.domain.ext/index.html/SOFTWARE/VS_GUI_1_7_30_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 3 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC02 Before: B98038606 After:B113587424 **627,642,658,672,722,694,824** Routine Name: SDEC824P Before: n/a After: B2328385 **824** Routine Name: SDES Before:B118820206 After:B114336785 **788,790,792,794,797,799,800, 801,803,804,805,807,809,813, 814,815,818,819,824** Routine Name: SDESAPPT Before: B85708643 After: B86494308 **788,805,807,809,815,819,820, 823,824** Routine Name: SDESAPPT3 Before: B65423369 After: B65423369 **823,824** Routine Name: SDESAPPT4 Before: n/a After: B91297874 **824** Routine Name: SDESAPPTLETTERS Before: n/a After:B124590289 **824** Routine Name: SDESCCAVAIL Before: B43695265 After:B184479431 **800,805,809,813,819,820,824** Routine Name: SDESCCAVAIL2 Before: n/a After: B6498029 **824** Routine Name: SDESCLINICSET Before:B165832866 After:B188102413 **799,805,820,824** Routine Name: SDESCLINPRECAN Before: n/a After: B7966169 **824** Routine Name: SDESCLNSEARCH Before: n/a After: B25451549 **824** Routine Name: SDESGETAPPTREQ Before:B185482301 After:B187766300 **815,818,819,823,824** Routine Name: SDESGETAPPTWRAP3 Before:B121002380 After:B122930731 **815,823,824** Routine Name: SDESGETAPPTWRAP5 Before:B129278192 After:B131256159 **823,824** Routine Name: SDESGETCONSULTS Before: B49738220 After: B50742003 **815,820,824** Routine Name: SDESGETRECALL Before: B24338785 After: B25035561 **803,805,809,813,815,820,824** Routine Name: SDESGETREGA Before: B86248672 After: B87115032 **799,804,805,809,814,820,823,824** Routine Name: SDESGETREGA1 Before: B87271648 After: B88145554 **823,824** Routine Name: SDESHASHCLIN Before: B17641795 After: B84361621 **823,824** Routine Name: SDESINPUTVALUTL Before: B4563613 After: B5254518 **819,823,824** Routine Name: SDESPATIENTDATA2 Before: B2333097 After: B2594258 **823,824** Routine Name: SDESPATRPC Before: B27309085 After: B28008685 **792,804,805,807,809,814,816, 820,823,824** Routine Name: SDESUTIL Before: B29940988 After: B36529691 **801,804,805,814,816,818,820, 823,824** Routine list of preceding patches: 694, 823 ============================================================================= User Information: Entered By : Date Entered : AUG 04, 2022 Completed By: Date Completed: SEP 30, 2022 Released By : Date Released : SEP 30, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT