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
親トピック: 2セクション・フォーム関数