Utilisation de scripts Ant pour publier des modèles UML

Vous pouvez utiliser des scripts Apache Ant pour publier des modèles UML. Il est possible de paramétrer ces scripts pour qu'ils publient automatiquement les modèles dès que vous y apportez un changement.
Pourquoi et quand exécuter cette tâche

Apache Ant est un outil de génération "open-source" à base de code Java. Vous pouvez créer et exécuter des fichiers de génération Ant directement à partir du plan de travail. Les fichiers de génération Ant peuvent agir sur des ressources situées dans le système de fichiers ainsi que sur celles qui se trouvent dans le plan de travail.

Ces instructions s'appliquent à l'utilisation des fichiers de génération Ant pour la publication de modèles à partir du plan de travail. Pour plus d'informations sur l'outil Ant, consultez le site Web Apache Ant ainsi que les rubriques de présentation du plan de travail.

L'élément des scripts Ant qui gère la publication des modèles est l'élément personnalisé com.ibm.xtools.publish.CLModelPublish. Si vous devez publier plusieurs modèles, un script peut contenir plusieurs de ces éléments.

Pour publier à l'aide d'un script Ant, procédez comme suit :

  1. Dans la vue Explorateur de projets, dans un projet, créez un nouveau fichier avec une extension XML.
  2. Définissez l'éditeur Ant comme éditeur par défaut pour ce fichier :
    1. Cliquez sur Fenêtre > Préférences.
    2. Développez Général, développez Editeurs puis sélectionnez Associations des fichiers.
    3. A la droite de la liste Types de fichiers, cliquez sur Ajouter, puis saisissez un nom pour le fichier XML et cliquez sur OK.
    4. Dans la liste Types de fichiers, sélectionnez le fichier XML.
    5. Dans la liste Editeurs associés, cliquez sur Editeur Ant, sélectionnez Par défaut, puis cliquez sur OK. Si l'éditeur Ant n'est pas dans la liste, cliquez sur Ajouter pour l'ajouter.
    6. Si le fichier XML est ouvert, fermez-le, puis cliquez deux fois sur le fichier pour l'ouvrir dans l'éditeur Ant.
  3. Dans le fichier XML, saisissez <pr, puis, dans la fenêtre d'exécution, cliquez deux fois sur l'élément <project>.
  4. Affectez une cible par défaut dans l'élément <project> ; par exemple <project default="MaCible">.
  5. Entre les balises ouvrante et fermante de l'élément <project>, créez une cible ; par exemple <project default="MaCible"><target name="MaCible"></target></project>.
  6. Entre les balises ouvrante et fermante de l'élément <target>, saisissez <pu, puis sélectionnez PublishModel dans la liste d'exécution. Cette action ajoute l'élément com.ibm.xtools.publish.CLModelPublish à votre script Ant.
  7. Indiquez les valeurs des paramètres de la tâche puis cliquez sur Fichier > Sauvegarder.
    Remarque : Pour plus d'informations sur la syntaxe, reportez-vous à la rubrique "Syntaxe Ant pour la publication de modèles UML".
    Le script devrait ressembler à cet exemple :
    <project default="MyTarget"><target name="MyTarget">
             <com.ibm.xtools.publish.CLModelPublish 
             modelPath="C:\workspace\MyProject\MyModel.emx" 
             outputFolder="c:\temp\pubweb" 
             outputFilename="index.html" 
             overwriteExisting="true" 
             preview="false" 
             showIcons="true"
             genDate="false"
             diagramImageFormat="gif"
             detailLevel="full"
             errorHandling="ignore"/> 
    
    </target></project>
  8. Dans la vue Explorateur de projets, cliquez avec le bouton droit sur le fichier XML, puis cliquez sur Exécuter en tant que > Compilation Ant... Vérifiez bien que vous cliquez sur Compilation Ant..., et non Compilation Ant.
  9. Dans la boîte de dialogue JRE, sous JRE d'exécution, cliquez sur Exécuter dans le même JRE que l'espace de travail.
  10. Pour exécuter le script et publier le modèle, cliquez sur Appliquer puis sur Exécuter.
Que faire ensuite

Le fichier Ant peut aussi être défini comme fichier de génération (build file) à exécuter automatiquement chaque fois qu'un modèle est modifié. Pour plus d'informations, effectuez le tutoriel "Automatiser la publication et la génération de rapports avec Apache Ant."

Information associée
Tutoriel : Automatiser la publication à l'aide de Apache Ant
Site Web de Apache Ant

Vos commentaires