pull request で作業項目を自動的に完了する

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

作業項目を pull request (PR) にリンクすると、PR が完了したときに、それらの作業項目を自動的に完了することができます。 または、PR のマージ時に作業項目を切り替えるワークフロー状態を指定することもできます。

作業項目を pull request (PR) にリンクすると、PR が完了したときに、それらの作業項目を自動的に完了することができます。

詳細については、「プル リクエストの作成、表示および管理」を参照してください。

作業項目の自動完了

次の図に示すように、[リンクされた作業項目をマージ後に完了する] ボックスを選択します。 システムでは、将来の PR の選択内容に既定値で設定されます。

[Pull request の完了] ダイアログ、[リンクされた作業項目をマージ後に完了する]

[Pull request の完了] ダイアログ、PR の完了オプションで作業項目を自動的に完了する

この状況では、システムは作業項目状態を、作業項目種類 (WIT) の [終了][クローズ] または [完了] カテゴリーに自動更新しません。

  • WIT が継承プロセス モデルで管理されている作業項目は、すでに、[解決済み] 状態です。 この場合、システムは状態を更新しません。 たとえば、アジャイル プロセスから派生したバグが、[解決済み] 状態の場合、システムは、状態を [クローズ] 状態に変更しません。
  • 作業項目は既に [完了] 状態です。 これ以上遷移は必要ありません。
  • WIT には、作業項目が次の状態に進むのを妨げるワークフロー フィールド ルールが含まれています。 たとえば、ルールでは、作業項目をクローズするときに別のフィールドを定義する必要がある場合があります。
  • オンプレミスのデプロイと Azure Boards ホステッド プロセス モデルの場合は、ワークフローを遷移するときに実行するアクション (ACTION 要素) を指定するようにワークフローを変更する必要があります。 詳細については、「WIT のワークフローを変更する」、「アクションを指定する」を参照してください。

詳細については、「作業追跡エクスペリエンスをカスタマイズする」を参照してください。

リンクされた作業項目のワークフロー状態を指定する

作業項目を特定のワークフロー状態に移行するには、プル リクエストの説明に情報を入力します。 指定された作業項目に対して有効なワークフロー状態にプレフィックス #ID を付けます。

Note

この機能には、Azure DevOps Server 2020.1 更新プログラム以降のバージョンが必要です。

次の例は、状態を [解決済み] に変更し、別の状態を [レビュー] 状態に変更したユーザーのストーリーを示しています。 また、2 つのタスクは、[終了] としてマークされています。

pull request のスクリーンショット、ワークフローの状態を設定して #ID 作業項目を移行します。

関連付けられている作業項目の自動完了を無効にする

ユーザーがプル リクエストを完了したときに、関連付けられている作業項目の自動完了を無効にするには、次の手順を実行します。

  1. [プロジェクト設定]>[リポジトリ]> の順に選択し、リポジトリを選択します。
  2. [設定] タブで、[指定作業項目解決をコミットする][オフ] に切り替えます。

作業項目をクローズするコミット コメントのメンション (たとえば「#123 を修正など」) は許可されません。