可以使用
Apache Ant 脚本来生成 UML 模型报告。可以设置脚本以在对模型进行更改时自动生成报告。
Apache Ant 是一个使用开放式源代码编写的基于
Java 的构建工具。可以从工作台创建并运行 Ant 构建文件。Ant 构建文件可以使用文件系统和工作空间中的资源。
这些指示信息旨在帮助使用
Ant 构建文件来从工作台生成有关模型的报告。有关 Ant 构建工具的更多信息,请参阅 Apache Ant Web 站点和工作台概述主题。
处理生成报告的 Ant 脚本元素为定制元素 com.ibm.ccl.erf.rsa.report.ic.ant.UMLBirtReportPublish。如果需要生成多个报告,那么脚本可包含多个这些元素。
要通过使用 Ant 脚本来生成报告:
- 在“项目资源管理器”视图中,在项目中创建一个扩展名为 XML 的新文件。
- 将 Ant 编辑器设置为此文件的缺省编辑器:
- 单击。
- 展开常规,展开编辑器,然后单击文件关联。
- 在文件类型列表的右边,单击添加,输入 XML 文件的名称,然后单击确定。
- 从文件类型列表中,选择 XML 文件。
- 从相关联的编辑器列表中,选择 Ant
编辑器,单击缺省值,然后单击确定。 如果“Ant 编辑器”不在列表中,请单击添加以添加它。
- 如果 XML 文件处于打开状态,请将它关闭;然后双击该文件以在缺省 Ant 编辑器中将它打开。
- 在 XML 文件中,输入 <pr,然后在“添加元素”窗口中,双击 <project> 元素。
- 在 <project> 元素中指定缺省目标;例如,<project default = MyTarget>。
- 在左右 <project> 元素标记之间,创建目标;例如,<project default = MyTarget><target
name="MyTarget></target></project>。
- 在左右 <target> 元素标记之间,输入
<pu 并从补充列表中选择 PublishBIRTUMLReport。 这会将 UMLBirtReportPublish 元素添加至 Ant 脚本。
- 指定任务参数的值,然后单击。
注: 有关语法信息,请参阅主题“用于通过 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>
- 在“项目资源管理器”视图中,右键单击 XML 文件,然后单击。 务必单击 Ant 构件 ... 而不是 Ant 构件。
- 在对话框的 JRE 页面上,在运行时 JRE 下面,单击与工作空间运行于同一 JRE 中。
- 要运行脚本并生成报告,单击应用,然后单击运行。
还可以将 Ant 脚本设置为每当修改模型时自动运行的构建文件。有关更多信息,请完成名为“使用 Apache Ant 自动发布和报告”教程。
要通过使用
Ant 脚本来使用 XSLT 模板生成报告,从补全列表中选择 PublishReport 而不是
PublishBIRTUMLReport,并为
com.ibm.xtools.publish.CLLegacyXSLTReportPublish 任务指定值。有关语法信息,请参阅主题“用于通过 XSLT 模板生成 UML 报告的 Ant 语法”。