FindMatchingRepeatingForm( )

検索値と一致する値を含む繰返しフォーム・インスタンスを検索します。

この関数について:

• ドロップダウン、ラジオ・ボタンまたはチェック・ボックス値を関数パラメータまたはターゲットとして使用することはできません。
• 変数が日付の一部を保持するように設計されている場合は、同じ部分的な日付書式でそのパラメータの値を指定する必要があります。日付の一部を次の書式で使用できます。
  • <dd- mmm- yyyy hh:mm>
  • <dd- mmm- yyyy hh>
  • <dd- mmm- yyyy>
  • <mmm- yyyy>
  • <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>
  • <mmm- yyyy>
  • <yyyy>
• 時間は、文字列'Time(hh:mm:ss)'内に指定する必要があります。
• 時間の一部は、次の形式で使用できます。
  • <h: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.