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

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

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

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

前提条件

• Project access: project メンバーになります。

• アクセス許可:

  • 作業項目を表示、フォロー、編集するには、このノードの作業項目を表示しこのノードの作業項目を編集権限を Allow に設定します。 デフォルトでは、 Contributors グループにこれらの権限が与えられます。 詳細については、「作業追跡権限を設定する」を参照してください。

• 作業項目にタグを追加するには、プロジェクト レベルの 新しいタグ定義の作成 権限を Allow に設定します。 デフォルトでは、 Contributors グループにこの権限が与えられます。

• アクセス レベル:

  • 作業項目に新しいタグを追加したり、pull request を表示またはフォローしたりするには、少なくとも Basic アクセス権を持ちます。
  • 作業項目を表示またはフォローするには、少なくとも Stakeholder アクセス権を持つ必要があります。 詳細については、「アクセス レベルについて」を参照してください。
  • Readers グループのメンバーを含むすべてのプロジェクト メンバーは、作業項目を含む電子メールを送信できます。

  Note

  • ディスカッションに貢献し、進捗状況を確認するメンバーにStakeholder アクセス権を付与します。 これらは通常、コードには貢献しないが、作業項目、バックログ、ボード、ダッシュボードを表示したいメンバーです。
  • 利害関係者 アクセス レベルにより、アクセス許可が明示的に設定されている場合でも、新しいタグを追加することはできません。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。

• GitHub のアクセス許可: GitHub リポジトリへの Contributor 。

作業項目の自動完了

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

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

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

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

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

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

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

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

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

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

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

関連記事

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