$TXT Created by DEVVSA.DOMAIN.EXT (KIDS) on Wednesday, 05/27/20 at 10:09 ============================================================================= Run Date: JUN 25, 2020 Designation: SD*5.3*694 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #608 Status: Released Compliance Date: JUL 24, 2020 ============================================================================= Associated patches: (v)SD*5.3*509 <<= must be installed BEFORE `SD*5.3*694' (v)SD*5.3*704 <<= must be installed BEFORE `SD*5.3*694' (v)SD*5.3*734 <<= must be installed BEFORE `SD*5.3*694' (v)SD*5.3*737 <<= must be installed BEFORE `SD*5.3*694' (v)SD*5.3*744 <<= must be installed BEFORE `SD*5.3*694' Subject: CHANGES FOR VISTA SCHEDULING GUI 1.7.0 Category: - Routine - Data Dictionary - Input Template - Other Description: ============ ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the Graphical User Interface (GUI) * * update for release 1.7.0 of VistA Scheduling (VS) GUI is installed * * The previous 1.6.0 release will NOT work after this patch has been * * installed. * ************************************************************************** In addition to the items listed in the defect tracking ticket review below, the following enhancements were made: 1. Create Help pane - new file SDEC SETTINGS (#409.98) - new input template SDEC HELP PANE - new option VS GUI Help Pane Edit [SDEC HELP PANE EDIT (LOCAL)] - new Remote Procedure Call (RPC) SDECSTNG HELPLINK - new Security Key SDEC HELP The above items were created to support the GUI changes made to add a Help pane. The new option will be listed on the SDSUP [Supervisor Menu] main menu. Users must hold the SDEC HELP security key to access this new option. Only local links can be updated through this option. National links will only be updated through the release of new patches. This patch sends out the initial set of National Links. The local links will be blank when sent out in this patch. Current National Links sent out with this patch: Veterans Crisis Line - (800) 273-8255 x1 https://vaww.insider.domain.ext/veterans-crisis-line-national-suicide-prevent ion-lifeline/ VS GUI Keyboard Shortcuts https://dvagov.sharepoint.com/sites/vhavista-scheduling-enhancements-vse/ SitePages/VS-GUI-Keyboard-Shortcuts.aspx VS GUI Resources https://dvagov.sharepoint.com/sites/vhavista-scheduling-enhancements-vse/S itePages/VS-GUI-Resources.aspx Contact VSE Program Office mailto:VHAVSEProgramOffice@domain.ext?subject=VS%20GUI%20User%20Feedback%20Lin k VA Enterprise Service Desk (OIT Help Desk) - (855) 673-4357 https://yourit.domain.ext/ MISSION Act https://vaww.insider.domain.ext/mission-act/ Scheduling Manager (SM) https://mobile.domain.ext/app/scheduling-manager Virtual Care Manager (VCM) - Video Visit https://mobile.domain.ext/app/virtual-care-manager Example of the new menu option: VS GUI Help Pane Edit [SDEC HELP PANE EDIT (LOCAL)] **> Locked with SDEC HELP 2. Modify RPCs to support VETERAN appointment request type and to restrict access to users with security key. 3. Updated RPC SDEC ARCLOSE on wording only to match the written code. Replaced the INP(1) input parameter from Waitlist ID to APPT REQUEST ID. 4. New mail group SDECSETTINGS added as a server group. When this mail group receives a message, server code is executed in routine SERVER^SDECSTNG. The server code performs different functions based on the content of the message. For this patch, it inserts the GUI version number and effective date into the SDEC SETTINGS File (#409.98). Patch Components ================ Files & Fields Associated: File Name (#) Field Name (#) New/Modified/Deleted ------------- ---------------------- -------------------- SDEC SETTINGS (#409.98) NEW SDEC APPT REQUEST (#409.85) REQUEST TYPE (#4) Modified Forms Associated: Form Name File # New/Modified/Deleted --------- ------ -------------------- n/a Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- SDECSETTINGS NEW Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- SDEC HELP PANE EDIT (LOCAL) EDIT NEW SDECRPC BROKER (CLIENT/SERVER) MODIFIED SDEC SETTINGS REMOTE UPDATE SERVER NEW SDSUP MENU MODIFIED Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- n/a Security Keys Associated: Security Key Name ----------------- SDEC HELP Templates Associated: Template Name Type File Name (#) New/Modified/Deleted ------------- ---- ------------------ -------------------- SDEC HELP PANE INPUT SDEC SETTINGS (#409.98) NEW Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC SUSRINFO MODIFIED SDECSTNG HELPLINK NEW SDEC ARCLOSE MODIFIED Additional Information: New Service Requests (NSRs): ----------------------------- n/a Patient Safety Issues (PSIs): ------------------------------ n/a Defect Tracking Ticket(s) & Overviews: ------------------------------------- 1. I17438953FY18, I15586145FY17, R16980172FY18: String not recognized as valid date/time. Problem: ------- VistA and .NET store dates and times differently, so some date/time instances in one cannot be passed to the other without modification. For example, midnight in VistA is 2400 hours of the day before, while in .NET it is 0000 hours of the day (e.g., 7/1@2400 in VistA is the same as 7/2@0000). Sending 7/1@2400 to .NET causes an error and sending 7/2@0000 to VistA causes an error. Resolution: ---------- The RPCs that receive the date/time from .NET were modified to recognize and convert midnight to the VistA equivalent. Likewise, RPCs that send the date/time were modified to convert midnight to the .NET equivalent. 2. R18543573FY18, I18556830FY18, R18561243FY18: Future appointments show as "action required." Problem: ------- Future appointments show as 'Action Required' in the Encounter 'Action Required' Report [SCRPW ACTION REQUIRED REPORT]. An entry was added to the OUTPATIENT ENCOUNTER File (#409.68) when the future appointment was scheduled. Resolution: ----------- Modified the routine to check the status of an appointment. The status is set based on the status in the PATIENT File (#2). Modified the code to create an entry in the OUTPATIENT ENCOUNTER File (#409.68) after the appointment date/time and once the nightly SDAM BACKGROUND JOB has completed for that date. 3. No ticket: Can't disposition an appointment request of a Multiple Return To Clinic (MRTC) when the other requests are made into appointments. Can't disposition an appointment request of a MRTC when the final appointment is cancelled, and the request is returned to the Request Management (RM) Grid. Problem: ------- For MRTC appointment requests on the RM Grid, 2 disposition actions - Removed/Scheduled-Assigned and Removed/VA Contract Care - were disabled. This prevented schedulers from dispositioning MRTC requests. Resolution: ---------- The 2 disposition actions - Removed/Scheduled-Assigned and Removed/VA Contract Care - have been enabled (refer to SD*5.3*695 VSE 1.7.0 Informational Patch). In this patch, changes were made to the VistA code to support the proper function of those disposition actions. 4. Rational #809445: Prevent the use of older releases of the GUI to curtail user problems and system irregularities. Problem: ------- A recent survey of schedulers showed that over 30% of them were using GUI versions other than the current version. Some of the versions in use were replaced long ago. Users who are using older versions of the software will experience errors that have subsequently been fixed and could fail to function properly with newer VistA patches that have been installed. Resolution: ---------- Two fields were added to the SDEC SETTINGS (#409.98) File. The first stores the version identifier of the latest GUI release. The second stores the date the version was released to the user community. An RPC (SDEC SUSRINFO) was modified to compare the version of the GUI in use to the current version. If the GUI version in use does not match the newest GUI version, the user is prevented from using the application until the current version is installed. The user will be notified that he/she does not have access to the GUI. When future releases to the GUI are made, the user will be informed of the current version and told to install it before he/she can access the GUI. 5. Rational #1243400 Slot counts incorrect for midnight date Problem: -------- Slot counts are not reducing in number for midnight appointments. Resolution: ----------- VistA is not able to handle a true midnight appointment, so it tacks on an extra second to the time (i.e. 00:00:01). This took care of slot counts reducing in number when an appointment is made at midnight. The VS GUI midnight appointments create the time as 00:01, therefore not causing any issues with midnight appointment slot count reduction. 6. Rational #1245455 Midnight appointments created in VistA and checked out in the VS GUI returns an error message Problem: -------- Midnight appointments created in VistA and checked out in the VS GUI return an error message. Resolution: ----------- Modified routine to strip off ending zeros for time that was causing a mismatch error from VS GUI sent data and VistA stored data. 7. Rational #1245453 Midnight appointments created in VistA and cancelled in VS GUI return an error message. Problem: -------- Midnight appointments created in VistA and cancelled in VS GUI return an error message. Resolution: ----------- Modified routine to strip off ending zeros for time that was causing a mismatch error from VS GUI sent data and VistA stored data. 8. Rational #1242322 Creating a midnight appointment in VS GUI causes the GUI to shut down Problem: -------- Creating a midnight appointment in the VS GUI causes an error in VistA. VistA creates the following error: DIAGN+7^SDECEP Resolution: ----------- Modified routine to strip off ending zeros for time that was causing a mismatch error from VS GUI sent data and VistA stored data. Test Sites: ----------- Martinsburg, WV Omaha, NE Fayetteville, NC Software and Documentation Retrieval Instructions: ------------------------------------------------- The software for this patch is being released in a PackMan message. 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 ------------------------------------------------------------------------- VistA Scheduling Enhancements VSE_VA_GUI_UG.PDF Binary GUI User Guide VistA Scheduling Enhancements VSE_TM.PDF Binary Technical Manual VistA Scheduling Enhancement VSE_GUI_Release_1.7_DIBR.PDF Binary (DIBR = Deployment, Installation, Backout and Rollback Guide) VistA Scheduling Enhancements VSE_GUI_Release_1.7_Release_ Binary Release Notes Notes.PDF VistA Scheduling Enhancements VSE_GUI_Release_1.7_VDD.PDF Binary (VDD = Version Description Document) Patch Installation: Pre/Post Installation Overview ------------------------------ 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. The following option should be disabled during installation: SDSUP [Supervisor Menu] Installation Instructions ------------------------- 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the Kernel Installation and Distribution System (KIDS) Menu, select the Installation Menu. From this menu, you may elect to use the following option. When prompted for the INSTALL enter the patch # (SD*5.3*694): a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not back up any other changes such as Data Dictionaries (DDs) or templates. 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 choose the patch to install. a. When prompted to "Enter the Coordinator for Mail Group 'SDECSETTINGS':", leave blank. 5. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', respond YES. 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', respond NO. 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond YES. a. When prompted 'Enter options you wish to mark as 'Out Of Order':', select the following options: Option Name Menu Text ----------- --------- SDSUP [Supervisor Menu] Press the Enter key when you are done selecting options. b. When prompted 'Enter protocols you wish to mark as 'Out Of Order':', press the Enter key. c. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. 8. If prompted 'Delay Install (Minutes): (0 - 60): 0//', respond 0. Post-Installation Instructions: ------------------------------ N/A Backout Plan: ------------- Restore the 28 routines using the routine save set created when installing the patch. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;;Build 61 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SD694PO Before: n/a After: B1340495 **694** Routine Name: SDEC Before:B133133924 After:B133763102 **627,643,642,651,658,665,672, 679,686,694** Routine Name: SDEC01 Before: B52469738 After: B69413501 **627,642,658,694** Routine Name: SDEC02 Before: B83466208 After: B98038606 **627,642,658,672,722,694** Routine Name: SDEC05 Before: B17215588 After: B18972655 **627,694** Routine Name: SDEC06 Before: B7162903 After: B10464242 **627,694** Routine Name: SDEC07 Before:B185206472 After:B174269903 **627,642,651,658,665,669,671, 672,701,686,740,694** Routine Name: SDEC07A Before: B87285683 After:B103431666 **627,642,651,679,686,694** Routine Name: SDEC07B Before: B61359550 After: B64345501 **627,658,665,669,717,722,744,694** Routine Name: SDEC07C Before: B2886008 After: B16505556 **686,694** Routine Name: SDEC08 Before:B224217895 After:B226009434 **627,651,658,665,722,740,744,694** Routine Name: SDEC12 Before: B29844447 After: B30805511 **627,694** Routine Name: SDEC25 Before:B151472805 After:B157030281 **627,665,671,717,694** Routine Name: SDEC25B Before: B10232111 After: B10704512 **627,694** Routine Name: SDEC27 Before:B106344952 After:B125176345 **627,694** Routine Name: SDEC31 Before: B34604414 After: B35513469 **627,683,717,740,694** Routine Name: SDEC33 Before: B10928495 After: B11738185 **627,694** Routine Name: SDEC34 Before: B41388078 After: B51016679 **627,694** Routine Name: SDEC38 Before: B35171696 After: B42456241 **627,694** Routine Name: SDEC40 Before: B69194006 After: B76069863 **627,665,694** Routine Name: SDEC47 Before: B35928564 After: B43226762 **627,694** Routine Name: SDEC48 Before: B25736375 After: B41416201 **627,694** Routine Name: SDEC49 Before: B64193404 After: B75180610 **627,658,694** Routine Name: SDEC50 Before:B169535547 After:B187919656 **627,658,665,672,722,723,737,694** Routine Name: SDEC52A Before: B50602257 After: B58047562 **627,658,694** Routine Name: SDEC55A Before: B91554722 After: B98719180 **627,671,701,722,734,694** Routine Name: SDEC57 Before:B100290193 After:B115901587 **627,642,658,665,701,686,694** Routine Name: SDECAPI Before: B60453354 After: B60666254 **627,694** Routine Name: SDECAR1 Before:B167351251 After:B182103175 **627,642,658,686,694** Routine Name: SDECAR2 Before:B199967808 After:B203864151 **627,642,658,671,686,694** Routine Name: SDECCAP Before:B108308383 After:B114946199 **642,694** Routine Name: SDECDATE Before: n/a After: B3036435 **694** Routine Name: SDECEP Before: B20201129 After: B24363512 **669,694** Routine Name: SDECEPT Before:B132582629 After:B142375915 **669,671,694** Routine Name: SDECIDX Before: B47077475 After: B55476726 **627,642,658,665,694** Routine Name: SDECSTNG Before: n/a After: B8146496 **694** Routine Name: SDECWL Before:B102048711 After:B106737488 **627,642,665,672,694** Routine Name: SDECWL2 Before:B126043834 After:B133202461 **627,642,658,665,694** Routine Name: SDM1A Before:B133660852 After:B137789967 **26,94,155,206,168,223,241, 263,327,478,446,544,621,622, 627,658,665,650,704,694** Routine Name: SDROUT0 Before: B23084570 After: B23258460 **343,377,509,694** Routine list of preceding patches: 509, 704, 734, 737, 744 ============================================================================= User Information: Entered By : Date Entered : APR 25, 2018 Completed By: Date Completed: JUN 24, 2020 Released By : Date Released : JUN 25, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT