setQueryMessage( )

在规则内动态设置查询消息。此查询消息用于在规则返回 false 时创建查询。

您为查询设置的消息可以是动态生成的字符串。可以通过使用返回字符串的变量或函数来实现此目的。请参阅下面的示例部分。

运行规则时未设置动态查询消息时，将使用在规则创建时提供的默认查询消息。如果在逻辑中使用 setQueryMessage() 函数，则在动态查询消息的值为空值、未定义、空字符串或仅包含空格时，不会设置动态查询消息。

注意：

此功能不能用于发送电子邮件通知的规则。

语法

setQueryMessage(strMessage)

参数

参数	必选/可选	说明
strMessage	必需	包含查询消息的字符串。可以在规则表达式中动态生成此字符串。 提示： 在将日期传递到此函数之前，可以使用 getDateDMYFormat( ) 帮助函数设置日期格式。

返回值

包含已设置用于创建查询的查询消息的字符串。或者，如果函数运行过程中出现任何错误，则为空字符串。

示例

示例 3-101 设置权重小于 120 时的查询消息

// Given "weight" item containing value of 110.
if (weight < 120){
var strMessage = "Subject weight of " + weight + " lb is less than the required weight of 120 lb."
setQueryMessage(strMessage);
  return false; // create query
} else {
 
   return true;  // close query
}
  
// A query is created with message "Subject weight of 110 lb is less than the required weight of 120 lb."