練習 3:移入資料至 Ant Script

本練習顯示如何編輯 Apache Ant Script,來發佈 Web 和報告。

開始之前,您必須先完成練習 2:建立及配置 Ant Script

新增發佈 Web 元素至 Ant Script

若要在 Ant Script 中加入要發佈的元素,請遵循下列步驟。
  1. 在「模型瀏覽器」或「瀏覽器」視圖中, 按兩下 publish.xml Ant Script。
  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 Script

若要在 Ant Script 中加入要發佈的元素,請遵循下列步驟。
  1. 將游標置於結束 </target> 標示之前, 並輸入 <pub Ctrl+Space to add the <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 Script 現在會包含下列元素(請注意,您的屬性值可能會有不同):
<project default="foo">
  <target name="foo">
<!-- ===================================================================
      modelPath: 必要的參數,至要發佈之模型的完整路徑 (FQP)
      outputFolder: 必要的參數,至要發佈之目的地資料夾的完整路徑 (FQP)
     =================================================================== -->

    <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: 必要的參數,要發佈之模型的完整路徑 (FQP)
      targetOutputFolder: 必要的參數,發佈目的資料夾的完整路徑 (FQP)
      targetOutputFile: 必要的參數,報告的檔案名稱
      =================================================================== -->
    <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 Script

意見
(C) Copyright IBM Corporation 2005. All Rights Reserved.