Kueri menurut area atau jalur perulangan
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Jalur Area dan Jalur Perulangan adalah dua bidang yang muncul pada formulir pelacakan kerja untuk semua jenis item kerja. Anda menentukannya untuk proyek—jalur area dan jalur iterasi—lalu pilih jalur yang ingin Anda kaitkan dengan tim.
Untuk lebih memahami cara bekerja dengan jalur area dan iterasi, lihat Tentang tim dan alat Agile.
Catatan
Makro berikut ini hanya didukung dari portal web: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity, dan @TeamAreas. Kueri yang berisi makro ini tidak akan berfungsi saat dibuka di Visual Studio/Team Explorer, Microsoft Excel, atau Microsoft Project.
Operator dan makro yang didukung
Saat membuat kueri dan menentukan bidang Jalur Area dan Jalur Perulangan, Anda bisa menggunakan operator berikut:
| Operator | Gunakan saat Anda ingin... |
|---|---|
= |
Tentukan satu area atau jalur iterasi tertentu |
<> |
Memfilter satu, area tertentu, atau jalur perulangan. |
In |
Filter untuk sekumpulan jalur area atau perulangan. |
Not In |
Kecualikan item yang ditetapkan ke sekumpulan area atau jalur iterasi. |
Under |
Tentukan semua jalur di bawah area atau jalur perulangan tertentu. |
Not Under |
Kecualikan item yang ditetapkan di bawah area atau jalur perulangan tertentu. |
Bersama dengan operator ini, Anda dapat menggunakan makro berikut saat memilih Jalur Perulangan. Misalnya, lihat Kueri menurut tanggal atau iterasi saat ini.
| Makro | Gunakan saat Anda ingin... |
|---|---|
@CurrentIteration |
Tentukan iterasi saat ini yang terkait dengan konteks tim yang dipilih. |
@CurrentIteration +/- n |
Filter item berdasarkan penugasan ke jendela geser sprint yang terkait dengan konteks tim yang dipilih. |
@TeamAreas |
Filter item berdasarkan jalur area yang ditetapkan ke tim tertentu. |
Catatan
@CurrentIteration +/- n Makro dan @TeamAreas didukung untuk Azure DevOps Server 2019 dan versi yang lebih baru. Makro ini hanya didukung dari portal web. Kueri yang berisi makro ini tidak akan berfungsi saat dibuka di Visual Studio/Team Explorer, Microsoft Excel, atau Microsoft Project.
Kueri jalur area
Anda dapat menentukan untuk memfilter item kerja yang ditetapkan ke beberapa jalur area dengan menggunakan operator Di seperti yang ditunjukkan dalam contoh berikut.
Nama Simpul dan kueri berbasis kata kunci
Gunakan bidang Nama Simpul untuk memfilter item kerja yang ditetapkan ke jalur area berdasarkan kata kunci menggunakan operator Berisi. Nama Simpul menentukan simpul terakhir Dari Jalur Area, yang sesuai dengan simpul terakhir dalam hierarki pohon.
Kueri berikut menghasilkan hasil yang sama dengan contoh sebelumnya.
Dalam contoh ini, filter mengembalikan item kerja apa pun yang ditetapkan ke jalur area yang simpul terakhirnya berisi kata "Azure".
Berikut adalah contoh lain yang menggunakan Nama Node dan operator Di .
Kueri jalur area tim
Gunakan makro @TeamAreas untuk menemukan item yang ditetapkan dengan cepat ke jalur area yang ditetapkan ke tim tertentu. Tentukan = operator. Editor Kueri secara otomatis meminta Anda untuk memasukkan nama tim. Anda dapat menambahkannya dengan memasukkan nama tim dan memilih nilai tim yang muncul di kriteria filter pencarian.
Referensi bidang klasifikasi
| Nama bidang | Keterangan | Nama referensi |
|---|---|---|
| Jalur Area | Mengelompokkan item kerja ke dalam fitur produk atau area tim. Area harus merupakan simpul yang valid dalam hierarki proyek. | System.AreaPath |
| Jalur Perulangan | Mengelompokkan item kerja menurut sprint atau periode waktu bernama. Iterasi harus merupakan simpul yang valid dalam hierarki proyek. | System.IterationPath |
Untuk setiap bidang, jalur data=TreePath, tipe yang dapat dilaporkan=Dimension, atribut indeks=True.
Jika Anda menentukan nama jalur yang lebih panjang dari 256 karakter, Anda tidak dapat menentukannya di Microsoft Project. Untuk menghindari masalah ini, tentukan nama jalur tidak lebih dari 10 karakter, dan jangan menumpuk simpul lebih dari 14 tingkat kedalaman.
Anda tidak dapat menerapkan sebagian besar aturan bidang ke bidang sistem, seperti bidang System.AreaPath dan System.IterationPath. Untuk informasi selengkapnya, lihat Aturan dan evaluasi aturan.
Bidang berikut ini tidak muncul pada formulir item kerja tetapi dilacak untuk setiap jenis item kerja. Bidang-bidang ini memberikan nilai numerik untuk setiap nilai klasifikasi yang ditentukan untuk proyek. Anda dapat menggunakan bidang ini untuk memfilter kueri dan membuat laporan.
| Nama bidang | Keterangan | Nama referensi | Jenis data |
|---|---|---|---|
| ID Area | ID unik area tempat item kerja ini ditetapkan. | System.AreaId | Bilangan bulat |
| ID Perulangan | ID unik dari iterasi tempat item kerja ini ditetapkan. | System.IterationId | Bilangan bulat |
| Nama Node | Nama simpul terakhir jalur area. Misalnya, jika jalur area adalah Project\A1\B2\C3, nama nodenya adalah C3. | System.NodeName | String |
Jenis default yang dapat dilaporkan tidak ada. ID Area dan ID Perulangan diindeks, Nama Simpul tidak. Untuk mempelajari selengkapnya tentang atribut bidang, lihat Bidang dan atribut item kerja.
Artikel terkait
- Referensi cepat kueri
- Menentukan jalur area dan menetapkan ke tim
- Menentukan jalur iterasi (sprint) dan mengonfigurasi iterasi tim
- Mengatur izin dan akses untuk pelacakan kerja
REST API
Untuk berinteraksi secara terprogram dengan kueri, lihat salah satu sumber daya REST API ini: