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.

Prasyarat

Kategori	Persyaratan
Tingkat akses	- Untuk melihat dan menjalankan kueri bersama: anggota proyek. - Untuk menambahkan dan menyimpan kueri bersama: Setidaknya akses Dasar.
Izin	Atur izin Kontribusi menjadi Izinkan untuk folder yang ingin Anda tambahkan kueri. Secara default, grup Kontributor tidak memiliki izin ini.

Nota

Pengguna dengan akses Stakeholder untuk proyek publik memiliki akses penuh ke fitur kueri sama seperti pengguna dengan akses Dasar. Untuk informasi selengkapnya, lihat referensi cepat akses pemangku kepentingan .

Nota

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 atau jalur iterasi tertentu.
In	Filter untuk sekumpulan jalur area atau iterasi.
Not In	Mengecualikan item yang diatur pada sejumlah area atau jalur iterasi.
Under	Tentukan semua jalur dalam area atau jalur iterasi tertentu.
Not Under	Kecualikan item yang ditetapkan di bawah area atau jalur iterasi tertentu.

Bersama dengan operator ini, Anda dapat menggunakan makro berikut saat memilih Jalur Perulangan. Misalnya, lihat kueri berdasarkan 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.

Nota

Makro @CurrentIteration +/- n 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 lintasan area

Anda dapat menentukan untuk memfilter item kerja yang ditetapkan ke beberapa jalur area dengan menggunakan operator Di seperti yang ditunjukkan dalam contoh berikut.

Permintaan

Nama Simpul dan kueri yang 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 pada 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".

kueri

Berikut adalah contoh lain yang menggunakan Nama Simpul dan operator Dalam.

Kueri jalur area tim

Gunakan makro @TeamAreas untuk dengan cepat menemukan item yang ditugaskan ke jalur area yang diterapkan pada 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	Deskripsi	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 Iterasi	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, jenis 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 menyusun simpul lebih dari 14 tingkat.

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	Deskripsi	nama referensi	Jenis data
Area ID	ID unik dari area tempat item kerja ini ditetapkan.	System.AreaId	Integer
ID Perulangan	ID unik dari iterasi tempat item kerja ini ditetapkan.	System.IterationId	Integer
Nama Simpul	Nama simpul terakhir dari jalur area. Misalnya, jika jalur area adalah Project\A1\B2\C3, nama nodenya adalah C3.	System.NodeName	Tali

Jenis default yang dapat dilaporkan tidak ada. ID Area dan ID Perulangan telah diindeks, sedangkan Nama Simpul tidak diindeks. Untuk mempelajari lebih lanjut tentang atribut dan bidang item kerja, lihat Bidang dan atribut item kerja.

Artikel terkait

• referensi cepat kueri
• Menentukan lintasan area dan menetapkan ke tim
• Menentukan jalur iterasi (sprint) dan mengonfigurasi iterasi tim
• Mengatur akses dan izin untuk pelacakan kerja

REST API

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

• Referensi REST API Azure DevOps Services
• Kueri
• bahasa kueri item kerja
• Mengambil item kerja dengan kueri secara terprogram