Exécuter des transformations Exigences vers UML

Ces informations concernent la version 7.5.1 ou ultérieure.Avant d'exécuter une transformation, vous devez créer une configuration de transformation. Lorsque vous appliquez une configuration de transformation, une instance de la transformation est créée et exécutée avec les propriétés définies dans la configuration.
Avant de commencer
vérifiez qu'un fichier de configuration de transformation existe dans l'espace de travail ou dans un fichier accessible par une URL.
Pour exécuter une transformation, effectuez les étapes pour une des options suivantes :
Option Description
Utiliser une configuration de transformation Procédez de l'une des façons suivantes, selon la vue utilisée :
  • Dans la vue de navigation, cliquez avec le bouton droit sur un fichier de configuration de transformation (.tc), cliquez sur Transformer, puis cliquez sur une transformation. Lorsque vous appliquez une configuration de transformation, une instance de la transformation est créée et exécutée avec les propriétés définies dans la configuration.
  • Dans la vue Explorateur de patterns, faites un clic droit sur une transformation et sélectionnez Exécuter la transformation. Dans la fenêtre Sélectionner une configuration, spécifiez la configuration de transformation à exécuter, puis cliquez sur OK.
  • Si vous voulez appliquer une configuration de transformation à partir de l'éditeur de configuration de transformation, accédez à l'onglet Principal et cliquez sur Exécuter.
Remplacer la source définie dans une configuration de transformation Dans la perspective Modélisation, sélectionnez les éléments à traiter dans le modèle ou le projet source et cliquez avec le bouton droit sur la sélection, puis sélectionnez Transformer, cliquez sur une configuration de transformation, puis sur une transformation. La configuration de transformation n'est pas affectée et la source que vous spécifiez sur la page Source et cible de l'éditeur de configuration de transformation ou de l'assistant Nouvelle configuration de transformation ne change pas. Le fichier de la configuration de transformation doit être dans le même projet que les éléments sélectionnés.
Conseil : Pour exécuter à nouveau cette transformation, cliquez sur Modélisation > Transformer > Exécuter la dernière transformation. La transformation utilise les mêmes éléments source que ceux de la dernière transformation exécutée.
Exécuter la transformation depuis la ligne de commande Pour exécuter une transformation à partir d'une ligne de commande, utilisez cette syntaxe :
eclipse -data chemin-espace-de-travail -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "[-R]chemin-config-transformation1,[-R]chemin-config-transformation2,..." 

Dans le paramètre -transformConfigs, vous devez spécifier le chemin et le nom de fichier d'une ou de plusieurs configurations de transformation, en veillant à indiquer le chemin complet dans l'espace de travail et non le chemin défini par rapport au système de fichiers.

L'exécution d'une transformation à partir de la ligne de commande supprime l'affichage de toutes les boîtes de dialogue produites habituellement par cette transformation.

Prenons par exemple le cas d'une configuration de transformation appelée MaConfig.tc, située dans un projet nommé MonProjet, dans un espace de travail appelé MonEspace. Cette configuration définit les caractéristiques d'exécution d'une transformation appelée MaTransformation et celles de la transformation inverse correspondante, MaTransformationInverse.
  • Pour appeler MaTransformation, vous pouvez exécuter la configuration MaConfig.tc en entrant le texte suivant sur une ligne de commande :
    eclipse -data /MonEspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MonProjet/MaConfig.tc" 
  • Pour exécuter la transformation inverse, spécifiez l'option -R au début du chemin de la configuration de transformation, comme dans cet exemple :
    eclipse -data /MonEspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "-RMonProjet/MaConfig.tc"
  • Pour exécuter plusieurs transformations, dans le paramètre -transformConfigs, spécifiez la liste des configurations correspondantes en les séparant par des virgules et en incluant pour chacune d'elles son chemin dans l'espace de travail. Vous pouvez exécuter des transformations directes ou inverses, comme dans cet exemple :
    eclipse -data /MonEspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MonProjet/MaConfig.tc, -RMonProjet/MaConfig.tc"
Appeler l'API de transformation Pour exécuter la transformation dans le cadre d'une application, vous pouvez appeler l'API de transformation, comme dans cet exemple :
IFile file = ResourcesPlugin.getWorkspace().getRoot().getFile(new Path("/MonEspace/MaConfig.tc")); 
try 
{ITransformConfig config = TransformConfigUtil.
loadConfiguration(file);IStatus status = TransformController.
getInstance().execute(config, null, false, null); } catch 
(IOException e) { // Le fichier de configuration n'a pas pu être lu.}
Vous pouvez aussi charger une configuration de transformation en spécifiant une URL, comme dans cet exemple :
try {
		URL url= new URL(platform:/plugin/monPluginID/maConfig.tc);
			
ITransformConfig config = TransformConfigUtil.loadConfiguration(url);
	}
	catch (MalformedURLException malURLEx) {
		// Traiter l'exception.
	}
	catch (IOException ioEx) {
		// Traiter l'exception.
Vous pouvez spécifier une URL qui utilise différents protocoles, comme dans ces exemples :
  • -platform:/plugin/monPluginID/maConfig.tc
  • -http://monServeur.maSociete.com/maConfig.tc
  • -ftp://monNom_utilisateur:monMot_de_passe@monServeur.maSociete.com/maConfig.tc
  • -jar:file:c:/monDossier/monJar.jar!/maConfig.tc
  • -file:c:/monDossier/maConfig.tc
Exécuter une configuration de transformation à partir d'un script Ant
Pour exécuter une transformation à partir d'un script Ant ou d'un fichier build.xml, entre les balises <project></project>, créez un élément target, comme dans cet exemple :
<target name="generate"> 	<echo>Exécution de la transformation 
'monProjet/maConfig.tc'...</echo> 	<com.ibm.xtools.
transform.core.runTransformation transformConfig=
"monProjet/maConfig.tc" reverse="false"/> </target>

Dans le fichier build.xml, dans l'élément project, spécifiez pour l'attribut default la même valeur que celle de l'attribut name dans l'élément target.

L'attribut transformConfig doit avoir comme valeur un chemin valide dans l'espace de travail.

Pour exécuter la transformation inverse, spécifiez true pour l'attribut reverse.
Important : La configuration de transformation doit implémenter le protocole DCMP appelé Modélisation réconciliée.

Pour exécuter le script Ant, cliquez avec le bouton droit sur le fichier build.xml, puis cliquez sur Exécuter en tant que > Génération Ant.


Commentaires