logMsg()

デバッグ中にルールのロジックに関する特定の情報を取得します。JavaScript式で必要に応じてログ文を配置し、定義された変数とメッセージの値を表示してルールの動作を明らかにします。

構文

logMsg(argument)

パラメータ

引数

デバッグ用に記録および表示する式または変数値。

引数としてサポートされているのは stringsと numbersのみであり、つまり、これらの型の変数を使用できます。オブジェクトを引数として使用する場合は、文字列として渡されるようにstringify()メソッドを使用する必要があります。

戻り値

logMsg()ヘルパー関数に渡された引数が返され、デバッグ時にログ・ウィンドウに表示されます。

使用上のヒント

ノート:

logMsg()ヘルパー・ファンクションはデバッグ・モードでのみ実行されるため、ルールを公開する前にコールを削除する必要はありません。

例3-81変数のラベルの使用

変数を記録するときにラベルを使用して、出力の追跡を容易にします。

logMsg("weight: "+weight); // logs the label and the variable value

ログ・ウィンドウの出力

weight: 160

例3-82ログ文を使用したルール・ロジックのデバッグ

ルールの動作を駆動するロジックを示すフラグとしてメッセージをログに記録します。

var weight = "All visits"."Form Demo"."item weight";
logMsg("weight: "+weight); // logs the label and the variable value
if(weight >160){ 
    logMsg("weight > 160"); // log the execution path for "if" return false; }
else{ 
    logMsg("NOT weight > 160"); // log the execution path for "else" return true;}

ログ・ウィンドウの出力

weight: 160
NOT weight > 160

例3-83 stringify()メソッドを使用したオブジェクトの受渡し

stringify() メソッドを使用してオブジェクトを文字列に解析し、ログ文で使用できます。

var val1 = getValues("dt1","tpt"); 
logMsg("dt1 = "+JSON.stringify(dt1));

ログ・ウィンドウの出力

dt1 =
      [{"visitName":"SCR","deleted":false,"tableRowInstance":null,"branchName":null,"eventType":"ScreeningVisit","formRepeatNumber":1,
"value":"2022-03-09T00:00:00.000Z","cycleNumber":null,"empty":false,"treatmentArm":null},
{"visitName":"SCR","deleted":false,"tableRowInstance":null,"branchName":null,"eventType":"ScreeningVisit","formRepeatNumber":2,
"value":"2022-03-09T00:02:00.000Z","cycleNumber":null,"empty":false,"treatmentArm":null},
{"visitName":"SCR","deleted":false,"tableRowInstance":null,"branchName":null,"eventType":"ScreeningVisit","formRepeatNumber":3,
"value":"2022-03-09T06:00:00.000Z","cycleNumber":null,"empty":false,"treatmentArm":null}]