pull request を表示、フィルター処理、開く

  • [アーティクル]

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 サービスのオンとオフの切り替えに関するページを参照して Repos を再度有効にしてください。

  • PR を表示するには、PR が含まれている Azure DevOps プロジェクトのメンバーであり、Basic 以上のアクセス権を持っている必要があります。 プロジェクト メンバーでない場合は、追加してもらいます。

    注意

    パブリック プロジェクトの場合、利害関係者アクセス権を付与されたユーザーは、Azure Repos へのフル アクセス権があります。

  • プロジェクトで Repos を有効にする必要があります。 Repos ハブと関連ページが表示されない場合は、Azure DevOps サービスのオンとオフの切り替えに関するページを参照して Repos を再度有効にしてください。
  • PR を表示するには、Basic 以上のアクセス権を持つ Azure DevOps プロジェクト メンバーである必要があります。 プロジェクト メンバーでない場合は、追加してもらいます。

pull request の一覧表示

PR を一覧表示するには、Azure DevOps プロジェクト Web サイト、Visual Studio、または Azure DevOps コマンド ラインを使用します。

  1. プロジェクト内の特定のリポジトリの PR を一覧表示するには、Web ポータルでそのプロジェクトに移動し、[リポジトリ]>[pull request] を選択します。

    pull request を表示しているスクリーンショット。

  2. 正しいリポジトリを選択したことを確認します。

    リポジトリを選択しているスクリーンショット。

  3. 既定のビューには、[自分のもの] タブの下に PR が表示されます。[有効] を選択して、現在のリポジトリのすべてのアクティブな PR を表示します。 [完了済み] または [破棄済み] を選択して、閉じた PR の一覧を表示します。

    一覧から任意の PR を選択して、その PR の [概要] ページに移動します。

    Azure Repos の PR の表示タブのスクリーンショット。

  4. [担当作業] ビューで [pull request] を選択することで、組織のさまざまなプロジェクトのすべての PR を一覧表示できます。

    すべての pull request を表示しているスクリーンショット。

カスタム pull request ビューを定義する

PR リストをフィルター処理すると、PR を見つけて整理し、ワークフロー内で最も重要なファイルに優先順位を付けるのに役立ちます。

PR リストをフィルター処理するには、[pull request] ページの右上にある [フィルター] アイコンを選択します。 次に、[ターゲット ブランチ] またはその他の列ヘッダーを選択し、フィルター処理するブランチまたはその他の値を選択します。

PR リストの表示をさらにカスタマイズするには、[pull request] ページの右上にある [表示のカスタマイズ] を選択します。

[pull request] ページの [表示のカスタマイズ] ボタンを示すスクリーンショット。

[表示のカスタマイズ] ページでは、現在のビュー セクションの再配置、編集、削除を行うことができます。 新しいセクションを作成するには、[セクションの追加] を選択します。

[セクションの追加] ボタンが表示された [表示のカスタマイズ] ページを示すスクリーンショット。

[セクションのカスタマイズ] ページで、下書き状態や更新日などのパラメーターでセクションをフィルター処理するために、値を入力および選択します。 [別のタブで自分が承認または拒否した pull request を表示する] または [前のセクションに含まれている pull request (重複) を除外する] を選択できます。 ビューのカスタマイズが完了したら、[保存] を選択します。

[セクションのカスタマイズ] ページを示すスクリーンショット。

これらのカスタマイズされたビューによって、[pull request] ページに個別の折りたたみ可能なセクションが作成されます。 これらのカスタム クエリは、組織のホームページの [自分の pull requests] タブにあるリポジトリ間でも機能します。 折りたたみ可能なセクションを示す [pull request] ページのスクリーンショット。

カスタマイズしたビューのパラメーターを変更するには、ビューの横にある [カスタマイズ] ボタンを選択します。 または、[表示のカスタマイズ] を選択し、[表示のカスタマイズ] 画面で、変更するビューを選択します。 [自分に割り当て済み] などの一部のビューはカスタマイズできませんが、再配置または削除できます。

PR の [ファイル] タブでは、複数のフィルターを使用してファイルとコメントを選択し、より迅速なレビューを行うことができます。 [フィルター] を選択し、オプションの中から選択します。

フィルター オプションが表示された [ファイル] タブのスクリーンショット。

  • キーワード: キーワードを入力します。
  • レビュー済み/未レビュー: [すべて] (既定値)、[保留中]、[レビュー済み]。
  • コメント付きのファイル: [すべてのファイル] (既定値)、[コメントの付いたファイル]。
  • コメント: [表示] (既定値)、[最新情報]、[非表示]。
  • コメントの状態: [有効] (既定値)、[保留中]、[解決済み]、[仕様]、[修正しない]、[終了]。
  • コメントの作成者: [すべてのコメント] (既定値)、または特定のユーザー。

[検索] フィールドに文字列を入力して、上記のオプションから一致する結果を表示することもできます。

Pull request を開く

ブラウザー、Visual Studio、または Azure CLI から PR を開くと、ブラウザーで PR の [概要] ページが開きます。

ブラウザーで PR を開くには、[pull request] ページのリストから PR を選択します。 PR の [概要] タブが開きます。[概要] タブには、PR のタイトル、説明、レビュー担当者、リンクされた作業済み項目、履歴、および状態が表示されます。 合格または不合格のブランチ ポリシーの概要を確認したり、レビュー担当者が作成したコメントを確認したりできます。

PR の [概要] タブを示すスクリーンショット。

PR の [ファイル] タブでは、PR ファイルの実際の変更を確認できます。 [更新] タブと [コミット] タブでは、作成者が PR ブランチを更新するために行った変更を確認できます。

変更を確認したり、コメントや提案を行ったり、PR に対して承認または投票したりするには、「pull request のレビュー」を参照してください。

モバイル デバイスから pull request を表示および更新する

モバイル デバイスを使用して、すべてのAzure Repos の PR 画面を表示し、アクションを実行できます。

モバイル デバイス上の Azure Repos の PR 画面のスクリーンショット。

次のステップ

pull request をレビューする。