282 lines
9.4 KiB
Plaintext
282 lines
9.4 KiB
Plaintext
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").
|
|
|
|
|
|
|