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

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

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

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

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

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

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

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

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

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

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

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

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

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

DVCS が Jira に到達していない

1 時間程度待ちます。1 時間後に到達していない場合は、DVCS との接続が正しく設定されていることを確認します。「開発ツールとの統合」をご確認ください。

トリガーが設定されていない場合、または Bitbucket/GitHub から Jira にアクセスできない場合、遅延は最大 1 時間になる可能性があります。これは、トリガー設定に関係なく、コミット/ブランチ/プルリクエストの 1 時間ごとの同期が引き続き実行されるためです。イベント処理とイベント制限について確認する。

DVCS リポジトリが同期済み DVCS アカウントにリンクされていない

Jira 管理コンソールに移動し、アドオン、DVCS アカウントの順に選択します。リポジトリを有効にする。

Bitbucket または GitHub で新しいリポジトリの自動リンクを設定していない場合、有効になっていないリポジトリがある可能性があります（つまりDVCS アカウントにリンクされています）。これは、リンクされていないリポジトリからのイベントが Jira に送信されないことを意味します。そのため、トリガーを設定していても、作業項目は自動的にトランジションしません。

コミットが古すぎます

トランジションが生じるのは、経過日数 21 日未満のコミットのみです。これにより、一括アップロードを防止して一括トランジションが生じないようにしています。 

匿名ユーザーにはこの操作は許可されません。

開発ツールの各ユーザーを Jira ユーザーにマッピングしていることを確認します。

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

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

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

開発ツールのイベントが Jira ユーザーにマッピングできない場合は、トリガーされたトランジションは匿名ユーザーによって実行されます。ユーザーのマッピングに関する詳細についてご確認ください。

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

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

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

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

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

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

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

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

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

トリガーが作業項目の動作にどのような影響を与えるか正確に理解しているという自信がある場合を除いて、グローバル トランジションのトリガーは設定しないことをお勧めします。トリガーとグローバル トランジションの詳細についてご確認ください。

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

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

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

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

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

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

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

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

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

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

開発ツールのユーザーが Jira のユーザーにマッピングされていません。

開発ツールの各ユーザーを Jira ユーザーにマッピングしていることを確認します。

ユーザーが正しくマッピングされていない場合、作業項目のトランジションのユーザーは匿名になります。詳細については、上記のユーザーマッピングのセクションをご覧ください。