Menampilkan, memfilter, dan membuka permintaan pull

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Anda membuat permintaan pull (PR) untuk meninjau dan menggabungkan perubahan kode di repositori Git di Azure Repos. Anggota tim dan pemangku kepentingan dapat meninjau perubahan dan memberikan umpan balik sebelum menggabungkan kode ke cabang target. Peninjau juga dapat mengomentari perubahan dan memilih untuk menyetujui atau menolak kode.

Teams dapat mengharuskan PR untuk setiap perubahan pada cabang yang dilindungi, dan menetapkan kebijakan cabang untuk mewajibkan PR tertentu untuk memenuhi kriteria tertentu.

Ada beberapa cara untuk mencantumkan, memfilter, menampilkan, dan membuka PR untuk proyek.

Prasyarat

• Repositori harus diaktifkan pada proyek Anda. Jika hub Repos dan halaman terkait tidak ditampilkan, lihat Mengaktifkan atau menonaktifkan layanan Azure DevOps untuk mengaktifkan kembali Repositori.

• Untuk melihat PR, Anda harus menjadi anggota proyek Azure DevOps tempat PR berada, dengan akses Dasar atau yang lebih tinggi. Jika Anda bukan anggota proyek, tambahkan.

  Catatan

  Untuk proyek publik, pengguna yang diberikan akses Pemangku Kepentingan memiliki akses penuh ke Azure Repos.

• Untuk mempelajari selengkapnya tentang izin dan akses, lihat Repositori Git default dan izin cabang dan Tentang tingkat akses.

• Di Azure DevOps Services, Anda dapat mengelola PR dan sumber daya lain dari antarmuka baris perintah (CLI) Azure dengan azure-devops ekstensi. Untuk mempelajari cara bekerja dengan Azure DevOps Services CLI, lihat Mulai menggunakan Azure DevOps CLI. Perintah Azure Repos CLI untuk PR menggunakan az repos pr.

Mencantumkan permintaan pull

Anda dapat mencantumkan PR dengan menggunakan situs web proyek Azure DevOps, Visual Studio, atau baris perintah Azure DevOps.

Browser

1. Untuk mencantumkan PR di repositori tertentu dalam proyek, buka proyek tersebut di portal web dan pilih Repos>permintaan Pull.

   

2. Verifikasi bahwa Anda memilih repositori yang benar.

   

3. Tampilan default memperlihatkan PR Anda di bawah tab Tambang . Pilih Aktif untuk menampilkan semua PR aktif untuk repositori saat ini. Pilih Selesai atau Diabaikan untuk memunculkan daftar PR tertutup.

   Pilih PR apa pun dalam daftar untuk masuk ke halaman Gambaran Umum PR tersebut.

   

4. Anda dapat mencantumkan semua PR Anda di berbagai proyek di organisasi Anda dengan memilih Permintaan pull di tampilan Pekerjaan Saya.

   

Visual Studio

Untuk mencantumkan permintaan pull dari Visual Studio, di menu Git, pilih <layanan>>Git Anda Lihat Permintaan Pull.

Visual Studio 2019 versi 16.8 dan versi yang lebih baru memberikan pengalaman kontrol versi Git sambil mempertahankan antarmuka pengguna Team Explorer Git. Untuk menggunakan Team Explorer, hapus centang Opsi Alat>Pratinjau>Fitur>pengalaman pengguna Git Baru dari bilah menu. Anda dapat menjalankan fitur Git dari salah satu antarmuka secara bergantian.

Untuk mengakses PR dari Visual Studio Team Explorer:

1. Koneksi ke proyek Anda dari Visual Studio.

2. Pilih Tampilkan>Team Explorer untuk membuka Team Explorer. Anda juga dapat menekan Ctrl+\, Ctrl+M.

3. Dari Beranda, pilih Tarik Permintaan untuk melihat daftar PR yang dibuka oleh Anda atau ditetapkan untuk Anda.

4. Untuk melihat daftar PR di portal web Azure DevOps, pilih Tindakan lalu pilih Buka di browser.

   

Azure DevOps CLI

Untuk mencantumkan PR aktif di proyek Anda dengan detailnya, gunakan 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]

Parameter

Parameter	Deskripsi
--creator	Batasi hasil untuk menarik permintaan yang dibuat oleh pengguna ini.
--detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
--include-links	Sertakan _links untuk setiap permintaan pull.
--org --organization	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
--project -p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default dengan menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
--query-examples	String JMESPath yang direkomendasikan. Anda dapat menyalin salah satu kueri dan menempelkannya setelah --query parameter dalam tanda kutip ganda untuk melihat hasilnya. Anda dapat menambahkan satu atau beberapa kata kunci posisional sehingga saran didasarkan pada kata kunci ini.
--repository -r	Nama atau ID repositori.
--reviewer	Batasi hasil untuk menarik permintaan di mana pengguna ini adalah peninjau.
--skip	Jumlah permintaan pull yang akan dilewati.
--source-branch -s	Batasi hasil untuk menarik permintaan yang berasal dari cabang sumber ini.
--status	Batasi hasil untuk menarik permintaan dengan status ini. Nilai yang diterima: abandoned, , allactive, completed.
--subscription	Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
--target-branch -t	Batasi hasil untuk menarik permintaan yang menargetkan cabang ini.
--top	Jumlah maksimum permintaan pull untuk dicantumkan.

Contoh

Perintah berikut mencantumkan semua PR di repositori, terlepas dari statusnya, dan memperlihatkan output dalam tabel. Contoh menggunakan konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Menentukan tampilan permintaan pull kustom

Memfilter daftar PR membantu Anda menemukan dan mengatur PR untuk memprioritaskan file terpenting dalam alur kerja Anda.

Browser

Untuk memfilter daftar PR, pada halaman Permintaan pull, pilih ikon Filter di kanan atas. Lalu pilih Cabang target atau header kolom lainnya, dan pilih cabang atau nilai lain yang ingin Anda filter.

Untuk mengkustomisasi tampilan daftar PR anda lebih lanjut, pilih Kustomisasi tampilan di kanan atas pada halaman Permintaan pull.

Pada halaman Kustomisasi tampilan , Anda bisa menyusun ulang bagian tampilan saat ini, mengeditnya, atau menghapusnya. Untuk membuat bagian baru, pilih Tambahkan bagian.

Pada halaman Kustomisasi bagian , masukkan dan pilih nilai untuk memfilter bagian menurut parameter seperti status draf atau tanggal yang diperbarui. Anda dapat memilih apakah akan Menampilkan permintaan pull yang telah saya setujui atau tolak pada tab terpisah, atau Mengecualikan permintaan pull (duplikat) yang disertakan di bagian sebelumnya. Saat Anda selesai menyesuaikan tampilan, pilih Simpan.

Tampilan yang dikustomisasi ini membuat bagian terpisah yang dapat diciutkan di halaman permintaan pull. Kueri kustom ini juga berfungsi di seluruh repositori pada tab Permintaan pull saya di beranda organisasi.

Untuk mengubah parameter tampilan yang dikustomisasi, pilih tombol Kustomisasi di samping tampilan. Atau pilih Kustomisasi tampilan, dan pada layar Kustomisasi tampilan , pilih tampilan yang ingin Anda ubah. Beberapa tampilan, seperti Ditetapkan kepada saya, tidak dapat disesuaikan, tetapi dapat diatur ulang atau dihapus.

Pada tab File PR, Anda dapat menggunakan beberapa filter untuk memilih file dan komentar untuk tinjauan yang lebih cepat. Pilih Filter, lalu pilih di antara opsi.

• Kata kunci: Masukkan kata kunci.
• Ditinjau/Tidak Ditinjau: Semua (default), Tertunda, Ditinjau.
• File yang dikomentari: Semua file (default), File dengan komentar.
• Komentar: Tampilkan (default), Apa yang baru, Sembunyikan.
• Status komentar: Aktif (default), Tertunda, Diselesaikan, Seperti yang dirancang, Tidak Akan memperbaiki, Ditutup.
• Dikomentari oleh: Semua komentar (default), atau orang tertentu.

Anda juga dapat mengetik string ke dalam bidang Pencarian untuk menampilkan hasil yang cocok dari opsi sebelumnya.

Visual Studio

Untuk memfilter permintaan pull dari Visual Studio:

1. Di menu Git, pilih <layanan>>Git Anda Lihat Permintaan Pull.

2. Filter menurut Penulis, Label, atau atribut lainnya.

Dari tampilan Permintaan Pull Team Explorer:

• Pilih Aktif, atau Ditetapkan kepada saya atau tim saya, untuk memfilter daftar PR menurut status atau penugasan PR.
• Atau, ketik tipe di sini untuk memfilter bidang daftar untuk memfilter daftar PR menurut tanggal, penulis, cabang, atau atribut lainnya.

Azure DevOps CLI

Anda dapat menggunakan beberapa parameter az repos pr list untuk memfilter daftar PR, seperti --creator, , --project, --repository, --reviewer--source-branch, --status, --target-branchdan --top.

Nilai --creator dan --reviewer dapat berupa nama tampilan atau alamat email. Parameter --top menentukan jumlah maksimum PR yang akan dicantumkan.

Misalnya, untuk mencantumkan detail tentang PR terakhir yang Anda buat, terlepas dari statusnya, gunakan:

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

Membuka permintaan pull

Saat Anda membuka PR dari browser, dari Visual Studio, atau dari Azure CLI, halaman Gambaran Umum PR terbuka di browser.

Browser

Untuk membuka PR di browser, pilih PR dari daftar di halaman Permintaan pull. PR terbuka ke tab Gambaran Umumnya . Tab Gambaran Umum memperlihatkan judul PR, deskripsi, peninjau, item kerja, riwayat, dan status yang ditautkan. Anda dapat melihat ringkasan kebijakan cabang yang lolos atau gagal, dan melihat peninjau komentar telah membuat.

Pada tab File PR, Anda dapat meninjau perubahan aktual dalam file PR. Pada tab Pembaruan dan Penerapan , Anda dapat melihat perubahan yang dibuat penulis untuk memperbarui cabang PR.

Visual Studio

Untuk membuka permintaan pull dari Visual Studio, di menu Git, pilih< layanan>>Git Anda Lihat Permintaan Pull, lalu pilih permintaan pull untuk membukanya.

Atau, dari tampilan Permintaan Pull Team Explorer, klik kanan PR dan pilih Buka di browser untuk membuka PR di portal web.

Cek keluar cabang

Di Visual Studio 2019, Anda dapat memeriksa cabang sumber PR langsung dari tampilan Permintaan Pull. Klik kanan PR, dan pilih Cabang Sumber Checkout.

Catatan

Visual Studio 2019 versi 16.8 dan versi yang lebih baru menyediakan menu Git baru untuk mengelola alur kerja Git dengan peralihan konteks yang lebih sedikit daripada Team Explorer. Prosedur yang disediakan dalam artikel ini di bawah tab Visual Studio menyediakan informasi untuk menggunakan pengalaman Git serta Team Explorer. Untuk mempelajari selengkapnya, lihat Perbandingan berdampingan git dan Team Explorer.

Azure DevOps CLI

Untuk menampilkan detail untuk satu PR, gunakan az repos pr show dengan parameter yang diperlukan --id . Untuk membuka PR di browser Anda, gunakan --open.

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

Parameter

Parameter	Deskripsi
--id	ID permintaan pull. Diperlukan.
--detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
--open	Buka permintaan pull di browser web Anda.
--org --organization	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
--query-examples	String JMESPath yang direkomendasikan. Anda dapat menyalin salah satu kueri dan menempelkannya setelah --query parameter dalam tanda kutip ganda untuk melihat hasilnya. Anda dapat menambahkan satu atau beberapa kata kunci posisional sehingga saran didasarkan pada kata kunci ini.
--subscription	Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.

Contoh

Contoh berikut menunjukkan detail untuk PR #21, memperlihatkan output perintah sebagai tabel, dan membuka PR di browser:

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

Cek keluar cabang

Gunakan az repos pr checkout dengan parameter yang diperlukan --id untuk memeriksa cabang PR secara lokal, selama tidak ada perubahan lokal.

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

Parameter

Parameter	Deskripsi
--id	ID permintaan pull.
--remote-name	Nama git remote di mana PR dinaikkan. Nilai default: origin.
--subscription	Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.

Contoh

Misalnya, untuk memeriksa cabang untuk PR #21 secara lokal, gunakan:

az repos pr checkout --id 21

Untuk meninjau perubahan, buat komentar atau saran, atau setujui atau pilih PR, lihat Meninjau permintaan pull.

Melihat dan memperbarui permintaan pull dari perangkat seluler

Anda dapat menggunakan perangkat seluler untuk melihat semua layar Azure Repos PR dan mengambil tindakan.

Langkah berikutnya

Meninjau permintaan pull

Artikel terkait

• Membuat permintaan pull
• Pemberitahuan pembaruan permintaan pull
• Menyelesaikan permintaan pull
• Mengubah cabang default
• Salin perubahan dengan cherry-pick
• Tentang permintaan pull dan izin