FindRFInstance( )

使用提供的运算符查找包含与搜索值匹配的值的重复表单实例。

此函数与 FindMatchingRepeatingForm( ) 类似。但是，它允许规则设计器指定匹配操作数（=、>、<、>=、<=）。

注意：

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

语法

FindRFInstance (DateMask, 'variable1', 'compareOperator1', value1, 'variable2', ...)

参数

DateMask

用于指定如何处理部分日期的标志。

• null。进行比较时忽略部分日期。
• value 。将部分日期中的 UNK 组件替换为指定的值。例如：输入 '10-Apr' 可替换为“天”(DD) 组件的每 UNK 值 '10' 以及“月”(MMM) 组件的每 UNK 值 'Apr'。

  注意：

  仅对日期元素使用掩码，不将其用于时间元素。时间部分中缺少的任何值都视为 00。

变量

要搜索的项目变量。

注：

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

compareOperator

用于比较的运算符：=、>、<、>=、<=。

值

将变量作为字符串进行比较的值。

• 日期值可作为 Javascript 日期变量或以下格式的字符串提供：
  • 'Date(dd-mmm-yyyy)'
  • 'Date(dd-mmm-yyyy hh:mm:ss)'
  • 'dd-mmm-yyyy'
  • 'dd-mmm-yyyy hh:mm:ss'
• 时间值可作为 'Time(hh:mm:ss)' 提供

返回值

如果未找到匹配项，则返回 -1；如果找到至少一个匹配实例，则返回表单实例的索引号 (>0)。如果找到多个实例，则仅返回第一个索引。

使用提示

• 自定义函数中的值应该是 JavaScript 变量或直接值。请勿直接在定制函数表达式中使用操作数变量。
• 如果要将其他操作数 / 变量用于值，则必须首先将其分配给 JavaScript 变量，然后在函数表达式中使用。
• 使用 'DD-MON' 格式作为 DateMask 来替代部分日期值中的未知 (UNK) 值。例如，如果掩码为 '01-MAR'：

  部分日期值	屏蔽日期	附注
  'UNK-FEB-2020'	'01-FEB-2020'	使用掩码的 day 部分进行有效计算。
  'UNK-UNK-2020'	'01-MAR-2020'	可使用掩码的 day 和 month 部分进行有效计算。

示例 3-50 如果脉冲实例大于给定值，则引发查询

// Raise a query if there is an instance of pulse > 100
return (FindRFInstance(null, 'pulseVal','>', 100) > 0)?false:true;        //query is raised when false is returned
 

示例 3-51 如果日期变量等于或晚于给定日期值，则引发查询

// Raise a query if there's an instance where onDate is >= 10-Jun-2010
//(onDate is partial UNK-UNK-YYYY) 
return (FindRFInstance('10-Jun', 'onDate', '>=', '10-Jun-2010') > 0)?false:true;

示例 3-52 如果日期时间变量等于或晚于给定日期时间值，则引发查询

// Raise a query if there's an instance where onDateTime is >= 10-Jun-2010 11:12:15
//(onDateTime is partial DD-MMM-YYYY UNK:UNK:UNK)
return (FindRFInstance('10-Jun', 'onDateTime' , '>=', '10-Jun-2010 11:12:15') > 0)?false:true; 

//or
return (FindRFInstance('10-Jun', 'onDateTime' , '>=', 'Date(10-Jun-2010 11:12:15)') > 0)?false:true;

示例 3-53 如果时间变量等于或晚于给定时间值，则引发查询

// Raise a query if there's an instance where onTime is >= 11:12:15 
//(onTime is partial HH:UNK:UNK)
return (FindRFInstance(null, 'onTime' ,'>=', 'Time(11:12:15)') > 0)?false:true;