ワークフロー トリガーのトラブルシューティング
トリガーの設定や動作に問題がある場合、以下の手順に従い問題をトラブルシューティングしてください。
トリガー診断を使用する
Your first step in troubleshooting a trigger is to check the diagnostics for it in Jira. The diagnostics can tell you if there is a problem with the connection to your development tools or whether a work item did not automatically transition as expected.
[設定] () > Work items.
[ワークフロー] で [ワークフロー] を選択します。
対象のワークフローを見つけ、[操作] 列で [表示] をクリックします。
ダイアグラム モードではなくテキスト モードで、対象のトランジションをクリックします。
トランジション画面 ([トリガー] タブが表示されます) で対象のトリガーの [詳細を表示] をクリックし、診断情報を表示します。
「トリガー ソース」セクションには Jira と開発ツール間の統合に関する問題が一覧表示されます。たとえば、設定された認証のタイプが正しいかどうか、などが表示されます。
The 'Transition failures' section lists work items that have failed to automatically transition despite the trigger firing. For example, an anonymous user was mapped to the transition but the transition has a post function that requires a non-anonymous user.
一般的な問題を確認する
トリガー診断からの情報で問題が解決できない場合、以下の一般的な問題のリストの考えられる原因と解決方法を確認します。
トリガーをトランジションに追加できない
原因 | ソリューション |
---|---|
JIRA または開発ツールのバージョンが正しくない | 正しいバージョンをインストールまたはアップグレードします。 |
開発ツールが Jira に正しく接続できない | 接続の設定を確認します:
|
追加しようとしているトリガーが既にトランジションに追加されている | 何もする必要はありません。 すべてのトリガーはトランジションに対してユニークで、一度だけトリガーをトランジションに追加することができます。 |
The work item does not transition
原因 | ソリューション |
---|---|
プロジェクトが、トリガーが設定されているワークフローを使用していない |
|
トリガーを追加したワークフローの変更を保存していない | トリガーを追加したワークフローに移動します。ワークフロー トランジションを表示し、表示されたトリガーを確認して公開されていることを確認します。 |
DVCS が Jira に到達していない | 1 時間程度待ちます。1 時間後に到達していない場合は、DVCS との接続が正しく設定されていることを確認します。「開発ツールとの統合」をご確認ください。 トリガーが設定されていない、または Jira が Bitbucket/GitHub からアクセスできない場合は、最大 1 時間程度の遅延が発生する可能性があります。これは、トリガー設定にかかわらずコミット/ブランチ/プル リクエスト同期が 1 時間ごとに行われるためです。イベント処理とイベント制限の詳細についてご確認ください。 |
DVCS リポジトリが同期済み DVCS アカウントにリンクされていない | Jira 管理コンソール > [アドオン] > [DVCS アカウント] の順に移動して、リポジトリを有効にします。 If you have not configured Bitbucket or GitHub to autolink new repositories, you may have repositories that are not enabled (i.e. linked to your DVCS account). This means that events from the unlinked repository will not be sent to Jira, hence the work item will not transition automatically, even if you have configured a trigger. |
コミットが古すぎます | トランジションが生じるのは、経過日数 21 日未満のコミットのみです。これにより、一括アップロードを防止して一括トランジションが生じないようにしています。 |
匿名ユーザーにはこの操作は許可されません。 | 開発ツールの各ユーザーを Jira ユーザーにマッピングしていることを確認します。 Certain work item operations will throw exceptions when the transition is performed by an anonymous user. These are:
開発ツールのイベントが Jira ユーザーにマッピングできない場合は、トリガーされたトランジションは匿名ユーザーによって実行されます。ユーザーのマッピングに関する詳細についてご確認ください。 |
The maximum number of automatic transitions permitted for a work item has been exceeded | ワークフロートランジションが無限ループで終了していないことを確認します。 |
Automatic work item transition events are incorrectly suppressed by the development tool | イベントを送信できるようにリポジトリ/プロジェクト設定を変更します。 重複するイベントが送信されていた場合、ワークフローをトリガーするイベントを Jira に送信しないよう Bitbucket Data Center (Stash 3.3 ~ 3.5) リポジトリまたは Fisheye (3.5 以降) リポジトリを構成している可能性があります。複数の開発ツールでインデックスされている同一のリポジトリがある場合、Jira にリポジトリ イベントが重複して送信される可能性があります。 Jira はワークフロー トリガーを処理する際に、重複するコミット イベントおよびブランチ作成イベントを自動的に削除します。 You shouldn't suppress repository events from Bitbucket Data Center or Fisheye, unless duplicate events are causing work items to transition incorrectly. |
The work item transitions but not as expected
原因 | ソリューション |
---|---|
グローバルトランジションにトリガーを設定しました。 | Investigate how the trigger event affects work items in different statuses. Consider removing the trigger from the global transition. We recommend that you do not configure triggers for global transitions, unless you are confident that you understand exactly how the trigger will affect the behavior of the work item. Learn more about triggers and global transitions. |
Workflow conditions, validators and permissions are intentionally ignored for automatic work item transitions | 何もする必要はありません。 If you were expecting workflow conditions, validators or permissions to be applied to an automatic work item transition, then please note that none of these apply. Related to this, post functions do apply to automatic work item transitions. |
ワークフローが複数のプロジェクトにわたって共有されています。 | トリガーをワークフローに適用したいプロジェクトと適用したくないプロジェクトがある場合、ワークフローをコピーする必要がある場合もあります。 トリガーはワークフローに適用されます。ワークフローが複数のプロジェクトにわたって共有されている場合、そのワークフロー用に設定されたすべてのトリガーが適用されることになります。 |
Duplicate automatic work item transition events are being sent by multiple development tools | 開発ツールの1つ (またはそれ以上) のリポジトリ/プロジェクト設定を変更して、イベントが送信されないようにします。 複数の開発ツールでインデックスされている同一のリポジトリがある場合、Jira にリポジトリ イベントが重複して送信される可能性があります。Jira は重複するコミット イベントおよびブランチ作成イベントを自動的に削除します。 If you are not using the latest Jira version and have duplicate repository events causing incorrect work item transitions, you can configure Bitbucket Data Center (Stash 3.3 - 3.5) and Fisheye (3.5+) repositories to suppress events sent to Jira for workflow triggers. |
トランジションについて記録された情報が正しくない
原因 | ソリューション |
---|---|
開発ツールのユーザーが Jira のユーザーにマッピングされていません。 | 開発ツールの各ユーザーを Jira ユーザーにマッピングしていることを確認します。 If users are not mapped correctly, then the user for the work item transition will be anonymous. For more information, see the section on user mapping above. |
Known issue: The correct user is only shown on the 'History' and 'Activity' tabs for work items in Jira, and in notification emails. In other notifications (e.g. 'Transitions' tab for work items) an anonymous user is shown. | 何もする必要はありません。 この既知の問題は今後のリリースで修正される予定です。 |
問題を解決できない場合
問題を解決できない場合は、アプリケーション フォーラム、アトラシアン コミュニティ、サポート チームなど、さまざまなヘルプ リソースをご利用いただけます。
この内容はお役に立ちましたか?