Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Saat menautkan item kerja ke permintaan pull (PR), Anda dapat secara otomatis menyelesaikan item kerja tersebut saat menyelesaikan PR. Atau, Anda dapat menentukan status alur kerja untuk transisi item kerja ke saat menggabungkan PR.
Otomatisasi ini menyederhanakan alur kerja pengembangan Anda dengan memastikan bahwa item kerja mencerminkan status perubahan kode Anda saat ini tanpa intervensi manual.
Petunjuk / Saran
Anda dapat menggunakan AI untuk membantu tugas ini nanti dalam artikel ini, atau lihat Mengaktifkan bantuan AI dengan Azure DevOps MCP Server untuk memulai.
Untuk informasi selengkapnya, lihat Membuat, menampilkan, dan mengelola permintaan tarik.
Prasyarat
| Kategori | Persyaratan |
|---|---|
| Permissions | - Untuk menampilkan, mengikuti, dan mengedit item kerja: Menampilkan item kerja dalam simpul ini dan Mengedit item kerja dalam simpul ini izin diatur ke Izinkan. Secara default, grup Kontributor memiliki izin ini. Untuk informasi selengkapnya, lihat Mengatur izin pelacakan kerja. - Untuk menambahkan tag ke item kerja: Buat definisi tag baru izin disetel ke Izinkan. Secara default, grup Kontributor memiliki izin ini. |
| Tingkat akses |
-
anggota proyek. - Untuk menambahkan tag baru ke item kerja atau untuk melihat atau mengikuti pull request: Setidaknya akses dasar. - Untuk melihat atau mengikuti item kerja: Setidaknya akses Pemangku Kepentingan. Untuk informasi selengkapnya, lihat Tentang tingkat akses. - Semua anggota proyek, termasuk yang ada di grup Pembaca, dapat mengirim email yang berisi item kerja. |
Pengisian otomatis tugas kerja
Untuk mengaktifkan penyelesaian otomatis item kerja tertaut saat Anda menggabungkan permintaan pull, pilih kotak centang Selesaikan item kerja tertaut setelah penggabungan, seperti yang ditunjukkan pada gambar berikut. Sistem menyimpan pilihan Anda sebagai default untuk PR di masa mendatang.
Ketika penyelesaian otomatis tidak terjadi
Sistem tidak secara otomatis memperbarui status item kerja ke kategori Selesai, Ditutup, atau Selesai untuk jenis item kerja (WIT) dalam keadaan berikut:
- Item kerja sudah dalam status Diselesaikan: Item kerja, yang WIT-nya menggunakan model proses Pewarisan, sudah dalam status Diselesaikan . Dalam hal ini, sistem tidak memperbarui status. Misalnya, jika bug yang berasal dari proses Agile dalam keadaan Teratasi , sistem tidak mengubahnya ke Ditutup.
- Item kerja sudah selesai: Item kerja sudah berada dalam kategori Status selesai . Tidak diperlukan transisi lebih lanjut.
- Aturan alur kerja mencegah transisi: WIT menyertakan aturan bidang alur kerja yang mencegah item kerja maju ke status berikutnya. Misalnya, aturan mungkin mengharuskan Anda menentukan bidang lain saat menutup item kerja.
- Konfigurasi alur kerja on-premises: Untuk penyebaran lokal dan model proses Azure Boards terhosting, Anda harus memodifikasi alur kerja untuk menentukan tindakan elemen ACTION untuk terjadi saat transisi alur kerja. Untuk informasi selengkapnya, lihat Mengubah alur kerja untuk WIT, Tentukan Tindakan.
Untuk informasi selengkapnya tentang menyesuaikan alur kerja, lihat Menyesuaikan pengalaman pelacakan kerja Anda.
Tentukan keadaan alur kerja item kerja yang ditautkan.
Anda dapat mentransisikan item kerja ke status alur kerja tertentu dengan memasukkan informasi dalam deskripsi permintaan pull. Awali #ID dengan status alur kerja yang valid untuk item kerja yang disebutkan. Pendekatan ini memberi Anda kontrol yang tepat atas bagaimana transisi item kerja saat Anda menggabungkan perubahan kode.
Contoh berikut menunjukkan cerita pengguna yang beralih—satu ke status Diselesaikan dan yang lain ke status Tinjau . Sistem juga menandai dua tugas sebagai Selesai.
Sintaks untuk transisi status
Gunakan pola sintaks berikut dalam deskripsi permintaan pull Anda untuk menentukan transisi status:
-
Resolves #123- Transisi item kerja 123 ke status Diselesaikan -
Fixes #456- Memindahkan item pekerjaan 456 ke status selesai yang sesuai -
Closes #789- Mengubah status item kerja 789 menjadi Tertutup -
Review #101- Mengubah item kerja 101 ke status Tinjauan
Sistem mengenali kata kunci umum dan menerapkan transisi status yang sesuai berdasarkan konfigurasi alur kerja jenis item kerja Anda.
Menonaktifkan penyelesaian otomatis item kerja terkait
Untuk menonaktifkan penyelesaian otomatis item kerja terkait saat pengguna menyelesaikan permintaan pull, ikuti langkah-langkah berikut:
- Arahkan ke Pengaturan Proyek>Repositori> pilih repositori Anda.
- Di tab Pengaturan , nonaktifkan tombol untuk Penerapan sebutkan resolusi item kerja.
Saat Anda menonaktifkan pengaturan ini, sistem tidak mengizinkan menyebut dalam komentar commit untuk menandai item kerja sebagai selesai (misalnya, "Fixes #123"). Pengaturan ini memengaruhi penyelesaian permintaan tarik dan penyebutan komit langsung.
Praktik terbaik
Pertimbangkan praktik terbaik ini saat menggunakan penyelesaian item kerja otomatis:
- Tinjau status item kerja: Sebelum mengaktifkan penyelesaian otomatis, pastikan status item kerja Anda selaras dengan harapan alur kerja tim Anda.
- Gunakan transisi status tertentu: Saat Anda memerlukan kontrol yang tepat, gunakan sintaks transisi status dalam deskripsi permintaan penarikan daripada mengandalkan perilaku penyelesaian default.
- Aturan alur kerja pengujian: Verifikasi bahwa aturan alur kerja kustom apa pun tidak mencegah transisi status otomatis.
- Berkomunikasi dengan tim Anda: Pastikan semua anggota tim memahami bagaimana penyelesaian otomatis memengaruhi pelacakan item kerja.
Troubleshooting
Jika item kerja tidak selesai secara otomatis seperti yang diharapkan:
- Periksa izin: Pastikan Anda memiliki izin yang diperlukan untuk mengedit item kerja.
- Tinjau aturan alur kerja: Pastikan tidak ada aturan bidang alur kerja yang mencegah transisi status.
- Memvalidasi tautan item kerja: Pastikan item kerja ditautkan dengan benar ke permintaan penarikan.
- Periksa status saat ini: Pastikan item kerja belum dalam status selesai.
- Meninjau pengaturan repositori: Pastikan penyelesaian otomatis diaktifkan dalam pengaturan repositori.
Gunakan AI untuk mengelola item kerja yang ditautkan ke pull request
Jika Anda mengonfigurasi Azure DevOps MCP Server, Anda dapat menjalankan kueri dan mengelola item kerja yang ditautkan ke pull request menggunakan bahasa alami.
| Tugas | Contoh perintah |
|---|---|
| Menemukan item tertaut | Show all work items linked to open pull requests in project <Contoso> |
| Periksa status penyelesaian | List work items linked to merged PRs that are still in the Active state in <Contoso> |
| Menautkan item kerja ke PR | Link work item #3456 to pull request #789 in project <Contoso> |
| Mengaudit item yang terkait dengan PR | Show all pull requests merged this sprint with their linked work items for <Contoso> |
| Menemukan item yang tidak memiliki tautan PR | List all completed user stories in Sprint 12 that have no linked pull request in project <Contoso> |
| Mendeteksi tautan PR kedaluarsa | Find work items linked to pull requests that were abandoned or closed without merging in <Contoso> |
| Memverifikasi pengerjaan otomatis yang diselesaikan secara otomatis | Which work items linked to PRs merged today are still not in the Done or Closed state in project <Contoso>? |
| Melacak aktivitas PR oleh penerima tugas | For each team member on <Contoso Team>, list their work items that have linked PRs currently in review |
| Menemukan item dengan beberapa PR | Show work items in project <Contoso> that are linked to more than one pull request |
| Laporan cakupan PR Sprint | What percentage of completed work items in Sprint 12 have at least one linked pull request in <Contoso>? |
Nota
Jika Anda menggunakan Visual Studio Code, mode agent sangat membantu untuk mengelola hubungan item kerja dan pull request.