FindMatchingRepeatingForm( )

查找包含与搜索值匹配的值的重复表单实例。

对于此函数:

  • 不能使用下拉列表、单选按钮或复选框值作为函数参数或目标。
  • 如果变量设计为保存部分日期,则必须以相同的部分日期格式提供该参数的值。您可以采用以下格式使用部分日期:
    • <dd-mmm-yyyy hh:mm>
    • <dd-mmm-yyyy hh>
    • <dd-mmm-yyyy>
    • <mmm-yyyy>
    • <yyyy>

注意:

这是一个聚集函数。如果目标位于重复表单上,则为每个表单实例运行规则。

语法

FindMatchingRepeatingForm('variable1', value1, 'variable2', value2, ...)

参数

变量
要搜索的项变量。

注意:

允许在规则表达式的其他位置重复使用传递给此函数的变量,但是必须使用单引号将变量添加为参数。
value(s)(值)

搜索值。

这些值必须是硬编码的,不能是规则变量:
  • 必须在字符串 '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)' 内提供时间。
  • 您可以采用以下格式使用部分时间:
    • <hh:mm>
    • <hh>

返回值

如果未找到匹配项,则返回 -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.