Membuat kueri item kerja

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Kueri item kerja di Azure Boards menghasilkan daftar item kerja berdasarkan kriteria filter yang Anda sediakan. Anda dapat menyimpan kueri terkelola ini dan membagikannya dengan orang lain.

Kiat

Anda dapat menggunakan AI untuk membantu tugas ini nanti dalam artikel ini, atau lihat Mengaktifkan bantuan AI dengan Azure DevOps MCP Server untuk memulai.

Anda dapat membuat kueri dari portal web atau dari klien yang didukung, seperti Visual Studio Team Explorer. Untuk mendukung pembaruan atau penambahan massal, impor atau ekspor kueri dengan menggunakan File Excel atau .csv.

Catatan

Gambar berikut menunjukkan fitur Hub Papan Baru yang diaktifkan secara default. Untuk informasi selengkapnya, lihat Mengelola atau mengaktifkan fitur.

Lihat praktik terbaik yang direkomendasikan nanti di artikel ini.

Prasyarat

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

Catatan

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

Pilih filter pertanyaan

Dari Query Editor, pilih filter untuk melompat ke artikel dengan kueri sampel. Bersama dengan filter kueri, Anda bisa menerapkan filter secara interaktif ke hasil kueri.

Catatan

Kueri terkelola tidak mendukung pencarian kedekatan tetapi pencarian semantik dilakukan. Pencarian semantik juga mendukung kedua karakter * dan ? sebagai karakter wildcard, dan Anda dapat menggunakan lebih dari satu karakter wildcard untuk mencocokkan lebih dari satu karakter. Untuk informasi selengkapnya, lihat Pencarian item kerja fungsional.

---

Fitur filter

Macro

---

• Membandingkan bidang
• Kata kunci
• Item kerja terkait
• Pengelompokan logis
• Makro kueri
• Tagar
• Pernah Ada
• Pernah Ada (Kolom Papan)
• Kartu Liar

• Bidang kosong atau tidak terisi
• Pencarian Boolean
• Pencarian identitas
• Riwayat dan Diskusi
• Bidang Dewan
• Pencarian Di Dalam dan Di Luar Grup
• Mencari di seluruh proyek

• [Apa saja]
• @Me
• @Today
• @CurrentIteration, @CurrentIteration +/-n
• @Follows
• @MyRecentActivity, @RecentMentions, @RecentProjectActivity
• @StartOfDay, @StartOfMonth, @StartOfWeek, @StartOfYear
• @TeamAreas

---

Anda bisa menggunakan fungsi Filter untuk memfilter kueri secara interaktif.

Buka Kueri

Peramban

Dari proyek Anda, pilih > Kueri, lalu pilih Semua.

Halaman Kueri terbuka ke tab Favorit yang mencantumkan kueri yang Anda tetapkan sebagai favorit. Anda dapat memilih tab Semua untuk melihat semua kueri yang Anda tentukan dan bagikan kueri untuk proyek.

Kiat

Kueri yang Anda atau tim Anda pilih sebagai favorit muncul di halaman Favorit . Kueri favorit bersama dengan objek lain juga muncul di halaman Proyek Anda. Untuk informasi selengkapnya, lihat Mengatur favorit pribadi atau tim.

Visual Studio

Penting

Kami sangat menyarankan agar semua orang menggunakan tampilan default alih-alih tampilan warisan ini. Ini dirancang agar Anda dapat dengan cepat mengakses daftar item kerja berdasarkan tugas Anda, yang Anda ikuti, disebutkan, atau pembaruan terbaru. Tampilan warisan tidak lagi ditingkatkan dan kami berharap untuk menghapusnya dalam rilis Visual Studio di masa mendatang.

1. Dari beranda Team Explorer, pilih Item Kerja.

   

2. Untuk membuka kueri, buka menu konteks untuk kueri (klik kanan dengan mouse Anda), dan pilih Tampilkan Hasil. Atau, klik dua kali kueri untuk membukanya.

   

Atau, pilih salah satu opsi berikut:

• Edit Query: Membuka Query Editor untuk kueri yang dipilih.
• Kueri Baru: Membuka Query Editor dengan opsi kueri baru default.
• Buka di Microsoft Excel (Flat): Membuka kueri di Microsoft Excel.
• Send ke Microsoft Outlook: Buka
• Potong: Memangkas kueri. Anda kemudian dapat menempelkan kueri di bawah folder lain.
• Salin: Menyalin kueri. Anda kemudian dapat menempelkan kueri di bawah folder yang sama atau folder lain.
• Hapus: Menghapus kueri.
• Ganti nama: Memungkinkan Anda mengganti nama kueri.
• Tambahkan ke Favorit Saya: Menambahkan kueri ke bagian Favorit Saya.
• Tambahkan ke Favorit Tim: Menambahkan kueri ke bagian Favorit Tim.
• Keamanan: Membuka dialog Izin untuk kueri.

Menentukan kueri daftar datar

Mulai kueri baru dari tab Kueri di portal web atau tab Item Kerja di Team Explorer.

Peramban

1. Pilih Baru>Kueri baru.

Query Editor ditampilkan dengan pengaturan default berikut: Flat list of work item, Work Item Type=[Any], dan State=[Any].

1. Ubah Nilai dan tambahkan atau hapus klausa, atau ubah Tipe kueri menjadi Item kerja dan tautan langsung atau ke Pohon item kerja.

Visual Studio

Penting

Gunakan tampilan default alih-alih tampilan warisan ini. Tampilan default menyediakan akses cepat ke daftar item kerja berdasarkan penugasan Anda, yang Anda ikuti, disebutkan, atau pembaruan terbaru. Tampilan lama tidak akan ditingkatkan dan akan dihapus dalam rilis Visual Studio mendatang.

1. Pilih Kueri Baru dari halaman Item Kerja.

   

   Query Editor ditampilkan dengan pengaturan default berikut: daftar datar (Default), Team Project=proyek saat ini, Work Item Type=[Any], dan State=[Any].

   

2. Ubah Nilai dan tambahkan atau hapus klausa. Atau, ubah Tipe kueri menjadi Item kerja dan tautan langsung atau ke Pohon item kerja.

Menjalankan pencarian di seluruh atau dalam proyek

Kueri baru mencakup proyek saat ini secara otomatis. Namun, Anda dapat membuat kueri untuk menemukan item kerja yang ditentukan dalam organisasi atau koleksi proyek. Namun, semua kueri yang Anda simpan berada di bawah proyek tertentu.

Peramban

Untuk mencantumkan item kerja yang ditentukan dalam dua proyek atau lebih, pilih Kueri di seluruh proyek. Misalnya, kueri berikut menemukan semua fitur yang dibuat di semua proyek dalam 30 hari terakhir.

Catatan

• Pisahkan beberapa nama proyek menggunakan pemisah daftar yang ditentukan oleh pengaturan regional komputer klien Anda, seperti koma ,.
• Saat Anda menggunakan bidang 'Status' dalam kueri di beberapa proyek, nilai yang ditampilkan terbatas pada item yang ditentukan dalam proyek default. Jika Anda mengkueri di seluruh proyek, Anda mungkin tidak melihat semua nilai status yang mungkin dari setiap proyek, tetapi hanya nilai dari proyek default. Misalnya, jika Anda memiliki tiga proyek - Proyek A, Proyek B, dan Proyek C - dan hanya Proyek A yang memiliki status yang disebut 'Dalam Tinjauan,' sementara Proyek B dan C memiliki status yang berbeda, kueri hanya menampilkan status yang ditentukan dalam Proyek A.

Saat Anda membuat kueri di beberapa proyek, ketersediaan bidang di menu drop-down Bidang bergantung pada apakah opsi Kueri di seluruh proyek diaktifkan. Ingatlah perilaku utama berikut:

• Bidang Proyek Tim hanya akan tersedia setelah Anda memilih Kueri di seluruh proyek.
• Saat Anda memilih Kueri antar proyek, semua bidang dari semua tipe item kerja yang didefinisikan dalam semua proyek dalam koleksi tersebut muncul di menu drop-down Bidang.
• Saat Anda menghapus Kueri di seluruh proyek, hanya bidang dari jenis item kerja yang ditentukan dalam proyek saat ini yang muncul di menu drop-down Bidang .

Saat Anda memilih Kueri di seluruh proyek, Anda bisa menambahkan bidang Proyek Tim untuk memfilter jumlah proyek tertentu.

Visual Studio

Penting

Gunakan tampilan default alih-alih tampilan warisan ini. Tampilan default dirancang agar Anda dapat dengan cepat mengakses daftar item kerja berdasarkan tugas yang ditugaskan kepada Anda, item yang Anda ikuti, item di mana Anda disebutkan, atau item dengan pembaruan terbaru. Tampilan warisan tidak lagi ditingkatkan dan diharapkan akan dihapus dalam rilis Visual Studio di masa mendatang.

Untuk mencantumkan item kerja yang ditentukan dalam dua proyek atau lebih, ubah klausul untuk bidang Proyek Tim dengan menggunakan operator Dalam . Masukkan nama proyek yang akan dicari. Misalnya, kueri berikut menemukan item kerja yang ditentukan dalam proyek Fabrikam Fiber dan Design Agile .

Untuk mengkueri di seluruh proyek, hapus klausa dengan bidang Proyek Tim.

Menentukan klausa

Untuk membuat kueri, tentukan satu atau beberapa klausa. Setiap klausa menentukan kriteria filter untuk satu bidang.

Contoh klausa kueri

dan/atau	Bidang	Pengendali	Nilai
Dan	Ditetapkan Ke	=	@Me

Untuk daftar operator yang tersedia berdasarkan tipe data bidang, lihat Referensi Cepat Indeks Kueri.

Tambahkan semua klausa sebagai pernyataan Dan . Pilih Atau untuk mengubah pengelompokan. Klausa grup untuk memastikan bahwa pernyataan klausul berjalan dalam urutan yang diperlukan.

Peramban

Pilih Tambahkan klausa baru untuk menambahkan klausa lain di akhir kueri, lalu pilih Bidang, Operator, dan Nilai untuk klausa tersebut.

Misalnya, cari semua item kerja yang ditetapkan kepada Anda dengan menentukan bidang Ditetapkan Ke, operator sama dengan (=), dan makro @Me yang mewakili identitas pengguna Anda.

Visual Studio

Penting

Gunakan tampilan default alih-alih tampilan warisan ini. Tampilan default dirancang agar Anda dapat dengan cepat mengakses daftar item kerja berdasarkan tugas yang ditugaskan kepada Anda, item yang Anda ikuti, item di mana Anda disebutkan, atau item dengan pembaruan terbaru. Tampilan warisan tidak lagi ditingkatkan dan diharapkan akan dihapus dalam rilis Visual Studio di masa mendatang.

Pilih Klik di sini untuk menambahkan klausa untuk menambahkan klausa lain di akhir kueri, lalu pilih Bidang, Operator, dan Nilai untuk klausa tersebut.

Screenshot dari Editor Kueri Visual Studio, tambahkan klausa baru.

Untuk menyisipkan klausa dalam kumpulan klausa kueri yang ada, letakkan kursor Anda pada klausa berikut tempat Anda ingin menyisipkan klausa, lalu pilih Sisipkan Klausa. Kemudian, pilih Bidang, Operator, dan Nilai untuk klausa tersebut.

Atau, buka menu konteks untuk klausa dan pilih Sisipkan Klausa.

Untuk menghapus klausa, pilih klausa yang ingin Anda hapus, dan pilih Hapus Klausa.

Setelah selesai, pilih Jalankan atau Simpan Kueri.

Kiat

Untuk melihat sintaks WIQL untuk kueri, dan bagaimana tanda kurung digunakan untuk mengelompokkan klausa, instal Editor Wiql Marketplace. Ekstensi ini mendukung melihat sintaks WIQL dan mengekspornya ke file WIQL untuk digunakan dalam panggilan REST API. Untuk informasi selengkapnya, lihat Sintaks untuk Work Item Query Language (WIQL).

Daftar periksa untuk menentukan klausa kueri

1. Di baris kosong pertama, di bawah judul Kolom bidang , pilih panah bawah untuk menampilkan daftar bidang yang tersedia, dan pilih item dalam daftar. Untuk informasi selengkapnya, lihat Kueri Bidang dan Nilai.

2. Di baris yang sama, di bawah judul kolom Operator , pilih panah bawah untuk menampilkan daftar operator yang tersedia, lalu pilih item dalam daftar. Untuk informasi selengkapnya, lihat Operator.

3. Di baris yang sama, di bawah judul kolom Nilai , masukkan nilai, atau pilih panah bawah, lalu pilih item dalam daftar. Untuk informasi selengkapnya tentang cara menggunakan makro atau variabel untuk menentukan proyek, pengguna, tanggal, atau pilihan saat ini, lihat Variabel.

4. Untuk menambahkan klausa, pilih Tambahkan klausa baru.

   Anda bisa menambahkan klausa ke akhir kueri, atau melakukan tugas berikut dengan menggunakan ikon terkait:

   • Sisipkan baris filter baru
   • Hapus baris filter ini
   • Mengelompokkan klausa yang dipilih
   • Pisahkan klausa

Menggunakan pohon item kerja untuk melihat hierarki

Gunakan kueri Pohon Item Kerja untuk menampilkan daftar item kerja bersarang yang berlapis multitingkat. Misalnya, Anda dapat melihat semua item backlog dan tugas tertautnya. Untuk fokus pada bagian pohon yang berbeda, pilih Perluas semua atau Ciutkan semua.

Catatan

Anda tidak dapat membuat kueri yang memperlihatkan tampilan hierarkis Rencana Pengujian, Test Suites, dan Kasus Pengujian. Item ini tidak ditautkan bersama-sama menggunakan jenis tautan induk-turunan. Namun, Anda dapat membuat kueri tautan langsung yang mencantumkan item kerja terkait pengujian. Selain itu, Anda dapat melihat hierarki melalui halaman Rencana Pengujian.

Peramban

Tentukan kriteria filter untuk item kerja induk serta item kerja anak. Untuk menemukan anak yang ditautkan, pilih Cocokkan item kerja tingkat atas terlebih dahulu. Untuk menemukan orang tua yang ditautkan, pilih Cocokkan item kerja tertaut terlebih dahulu.

Visual Studio

Penting

Gunakan tampilan default alih-alih tampilan warisan ini. Tampilan default dirancang agar Anda dapat dengan cepat mengakses daftar item kerja berdasarkan tugas yang ditugaskan kepada Anda, item yang Anda ikuti, item di mana Anda disebutkan, atau item dengan pembaruan terbaru. Tampilan warisan tidak lagi ditingkatkan dan diharapkan akan dihapus dalam rilis Visual Studio di masa mendatang.

Tentukan kriteria filter untuk item kerja induk serta item kerja anak. Untuk menemukan anak yang ditautkan, pilih Cocokkan item kerja tingkat atas terlebih dahulu. Untuk menemukan orang tua yang ditautkan, pilih Cocokkan item kerja tertaut terlebih dahulu.

Menggunakan tautan langsung untuk melihat dependensi

Gunakan kueri Item kerja dan Tautan langsung untuk melacak item kerja yang bergantung pada pekerjaan terlacak lainnya, seperti tugas, bug, masalah, atau fitur. Misalnya, Anda dapat melihat item backlog yang bergantung pada item lain yang diimplementasikan atau bug sedang diperbaiki.

Gunakan kueri tautan langsung untuk melacak dependensi di seluruh tim. Kueri juga membantu Anda mengelola komitmen yang dibuat oleh tim Anda. Pilih kriteria filter untuk item kerja teratas dan tertaut. Dan, pilih jenis tautan untuk memfilter dependensi.

Peramban

Filter daftar item kerja tingkat pertama Anda dengan memilih salah satu opsi berikut:

• Hanya kembalikan item yang memiliki tautan yang cocok: Mengembalikan item kerja tingkat pertama, tetapi hanya jika item tersebut memiliki tautan ke item kerja yang ditentukan oleh kriteria filter item kerja tertaut.
• Mengembalikan semua item tingkat atas: Mengembalikan semua item kerja tingkat pertama meskipun ada kriteria filter item kerja yang ditautkan. Mengembalikan item kerja tingkat kedua yang ditautkan ke tingkat pertama jika cocok dengan kriteria filter item kerja yang ditautkan.
• Hanya kembalikan item yang tidak memiliki tautan yang cocok: Mengembalikan item kerja tingkat pertama, tetapi hanya jika mereka tidak memiliki tautan ke item kerja yang ditentukan oleh kriteria filter item kerja yang ditautkan.

Visual Studio

Penting

Gunakan tampilan default alih-alih tampilan warisan ini. Tampilan default dirancang agar Anda dapat dengan cepat mengakses daftar item kerja berdasarkan tugas yang ditugaskan kepada Anda, item yang Anda ikuti, item di mana Anda disebutkan, atau item dengan pembaruan terbaru. Tampilan warisan tidak lagi ditingkatkan dan diharapkan akan dihapus dalam rilis Visual Studio di masa mendatang.

Filter daftar item kerja tingkat pertama Anda dengan memilih salah satu opsi berikut:

• Mengembalikan semua item kerja tingkat atas: Mengembalikan semua item kerja tingkat pertama terlepas dari kriteria filter item kerja yang ditautkan. Mengembalikan item kerja tingkat kedua yang ditautkan ke tingkat pertama jika cocok dengan kriteria filter item kerja yang ditautkan.

• Hanya kembalikan item yang memiliki tautan yang ditentukan: Mengembalikan item kerja tingkat pertama, tetapi hanya jika mereka memiliki tautan ke item kerja yang ditentukan oleh kriteria filter item kerja tertaut.

• Hanya kembalikan item yang tidak memiliki tautan yang ditentukan: Mengembalikan item kerja tingkat pertama, tetapi hanya jika mereka tidak memiliki tautan ke item kerja yang ditentukan oleh kriteria filter item kerja tertaut.

Untuk informasi selengkapnya tentang setiap jenis tautan, lihat Referensi jenis tautan.

Menggunakan ekspresi logis dan/atau

Tentukan And atau Or untuk membuat ekspresi logis klausa kueri Anda. Gunakan And untuk menemukan item kerja yang memenuhi kriteria dalam klausa saat ini dan klausa sebelumnya. Gunakan Or untuk menemukan item kerja yang memenuhi kriteria baik dalam klausa saat ini atau klausa sebelumnya.

Tambahkan satu klausa baru untuk setiap bidang item kerja untuk menyempurnakan kriteria pencarian Anda. Tambahkan klausa untuk mengembalikan hanya sekumpulan item kerja yang Anda inginkan. Jika Anda tidak menerima hasil yang Anda harapkan dari kueri Anda, perbaiki. Anda bisa menambahkan, menghapus, mengelompokkan, atau memisahkan grup klausul kueri untuk meningkatkan hasil kueri Anda.

Mengelompokkan klausa kueri untuk berfungsi sebagai satu unit yang terpisah dari bagian kueri lainnya. Klausa pengelompokan mirip dengan menempatkan tanda kurung di sekitar ekspresi dalam persamaan matematika atau pernyataan logika. Saat Anda mengelompokkan klausa, And atau Or untuk klausa pertama dalam kelompok berlaku untuk seluruh kelompok.

Klausa kelompok

Klausa yang dikelompokkan bertindak sebagai unit tunggal yang terpisah dari kueri lainnya. Klausa pengelompokan mirip dengan menempatkan tanda kurung di sekitar persamaan matematika atau ekspresi logika. Operator And atau Or untuk klausa pertama dalam grup berlaku untuk seluruh grup.

Seperti yang ditunjukkan contoh berikut, klausa yang dikelompokkan diterjemahkan ke ekspresi logis yang sesuai.

Kueri	Klausa yang dikelompokkan	Ekspresi logis
1
2
3

Kueri ini mengembalikan item kerja yang bertipe Bug dan memenuhi ekspresi logis berikut:

• Kueri 1: AND State=Active OR Assigned to @Me
• Kueri 2: AND (State=Active OR Assigned to @Me)
• Kueri 3: OR (State=Active AND Assigned to @Me)

Untuk mengelompokkan satu atau beberapa klausa, pilih klausa tersebut lalu pilih ikon klausa grup.

Anda juga dapat mengelompokkan beberapa klausa yang dikelompokkan. Centang kotak setiap klausa. Lalu, pilih ikon klausa grup.

Jika hasil kueri Anda tidak mengembalikan hasil yang diharapkan, coba langkah-langkah berikut:

• Pastikan bahwa setiap klausa didefinisikan seperti yang Anda inginkan.
• Verifikasi And/Or penugasan pada setiap klausul. Jika hasil Anda berisi lebih banyak item kerja daripada yang diharapkan, seringkali terdapat klausa Or menggantikan klausa And.
• Tentukan apakah Anda perlu mengelompokkan atau mengubah pengelompokan klausa kueri dan And/Or penetapan setiap klausa yang dikelompokkan.
• Tambahkan klausa kueri lainnya untuk menyempurnakan kriteria filter kueri Anda.
• Tinjau opsi yang tersedia untuk menentukan bidang, operator, dan nilai.
• Lihat praktik terbaik, nanti di artikel ini.

Mengelompokkan ulang klausa

Untuk melepaskan pengelompokan klausa, pilih ikon untuk klausa yang sudah dikelompokkan.

Mengatur lebar kolom default dalam hasil kueri

Untuk mengatur lebar kolom default dalam hasil kueri, ikuti langkah-langkah berikut:

1. Buka kueri yang ingin Anda ubah.
2. Sesuaikan lebar kolom secara manual ke ukuran yang Anda inginkan dengan menyeret tepi header kolom.
3. Pilih Simpan atau Simpan Sebagai jika Anda ingin menyimpannya sebagai kueri baru.
4. Tutup dan buka kembali kueri untuk memastikan bahwa lebar kolom dipertahankan.

Azure DevOps saat ini tidak mendukung pengaturan lebar kolom default yang bertahan di semua sesi. Lebar kolom disimpan per kueri, jadi Anda perlu menyesuaikan dan menyimpannya untuk setiap kueri satu per satu.

Menampilkan hasil kueri di dasbor

Dua widget berikut menampilkan hasil kueri. Anda dapat membuka item kerja langsung dari widget ini.

• Pekerjaan yang ditetapkan kepada saya: Mencantumkan semua item kerja yang diusulkan atau aktif yang ditetapkan untuk pengguna yang masuk. Mencantumkan bidang ID, Status, dan Judul.
• Widget hasil kueri: Menampilkan hasil kueri datar, pohon, atau tautan langsung. Anda dapat mengonfigurasi bidang yang ditampilkan melalui widget, mengubah ukuran bidang kolom, dan memperluas dan menciutkan kueri pohon dan tautan langsung.

Untuk informasi selengkapnya, lihat Menambahkan widget ke dasbor.

Menampilkan widget hasil kueri dengan judul parent

Untuk menampilkan hasil kueri dengan judul Induk yang ditampilkan, selesaikan langkah-langkah berikut:

1. Buat kueri yang menyaring item kerja yang relevan. Kueri bisa berupa kueri daftar datar, pohon, atau tautan langsung.
2. Tambahkan bidang Induk sebagai kolom. Meskipun Anda dapat menyertakan bidang Induk , perilaku default mungkin hanya menampilkan ID item kerja induk. Untuk memastikan bahwa nama ditampilkan bersama ID, gabungkan bidang Tipe Item Kerja dan Induk dengan bidang Judul dalam struktur kueri.
3. Simpan kueri sebagai kueri Bersama atau Favorit tim.
4. Tambahkan widget Hasil kueri ke dasbor Anda dan konfigurasikan kueri. Pastikan bidang Induk diatur agar bisa ditampilkan.

Gambar berikut mengilustrasikan widget hasil kueri yang menampilkan kolom Induk.

Menentukan kueri sebagai hyperlink

Hyperlink kueri menggunakan Bahasa Kueri Item Kerja (WIQL), yang menyerupai Transact-SQL. Untuk informasi selengkapnya, lihat Sintaks untuk Work Item Query Language (WIQL).

Catatan

Sebagian besar browser memberlakukan batas antara 2.000 dan 2.083 karakter untuk string URL.

Kueri sintaksis hyperlink

Mengenkripsi bagian WIQL dari sintaks URL. Anda dapat menggunakan alat encoder URL apa pun untuk mengodekan URL Anda.

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

Misalnya, hyperlink berikut mencantumkan ID dan judul semua bug aktif yang ditentukan di bawah jalur area FabrikamFiber/Web untuk organisasi Fabrikam.

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

WIQL yang didekodekan sesuai dengan:

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

Catatan

Panjang WIQL tidak boleh melebihi karakter 32 K untuk kueri Azure Boards.

Praktik terbaik

Praktik terbaik berikut berlaku untuk kueri yang bisa Anda buat:

• Permintaan pencarian portal web
• Kueri Bahasa Pemrograman WIQL
• kueri papan az pada baris perintah
• Kueri REST API

Membuat kueri yang berfokus dan selektif

Tentukan kueri yang sangat selektif dengan menerapkan semua filter yang diperlukan. Semakin selektif kuerinya, semakin kecil kumpulan hasilnya. Kumpulan hasil yang lebih kecil berarti kueri Anda lebih ditargetkan dan selektif.

Menggunakan tag untuk mengategorikan item kerja

Gunakan tag item kerja untuk mengategorikan item kerja Anda alih-alih menggunakan bidang kustom. Kueri yang memfilter tag biasanya berkinerja lebih cepat daripada kueri yang memfilter kecocokan string.

Tidak seperti pencocokan bidang kustom atau pencocokan sebagian, kueri dengan Tags Contains operasi tidak memerlukan pemindaian lengkap terhadap semua tabel item kerja.

Gunakan Contains words untuk kecocokan string

Untuk memfilter string Contains Words yang cocok, gunakan operator Contains Words alih-alih operator . Operator Contains Words menjalankan pencarian teks lengkap pada bidang yang ditentukan, yang cenderung selesai lebih cepat.

Operator Contains menjalankan pemindaian tabel, yang merupakan operasi yang lebih lambat daripada Contains Words operator. Ini juga mengonsumsi lebih banyak siklus CPU. Siklus CPU ini dapat menyebabkan Anda mengalami keterbatasan laju. Untuk informasi selengkapnya, lihat Tarif dan batas penggunaan.

Tentukan grup kecil dengan In Group operator

Operator In Group memfilter item kerja berdasarkan kecocokan dalam sekelompok nilai. Grup nilai sesuai dengan nilai yang terkandung dalam kategori tim, grup keamanan, atau pelacakan kerja. Misalnya, Anda dapat membuat kueri untuk menemukan semua item kerja yang ditetapkan ke anggota tim mana pun. Atau, temukan semua item kerja yang termasuk dalam kategori persyaratan (Microsoft.RequirementCategory).

Saat Anda memfilter grup yang berisi sejumlah besar anggota, kumpulan hasil Anda cenderung lebih besar dan tidak dipilih. Selain itu, jika grup tersebut merupakan grup Microsoft Entra yang besar, kueri akan menghasilkan biaya yang cukup besar untuk memulihkan grup tersebut dari Microsoft Entra ID.

Hindari penggunaan operator yang dinegasikan

Operator yang dinegasikan—seperti <>, Not In, Not Under, Not In Group—cenderung menghasilkan kueri tidak selektif dan set hasil yang besar.

Hanya gunakan operator yang dinegasikan jika diperlukan. Selalu coba cari alternatif terlebih dahulu. Misalnya, jika Field1 memiliki nilai A, B, C, D; tentukan Field1 In A, B, C klausa, bukan klausa yang dinegasikan Field1 <> D .

Hindari perbandingan string

Kueri yang berisi perbandingan string menghasilkan pemindaian tabel yang secara inheren tidak efisien. Sebagai gantinya, gunakan tag atau bidang kustom tertentu sebagai alternatif, terutama ketika kueri berkinerja buruk.

Batasi operator Or

Batasi jumlah Or operator yang ditentukan dalam kueri Anda. Kueri berjalan lebih baik dengan lebih sedikit Or operator yang digunakan. Terlalu banyak Or operator yang dapat membuat kueri Anda tidak selektif. Jika kueri Anda berjalan lambat, susun ulang klausa operator Or ke bagian atas dari klausa kueri.

Simpan kueri Anda

Karena pengoptimalan internal, kueri yang disimpan cenderung berkinerja lebih baik daripada kueri yang tidak disimpan. Selalu simpan kueri Anda ketika Anda berencana untuk menggunakannya kembali. Bahkan untuk kueri WIQL yang dijalankan melalui REST API, simpan WIQL melalui portal web untuk melakukan panggilan REST API Anda, sehingga kurang rentan terhadap regresi performa di masa mendatang.

Jalankan kueri Anda

Terkadang Anda perlu menjalankan kueri beberapa kali untuk mencapai rencana pengoptimalan yang tepat. Simpan kueri Anda dan jalankan hingga 10 kali selama periode 30 menit. Dengan cara ini, sistem dapat memeriksa dan mencari rencana pengoptimalan yang paling sesuai untuk kueri Anda.

Menggunakan AI untuk mendefinisikan kueri item kerja

Jika Anda mengonfigurasi Azure DevOps MCP Server, Anda dapat menjelaskan kueri yang Anda butuhkan dalam bahasa alami alih-alih membangun klausul secara manual di Query Editor.

Tugas	Contoh perintah
Menemukan item menurut status dan penugasan	List all active bugs assigned to <me> in project <Contoso>
Kueri di seluruh iterasi	Show user stories completed in the last three sprints for <Contoso>
Memperjelas kueri struktur pohon	Get all tasks that are children of features in area path <Contoso\\Web>
Menemukan item yang baru diperbarui	Show work items changed in the last 7 days that are tagged "performance" in <Contoso>
Kueri multikondisi	Find active bugs in <Contoso> with priority 1, severity 2 or higher, and no one assigned
Hasilkan WIQL	Write a WIQL query that returns all user stories in the current iteration for <Contoso> with story points between 3 and 8
Meringkas hasil kueri	Run a query for all active work items in <Contoso> and give me a breakdown by type, state, and area path
Membuat kueri satu hop	Show all bugs in <Contoso> along with their related work items
Menciptakan kueri tren	Show bugs created per week for the last 8 weeks in <Contoso> grouped by area path
Kueri dengan negasi	List active user stories in <Contoso> that are not tagged "tech-debt" and not in area path <Contoso\\Maintenance>

Catatan

Jika Anda menggunakan Visual Studio Code, mode agent sangat membantu untuk membangun kueri yang kompleks.

Konten terkait

• Referensi Kueri Cepat.
• Tanya Jawab Umum Pertanyaan
• Memetakan kueri daftar linier
• Ubah opsi kolom
• Indeks bidang item kerja
• Pintasan papan ketik