Utilisation de scripts Ant pour générer des rapports de modèle UML

Vous pouvez utiliser des scripts Apache Ant pour générer des rapports de modèle UML. Il est possible de paramétrer ces scripts de sorte qu'ils génèrent automatiquement les rapports dès que vous apportez un changement aux modèles.

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 génération de rapports pour les 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 génération de rapports est l'élément personnalisé com.ibm.ccl.erf.rsa.report.ic.ant.UMLBirtReportPublish. Si vous devez générer plusieurs rapports, un script peut contenir plusieurs de ces éléments.

Pour générer un rapport à 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 cliquez sur 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 PublishUMLBIRTReport dans la liste d'exécution. Cette action ajoute l'élément UMLBirtReportPublish à 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 génération de rapports avec les conceptions de rapport BIRT".
    Le script devrait ressembler à cet exemple :
    <project default="MyTarget"><target name="MyTarget">
          <com.ibm.ccl.erf.rsa.report.ic.ant.UMLBirtReportPublish 
             modelPath="C:\workspace\MyModel.emx" 
             targetOutputFolder="c:\temp\pubweb" 
             targetOutputFile="MyReport.html" 
             reportDesignFile="file:/C:/<product location>/plugins/com.ibm.ccl.erf.rsa.report.data/designs/modelSummary.rptdesign" 
             overwriteExisting="true" 
             autoShowPublishedOutput="true" 
             errorHandling="ignore" 
             outputType="html"
             transform=""/>
    </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 générer le rapport, cliquez sur Appliquer puis sur Exécuter.
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."

Pour utiliser les scripts Ant afin de générer des rapports à l'aide d'un canevas XSLT, sélectionnez PublishReport au lieu de PublishBIRTUMLReport dans la liste d'exécution, puis indiquez les valeurs de la tâche com.ibm.xtools.publish.CLLegacyXSLTReportPublish. Pour plus d'informations sur la syntaxe, reportez-vous à la rubrique "Syntaxe Ant pour la génération de rapports avec les canevas XSLT".

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

Vos commentaires