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

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

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

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

作業項目の自動完了

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

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

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

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

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

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

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

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

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

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

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

関連記事

• pull request の作成、表示、管理
• ワークフローをカスタマイズする (継承プロセス)
• 作業追跡エクスペリエンスをカスタマイズする
• バックログとボードでワークフローの状態と状態カテゴリを使用する方法