ルールのデバッグ

ルール設計者は、logMsg()文を使用してルール・ロジックに関する情報を取得し、必要に応じて動作することを確認することで、ルールをデバッグできます。

注意:

デバッグ機能は、テスト・モードでのみ使用できます。

必要な要素を含む試験バージョンがテスト・コンテナにある必要があります。ルール・インタフェースへのアクセスの説明に従って、特定の試験バージョンおよびサイトからルール・インタフェースにアクセスします。

目的のスタディに移動し、サイトを選択します。
表で、編集するビジット・カードを見つけてクリックします。
訪問ウィンドウの左側で、操作するルールを含むフォームをクリックします。

注意:
ルールをデバッグする前に、ルールのテスト・データが入力されている必要があります。「デバッグ」ボタンは、ルールがアクセスされたサブジェクトに入力されたデータに対してルールを実行します。これには、他の訪問で入力された関連データが含まれます。
質問を選択し、右側の「ルール」ペインを展開して、そこに含まれるルールを表示します。

ヒント:
質問をクリックすると、「このフォームのすべてのルールを表示」オプションを有効にして、そのフォームの質問に追加されたすべてのルールのリストを取得できます
ルール・エディタを開きます。
- 既存のルールを編集するには: 指定されたルールについて、メニュー・アイコン()をクリックし、「編集」を選択します。
- 新しいルールを作成するには: 「計算値のルールの作成」を参照してください。
必要に応じてログ文を追加します。
ログ・ヘルパー関数を正しく使用する方法の詳細は、logMsg()を参照してください。
「デバッグ」をクリックします。

注意:
「デバッグ」をクリックすると、変更内容がJavaScript式に自動的に保存されます。すべてのルール保存要件を満たす必要があります。コンパイル・エラーや要件がないと、デバッグ・プロセスを完了できません。

ログ・ウィンドウがルール・エディタの右側に表示されます。

ルールは選択したサブジェクトのデータに対して実行され、ルール内およびすべてのインスタンスに対してlogMsg()ヘルパー関数に対して行われたコールを出力します。つまり、ルールが複数の訪問のフォームまたは繰返しセクションの質問に属している場合、影響を受けるすべての訪問および繰返しセクションのルールが分析されます。各ルール・インスタンスからの出力がログ・ウィンドウにリストされます。

例外が発生した場合は、スタック・トレースの詳細およびエラー・メッセージがログ・ウィンドウに表示されます。
ログ・メッセージを確認し、ルール式に必要な変更を加えます。
必要に応じてログ文を追加し、ルールの実行パスが期待どおりになるまでステップ6から8を繰り返します。
「保存」をクリックしてルール・エディタを終了します。

ヒント:

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

保存後、期待どおりにルール・パフォーマンスをテストする必要があります。ルールを本番で使用できるようにするには、ルールをテスト、承認および公開する必要があります。詳細は次を参照してください。

カスタム・ルールの開発例および詳細は、次を参照してください。

親トピック: カスタム・ルールの作成および管理