使用 Ant 脚本来生成 UML 模型报告

可以使用 Apache Ant 脚本来生成 UML 模型报告。可以设置脚本以在对模型进行更改时自动生成报告。

Apache Ant 是一个使用开放式源代码编写的基于 Java 的构建工具。可以从工作台创建并运行 Ant 构建文件。Ant 构建文件可以使用文件系统和工作空间中的资源。

这些指示信息旨在帮助使用 Ant 构建文件来从工作台生成有关模型的报告。有关 Ant 构建工具的更多信息,请参阅 Apache Ant Web 站点和工作台概述主题。

处理生成报告的 Ant 脚本元素为定制元素 com.ibm.ccl.erf.rsa.report.ic.ant.UMLBirtReportPublish。如果需要生成多个报告,那么脚本可包含多个这些元素。

要通过使用 Ant 脚本来生成报告:

  1. 在“项目资源管理器”视图中,在项目中创建一个扩展名为 XML 的新文件。
  2. 将 Ant 编辑器设置为此文件的缺省编辑器:
    1. 单击窗口 > 首选项
    2. 展开常规,展开编辑器,然后单击文件关联
    3. 文件类型列表的右边,单击添加,输入 XML 文件的名称,然后单击确定
    4. 文件类型列表中,选择 XML 文件。
    5. 相关联的编辑器列表中,选择 Ant 编辑器,单击缺省值,然后单击确定 如果“Ant 编辑器”不在列表中,请单击添加以添加它。
    6. 如果 XML 文件处于打开状态,请将它关闭;然后双击该文件以在缺省 Ant 编辑器中将它打开。
  3. 在 XML 文件中,输入 <pr,然后在“添加元素”窗口中,双击 <project> 元素。
  4. <project> 元素中指定缺省目标;例如,<project default = MyTarget>
  5. 在左右 <project> 元素标记之间,创建目标;例如,<project default = MyTarget><target name="MyTarget></target></project>
  6. 在左右 <target> 元素标记之间,输入 <pu 并从补充列表中选择 PublishBIRTUMLReport 这会将 UMLBirtReportPublish 元素添加至 Ant 脚本。
  7. 指定任务参数的值,然后单击文件 > 保存
    注: 有关语法信息,请参阅主题“用于通过 BIRT 报告设计生成报告的 Ant 语法”。
    该脚本看起来应类似于以下示例:
    <project default="foo"><target name="foo">
       <!-- ===================================================================
          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
       reportDesignFile: required parameter, a URL to a report design to run, see notes above for details
       =================================================================== -->             
          <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"
    </target></project>
  8. 在“项目资源管理器”视图中,右键单击 XML 文件,然后单击运行方式 > Ant 构件 ... 务必单击 Ant 构件 ... 而不是 Ant 构件
  9. 在对话框的 JRE 页面上,在运行时 JRE 下面,单击与工作空间运行于同一 JRE 中
  10. 要运行脚本并生成报告,单击应用,然后单击运行
还可以将 Ant 脚本设置为每当修改模型时自动运行的构建文件。有关更多信息,请完成名为“使用 Apache Ant 自动发布和报告”教程。

要通过使用 Ant 脚本来使用 XSLT 模板生成报告,从补全列表中选择 PublishReport 而不是 PublishBIRTUMLReport,并为 com.ibm.xtools.publish.CLLegacyXSLTReportPublish 任务指定值。有关语法信息,请参阅主题“用于通过 XSLT 模板生成 UML 报告的 Ant 语法”。

相关信息
教程:使用 Apache Ant 自动发布和报告
Apache Ant Web 站点

反馈