Add 'README File - Patch FMDC*1.0*2 (includes Delphi 5 instructions)' into 'Infrastructure/FileMan Delphi Components (FMDC)/1.0*2/'
Date-Created: 2001-10-01 Date-Updated: 2006-10-10
This commit is contained in:
US DVA
OSEHR Agent
parent
d763f3169c
commit
8c2757bc1d
|
|
@ -0,0 +1,281 @@
|
|||
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").
|
||||
|
||||
|
||||
|
||||
Loading…
Reference in New Issue