Bagikan melalui


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.

Kueri pada Jalur Area untuk beberapa area

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.

Kueri pada Nama Simpul untuk beberapa area

Dalam contoh ini, filter mengembalikan item kerja apa pun yang ditetapkan ke jalur area yang simpul terakhirnya berisi kata "Azure".

Kueri untuk beberapa sprint

Berikut adalah contoh lain yang menggunakan Nama Node dan operator Di .

Kueri pada Nama Simpul untuk beberapa area

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.

Kueri pada jalur area yang ditetapkan ke tim

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.

REST API

Untuk berinteraksi secara terprogram dengan kueri, lihat salah satu sumber daya REST API ini: