练习 3:植入 Ant 脚本

此练习向您展示如何编辑 Apache Ant 脚本来发布 Web 和报告。

在开始之前,您必须完成练习 2:创建和配置 Ant 脚本

把要发布的 Web 元素添加到 Ant 脚本

要在 Ant 脚本中添加将发布的元素,请遵循这些步骤。
  1. 在“模型浏览器”或“导航器”视图中,双击 publish.xml Ant 脚本。
  2. Ant 编辑器窗口中,输入 <pr Ctrl+Space 来添加 <project> 元素。将弹出元素完成窗口,其中显示 <project> 元素。在 default 属性中输入名称。例如,<project default="foo"></project>
  3. 把光标放在右 </project> 标记前,然后输入 <ta Ctrl+Space 来添加 <target> 标记
  4. 在可能元素的列表中,双击 <target>。 对 Name 属性输入名称。 例如,<target name="foo"> </target>
  5. 把光标放在右 </target> 标记之前,然后输入 <pub Ctrl+Space 来添加 <target> 标记
  6. 在可能元素的列表中,双击 <PublishModel>
  7. SimpleUMLModel 中输入标准路径名作为 modelPath 属性的值。要查看路径名,请在“模型浏览器”或“导航器”中选择该模型,然后右键单击属性。 剪切并粘贴位置的值,然后单击属性对话框中的取消
  8. 将光标移动到“fully_qualified_path_to_the_output_folder”上的任意位置,双击后在 outputFolder 属性中输入输出文件夹的标准路径名。
    注意:该文件夹必须存在。
    例如,输入 c:\pub\web
  9. 其他属性使用缺省值即可。

把要发布的报告元素添加到 Ant 脚本

要在 Ant 脚本中添加将发布的元素,请遵循这些步骤。
  1. 把光标放在右 </target> 标记之前,然后输入 <pub Ctrl+Space 来添加 <target> 标记
  2. 在可能元素的列表中,双击 <PublishReport>
  3. SimpleUMLModel 中输入标准路径名作为 modelPath 属性的值。要查看路径名,请在“模型浏览器”中选择该模型,然后右键单击属性。 剪切并粘贴位置的值,然后单击属性对话框中的取消。例如,C:\Documents and Settings\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx
  4. 将光标移动到“fully_qualified_path_to_the_output_folder”上的任意位置,双击后在 outputFolder 属性中输入输出文件夹的标准路径名。
    注意:该文件夹必须存在。
    例如,输入 c:\pub\rpt
  5. 将光标移动到“file_name_to_use”上的任意位置,双击后在 ReportName 属性中输入“Sample UML Metrics Report”报告名称。
  6. 其他属性使用缺省值即可。
  7. 单击文件 > 保存来保存文件。
现在您的 Ant 脚本应包含以下元素(请注意,属性值可能不同):
<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>

现在,您可以开始练习 4:测试并设置 Ant 脚本的自动执行

反馈
(C) Copyright IBM Corporation 2005. All Rights Reserved.