FDDFMChanger

De RAD Studio
Aller à : navigation, rechercher

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.

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.

Voir aussi