アクショングループパラメーターを持つアクショングループ

www.altova.com このトピックを印刷 前のページ 1つ上のレベル 次のページ

ホーム >  アクション > アクショングループ >

アクショングループパラメーターを持つアクショングループ

アクショングループは、以下の2つの種類のパラメーターを使用することができます:

 

パラメーターを持つアクショングループ 内で説明されている単純型パラメーター。 MobileTogether Designer 内では、名前の前のドルシンボル $ で示されています。
アクショングループを自身の値として取るアクショングループパラメーター。MobileTogether Designer 内では、名前の前のパーセントシンボル % で示されています。

 

下のスクリーンショットでは、 $length$width は、単純型パラメーターですが、 %RectangleProperty  は、アクショングループパラメーターです。アクショングループパラメーターとしてパラメーターを作成するには、 最初に単純型パラメーターとして作成し、 アクショングループ チェックボックスをチェックします (下のスクリーンショット参照)。

MTDAGParams01

 

アクショングループ パラメーターの動作方法

アクショングループ パラメーターは、自身の値としてパラメーターを宣言しないパラメーターを取ります。 これにより、呼び出されたパラメーターは MobileTogether タスクを実行する関数のように扱われます。 アクショングループ パラメーターは広い意味で、単純型パラメーターと同じように動作します。

 

アクショングループ パラメーターをパラメーター内で宣言します。 含まれるパラメーターはこれらのアクショングループパラメーターを使用するアクションを定義することができます。または、含まれるパラメーターをパラメーターの実行アクションを使用して直接アクショングループパラメーターを処理することもできます (アクショングループ パラメーターの処理のセクション参照 )。
アクショングループ パラメーターの値は、含まれるパラメーターを呼び出すパラメーターの実行アクションにより提供されます。 許可される値は(プロジェクト内の) パラメーターを持たないパラメータです。

 

使用方法のサンプル

アクショングループ パラメーターの使用方法のサンプルが以下に表示されています。 三角形の3つのプロパティ(面積、対角線、周囲)を計算し表示するために作成されました :

 

Calculate (上のスクリーンショット参照): 2つの単純型のパラメーター ($length および $width) とアクショングループ パラメーター (%RectangleProperty) を宣言します。アクショングループ パラメーターは、パラメータが定義されていない3つのパラメータの値をとることができます。Calculate パラメーター内では、Let アクション が定義されています。このアクションは、 $result と呼ばれる、変数を、 %RectangleProperty パラメーターの値であるパラメーターのパラメーターの結果をとるために定義します。前のアクションで定義された $result パラメーターの実行アクションの値を表示するメッセージボックスアクションが次です。
Area (下のスクリーンショット): このパラメーターは、2つの単純型のパラメーター $length$width の結果を含む単一のReturn アクション を含んでいます。 このパラメーターは、パラメーターを含みません。ですから、 %RectangleProperty の値となることができます。 %RectangleProperty が処理されると、 Calculate パラメーター内の $result 変数は、 Area パラメーターの戻り値を受け取ります。

MTDAGParams02

Diagonals: このパラメーターは、 Area パラメーターに類似しています。正方形の対角線の長さを返す、単一の リターン アクション を含んでいます。 (2つの単純型のパラメーター$length$widthの正方形の合計の平方根。XPath: math:sqrt($width*$width $length*$length))。 このパラメーターが %RectangleProperty の値である場合、返される値は、 Calculate パラメーター内の $result 変数の値として設定されます。
Perimeter: このパラメーターは、 AreaDiagonals パラメーターに類似しています。これは、長方形の周囲 (XPath: 2*$width + 2*$length) を返す単一の リターン アクションを含んでいます。 このパラメーターが %RectangleProperty の値の場合、 Calculate パラメーター内の $result 変数の値が返される値として設定されます。

 

上記の4つのパラメーターの詳細に関して、以下の点に注意してください:

 

Calculate パラメーターは、3つのパラメーターを含みます: 2つの単純型のパラメーターと1つのアクショングループ パラメーター。
他の3つのパラメーター (AreaDiagonalsPerimeter) は、パラメーターを宣言しません。
3つのパラメーター (AreaDiagonalsPerimeter) のそれぞれは、 Calculate 内で宣言されている単純型のパラメーターから値を計算する リターン アクション を持ちます。返された値は、これらのパラメーターのパラメーターの結果です。
3つのパラメーター (AreaDiagonalsPerimeter) のそれぞれは、アクショングループ パラメーター %RectangleProperty の値として設定することができ、処理される際、対応するパラメーターの結果を返します。
Calculate パラメーター内で処理されるアクショングループ パラメーター %RectangleProperty 。メッセージボックス内で表示される $result 変数の値を提供します。 ( 上の Calculate パラメーター スクリーンショット参照)。

 

 

アクショングループ パラメーターの値の提供

パラメーター は、 Calculate パラメーター内で宣言されているため、これらの値は(パラメーターの実行アクションを使用して) Calculate パラメーターが呼び出されるとパスされます。 ですから、例えば、 ボタンのクリック時 イベントを下のスクリーンショットに表示されるように定義することができます。

MTDAGParams03

(Calculate パラメーターをパラメーターペインにドラッグすることにより) パラメーターの実行アクションをイベントペイン内に作成します。Calculate パラメーターのパラメーターは、自動的に表示されます。 %RectangleProperty アクショングループ パラメーターに関しては、パラメーターの値とするパラメーターを選択します(上のスクリーンショット参照)。ですから、Calculate パラメーター が実行されると、呼び出しで指定されている 3つのパラメーターの値にパスされます。 Calculate パラメーター 内のLet アクション が実行されると、 (下のスクリーンショット参照)、$result 変数が、 %RectangleProperty の値として指定されているパラメーターのパラメーターの結果として設定されます。

MTDAGParams04

メモ:上のサンプルは、意図的に単純になるように作成されており、その目的はアクショングループパラメータの背景にあるメカニズムを説明することです。 しかし、アクショングループのパラメーターは動的なコンテンツを使用し、複雑なアクションを実行するために最適です。

 

アクショングループ パラメーターの処理

アクショングループ パラメーターは、パラメーターを自身の値として取ります。 このパラメーターはパラメーター値として2つの有効な方法で処理することができます:

 

Let アクションを使用して定義される変数の値を設定するために使用することのできる— パラメーターの結果—を提供します。この使用方法は上のサンプルで説明されています。
ノードの更新、電子メールの送信、パラメーターの結果が存在しない場合など、特定の MobileTogether タスクを実行することができます。 これは、含まれるアクショングループ内でをアクショングループパラメーターのためのアクショングループの実行アクションを定義することで指定されます (下のスクリーンショット’参照)。これは、アクショングループのパラメーターをアクショングループペインからイベントの定義にドラッグすることで行うことができます。

MTDAGParams05

両方のアクションのセットを組み合わせることも可能です。

 


(C) 2019 Altova GmbH