FindMatchingRepeatingForm( )
検索値に一致する値を含む繰返しフォーム インスタンスを検索します。
この関数の場合:
- ドロップダウン、ラジオ・ボタンまたはチェックボックス値は、ファンクション・パラメータまたはターゲットとして使用できません。
- 変数が部分的な日付を保持するように設計されている場合は、そのパラメータの値を同じ部分的な日付書式で指定する必要があります。日付の一部を次の書式で使用できます。
- <dd-mmm-yyyy hh:mm>
- <dd-mmm-yyyy hh>
- <dd-mmm-yyyy>
- <yyyy-mmm>
- <yyyy>
注意:
これは集計関数です。ターゲットが繰返しフォームにある場合は、各フォーム インスタンスに対してルールが実行されます。
構文
FindMatchingRepeatingForm('variable1', value1, 'variable2', value2, ...)
パラメータ
- 変数
-
検索するアイテム変数。
注意:
この関数に渡された変数は、ルール式内の他の場所でも再使用できますが、一重引用符を使用して変数をパラメータとして追加する必要があります。 - 値
-
値を検索します。
次の値はハードコードする必要があり、ルール変数にはできません。- 日付は、文字列
'Date(dd-mmm-yyyy hh:mm:ss)'
内に指定する必要があります。 - 日付の一部を次の書式で使用できます。
- <dd-mmm-yyyy hh:mm>
- <dd-mmm-yyyy hh>
- <dd-mmm-yyyy>
- <yyyy-mmm>
- <yyyy>
- 時間は文字列
'Time(hh:mm:ss)'
内に指定する必要があります。 - 時間の一部を次の書式で使用できます。
- <hh:mm>
- <hh>
- 日付は、文字列
戻り値
少なくとも1つの一致するインスタンスが見つからない場合は -1を返し、一致するインスタンスが見つからない場合はフォームインスタンスのインデックス番号(>0)を返します。複数のインスタンスが見つかった場合は、最初の索引のみが返されます。
注意:
日付では、UNK
値が他の値と一致するとみなされます。たとえば、'Date(01-Feb-2022)'
と'Date(20-Feb-2022)'
は、両方ともUNK-Feb-2022
日付値を持つエントリの一致とみなされます。
例3-48症状= "headache"およびパルス率= "100"のインスタンスが存在する場合に問合せを発生させます
// Given 5 repeating form instances with items "itmSymptom" and "itmPulse"
if (FindMatchingRepeatingForm('itmSymptom', "headache", 'itmPulse', 100) > 0) {
return false;
} else {
return true;
}
// Fires query if any of the 5 instances contain both itmSymptom = "headache" AND itmPulse = 100.
親トピック: 繰返しフォーム関数