プルリクエストを表示、フィルタリング、および開く
[アーティクル] 01/13/2025
12 人の共同作成者
フィードバック
この記事の内容
Azure DevOps Services の「」| Azure DevOps Server 2022 - Azure DevOps Server 2019「 」
Visual Studio 2019 |Visual Studio 2022
pull request (PR) を作成して、Azure Repos 上の Git リポジトリ のコード変更をレビュー してマージ します。 チーム メンバーと利害関係者は、コードをターゲット ブランチにマージする前に、変更を確認し、フィードバックを提供できます。 校閲者は、変更にコメントしたり、投票してコードを承認または拒否したりすることもできます。
チームは、保護されたブランチの変更に対して PR を要求したり、特定の PR が特定の条件を満たすことを要求するブランチ ポリシー を設定できます。
プロジェクトの PR を一覧表示、フィルター処理、表示、および開くには、いくつかの方法があります。
前提 条件
Repos は、プロジェクトで有効にする必要があります。 Repos ハブと関連ページが表示されない場合は、「Azure DevOps サービスを有効または無効にして、リポジトリを再び有効にする を参照してください。
PR を表示するには、PR が存在する Azure DevOps プロジェクトのメンバーであり、少なくとも Basic アクセス権を持つ必要があります。 プロジェクト メンバーでない場合は、追加してもらいます 。
手記
パブリック プロジェクトの場合、利害関係者 アクセス権を付与されたユーザーは、Azure Repos へのフル アクセス権を持ちます。
pull request を一覧表示する
AZURE DevOps プロジェクト Web サイト、Visual Studio、または Azure DevOps コマンド ラインを使用して、PR を一覧表示できます。
プロジェクト内の特定のリポジトリの PR を一覧表示するには、Web ポータルでそのプロジェクトに移動 し、[リポジトリ] >[pull request] を選択します。
正しいリポジトリを選択したことを確認します。
既定のビューには、[Mine ] タブの下に PR が表示されます。現在のリポジトリのすべてのアクティブな PR を表示するには、[アクティブ ] を選択します。 [完了済み] または [破棄済み] を選択して、閉じた PR の一覧を表示します。
一覧から任意の PR を選択して、その PR の [概要] ページに移動します。
マイ ワーク ビューで プルリクエスト を選択すると、組織内のさまざまなプロジェクトのすべての PR を一覧表示できます。
Visual Studio からプル要求を一覧表示するには、Git メニューで、Git サービス [Pull Requestsの表示] 選択します。
Visual Studio 2019 バージョン 16.8 以降のバージョンでは、Team Explorer Git ユーザー インターフェイスを維持しながら、Git バージョン管理エクスペリエンスが提供されます。 チーム エクスプローラー を使用するには、メニュー バーから [ツール][オプション] [プレビュー機能] [新しい Git ユーザー エクスペリエンス] オフにします。 どちらのインターフェイスからも Git 機能を同じ意味で実行できます。
Visual Studio チーム エクスプローラーから PR にアクセスするには:
Visual Studio からプロジェクトに接続します。
[表示] >[チーム エクスプローラー] を選択して、チーム エクスプローラーを開きます。 CtrlCtrlM 押すこともできます。
ホーム で、Pull Requests を選択して、自分が開いたり、自分に割り当てられた PR の一覧を表示します。
Azure DevOps Web ポータルで PR の一覧を表示するには、[アクション ] を選択し、[ブラウザーで開く] 選択します。
プロジェクト内のアクティブな PR とその詳細を一覧表示するには、az repos pr list使用します。
az repos pr list [--creator]
[--detect {false, true}]
[--include-links]
[--org]
[--project]
[--query-examples]
[--repository]
[--reviewer]
[--skip]
[--source-branch]
[--status {abandoned, active, all, completed}]
[--subscription]
[--target-branch]
[--top]
パラメーター
パラメーター
説明
--creator
このユーザーによって作成された pull request に結果を制限します。
--detect
組織を自動的に検出します。 指定できる値: false
、true
。
--include-links
pull request ごとに _links を含めます。
--org
--organization
Azure DevOps 組織の URL。 az devops configure -d organization=<ORG_URL>
を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git config を使用して取得した場合は必須 です (例: https://dev.azure.com/MyOrganizationName/
)。
--project
-p
プロジェクトの名前または ID。 az devops configure -d project=<NAME_OR_ID>
を使用して、既定のプロジェクトを構成できます。 既定として構成されていない場合、または git config を使用して選択されていない場合は必須 です。
--query-examples
推奨される JMESPath 文字列。 いずれかのクエリをコピーし、--query
パラメーターの後に二重引用符で囲んで貼り付けて、結果を表示できます。 1 つ以上の位置指定キーワードを追加して、これらのキーワードに基づいて候補を作成できます。
--repository
-r
リポジトリの名前または ID。
--reviewer
このユーザーがレビュー担当者である pull request に結果を制限します。
--skip
スキップする pull request の数。
--source-branch
-s
このソース ブランチから送信されたプル要求に結果を制限します。
--status
この状態の pull request に結果を制限します。 使用できる値: abandoned
、active
、all
、completed
。
--subscription
Azure サブスクリプションの名前または ID。 既定のサブスクリプションは、az account set -s <NAME_OR_ID>
を使用して構成できます。
--target-branch
-t
このブランチを対象とするプル要求に結果を制限します。
--top
一覧表示するプル要求の最大数。
例
次のコマンドは、状態に関係なくリポジトリ内のすべての PR を一覧表示し、出力をテーブルに表示します。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"
を使用します。
az repos pr list --status all --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------------------------- --------- --------- ------------
11 2021-10-04 jamalh@fabrikam.com Revert 'Updated parameterized-functions.md' Completed False Fabrikam
10 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Completed False Fabrikam
9 2021-10-04 ke@fabrikam.com New pull request Completed False Fabrikam
8 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Abandoned False Fabrikam
7 2021-09-30 jamalh@fabrikam.com Added note-new-git-tool.md to / Completed False Fabrikam
6 2021-09-29 jamalh@fabrikam.com Revert 'Added parameterized-functions.md to /' Abandoned False Fabrikam
5 2021-09-29 jamalh@fabrikam.com Updated README.md Completed False Fabrikam
4 2021-09-29 jamalh@fabrikam.com Added parameterized-functions.md to / Completed False Fabrikam
3 2021-09-28 jamalh@fabrikam.com WIP New file Abandoned False Fabrikam
2 2021-09-28 jamalh@fabrikam.com Update README.md Abandoned False Fabrikam
1 2021-09-28 jamalh@fabrikam.com Edit README.md Completed False Fabrikam
Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。
カスタム pull request ビューを定義する
PR リストをフィルター処理すると、PR を検索して整理し、ワークフロー内の最も重要なファイルに優先順位を付けるのに役立ちます。
PR リストをフィルターするには、[Pull requests ] ページで、右上にある [フィルター ] アイコンを選択します。 次に、対象ブランチ または他の列ヘッダーを選択し、フィルターしたいブランチや他の値を選択します。
PR リストのビューをさらにカスタマイズするには、Pull requests ページの右上にある [ビュー のカスタマイズ] 選択します。
カスタマイズビュー ページでは、現在のビューセクションを再配置したり、編集や削除を行ったりすることができます。 新しいセクションを作成するには、[セクションの追加] 選択します。
[カスタマイズ] セクション ページで、値を入力して選択し、下書きの状態や更新日などのパラメーターでセクションをフィルター処理します。 別のタブで [承認または拒否した pull requests を表示する] を するか、前のセクションに含まれている pull requests (重複) を除外 するかを選択できます。 ビューのカスタマイズが完了したら、[保存]を選択します 。
これらのカスタマイズされたビューは、pull request ページに個別の折りたたみ可能なセクションを作成します。 これらのカスタム クエリは、組織のホーム ページの [my pull requests] タブ リポジトリ間でも機能します。
カスタマイズしたビューのパラメーターを変更するには、ビューの横にある [ のカスタマイズ] ボタン 選択します。 または、[ビューをカスタマイズ ] を選択し、[ビューをカスタマイズ ] 画面で、変更したいビューを選択します。 に割り当てられた など、一部のビューはカスタマイズできませんが、再配置または削除できます。
[PR Files ] タブでは、複数のフィルターを使用してファイルとコメントを選択し、より迅速なレビューを行うことができます。 フィルター を選択して、オプションの中から選びます。
キーワード: キーワードを入力します。
レビュー済み/未レビュー: すべて (既定)、保留中 、レビュー済み 。
コメント付きファイル: すべてのファイル (既定), コメントがあるファイル .
コメント: の表示 (既定), 新機能 , の非表示。
コメントの状態: アクティブ (既定), 保留中 , 解決済み , 設計通り , 修正しない , 閉鎖済み .
コメントの作成者: [すべてのコメント] (既定値)、または特定のユーザー。
[検索] フィールドに文字列を入力して、上記のオプションの一致する結果を表示することもできます。
Visual Studio からプル要求をフィルター処理するには:
[Git] メニューで、<Git サービス> >[pull request の表示] を選択します。
Author 、Label 、またはその他の属性でフィルター処理します。
チーム エクスプローラー pull requests ビューから次の手順を実行します。
[アクティブな] または [自分またはチームに割り当てられた ] を選択して、PR の状態または割り当てで PR リストをフィルター処理します。
または、ここで タイプを入力してリスト フィールドをフィルター処理し、日付、作成者、分岐、またはその他の属性で PR リストをフィルター処理します。
いくつかの az repos pr list パラメーターを使用して、--creator
、--project
、--repository
、--reviewer
、--source-branch
、--status
、--target-branch
、--top
などの PR の一覧をフィルター処理できます。
--creator
と --reviewer
の値には、表示名または電子メール アドレスを指定できます。 --top
パラメーターは、一覧表示する PR の最大数を定義します。
たとえば、状態に関係なく、最後に作成した PR に関する詳細を一覧表示するには、次のコマンドを使用します。
az repos pr list --creator "My Name" --status all --top 1
Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。
pull request を開く
ブラウザー、Visual Studio、または Azure CLI から PR を開くと、PR の [概要] ページがブラウザーで開きます。
ブラウザーで PR を開くには、Pull requests ページの一覧から PR を選択します。 PR が開き、概要 タブが開きます。概要 タブには、PR タイトル、説明、レビュアー、リンクされた作業項目、履歴、状態が表示されます。 合格または不合格のブランチ ポリシーの概要を確認したり、レビュー担当者が作成したコメントを確認したりできます。
PR ファイル タブでは、PR ファイルの実際の変更を確認できます。 [更新] タブと [コミット] タブでは、作成者が PR ブランチを更新するために行った変更を確認できます。
Visual Studio からプル要求を開くには、Git メニューで、Git サービス <> >Pull Requests の表示を選択し、pull request を選択して開きます。
または、チーム エクスプローラー Pull Requests ビューで PR を右クリックし、ブラウザー で開くを選択して、Web ポータルで PR を開きます。
ブランチをチェックアウトする
Visual Studio 2019 では、PR のソース ブランチを Pull Requests ビューから直接チェックアウトできます。 PR を右クリックし、[ソース ブランチのチェックアウト] を選択します。
手記
Visual Studio 2019 バージョン 16.8 以降のバージョンでは、チーム エクスプローラーよりも少ないコンテキスト切り替えで Git ワークフローを管理するための新しい Git メニューが提供されます。 この記事の Visual Studio タブにある手順では、Git エクスペリエンスとチーム エクスプローラーの使用に関する情報を提供します。 詳細については、「Git と Team Explorer の side-by-side 比較」を参照してください。
単一の PR の詳細を表示するには、必須の --id
パラメーターを指定して az repos pr show を使用します。 ブラウザーで PR を開くには、--open
を使用します。
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
パラメーター
パラメーター
説明
--id
pull request の ID。 必須 。
--detect
組織を自動的に検出します。 指定できる値: false
、true
。
--open
Web ブラウザーで pull request を開きます。
--org
--organization
Azure DevOps 組織の URL。 az devops configure -d organization=<ORG_URL>
を使用して、既定の組織を構成できます。 デフォルトとして設定されていないか、git の設定で取得されない場合は が必要です。例: https://dev.azure.com/MyOrganizationName/
.
--query-examples
推奨される JMESPath 文字列。 いずれかのクエリをコピーし、--query
パラメーターの後に二重引用符で囲んで貼り付けて、結果を表示できます。 1 つ以上の位置指定キーワードを追加して、これらのキーワードに基づいて候補を作成できます。
--subscription
Azure サブスクリプションの名前または ID。 既定のサブスクリプションは、az account set -s <NAME_OR_ID>
を使用して構成できます。
例
次の例は、PR #21 の詳細を示し、コマンド出力をテーブルとして示し、ブラウザーで PR を開きます。
az repos pr show --id 21 --open --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------- -------- --------- ------------
21 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam
ブランチをチェックアウトする
PR ブランチをローカルにチェックアウトするには、ローカルに変更がない限り、必須の --id
パラメーターを指定して az repos pr checkout を使用します。
az repos pr checkout --id
[--remote-name]
[--subscription]
パラメーター
パラメーター
説明
--id
pull request の ID。
--remote-name
PR が生成される Git リモートの名前。 既定値: origin
.
--subscription
Azure サブスクリプションの名前または ID。 既定のサブスクリプションは、az account set -s <NAME_OR_ID>
を使用して構成できます。
例
たとえば、PR #21 のブランチをローカルでチェックアウトするには、次を使用します。
az repos pr checkout --id 21
Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。
変更を確認したり、コメントや提案を行ったり、PRに対する承認または投票を行ったりするには、「プルリクエストのレビュー」を参照してください 。
モバイル デバイスからのプル要求の表示と更新
モバイル デバイスを使用して、すべての Azure Repos PR 画面を表示し、アクションを実行できます。
次の手順
関連記事