$TXT Created by VISTA-LOAD-AITC-5.AAC.DOMAIN.EXT (KIDS) on Monday, 08/03/20 at 15:55 ============================================================================= Run Date: AUG 17, 2020 Designation: SD*5.3*764 Package : SD - SCHEDULING Priority: EMERGENCY Version : 5.3 SEQ #612 Status: Released Compliance Date: AUG 24, 2020 ============================================================================= Associated patches: (v)SD*5.3*735 <<= must be installed BEFORE `SD*5.3*764' Subject: HSRM FIX FOR APPT START AND END TIMES Category: - Routine Description: ============ Description: ============ ************************************************************************** * IMPORTANT NOTE: To avoid disruption of service with the Tele Health * * Management Platform (TMP) and Community Care Referrals and * * Authorizations (CCR&A) applications, sites must first install * * SD*5.3*754 (DATA CLEANUP, TMP APPT START/END TIMES FIX) and SD*5.3*764 * * (HSRM FIX FOR APPT START AND END TIMES) (TMP and CCR&A patches have no * * specific install sequence). Followed by installation of the VS GUI * * patches; SD*5.3*694 (CHANGES FOR VISTA SCHEDULING GUI 1.7.0) and * * SD*5.3*762 (UPDATE VS GUI VERSION FROM 1.7.0 TO 1.7.0.2). * * * * Informational Patch SD*5.3*695 (CHANGES FOR VISTA SCHEDULING GUI 1.7.0)* * should be updated via the Mark a Non-Kids Patch as Complete VistA menu * * option. * ************************************************************************** The Community Care Referrals and Authorizations (CCR&A) application is an enterprise-wide system used by Community Care (CC) staff to automatically generate referrals and authorizations for all Veterans receiving care in the community. Clinical and VA CC staff located at VA Medical Centers, Outpatient Clinics, Community Based Outpatient Clinics, and VISN offices use this application. The CCR&A solution is an integral component of the VA Community Care Information Technology (IT) architecture that allows Veterans to receive care from Community Providers. This patch fixes an issue with the appointment start and end times that started with the release of patch SD*5.3*694. Patch SD*5.3*694 requires the appointment start and end dates to be in external date format. This patch also fixes an issue that happens when HealthShare Referral Manager (HSRM) attempts to cancel an appointment in VistA. If the appointment can't be canceled, the error is not always returned to HSRM and the user is not notified of the issue. This patch also includes code to convert the appointment start and end Times. This change is required to integrate with Cerner. Cerner requires all appointment start and end times to be in Eastern time zone. Patch Components: ----------------- ROUTINES: --------- SDCCRCOR SDCCRSEN Bulletins: --------- N/A Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File # New/Modified/Deleted --------- ------ -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- HL7 Logical Links New/Modified/Deleted ----------------- -------------------- Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Additional Information: N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- Problem: -------- The VistA Scheduling Enhancement (VSE) team has changed their Application Programming Interface (API) to make and cancel appointments to require these dates be passed in external date format. The current code sends these dates in VistA FileMan format. Routine SDCCRCOR has been modified to convert the date/times to external date format. Resolution: ----------- Send the dates in external date format Problem: -------- When HSRM attempts to cancel an appointment in VistA, if the appointment can't be canceled the error is not always returned to HSRM and the user is not notified of the issue. Resolution: ----------- When an appointment can't be canceled, return the error back to HSRM in the HL7 acknowledgment message to notify the user of the issue. Routine SDCCRSEN has been modified to parse the error from the VSE cancel an appointment API and return that error to HSRM. Problem: -------- HSRM will integrate with both VistA and Cerner. Cerner requires the appointment start and end date/time to be sent in Eastern time zone time. This requires a modification to the appointment processes on VistA to convert the start and end date/times. Resolution: ----------- Add code to convert the appointment start and end times. Routine SDCCRCOR has been modified to add the TIMES function to convert date/times. Test Sites: -------- Lebanon, PA Togus, ME Software and Documentation Retrieval Instructions: ---------------------------------------------------- Software is distributed by PackMan. Backout and rollback Procedure: ------------------------------- IN ORDER TO BACK OUT THIS PATCH, SITES MUST USE THE KIDS OPTION TO BACKUP UP A TRANSPORT GLOBAL AFTER LOADING THE PATCH. IF THIS OPTION IS NOT USED, THEN BACKING OUT THE PATCH IS NOT POSSIBLE. In the event of a catastrophic failure, the Facility CIO may make the decision to back-out the patch. It is imperative that you have performed a backup of the routines included in this patch prior to installation. The back-out plan is to restore the routines from the backup created. No data was modified by this patch installation and, therefore, no rollback strategy is required. To verify the back-out completed successfully, ensure the checksum matches the pre-patch checksum from the patch description. Patch Installation: ------------------- N/A Pre/Post Installation Overview: ------------------------------- N/A Pre-Installation Instructions: ------------------------------ Ensure patch SD*5.3*735 has been installed. Setup/Configuration Instructions: --------------------------------- These steps can be completed with users on the system. This should take less than 15 minutes to configure. NOTE: Patch SD*5.3*735 must be installed in order to install this patch. This patch should take less than 15 minutes to install. This patch can be queued for later installation. 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*764. a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes such as Data Dictionaries (DDs) or templates. IN ORDER TO BACKOUT THIS PATCH, THIS OPTION MUST BE USED. 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*764. 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. Sample Install: --------------- Post-Installation Instructions: N/A Routine Information: ==================== Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;APR 4, 2019;Build 22 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDCCRCOR Before:B132572414 After:B181156809 **707,730,735,764** Routine Name: SDCCRSEN Before:B183223052 After:B186654348 **707,730,735,764** Routine list of preceding patches: 735 ============================================================================= User Information: Entered By : Date Entered : JUL 07, 2020 Completed By: Date Completed: AUG 17, 2020 Released By : Date Released : AUG 17, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT