ワークフロー トリガーのトラブルシューティング

JIRA または開発ツールのバージョンが正しくない

正しいバージョンをインストールまたはアップグレードします。

開発ツールが Jira に正しく接続できない

接続の設定を確認します：

• Jira + Bitbucket Data Center/Fisheye/Crucible：2LO と 3LO を使用した OAuth による双方向アプリリンクを設定する必要があります。

• Jira + Bitbucket/GitHub： DVCS コネクタを正しく設定する必要があります。

開発ツールとの統合に関する詳細をご確認ください。

スペースでは、トリガーで設定されたワークフローが使用されていません

1. サイドバーにあるスペース名の横で、その他のアクション（•••）を選択し、スペース設定を選択します。 

2. サイドバーから [ワークフロー] を選択します。

3. 設定したトリガーを使用するワークフローがスペースで使用されていることを確認してください。

トリガーが追加されたワークフローの変更が保存されていません

トリガーを追加したワークフローに移動します。ワークフロー トランジションを表示し、表示されたトリガーを確認して公開されていることを確認します。

DVCS が Jira に到達していない

Wait an hour. If it still cannot be reached after an hour, check that the connection to your DVCS is configured correctly, see Integrating with development tools.

If triggers are not configured or Jira is not reachable from Bitbucket/GitHub, then the delay might be up to one hour, as there is still an hourly synchronization of commits/branches/pull requests happening regardless of the triggers configuration. Find out about event handling and event limits.

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 ユーザーにマッピングしていることを確認します。

特定の作業項目操作では、匿名ユーザーによってトランジションが実行された場合に例外がスローされます。これらは：

• CreateWorkItem イベント（これは、おそらくワークフローの「作成」または「作業項目を作成」トランジションに関連しています）

• ユーザーがトランジションを実行していると仮定する 事後操作

A triggered transition is performed by an anonymous user if the event in the development tool cannot be mapped to a Jira user. Learn more about user mapping.

作業項目に許可されている自動トランジションの最大数を超えました

ワークフロートランジションが無限ループで終了していないことを確認します。

開発ツールによって自動作業項目トランジションイベントが誤って抑制されています

リポジトリ/スペースの設定を変更して、イベントの送信を許可してください。

重複するイベントが送信されていた場合、ワークフローをトリガーするイベントを Jira に送信しないよう Bitbucket Data Center (Stash 3.3 ～ 3.5) リポジトリまたは Fisheye (3.5 以降) リポジトリを構成している可能性があります。複数の開発ツールでインデックスされている同一のリポジトリがある場合、Jira にリポジトリ イベントが重複して送信される可能性があります。

Jira はワークフロー トリガーを処理する際に、重複するコミット イベントおよびブランチ作成イベントを自動的に削除します。

Bitbucket Data Center や Fisheye からのリポジトリイベントは、重複するイベントが作業項目を誤ってトランジションさせる原因となっている場合を除き、抑制すべきではありません。

グローバルトランジションにトリガーを設定しました。

トリガーイベントが異なるステータスの作業項目にどのような影響を与えるかを調査します。グローバルトランジションからトリガーを削除することを検討してください。

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. Find out about triggers and global transitions.

自動作業項目トランジションでは、ワークフロー条件、バリデーター、および権限は意図的に無視されます。

何もする必要はありません。

ワークフロー条件、バリデーター、または権限が自動作業項目トランジションに適用されることを期待していた場合は、これらのいずれも適用されないことにご注意ください。これに関連して、事後操作は作業項目の自動トランジションに適用されます。

ワークフローは複数のスペース間で共有されています

一部のスペースではワークフローにトリガーを適用し、他のスペースでは適用しない場合は、ワークフローをコピーする必要がある場合があります。

トリガーはワークフローに適用されます。ワークフローが複数のスペースで共有されている場合、そのワークフローに設定されているすべてのトリガーが含まれます。

重複する自動作業項目トランジションイベントが複数の開発ツールにより送信されています。

開発ツールの 1 つ（または複数）でリポジトリ/スペース設定を変更して、イベントが送信されないようにします。

複数の開発ツールでインデックスされている同一のリポジトリがある場合、Jira にリポジトリ イベントが重複して送信される可能性があります。Jira は重複するコミット イベントおよびブランチ作成イベントを自動的に削除します。

最新の Jira バージョンを使用しておらず、重複するリポジトリイベントが原因で作業項目のトランジションが正しく行われない場合は、Bitbucket Data Center（Stash 3.3 - 3.5）および Fisheye（3.5+）リポジトリを設定して、ワークフロートリガー用に Jira に送信されるイベントを抑制できます。

開発ツールのユーザーが 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.