Übung 3: Das Ant-Script auffüllen

Diese Übung zeigt Ihnen, wie Sie das Apache Ant-Script bearbeiten, um ein Web zu veröffentlichen und einen Bericht zu veröffentlichen.

Bevor Sie beginnen, müssen Sie Übung 2: Das Ant-Script erstellen und konfigurieren ausführen.

Ant-Script ein veröffentlichendes Webelement hinzufügen

Folgen Sie diesen Schritten, um die zu veröffentlichenden Elemente Ihrem Ant-Script hinzuzufügen:
  1. Klicken Sie in der Modellexplorer- oder Navigatorsicht doppelt auf Ihr Ant-Script publish.xml.
  2. Geben Sie im Fenster Ant-Editor den Eintrag <pr Strg+Leertaste ein, um das Element <project> hinzuzufügen. Das Fenster zur Elementfertigstellung wird mit dem Element <project> angezeigt. Geben Sie im Attribut Standard einen Namen ein. Ein Beispiel ist <project default="foo"></project>
  3. Positionieren Sie den Cursor vor dem abschließenden Befehl </project>, und geben Sie <ta Strg+Leertaste ein, um den Befehl <target> hinzuzufügen.
  4. Klicken Sie in der Liste der möglichen Elemente doppelt auf <target>. Geben Sie für das Attribut Name einen Namen ein. Ein Beispiel ist <target name="foo"> </target>
  5. Positionieren Sie den Cursor vor dem abschließenden Befehl </target>, und geben Sie <pub Strg+Leertaste ein, um den Befehl <target> hinzuzufügen.
  6. Klicken Sie in der Liste der möglichen Elemente doppelt auf <PublishModel>.
  7. Geben Sie den vollständig qualifizierten Pfadnamen für SimpleUMLModel als den Wert des Attributs modelPath ein. Um den Pfadnamen anzuzeigen, wählen Sie das Modell im Modellexplorer oder Navigator aus, und klicken Sie mit der rechten Maustaste auf Eigenschaften. Schneiden Sie den Wert der Speicherposition aus und fügen Sie ihn ein. Klicken Sie anschließend auf Abbrechen im Dialogfenster Eigenschaften.
  8. Bewegen Sie den Cursor an eine beliebige Stelle über "vollständig_qualifizierter_pfad_zum_ausgabeordner", doppelklicken Sie, und geben Sie den vollständig qualifizierten Pfadnamen des Ausgabeordners im Attribut outputFolder ein.
    Hinweis: Der Ordner muss bereits vorhanden sein.
    Geben Sie beispielsweise c:\pub\web ein.
  9. Die anderen Attribute verwenden ihre Standardwerte.

Ant-Script ein veröffentlichendes Berichtselement hinzufügen

Folgen Sie diesen Schritten, um die zu veröffentlichenden Elemente Ihrem Ant-Script hinzuzufügen:
  1. Positionieren Sie den Cursor vor dem abschließenden Befehl </target>, und geben Sie <pub Strg+Leertaste ein, um den Befehl <target> hinzuzufügen.
  2. Klicken Sie in der Liste der möglichen Elemente doppelt auf <PublishReport>.
  3. Geben Sie den vollständig qualifizierten Pfadnamen für SimpleUMLModel als den Wert des Attributs modelPath ein. Um den Pfadnamen anzuzeigen, wählen Sie das Modell im Modellexplorer aus, und klicken Sie mit der rechten Maustaste auf Eigenschaften. Schneiden Sie den Wert der Speicherposition aus und fügen Sie ihn ein. Klicken Sie anschließend auf Abbrechen im Dialogfenster Eigenschaften. Ein Beispiel ist C:\Dokumente und Einstellungen\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx.
  4. Bewegen Sie den Cursor an eine beliebige Stelle über "vollständig_qualifizierter_pfad_zum_ausgabeordner", doppelklicken Sie, und geben Sie den vollständig qualifizierten Pfadnamen des Ausgabeordners im Attribut outputFolder ein.
    Hinweis: Der Ordner muss bereits vorhanden sein.
    Geben Sie beispielsweise c:\pub\rpt ein.
  5. Bewegen Sie den Cursor an eine beliebige Stelle über "zu_verwendender_dateiname", doppelklicken Sie, und geben Sie den Berichtsnamen "Beispiel-UML-Metrikbericht" im Attribut ReportName ein.
  6. Die anderen Attribute verwenden ihre Standardwerte.
  7. Klicken Sie auf Datei > Speichern, um die Datei zu speichern.
Das Ant-Script sollte jetzt die folgenden Elemente enthalten (beachten Sie, dass Ihre Attributwerte unterschiedlich sein können):
<project default="foo">
  <target name="foo">
<!-- ===================================================================
      modelPath: erforderlicher Parameter, vollständig qualifizierter Pfad
                 zum Modell, das veröffentlicht werden soll
      outputFolder: erforderlicher Parameter, vollständig qualifizierter Pfad
                 zum Ordner, in dem veröffentlicht werden soll
     =================================================================== -->

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

<!-- ===================================================================
      modelPath: erforderlicher Parameter, vollständig qualifizierter Pfad zum Modell, das veröffentlicht werden soll
      targetOutputFolder: erforderlicher Parameter, vollständig qualifizierter Pfad zum Ordner, in dem veröffentlicht werden soll
      targetOutputFile: erforderlicher Parameter, Dateiname des Berichts
      =================================================================== -->
    <com.ibm.xtools.publish.CLReportPublish
      modelPath="C:\Dokumente und Einstellungen\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx"
      targetOutputFolder="c:\myRpts\simpleRpt"
      targetOutputFile="metric.pdf"
      reportName="Beispiel-UML-Metrikbericht"
      overwriteExisting="true"
      autoShowPublishedOutput="false"
      errorHandling="ignore"/>
  </target>
</project>

Jetzt können Sie mit Übung 4: Die automatische Ausführung des Ant-Scripts testen und konfigurieren beginnen.

Feedback
(C) Copyright IBM Corporation 2005. Alle Rechte vorbehalten.