アクショングループ内のパラメーターは、以下の通り動作します:
•アクショングループ内でパラメーターを宣言し、これらのパラメーターを使用するアクションを(アクショングループ内で)定義します。
•アクショングループのアクションの実行によりアクショングループが呼び出されると、パラメーターの値はパラメーターにパスされます。
アクショングループ内のパラメーターを宣言し、これらのパラメーターを使用するアクションを定義する
アクショングループ内で、必要とする結果を生成するために必要なパラメーターを宣言します。これは、[パラメーターの追加] アイコンをクリックして行います (下のスクリーンショット参照)。新しいパラメーターが追加された後、パラメーターの$シンボルをダブルクリックして、パラメーターの名前を入力します。
下のスクリーンショットでは、 RectangleArea という名前の アクショングループが $length と $width という名前の2つのパラメーターを宣言しています。パラメーターは任意としてマークされていません。これは、アクショングループがランタイムで呼び出されると、これらのパラメーターの値を提出する必要があり、それ以外の場合はエラーが報告されます。(アクショングループの実行を使用してパラメーター値を提供する を参照してください)。(アクショングループ チェックボックスに関する詳細はアクショングループパラメーターを持つアクショングループのセクションを参照してください。)
アクショングループは2つのアクションより構成されています:
•Area ノードを更新するための値を生成する2つのパラメーター $length と $width を乗算する更新ノード アクション。
•2つのパラメーター $length と $width.を乗算し取得された値を含むメッセージボックスを表示するメッセージボックス アクション。
アクショングループ内でパラメーターを宣言し、これらのパラメータを使用するアクションを定義することに注意してください。パラメーターの値は、アクショングループのアクションの実行により、ランタイムで提供されます。
パラメーターの値を提供する
アクショングループ内の変数も定義することができます。すなわち、変数を定義してそれぞれのために値を定義することができます。変数に関する重要な点に注意してください:
•アクショングループ内のスコープで、アクショングループ内でのみ使用することができます。
•変数の値の定義は変数のリスト内で既に宣言されているパラメーターと変数を使用することができます。例: (上記の順序で) アクショングループがパラメータ $a, $b, $c, と変数 $x, $y, $z を持つ場合、変数 $y は次のパラメーターと変数を使用して値を生成することができます: $A、$b、$c、$x、($z、$b、$c、$x、($z を除く )。
アクショングループの パラメーターの値は、アクショングループのアクションの実行により提供されます。
アクショングループ アクションの実行は、イベントのために定義され、イベントがトリガーされると処理されます。ですから、与えられたイベントがトリガーされると、パラメーターの値がアクショングループにパスされることができます。アクショングループは、これらの値を定義されたアクションを実行するために使用します。
アクショングループ アクションの実行を作成するには、( [アクショングループ] ペイン から) 対応するアクショングループをイベントのアクションの定義にドラッグします。ドロップされる際に、アクショングループは実行するアクショングループとして表示されます。下のスクリーンショットでは、ボタンのクリック時イベントのアクショングループアクションのための実行を定義しました。クリック時イベントの下の RectangleArea アクショングループをドラッグして行いました。現在選択されている実行するアクショングループは、(下のスクリーンショットで赤枠で囲まれている) アクショングループの実行コンボボックスにより変更されることができます .追加オプション アイコンをクリックして選択されたアクショングループを開きます。または、 XPath 式を使用してアクショングループを使用することができます。(例えば、アクショングループの名前をページソースノードから取得するなど) Xpath 式の使用によりアクショングループを動的に選択することができます。Xpath 式はプロジェクト内で定義されているアクショングループの名前である文字列を返す必要があります
パラメーターが現在選択されているアクショングループ内でパラメーターが宣言されている場合、これらのパラメーターはアクショングループ アクションの実行内で表示されています。これはランタイムにパラメーターに値をパスする箇所です。上のスクリーンショットでは、RectangleArea アクショングループ には次の二つのパラメータがあることが表示されています: $length と $width。簡単な統計の値 (3 と 4) を、2つのパラメーターの値を生成するために使用した XPath 式に入力しました。XML ツリーソースから動的に、または、複雑な XPath 計算を指定して値を取得することもできます。アクショングループ内で、パラメーターがオプションではなく、必須として宣言されている場合、赤い文字で表示され、値は与えられません。
ランタイムでは、以下が発生します:
1.イベントがトリガーされると、(アクショングループ アクションの実行で指定されているとおり)パラメーターの値は、アクショングループ内の対応するパラメーターにパスされます。
2.アクショングループのアクションが処理されます。これらがアクショングループの宣言されたパラメーターを使用する箇所で、与えられたパラメーターの値が代替されます。
パラメーター値の種類
アクショングループの実行アクション内であパラメーターの値は次の種類であることができます。 ( Xpath 式を使用して)これらは直接入力されるか動的に生成されることができます。
•動的な値: 例： "Altova" のような文字列または 1 または 2.56 のような数値。
•配列: 例： [(2010,2019), ("StartYear","EndYear")]
•マップ: 例： map{"StartYear":2010, "Offices":("Boston","Vienna")}
