Readme File Last Updated: 10/11/01 ========================================= Package: FileMan Delphi Components (FMDC) Current Version: 1.0 Original Release Date: June 1998 Dept. of Veterans Affairs VHA OI System Design & Development (SD&D) ========================================= This file contains any last minute changes, new instructions (not found in the documentation), and additional information to supplement the manuals. This version of the FMDC Readme has been reformatted, updated, and reordered. NOTE: References to Delphi V. 3. have been removed. However, the latest FMDC installation program (i.e., FMDC1_0P1.EXE) still installs FMDC components that work with Delphi V. 3. TABLE OF CONTENTS ================= 1. Signs that You Need to (Re)compile FMDC 2. (Re)compiling the FMDC (Delphi Versions 4 and 5) 3. Recompiling when You Update Your BDK 4. Run the Installation Program (i.e., FMDC*1.0P1.EXE) (added 10/11/01) 5. Updating the FMDC for Delphi Versions 4 and 5 (updated 10/11/01) 6. Manual (Re)compilation and FMDC Installation Procedure 7. Updating the FMDC Library Path for a New Delphi Version 8. Installing the FMDC Help in Delphi Version 5 ------------------------------------------------------------------ 1. Signs that You Need to (Re)compile FMDC ------------------------------------------------------------------ When you install an updated version of one of the referenced BDK or Delphi components in Delphi's Component Palette, Delphi may present error messages indicating one of several potential problems. These messages may indicate that the FMDC package needs to be (re)compiled with the latest version of the component(s) that have been updated. ------------------------------------------------------------------ 2. (Re)compiling the FMDC (Delphi Versions 4 and 5) ------------------------------------------------------------------ Patch FMDC*1.0*1 provides the source code for the FileMan Delphi Components (FMDC). You need to use the source code in order to compile or recompile FMDC in the following situations: A. When you upgrade your Broker Development Kit (BDK) B. When you upgrade your Delphi VCL source code or your Delphi version (e.g., to Delphi V. 5). (Re)compilation (see #6 below) is necessary in these situations because the FMDC source code has references/dependencies on both the BDK's TRPCBroker component and also on certain components distributed in Delphi. ------------------------------------------------------------------ 3. Recompiling when You Update Your BDK ------------------------------------------------------------------ When you update your BDK, in most cases with Delphi V. 4 and Delphi V. 5, Delphi should recompile FMDC automatically - if it can find the source code (see #4 below) - when a change in the BDK component is encountered. If automatic recompilation does not occur, you can manually recompile (see #6 below). ------------------------------------------------------------------ 4. Run the Installation Program (i.e., FMDC*1_0P1.EXE) (added 10/11/01) ------------------------------------------------------------------ If this is a virgin installation of the FMDC, do the following: A. Follow Steps #1-2 under the "Delphi V. 4 Instructions" topic in the "FileMan Delphi Components V. 1.0*1 Installation Guide" to install the FMDC. B. Proceed to #5 below. Otherwise, proceed to #5 below. ------------------------------------------------------------------ 5. Updating the FMDC for Delphi Versions 4 and 5 (updated 10/10/01) ------------------------------------------------------------------ When moving to version 5 of Delphi, do the following: A. Create a D5 directory under VISTA\Fmdc: C:\Program Files\VISTA\Fmdc\D5 B. Copy the current FMDC source code and related files from: C:\Program Files\VISTA\Fmdc\D4 < existing directory > TO: C:\Program Files\VISTA\Fmdc\D5 < new directory, see #5A > Thus, the compiled modules for Delphi V. 5 will not overwrite the compiled modules for Delphi V. 4. C. Delete the Trpcb.dcu file, if it exists, from both the ...\Fmdc\D4 and D5 directories. D. Use a text editor (e.g., Microsoft's Notepad) to open up the Fmdc.dpk. In the "requires" section, do the following: For Delph V. 4, change "VistaBroker" to "XWB_D40". The requires section should now look like: requires vcl40, XWB_D40; For Delphi V. 5, change "vcl40" to "vcl50" and "VistaBroker" to "XWB_D50". The requires section should now look like: requires vcl50, XWB_D50; E. When your edits are complete, save the file and close the text editor. F. Compile the FMDC for Delphi V. 5 (See #6 below). ------------------------------------------------------------------ 6. Manual (Re)compilation and FMDC Installation Procedure ------------------------------------------------------------------ A. Open Delphi and close all projects. B. Select File | Open. C. In the "Open" window, change the "Files of type" filter to "Delphi package (*.dpk)" D. Navigate to the appropriate directory in which you've installed FMDC for the version of Delphi that you are using, and open Fmdc.dpk. If you are using a newer version of Delphi you may get the following messages: * "This package appears to be in an older format. Would you like to convert it to the new format?" Click Yes. * "Update Complete." Click OK. E. In the "Package - Fmdc.dpk" window, Press the Compile speed button. You may get the following message: * "Package 'fmdc' is about to be compiled. Continue?" Click Yes. This (re)compiles FMDC with whatever version of the BDK is present on the library path (see #4 above). NOTE: If you get a compiler error for Delphi V. 4 or 5, make sure that you review/follow #5C - #5F above. F. In the "Package - Fmdc.dpk" window, press the Install speed button. If the install succeeds, Delphi will tell you: "Package ...\Fmdc.bpl has been installed. The following new component(s) have been registered: TFMCheckBox, TFMComboBox, TFMComboBoxLookUp, TFMEdit, TFMFiler, TFMFinder, TFMFindOne, TFMGets, TFMHelp, TFMLabel, TFMListBox, TFMLister, TFMLookUp, TFMMemo, TFMRadioButton, TFMRadioGroup, TFMValidator." Click OK. G. Close the "Package - Fmdc.dpk" window and/or Delphi itself. Delphi will ask you: "Save changes to project FMDC?" Click Yes. If this does not work, it may be necessary to go one step lower and start from there (to rebuild the FMDC package file). To do this: a. Open Delphi and close all projects. b. Select Component | Install Component... c. If not already selected, select the "Into existing package" tab. d. For "Package file name", locate and select the desired Package file (e.g. Fmdc.dpk) using the Browse button. e. For "Unit file name", locate the FMDC desired directory and select any of the Pascal FMDC source code files (e.g. Fmcmpnts.pas). Click OK. You may get the following message: * "This package already contains a unit named ****.pas" Click OK. If you are using a newer version of Delphi you may get the following messages: * "This package appears to be in an older format. Would you like to convert it to the new format?" Click Yes. * "Update Complete." Click OK. f. Click on the Compile speed button to compile the Fmdc.dpk package. g. Click on the Install speed button to install the Fmdc.dpk package into Delphi. You may get the following messages: * "Package 'fmdc' is about to be compiled. Continue?" Click Yes. * "Package ...\fmdc.bpl has been installed. The following new component(s) have been registered: TFMCheckBox, TFMComboBox, TFMComboBoxLookUp, TFMEdit, TFMFiler, TFMFinder, TFMFindOne, TFMGets, TFMHelp, TFMLabel, TFMListBox, TFMLister, TFMLookUp, TFMMemo, TFMRadioButton, TFMRadioGroup, TFMValidator." Click OK. h. Close the "Package - Fmdc.dpk" window and/or Delphi itself. Delphi will ask you: "Save changes to project FMDC?" Click Yes. Note: These instructions also apply for any other Delphi components that may depend on RPC Broker code, as FMDC does. ------------------------------------------------------------------ 7. Updating the FMDC Library Path for a New Delphi Version ------------------------------------------------------------------ Open up Delphi and make sure that the directory for the BDK, usually: C:\Program Files\VISTA\BDK32\D4 (or D5) and FMDC, usually: C:\Program Files\VISTA\Fmdc\D4 (or D5) are included in the Library Path under the Tools|Environment Options|Library tab in Delphi. If after (re)compiling, problems are still encountered, ensure that none of the directories referenced in the Library Path prior to the working directories for the BDK and FMDC contain old versions of the compiled packages. ------------------------------------------------------------------ 8. Installing FMDC Help in Delphi V. 5 ------------------------------------------------------------------ Follow Step #6 under the "Delphi V. 4 Instructions" topic in the "FileMan Delphi Components V. 1.0*1 Installation Guide" to install the FMDC Help (changing references from "Delphi 4" to "Delphi 5" and "D4" to "D5").