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

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

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

詳細については、「 pull requests の作成、表示、管理を参照してください。

作業項目の自動完了

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

次の状況では、作業項目の状態は、作業項目の種類 (WIT) の Done、 Closed、または Completed カテゴリに自動的に更新されません。

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

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

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

作業項目を特定のワークフロー状態に移行するには、プル要求の説明に情報を入力します。 #IDに、前述の作業項目の有効なワークフロー状態のプレフィックスを付けます。

次の例は、遷移したユーザー ストーリー (1 つは Resolved 状態、もう 1 つは Review 状態) を示しています。 また、2 つのタスクは Done としてマークされます。

関連記事

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