$TXT Created by MDEVC.FO-BIRM.DOMAIN.EXT (KIDS) on Tuesday, 05/02/23 at 12:53 ============================================================================= Run Date: JUN 05, 2023 Designation: VDI*1*1 Package : VDI - VETERANS DATA INTEGRATION AND Priority: Mandatory Version : 1 SEQ #1 Status: Released Compliance Date: JUL 06, 2023 ============================================================================= Subject: ADD NPE USERS FOR VDIF CUSTOMERS Category: - Other - Routine Description: ============ This patch will create New Person (#200) file entries for Non Person Entity (NPE) type users for the Immunization Gateway (IZG) & MyHealtheVet (MHV) projects. The Veterans Data Integration and Federation (VDIF) team is doing this as a service for the IZG & MHV projects. This is needed so that the projects can access VistA instances in a authorized way so they can conduct their business. Veterans Data Integration and Federation Enterprise Platform (VDIF-EP) is a standards based, healthcare IT integration and interoperability platform using Intersystems' HealthShare suite of products. It includes the ability to read, write, and share VistA data. The KIDS build for this patch (VDI*1*1) contains a routine for KIDS to invoke during the post install process. The routine's only purpose is to create appropriate NPE users for the IZG & MHV teams in the local New Person (#200) file. ========================================================================= NOTE: The installer may be called upon to determine & select the type of system this patch is being installed upon. If the system is a production system, KIDS will detect this & the installer will not be prompted. If the system is any kind on non-production system, the installer will be prompted to tell KIDS if it is a pre-production system (PPD), software quality assurance system (SQA), test system (TST), or finally a development system (DEV). The type of system alters the details of the NPE entries created. If the site intends to conduct some version of end to end testing or training with the IZG or MHV products they should select "1" or "2" for PPD or SQA when prompted, otherwise they should select "3" for TST. The prompt will look like: Install Questions for VDI*1.0*1 1 - Pre-Prod, 2 - SQA, 3 - Test, 4 - Development Enter the type of site into which this patch is being installed:? Enter a number (1-4). Select one of the following: 1 Pre-Prod 2 SQA 3 Test 4 Development ========================================================================= ========================================================================= NOTE: The installer may be called up to supply field values to KIDS if their site has required fields set for required identifiers which are not included in the values supplied by the patch. Your site could have different additional required identifiers than those shown in the example below. The prompt will look like: Will first run the Environment Check Routine, VDI1P1 This site has required identifier fields for New Person file entries which are not contained in the new entries being made for this patch. Please supply the values for these fields at your facility. The fields are: SERVICE/SECTION: ? << and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. 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 of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer . iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. v. If prompted to supply KIDS with values for additional required identifier fields, 'The fields are:', use the lookup dialog to supply the appropriate value(s). You may use '?' or '??' for help at this prompt to make the best selection. vi. If prompted with an Install Question for VDI*1.0*1 'Enter the type of site into which this patch is being installed:' answer with a number 1-4. Backout Procedures: ------------------- If rollback/backout is required, the KIDS build that was created in step 2B may be installed to restore all modified components back to their pre-patch released state. The message containing the backed-up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The Packman function "INSTALL/CHECK MESSAGE" is then used. Post-Installation Instructions: The installer can use VA FileMan to look at the new NEW PERSON (#200) file entries and verify the values installed. The KIDS build will display the names of the NPE user(S). The following is an example & the output is deliberately truncated for this patch description for security concerns. VA FileMan 22.2 Select OPTION: 5 INQUIRE TO FILE ENTRIES Output from what File: NEW PERSON// (945 entries) Select NEW PERSON NAME: OITAUSMHV Another one: OITAUSIZG Another one: Standard Captioned Output? Yes// (Yes) Include COMPUTED fields: (N/Y/R/B): NO// - No record number (IEN), no Computed Fields Display Audit Trail? No// NO NAME: OITAUSMHVSQA,OITAUSMHVSQA DATE ENTERED: APR 04, 2023 CREATOR: FLEGEL,CHRIS NAME COMPONENTS: 200 SIGNATURE BLOCK PRINTED NAME: OITAUSMHVSQA OITAUSMHVSQA NAME: OITAUSIZGSQA,OITAUSIZGSQA DATE ENTERED: APR 04, 2023 CREATOR: FLEGEL,CHRIS NAME COMPONENTS: 200 SIGNATURE BLOCK PRINTED NAME: OITAUSIZGSQA OITAUSIZGSQA Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;VETERANS DATA INTEGRATION AND FEDERATION;**[Patch List]**;Dec 30, 1994;Build 19 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: VDI1P1 Before: n/a After: B37044960 **1** ============================================================================= User Information: Entered By : Date Entered : MAR 23, 2023 Completed By: Date Completed: JUN 05, 2023 Released By : Date Released : JUN 05, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT