VistA Patch Display Page: 1 ============================================================================= Run Date: AUG 27, 2021 Designation: XWB*1.1*73 TEST v2 Package : RPC BROKER Priority : MANDATORY Version : 1.1 Status : UNDER DEVELOPMENT ============================================================================= Subject: USER DIVISION, CERTIFICATE SELECTION AND OTHER FIXES Category: INFORMATIONAL ENHANCEMENT Description: =========== Patch XWB*1.1*73 RPC Broker Development Kit (BDK) with support for Delphi XE8, 10, 10.1, 10.2, 10.3, and 10.4 Patch XWB*1.1*73 corrects the following issue: o When a user assigned more than one division in VistA selects the division they will be working in the Brokerx.User.Division field is populated with the selected division, however, the division is only identified by its number, the correct return should be IEN^SITENAME^SITEID, this patch ensures the data placed into the Brokerx.User.Division field is correctly formatted. o Users are reporting that the default certificate for connection to VistA is not correct. Patches XWB*1.1*71 and XWB*1.1*72 addressed certificate processing, however, the user would have to ensure they were selecting the correct certificate from the list presented. This causes confusion if the list presented does not default to the certificate used for authenticating to VistA. This patch has redesigned the method of certificate processing, selecting the user's Authentication certificate automatically, eliminating the need for the user to select from a list of certificates. o A new property has been added to the TRPCBroker component, the property, named ShowCertDialog, is of type Boolean and defaults to False. If set to true, either at design time or at run time, the user will be prompted to select a certificate rather than one being auto-selected. This was requested considering the auto-selection process, many applications have various components which require different user attributes to successfully test, this new property affords the software developer with the ability to show the selection dialog to the user who can cancel it and be presented with the Access/Verify code dialog. Backward Compatibility ====================== Patch XWB*1.1*73 is built on top of and includes all the BDK Delphi code of patch XWB*1.1*72, except for the changes described above. Applications compiled with this version of the BDK will automatically incorporate these fixes into their applications. Distribution and Installation ============================= There is no action for VHA sites required by this patch. This patch is Programmer-Only Client-Only. There is no server side (VistA PackMan or KIDS) part to the patch. There are no client side (Windows executable) programs for VHA production workstations. The patch is intended for Delphi/RAD Studio developer client workstations only. The BDK Delphi code is distributed as a zip file (XWB_1_1_P73.zip) on the anonymous directory sites. The zip file is intended for Delphi GUI application developers only. It contains all the source code and instructions for compiling and installing for Delphi XE8, 10, 10.1, 10.2, 10.3, and 10.4, as well as a few sample programs. The installation of the BDK requires less than 30 Megabytes of disk space on a workstation. Patch Components ================ Files & Fields Associated: ------------------------- Forms Associated: Form Name Type New/Modified/Deleted --------- ---- -------------------- N/A Options Associated: ------------------ Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: -------------------- N/A Security Keys Associated: ------------------------ N/A Templates Associated: -------------------- Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedure Calls Associated: --------------------------------- RPC Name Type New/Modified/Deleted -------- ---- -------------------- New Service Requests (NSRs) --------------------------- N/A Patient Safety Issues (PSIs) ---------------------------- N/A SDM Ticket(s) & Overview ------------------------ Test Sites: (Patch Tracking Message #N/A) ---------- Field test waiver: No field testable components included in patch. Patch Installation: ================== Pre-Installation Instructions ----------------------------- There are no pre-installation steps associated with patch XWB*1.1*73 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: redacted The install README file is available at the following location: redacted XWB_1_1_P73_README.TXT Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.va.gov/vdl/application.asp?appid=23 The files containing the updated RPC Broker documentation may also be downloaded from the following location. redacted RPC Broker Readme File (XWB_1_1_P73_README.TXT) RPC Broker Release Notes (XWB_1_1_RN.DOCX/.PDF) RPC Broker Patch XWB*1.1*71 Deployment, Installation, Back-Out, and Rollback (DIBR) Guide (XWB_1_1_DIBRG.DOCX/.PDF) RPC Broker Developer's Guide (XWB_1_1_DG.DOCX/.PDF) RPC Broker Online Help File (BROKER_1_1.CHM) RPC Broker Systems Management Guide (XWB_1_1_SM.DOCX/.PDF) RPC Broker User Guide (XWB_1_1_UG.DOCX/.PDF) RPC Broker Technical Manual (XWB_1_1_TM.DOCX/.PDF) NOTE: VistA documentation is made available online in Microsoft Word format (.DOC) and Adobe Acrobat Portable Document Format (.PDF). Documentation contained in the XWB_1_1_P73_README.txt file contains updated instructions for installing the RPC Broker BDK. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : redacted Date Entered : APR 8,2021 Completed By: Date Completed: Released By : Date Released : =============================================================================