FDDFMChanger
Remonter à Utilitaires (FireDAC)
Cette rubrique décrit l'utilitaire de migration automatique BDE > FireDAC.
Remarque : FDDFMChanger n'est pas actuellement disponible dans Embarcadero FireDAC v 7.0.1.
Sommaire
Informations générales
FireDAC FDDFMChanger est une application console, conçue pour un fonctionnement semi-automatique en ce qui concerne :
- La conversion d'une application BDE en application FireDAC.
- La migration d'une application FireDAC entre deux versions FireDAC, avec des API incompatibles.
Le but de FDDFMChanger est de remplacer les noms des composants et des propriétés du BDE avec les noms FireDAC appropriés.
Remarque : L'utilitaire FDDFMChanger et les fichiers BDE2FireDAC.txt sont situés dans le sous-dossier Bin du dossier d'installation de FireDAC.
Paramètres de la ligne de commande
Exécutez l'utilitaire FDDFMChanger sans aucun argument. Il affiche en sortie le texte de référence suivant :
DFM-Changer 2.3 Copyright (c) 2000-2013 by DA-SOFT Technologies (www.da-soft.com) All Rights Reserved. Use: FDDFMChanger {<filesToProcess>} [-s] [-i] [-a] -f <RuleFile> -s - recurse subdirectories -i - ignore errors -f - path to filter files -a - migrate all occurrences; otherwise, only components are migrated
Par exemple,
FDDFMChanger x:\myDir\*.pas x:\myDir\*.dfm -s -a -f x:\MyRules.txt
change tous les fichiers PAS et DFM situés dans myDir, y compris les sous-répertoires conformément à x:\MyRules.txt
Utilisation de FDDFMChanger
Vous devez indiquer dans la ligne de commande l'emplacement des fichiers à convertir. L'exemple ci-dessous illustre la migration de tous les fichiers PAS et DFM situés dans le répertoire "x:\myDir\":
FDDFMChanger.exe x:\myDir\*.pas x:\myDir\*.dfm [...]
Vous devez aussi indiquer l'emplacement du fichier de règles. Le fichier de règles BDE > FireDAC se trouve dans Bin\BDE2FireDAC.txt :
FDDFMChanger x:\myDir\*.pas x:\myDir\*.dfm -s -a -f BDE2FireDAC.txt
Le fichier de règles est composé de quelques lignes, chacune étant semblable à l'exemple suivant :
[old name] -> [new name] -> [add this unit to the interface USES clause]
L'unité ("unit') peut être une liste d'unités séparées par des virgules. Voici un exemple de règle de conversion dans le fichier de règles :
[TStoredProc] -> [TADStoredProc] -> [uADCompClient]
Elle provoque le remplacement de TStoredProc
par TADStoredProc
et ajoute l'unité uADCompClient
à la clause USES.
Le code d'achèvement
Lorsque l'utilitaire effectue la conversion avec succès, il renvoie le code de sortie 0. Sinon, le code de sortie est supérieur à 0.