演習 3: Ant スクリプトへのデータの取り込み

この演習では、Apache Ant スクリプトを編集して、Web およびレポートを公開する方法を示します。

始める前に、『演習 2: Ant スクリプトの作成および構成』を完了しておく必要があります。

公開する Web 要素の Ant スクリプトへの追加

公開する要素を Ant スクリプトに追加するには、以下のステップに従ってください。
  1. 「モデル・エクスプローラー」または「ナビゲーター」ビューで publish.xml Ant スクリプトをダブルクリックする。
  2. 「Ant エディター (Ant editor)」ウィンドウで <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. modelPath 属性の値として、 SimpleUMLModel の完全修飾パス名を入力する。 パス名を確認するには、「モデル・エクスプローラー」または「ナビゲーター」でモデルを選択し、 「プロパティー」を右クリックします。 「場所」の値を切り貼りし、「プロパティー」ダイアログ・ボックスで 「キャンセル」をクリックします。
  8. 「fully_qualified_path_to_the_output_folder」上の任意の場所にカーソルを移動してダブルクリックし、 outputFolder 属性に出力フォルダーの完全修飾パス名を入力する。
    注: このフォルダーは必ず存在していなければなりません。
    例えば、c:\pub\web などを入力します。
  9. その他の属性はそのままにし、デフォルト値を使用する。

公開するレポート要素の Ant スクリプトへの追加

公開する要素を Ant スクリプトに追加するには、以下のステップに従ってください。
  1. </target> 終了タグの前にカーソルを置き、 <pub Ctrl+Space と入力して、<target> タグを追加する。
  2. 使用可能な要素のリストから、<PublishReport> をダブルクリックする。
  3. modelPath 属性の値として、 SimpleUMLModel の完全修飾パス名を入力する。 パス名を確認するには、「モデル・エクスプローラー」でモデルを選択し、 「プロパティー」を右クリックします。 「場所」の値を切り貼りし、「プロパティー」ダイアログ・ボックスで 「キャンセル」をクリックします。 例えば 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.