setQueryMessage( )

ルール内で問合せメッセージを動的に設定します。この問合せメッセージは、ルールがfalseを返すときに問合せの作成に使用されます。

ノート:

この関数は、通知を生成するルールには使用できません。

getDateDMYFormat( )ヘルパー関数を使用すると、日付をフォーマットしてからこの関数に渡すことができます。

構文

setQueryMessage(strMessage)

パラメータ

strMessage

問合せメッセージを含む文字列。この文字列は、ルール式内で動的に生成できます。

戻り値

問合せ作成用に設定された問合せメッセージを含む文字列。または、関数の実行中にエラーが発生した場合は空の文字列。

ノート:

動的問合せメッセージは、その値がnull、未定義、空の文字列、または空白のみを含む場合、設定されません。ルールの作成時に指定されたデフォルトの問合せメッセージは、ルールの実行時に動的問合せメッセージが設定されていない場合に使用されます。

例3-100重みが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."