カスタム・ルールのデバッグ

ルール設計者は、編集時にログを使用し、カスタムJavaScriptルールをデバッグして、ルール動作の背後にあるロジックを理解できるようになりました。

メリットは何ですか?

ルール・エディタでは、ルールの作成とデバッグを同時に実行できるため、ルールの動作を理解し、テスト前に失敗を識別して修正できます。新しいデバッグ機能は、既存のサブジェクト・データのデバッグでルールを実行するときに、logMsg()ヘルパー関数をコールすることによって使用されます。ルール式の様々なキー・ポイントでログ文を追加すると、ルール動作の背後にあるロジックを示す定義済変数およびメッセージの値を表示することで、ルールのパフォーマンスに関する関連情報を取得できます。また、例外が発生するたびにエラーの説明が表示されます。

ルール設計者の詳細

テスト・モードでルールを作成または編集する場合の新機能は次のとおりです。

• ルール・エディタでの作業中に、JavaScript式で必要な場所にログ文を配置して、ルールの実行時にコードの特定のポイントでデータがどのように処理されているかを確認できます。
• ルール・エディタ画面で、新しい「デバッグ」ボタンが導入されました。クリックすると、JavaScript式への変更が保存され、現在のサブジェクトの既存のデータに対して実行されます。
• デバッグ・プロセスが開始すると、「ルール・エディタ」ダイアログの右側にログ・ウィンドウが表示され、ログ情報が出力されます。例外が発生した場合、スタック・トレースの詳細およびエラー・メッセージがログとともに表示され、ルールの失敗または予期しない動作に関する追加情報が提供されます。
• ログ情報を確認した後、ルール式を変更し、ルールが期待どおりに機能するまで、さらにデバッグするプロセスを繰り返すことができます。

JavaScript式を保存する「デバッグ」をクリックする前に、すべてのルール保存要件を満たす必要があります。コンパイル・エラーまたは要件がないと、デバッグ・プロセスを完了できません。

この新機能を最大限に活用するには、logMsg()ヘルパー関数のドキュメントと使用上のヒントを確認してください。

既にライブ勉強をしていますか?

このリリースが使用可能になるとすぐに、ルール設計者は、テスト・モードのすべての試験について、新しく作成されたカスタム・ルールまたは既存のカスタム・ルールのデバッグを開始できます。デバッグ機能は、セキュリティ制約のため、本番モードのライブ・スタディでは使用できません。

この機能の詳細は、CROおよびスポンサ・ユーザー向けの情報を参照してください。カスタム・ルールの作成および管理を参照してください。