Exercice 3 : Remplissage du script Ant

Cet exercice explique comment modifier le script Apache Ant pour publier un site Web et un rapport.

Avant de commencer, vous devez effectuer l'exercice 2 : Création et configuration du script Ant.

Ajout d'un élément Web à publier dans le script Ant

Pour ajouter les éléments à publier dans votre script Ant, procédez comme suit :
  1. Dans l'explorateur de modèles ou dans le navigateur, cliquez deux fois sur le script Ant publish.xml.
  2. Dans la fenêtre Ant Editor, tapez <pr Ctrl+barre d'espacement, afin d'ajouter l'élément <project>. La fenêtre d'exécution d'élément s'affiche en incrustation ; elle contient l'élément <project>. Entrez un nom dans l'attribut default. Par exemple, <project default="foo"></project>
  3. Positionnez le curseur avant la balise de fermeture </project>, puis tapez <ta Ctrl+barre d'espacement, afin d'ajouter la balise <target>.
  4. Dans la liste des éléments possibles, cliquez deux fois sur <target>. Entrez un nom pour l'attribut Name. Par exemple, <target name="foo"> </target>
  5. Positionnez le curseur avant la balise de fermeture </target>, puis tapez <pub Ctrl+barre d'espacement, afin d'ajouter la balise <target>.
  6. Dans la liste des éléments possibles, cliquez deux fois sur <PublishModel>.
  7. Entrez le nom complet du chemin d'accès à SimpleUMLModel sous forme de valeur de l'attribut modelPath. Pour visualiser le nom du chemin d'accès, sélectionnez le modèle dans l'explorateur de modèles ou dans le navigateur, puis cliquez à l'aide du bouton droit de la souris sur Properties. Coupez et collez la valeur de Location, puis cliquez sur Cancel dans la boîte de dialogue Properties.
  8. Placez le curseur sur "fully_qualified_path_to_the_output_folder", cliquez deux fois dessus, puis entrez le nom complet du chemin d'accès au dossier de sortie dans l'attribut outputFolder.
    Remarque : Le dossier doit exister.
    Par exemple, entrez c:\pub\web.
  9. Conservez les valeurs par défaut des autres attributs.

Ajout d'un élément de rapport de publication dans le script Ant

Pour ajouter les éléments à publier dans votre script Ant, procédez comme suit :
  1. Positionnez le curseur avant la balise de fermeture </target>, puis tapez <pub Ctrl+barre d'espacement, afin d'ajouter la balise <target>.
  2. Dans la liste des éléments possibles, cliquez deux fois sur <PublishReport>.
  3. Entrez le nom complet du chemin d'accès à SimpleUMLModel sous forme de valeur de l'attribut modelPath. Pour visualiser le nom du chemin d'accès, sélectionnez le modèle dans l'explorateur de modèles, puis cliquez à l'aide du bouton droit de la souris sur Properties. Coupez et collez la valeur de Location, puis cliquez sur Cancel dans la boîte de dialogue Properties. Par exemple, C:\Documents and Settings\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx.
  4. Placez le curseur sur "fully_qualified_path_to_the_output_folder", cliquez deux fois dessus, puis entrez le nom complet du chemin d'accès au dossier de sortie dans l'attribut outputFolder.
    Remarque : Le dossier doit exister.
    Par exemple, entrez c:\pub\rpt.
  5. Placez le curseur sur "file_name_to_use", cliquez deux fois dessus, puis entrez le nom de rapport "Sample UML Metric Report" dans l'attribut ReportName.
  6. Conservez les valeurs par défaut des autres attributs.
  7. Cliquez sur File > Save pour sauvegarder le fichier.
Le script Ant doit désormais contenir les éléments suivants (il est à noter que les valeurs d'attribut risquent d'être différentes) :
<project default="foo">
  <target name="foo">
<!-- ===================================================================
      modelPath: required parameter, fully qualified path(FQP) to the model to publish
      outputFolder: required parameter fully qualified path(FQP) to folder to publish to
     =================================================================== -->

    <com.ibm.xtools.publish.CLModelPublish
      modelPath="C:\Documents and Settings\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx"
      outputFolder="C:\myWebs\FooWeb"
      overwriteExisting="true"
      preview="false"
      showIcons="true"
      diagramImageFormat="gif"
      detailLevel="full"
      errorHandling="ignore"/>

<!-- ===================================================================
      modelPath: required parameter, fully qualified path(FQP) to the model to publish
      targetOutputFolder: required parameter, fully qualified path(FQP) to folder to publish to
      targetOutputFile: required parameter, file name of the report
      =================================================================== -->
    <com.ibm.xtools.publish.CLReportPublish
      modelPath="C:\Documents and Settings\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx"
      targetOutputFolder="c:\myRpts\simpleRpt"
      targetOutputFile="metric.pdf"
      reportName="Sample UML Metric Report"
      overwriteExisting="true"
      autoShowPublishedOutput="false"
      errorHandling="ignore"/>  
  </target>
</project>

Maintenant, vous pouvez passer à l'exercice 4 : Test et configuration de l'exécution automatique du script Ant.

Commentaires
(C) Copyright IBM Corporation 2005. All Rights Reserved.