findMaxIn2SForms( )

2セクション・フォームの繰返しセクションのすべてのインスタンスで、特定のデータ・アイテムの最大値を検索します。この関数は数値フィールドでのみ機能します。

この機能には、数値タイプの質問のみを使用できます。ドロップダウン、ラジオ・ボタンまたはチェックボックス値は、ファンクション・パラメータまたはターゲットとして使用できません。

注意:

これは集計関数です。ルールは、ターゲットが2セクション・フォームの繰返しセクションにある場合に、各インスタンスに対して実行されます。

構文

findMaxIn2SForms(formInstance,'variable')

パラメータ

formInstance

最大値を検索するために検索されるフォーム インスタンス。

• formInstanceがnullで、変数がフラット・セクションにある場合は、すべてのインスタンスのフラット・セクションが検索されます。
• formInstanceがnullで、変数が表の行にある場合は、すべてのインスタンスのすべての表の行が検索されます。
• formInstance値が指定されている場合、検索は指定されたインスタンスの表の行間でのみ行われます。

変数

検索する項目変数。参照パスはeventId.formId.itemIdです。

注意:

この関数に渡された変数は、ルール式内の他の場所でも再使用できますが、一重引用符を使用して変数をパラメータとして追加する必要があります。

戻り値

すべてのインスタンスでの最大値を返します。最大値が見つからない場合は"0"を返します。

例3-64 1回の訪問における2セクション・フォームのすべての繰返しインスタンスにおける"weight"数値アイテムの最大値の検索

// Given 5 repeating section instances in a two-section form with "weight" item containing values of "150, 200, 250, 300, 350"
return findMaxIn2SForms(null,'varWeight');
 
// returns 350