檢視、篩選和開啟提取要求

1. 若要列出專案中特定存放庫中的 PR，移至網頁入口中的該專案，然後選取 [Repos] [>拉取請求]。

   

2. 確認您已選取正確的存放庫。

   

3. 默認檢視會在 [Mine] 索引標籤底下顯示您的 PR。選取 [使用中]，以顯示目前存放庫的所有使用中 PR。 選取 [已完成 或 [已放棄的] 以顯示關閉的 PR 清單。

   選擇列表中的任何 PR，前往該 PR 的 概觀 頁面。

   

4. 您可以在 [我的工作] 檢視中選擇 [拉取請求]，以列出組織中不同專案的所有 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]

參數

例

下列命令會列出存放庫中的所有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 Server 不支援 Azure DevOps CLI 命令。

若要篩選 PR 清單，請在 [提取要求] 頁面上，選取右上方的 [篩選] 圖示。 然後選擇 目標分支 或其他欄標題，然後選取您要過濾的分支或其他值。

若要進一步自定義PR清單的檢視，請選取 [提取 要求] 頁面右上角的 [自定義檢視]。

在 [[自定義檢視] 頁面上，您可以重新排列目前的檢視區段、編輯或移除它們。 若要建立新的區段，請選擇 新增區段。

在 [[自定義] 區段 頁面上，輸入並選取值，依草稿狀態或更新日期等參數來篩選區段。 您可以選擇 顯示我在個別索引標籤上核准或拒絕的提取要求，或 排除上一節中包含的提取要求（重複專案），。 當您完成自訂檢視時，請選擇 儲存。

這些自定義檢視會在提取要求頁面上建立個別的可折迭區段。 這些自定義查詢也可以在組織首頁的 [我的拉取請求] () 頁面 標籤中跨存放庫運作。

若要變更自定義檢視的參數，請選取檢視旁的 [自定義] 按鈕。 或選取 [[自定義檢視]，然後在 [自定義檢視] 畫面上，選取您想要變更的檢視。 某些檢視，例如 指派給我，無法自定義，但可以重新排列或移除。

在 [PR 檔案] 標籤上，您可以使用數個過濾器來選取檔案和批註，以加快檢閱速度。 選擇 篩選，然後從選項中選擇。

• 關鍵詞：輸入關鍵詞。
• 已檢閱/未檢閱：所有（預設值），擱置，已檢閱。
• 有評論的檔案：所有檔案（預設值），具有批注的檔案。
• 批注：顯示（預設值），新功能，隱藏。
• 批注狀態：作用中（預設值），擱置，解決，按設計，不會修正，關閉。
• 批注者：所有批注（預設值），或特定人員。

您也可以在 [搜尋] 字段中輸入字串，以顯示上述選項的相符結果。

您可以使用數個 az repos pr list 參數來篩選 PR 清單，例如 --creator、--project、--repository、--reviewer、--source-branch、--status、--target-branch和 --top。

--creator 和 --reviewer 值可以是顯示名稱或電子郵件位址。 --top 參數會定義要列出的最大PR數目。

例如，若要列出您建立的最後一個 PR 詳細數據，不論其狀態為何，請使用：

az repos pr list --creator "My Name" --status all --top 1

Azure DevOps Server 不支援 Azure DevOps CLI 命令。

若要顯示單一 PR 的詳細數據，請使用 az repos pr show 搭配必要的 --id 參數。 若要在瀏覽器開啟 PR，請使用 --open。

az repos pr show --id
                 [--detect {false, true}]
                 [--open]
                 [--org]
                 [--query-examples]
                 [--subscription]

參數

例

下列範例顯示 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

簽出分支

只要沒有本機變更，請使用 az repos pr checkout 並搭配必需的 --id 參數以檢出摘取請求（PR）分支。

az repos pr checkout --id
                     [--remote-name]
                     [--subscription]

參數

例

例如，若要在本機簽出PR #21的分支，請使用：

az repos pr checkout --id 21

Azure DevOps Server 不支援 Azure DevOps CLI 命令。