pull request で作業項目を自動的に完了する
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
作業項目を pull request (PR) にリンクすると、PR が完了したときに、それらの作業項目を自動的に完了することができます。 または、PR のマージ時に作業項目を切り替えるワークフロー状態を指定することもできます。
作業項目を pull request (PR) にリンクすると、PR が完了したときに、それらの作業項目を自動的に完了することができます。
詳細については、「プル リクエストの作成、表示および管理」を参照してください。
前提条件
アクセス許可:
- 作業項目を表示、フォローおよび編集するには、「このノードの作業項目を表示」および「このノードの作業項目を編集」のアクセス許可を許可に設定します。 デフォルトでは、 Contributors グループにこれらの権限が与えられます。 詳細については、「作業追跡権限を設定する」を参照してください。
- 作業項目にタグを追加するには、プロジェクト レベルの [新しいタグの定義を作成] アクセス許可を [許可] に設定します。 デフォルトでは、 Contributors グループにこの権限が与えられます。
アクセス レベル:
- プロジェクト メンバー。
- 作業項目に新しいタグを追加したり、プルリクエストを表示またはフォローしたりするには、最低でも Basic アクセスが必要です。
- 作業項目を表示またはフォローするには:少なくとも 利害関係者 アクセスが必要です。 詳細については、「アクセス レベルについて」を参照してください。
- Readers グループのメンバーを含むすべてのプロジェクト メンバーは、作業項目を含む電子メールを送信できます。
Note
- ディスカッションに貢献し、進捗状況を確認するメンバーにStakeholder アクセス権を付与します。 これらは通常、コードには貢献しないが、作業項目、バックログ、ボード、ダッシュボードを表示したいメンバーです。
- 既定では、パブリック プロジェクトのすべての共同作成者および関係者が、新規および既存のタグを追加できます。 プライベート プロジェクトでは、関係者は既存のタグのみを追加できます。 新しいタグを作成する権限を制御するには、プロジェクト レベルで [タグ定義の作成] アクセス許可を設定します。 詳細については、 プロジェクトレベルのアクセス許可の変更に関する記事を参照してください。
- GitHub のアクセス許可: GitHub リポジトリへの Contributor 。
作業項目の自動完了
次の図に示すように、[リンクされた作業項目をマージ後に完了する] ボックスを選択します。 システムでは、将来の PR の選択内容に既定値で設定されます。
この状況では、システムは作業項目状態を、作業項目種類 (WIT) の [終了]、[クローズ] または [完了] カテゴリーに自動更新しません。
- WIT が継承プロセス モデルで管理されている作業項目は、すでに、[解決済み] 状態です。 この場合、システムは状態を更新しません。 たとえば、アジャイル プロセスから派生したバグが、[解決済み] 状態の場合、システムは、状態を [クローズ] 状態に変更しません。
- 作業項目は既に [完了] 状態です。 これ以上遷移は必要ありません。
- WIT には、作業項目が次の状態に進むのを妨げるワークフロー フィールド ルールが含まれています。 たとえば、ルールでは、作業項目をクローズするときに別のフィールドを定義する必要がある場合があります。
- オンプレミスのデプロイと Azure Boards ホステッド プロセス モデルの場合は、ワークフローを遷移するときに実行するアクション (ACTION 要素) を指定するようにワークフローを変更する必要があります。 詳細については、「WIT のワークフローを変更する」、「アクションを指定する」を参照してください。
詳細については、「作業追跡エクスペリエンスをカスタマイズする」を参照してください。
リンクされた作業項目のワークフロー状態を指定する
作業項目を特定のワークフロー状態に移行するには、プル リクエストの説明に情報を入力します。 指定された作業項目に対して有効なワークフロー状態にプレフィックス #ID を付けます。
Note
この機能には、Azure DevOps Server 2020.1 更新プログラム以降のバージョンが必要です。
次の例は、状態を [解決済み] に変更し、別の状態を [レビュー] 状態に変更したユーザーのストーリーを示しています。 また、2 つのタスクは、[終了] としてマークされています。
関連付けられている作業項目の自動完了を無効にする
ユーザーがプル リクエストを完了したときに、関連付けられている作業項目の自動完了を無効にするには、次の手順を実行します。
- [プロジェクト設定]>[リポジトリ]> の順に選択し、リポジトリを選択します。
- [設定] タブで、[指定作業項目解決をコミットする] を [オフ] に切り替えます。
作業項目をクローズするコミット コメントのメンション (たとえば「#123 を修正など」) は許可されません。