自動化ルールをデバッグする

ルールが期待どおりに動作しない場合のトラブルシューティングや問題解決には、以下の情報が役立ちます。

1. 監査ログを確認する

Checking the audit log should be your first step when a rule is failing. When reviewing the audit log:

  • 表示されているエラーを確認します。エラーがある場合、問題の修正方法に関する提案や説明がありますか?

  • あるはずのエントリが表示されていない場合は、トリガーを正しく設定していないか、トリガーにフィルターが設定されており、そのフィルターが期待どおりにふるまっていないかのいずれかです。

  • 監査ログの編集内容を、製品で見つけられる履歴情報 (Jira の課題履歴や Confluence のページ履歴など) と比較します。

  • Jira Automation では、すべての関連するフィールドが、Jira の画面の右側にあるかどうかを確認します。

監査ログにアクセスする方法を学習します。

2. スマート バリューをデバッグする

"ログ" アクションを使用

The Log action adds values into the audit log, including smart values. This can be useful when testing complex smart-value functions.

Log message: This should evaluate to 2: {{#=}}1 + 1{{/}}

 

自動化ルールの "ログ" アクション。"ログ メッセージ" フィールドに値「{#=}1 + 1{/} should equal to 2」が入力されています

デバッグを使用

Using the Log action requires you to add an additional component to your rule. To avoid this, you can use the {{#debug}} function.

スマート バリューをデバッグ タグで囲うことで、スマート バリューを通常のように処理できます。また、監査ログ内に値を表示することで、より役立つ情報が確認できます。

{{#debug}}{{#=}}1 + 1{{/}}{{/}}

このルールを実行すると、監査ログには次の項目が含まれるようになります。

Debug message 2
自動化ルールの監査ログ。ルールには [成功] のステータスが表示されて、[デバッグ メッセージ] には 2 と表示されています。

3. テストを簡単、クリーンにする

  • テストの前に元のルールをコピーしてから無効にすると、変更しても簡単に元のルールに戻ることができます。

  • Use the Manual trigger (Jira only) to execute a rule from an issue at any time. You can also use the Scheduled trigger to run a rule for the purposes of testing.

  • 値を入力するアクションをテストするときは、スマート値 {{now}} を使用して現在の時刻を含めます。これによって、いつ編集が行われたのかと、値が変更されたかどうかがわかります。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。