Rational Quality Manager の STAX タスクの作成

Software Testing Automation Framework Execution Engine (STAX) は、自動化コードの作成に使用できる単純な XML 言語です。 自動化コードは中央の STAX サーバーで実行され、 テスト・マシンと対話する Software Testing Automation Framework (STAF) コマンドを使用できます。
始める前に
STAX コマンドの使い方と作成方法について詳しくは、http://staf.sourceforge.net/current/STAX/staxug.htmlの「STAX Service User's Guide」を参照してください。
このタスクについて
タスクは、単一の自動化コードです。タスクにはタイトルと引数のリストが含まれます。 各タスクは、integration_config.xml ファイル内で 構成された staxPath にある単一の STAX XML ファイルに 対応します。
  1. staxPath フォルダーの STAX ファイルは、次の形式でなければなりません。
    • <?xml version="1.0" encoding="UTF-8"?>
      <!DOCTYPE stax SYSTEM "stax.dtd">
      <stax>
      	<defaultcall function="myTask"/>
      	
      	<function name="myTask" scope="local">
      		<function-prolog>My Task Title</function-prolog>
      		
      		<function-epilog>
      			This is a description of My Task.
      		</function-epilog>
      		
      		<function-list-args>
      			<function-required-arg name="target">The target machine</function-required-arg>
      			<function-optional-arg name="MyArg1" default="'default1'">The first arg description</function-optional-arg>
      			<function-optional-arg name="MyArg2" default="'default2'">The second arg description</function-optional-arg>
      		</function-list-args>
      		
      		<sequence>
      			<!-- Rest of the automation code here -->
      
      			<return>0</return>
      		</sequence>
      	</function>
      </stax>
  2. STAX ファイルは、タスクの main 関数をポイントする <defaultCall> 要素を指定する必要があります。 XML ファイルには複数の関数を含めることができますが、defaultcall だけが IBM® Rational® Quality Manager により実行 されます。
  3. デフォルトの関数は <function-prolog> 要素を指定する 必要がありますが、これにはユーザー・インターフェースで表示されるタスクの ショート・タイトルを含めなければなりません。
  4. デフォルトの関数は、オプションで、タスクの詳しい説明を入れる <function-epilog> 要素を指定することができます。 この値は現在ユーザー・インターフェースでは使用されていませんが、 将来使用される可能性があります。
  5. デフォルトの関数は、<function-list-args> 要素を 指定しなければなりません。
  6. Rational Quality Manager は必ず、 ターゲット・マシンのホスト名を最初の引数として渡します。 <function-list-args> の最初の引数は次のようにする必要があります。
    • <function-required-arg name="target">The target machine</function-required-arg>
  7. 追加の引数は、<function-optional-arg> 要素を使用して指定できます。 これらにはデフォルト値を指定できるので、(引数が必須の場合 でも) <function-required-arg> の代わりに 使用します。 このデフォルト値は、ユーザー・インターフェースに表示されます。 デフォルトの属性は Python ストリングでなければなりません (単一引用符で囲む)。
    • <function-optional-arg name="MyArg2" default="'default2'">The second arg description</function-optional-arg>
  8. タスクの最後の要素は、成功の場合に 0 を戻し、失敗の場合にゼロ以外を戻す <return> 要素にする必要があります。

フィードバック