UML-Modelle mit Ant-Scripts veröffentlichen

Sie können Apache Ant-Scripts zum Veröffentlichen von UML-Modellen verwenden. Sie können die Scripts so einrichten, dass die Modelle automatisch veröffentlicht werden, wenn Sie Änderungen an den Modellen vornehmen.

Apache Ant ist ein Java-basiertes Open-Source-Erstellungstool. Sie können Ant-Builddateien über die Workbench erstellen und ausführen. Die Ant-Builddateien können auf Ressourcen im Dateisystem und auf Ressourcen im Arbeitsbereich operieren.

Die vorliegenden Anweisungen beziehen sich auf die Verwendung von Ant-Builddateien zur Veröffentlichung von Modellen in der Workbench. Weitere Informationen zum Ant-Erstellungstool finden Sie auf der Apache Ant-Website und in den Übersichtsabschnitten der Workbench.

Das Ant-Scriptelement, das die Modellveröffentlichung verarbeitet, ist das angepasste Element com.ibm.xtools.publish.CLModelPublish. Ein Script kann mehrere solcher Elemente enthalten, wenn Sie mehrere Modelle veröffentlichen müssen.

Gehen Sie wie folgt vor, um ein Modell mithilfe eines Ant-Scripts zu veröffentlichen:

  1. Erstellen Sie in der Sicht 'Projektexplorer' in einem Projekt eine neue Datei mit der Erweiterung XML.
  2. Legen Sie den Ant-Editor als Standardeditor für diese Datei fest:
    1. Klicken Sie auf Fenster > Einstellungen.
    2. Erweitern Sie Allgemein, erweitern Sie und Editoren, und klicken Sie auf Dateizuordnungen.
    3. Klicken Sie rechts neben der Liste Dateitypen auf Hinzufügen, geben Sie einen Namen für die XML-Datei ein, und klicken Sie auf OK.
    4. Wählen Sie in der Liste Dateitypen die XML-Datei aus.
    5. Wählen Sie in der Liste Zugeordnete Editoren die Option Ant-Editor aus, und klicken Sie auf Standard. Klicken Sie anschließend auf OK. Wenn der Ant-Editor in der Liste nicht enthalten ist, klicken Sie auf Hinzufügen, um ihn hinzuzufügen.
    6. Wenn die XML-Datei geöffnet ist, schließen Sie sie. Klicken Sie anschließend doppelt auf die Datei, um sie im Ant-Editor als Standardeditor zu öffnen.
  3. Geben Sie in der XML-Datei <pr ein, und klicken Sie im Fenster zur Vervollständigung von Elementen doppelt auf das Element <project>.
  4. Ordnen Sie im Element <project> ein Standardziel zu. Beispiel: <project default = MeinZiel>/
  5. Erstellen Sie zwischen dem öffnenden und dem schließenden Tag des <project>-Elements ein Ziel. Beispiel: <project default=MeinZiel><target name="MeinZiel></target></project>.
  6. Geben Sie zwischen dem öffnenden und dem schließenden Tag des <target>-Elements die Zeichenfolge <pu ein, und wählen Sie PublishModel in der Vervollständigungsliste aus. Dadurch wird das Element com.ibm.xtools.publish.CLModelPublish in Ihr Ant-Script eingefügt.
  7. Geben Sie Werte für die Taskparameter ein, und klicken Sie auf Datei > Speichern.
    Anmerkung: Informationen zur Syntax finden Sie im Abschnitt "Ant-Syntax für die UML-Modellveröffentlichung".
    Das Script sollte in etwa wie im folgenden Beispiel aussehen:
    <project default="MeinZiel"><target name="MeinZiel">
       <!-- ===================================================================
          modelPath: erforderlicher Parameter, vollständig qualifizierter Pfad (FQP) zum zu publizierenden Modell
          outputFolder: erforderlicher Parameter, vollständig qualifizierter Pfad (FQP) zum zu publizierenden Ordner
          outputFilename: erforderlicher Parameter wie zum Beispiel index.html
       =================================================================== -->             
          <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. Klicken Sie in der Sicht 'Projektexplorer' mit der rechten Maustaste auf die XML-Datei, und klicken Sie anschließend auf Ausführen als > Ant-Build.... Stellen Sie sicher, dass Sie auf Ant-Build ... und nicht auf Ant-Build klicken.
  9. Klicken Sie auf der Seite 'JRE' des Diaglogfensters unter Laufzeit-JRE auf In derselben JRE als Arbeitsbereich ausführen.
  10. Klicken Sie auf Anwenden und Ausführen, um das Script ausführen und das Modell zu veröffentlichen.
Anmerkung: Sie können das Ant-Script auch als Builddatei einrichten, die automatisch ausgeführt wird, wenn ein Modell geändert wird. Weitere Informationen erhalten Sie, wenn Sie das Lernprogramm mit dem Namen "Veröffentlichung und Berichterstellung mit Apache Ant automatisieren" durcharbeiten.
Zugehörige Informationen
Lernprogramm: Veröffentlichung und Berichterstellung mit Apache Ant automatisieren
Apache Ant-Website

Feedback