Kueri menurut judul, ID, dan bidang teks kaya

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Filter item kerja menurut kata kunci, ID, atau bidang teks kosong dengan menggunakan bidang teks baris tunggal (String), teks multibaris (Teks Biasa), dan teks kaya (HTML). Jika kueri membutuhkan waktu terlalu lama untuk dikembalikan, lihat Membuat kueri, Praktik terbaik.

Tip

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

Prerequisites

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

Note

Pengguna dengan akses Stakeholder pada proyek publik memiliki akses penuh ke fitur pencarian seperti pengguna dengan akses Dasar. Untuk informasi selengkapnya, lihat panduan cepat akses pemangku kepentingan.

Operator dan makro yang didukung

Gunakan operator dan makro yang tercantum untuk bidang teks dan teks kaya.

---

Jenis data

Operator dan makro yang didukung

---

Teks kaya (HTML)
String teks multibaris (Teks Biasa)

Contains Words, Does Not Contain Words, Is Empty¹, Is Not Empty¹

---

Teks tunggal (String)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever
Makro: [Any] valid dengan bidang Tipe Item Kerja dan @Project², valid dengan bidang Proyek Tim .

---

ID

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Makro: @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity sah dengan bidang ID dan operator In serta Not In.
@Project ², valid dengan bidang Proyek Tim .

---

Status dan Jenis Item Kerja

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever
Makro: [Any] berlaku untuk kedua bidang.

---

Note

1. Operator Is Empty dan Is Not Empty didukung untuk versi Azure DevOps Server 2020 dan yang lebih baru.
2. Sistem default untuk memfilter berdasarkan proyek saat ini. Untuk mengetahui informasi selengkapnya, lihat Kueri di seluruh proyek.

Gunakan Contains Words untuk kecocokan string

Saat Anda ingin memfilter berdasarkan kecocokan string, pilih operator Contains Words dibandingkan dengan Contains. Contains Words menggunakan indeks teks lengkap dan biasanya lebih cepat. String teks dibatasi hingga 100 karakter.

Operator Contains menjalankan pemindaian tabel; lebih lambat dan mengonsumsi lebih banyak sumber daya CPU, yang dapat memengaruhi batas laju Anda.

Note

Operator Contains Words menggunakan pengindeksan pencarian teks lengkap SQL. Saat nilai baru disimpan ke bidang teks panjang, SQL Server:

• Memisahkan frasa menjadi kata-kata
• Menghapus kata berhenti umum (misalnya, "a" atau "is")
• Mengonversi kata ke batang umumnya (misalnya, menjalankan → jalankan)
• Menyimpan kata kunci yang dihasilkan dalam indeks

Kueri yang menggunakan Contains Words pencarian indeks, memberikan hasil yang lebih cepat untuk bidang teks panjang. Untuk informasi selengkapnya dan persyaratan server/kolaksi, lihat Bidang kueri, operator, nilai, dan variabel - Pencarian teks lengkap dan kata parsial.

Kueri kata kunci atau frasa dengan kartubebas

Gunakan Contains atau Contains Words untuk menemukan item yang sebagian atau persis cocok dengan kata atau frasa.

Pilih Contains atau Does Not Contain untuk mencari kecocokan persis atau parsial. Pilih Contains Words atau Does Not Contain Words untuk menggunakan indeks teks lengkap dan karakter pencocokan pola (wildcard) *.

Misalnya, Contains Words dengan inform* sesuai dengan inform, information, dan informational.

Tip

Untuk memahami bagaimana AND/OR klausa dikelompokkan, lihat Klausa grup. Untuk melihat sintaks WIQL untuk kueri, instal ekstensi editor kueri WIQL, yang memungkinkan Anda melihat versi WIQL dari entri editor kueri apa pun.

Kueri untuk kata-kata tertentu dan bukan yang lain

Gunakan Contains Words dan Does Not Contain Words untuk menyertakan kata atau frasa yang tepat dan mengecualikan orang lain. Gabungkan operator ini dan gunakan * untuk pencocokan wildcard.

Contoh berikut menunjukkan filter yang menyertakan pekerjaan "Fase" tetapi mengecualikan "Phasor."

Note

Kata-kata SQL yang dicadangkan tertentu, seperti WHERE, THEN, dan AND, tidak mengembalikan hasil saat digunakan sebagai kata kunci pencarian tunggal dengan Contains Words atau Does Not Contain Words.

Kueri nilai bidang tidak terdefinisi

Temukan item kerja dengan nilai bidang yang tidak ditentukan (kosong) dengan menggunakan operator = "sama dengan" dan biarkan Nilai kosong. Misalnya, filter berikut mencantumkan semua tugas yang bidang Aktivitasnya kosong.

Untuk menemukan item di mana bidang tidak kosong, gunakan operator <> "tidak" dan biarkan Nilai kosong.

Kueri bidang HTML kosong atau tidak kosong

Gunakan Is Empty atau Is Not Empty dengan bidang HTML untuk mencantumkan item kerja dengan bidang teks kaya yang kosong atau tidak kosong. Anda tidak menentukan nilai untuk operator ini.

Filter untuk karakter khusus

Loloskan karakter khusus seperti / atau - dengan garis miring terbelakang saat memfilter URL atau frasa.

• Filter untuk URL:

  • Kueri: Title ~ "https:\/\/example.com\/path-to-resource"
  • Hasil: Mengembalikan item kerja dengan URL yang tepat.

• Filter untuk frasa dengan tanda hubung:

  • Kueri: Title ~ "feature-update\-2023"
  • Hasil: Mengembalikan item kerja yang berisi frasa yang tepat dengan tanda hubung.

Note

Anda tidak dapat melakukan pencarian item kerja yang tidak memiliki tag apa pun yang terpasang. Untuk memberikan suara setuju pada permintaan fitur ini, kunjungi Developer Community: Menemukan kemampuan untuk mencari tag kosong.

Kueri berbasis kategori

Untuk memfilter menurut kategori, gunakan In Group operator. Contoh di bawah ini menampilkan item dalam proyek saat ini yang ditugaskan kepada anggota tim dan termasuk dalam kategori Bug.

Item apa yang muncul di kategori Persyaratan atau Tugas?

Penetapan jenis item kerja default untuk setiap proses:

Process	Kategori persyaratan	Kategori tugas
Basic	Issue	Task
Agile	Cerita Pengguna	Task
Scrum	Item Backlog Produk, Gangguan	Task
CMMI	Requirement	Task

Teams dapat memilih apakah jenis item kerja Bug muncul di kategori Persyaratan atau Tugas. Lihat Menampilkan bug di backlog dan papan. Untuk menambahkan jenis item kerja kustom ke backlog, lihat Menambahkan atau mengubah jenis item kerja.

Kueri untuk item kerja yang Anda ikuti

Gunakan @Follows makro dengan bidang ID dan In operator untuk mencantumkan item kerja yang Anda ikuti melintasi proyek jika perlu.

Kueri untuk aktivitas item kerja terbaru

Gunakan makro ini untuk mencantumkan item berdasarkan aktivitas terbaru:

• @MyRecentActivity: Item yang baru saja Anda lihat atau ubah.
• @RecentMentions: Item dengan @mention untuk Anda dalam 30 hari terakhir.
• @RecentProjectActivity: Item-item yang baru dibuat atau dimodifikasi dalam proyek Anda.

Gunakan bidang ID dengan In atau Not In.

Bidang umum untuk sebagian besar jenis item kerja

Tabel ini menjelaskan bidang umum yang digunakan dalam kueri. ID secara unik mengidentifikasi item kerja. Gunakan Judul untuk membedakan item dengan jenis yang sama. Deskripsi dan bidang teks kaya lainnya memberikan info implementasi terperinci. Setelah pembuatan, Anda dapat memodifikasi semua bidang kecuali ID; sistem menetapkan ID saat item kerja dibuat.

Note

Sistem mengindeks bidang teks panjang jenis PlainText dan HTML untuk pencarian teks lengkap, termasuk Title, Description, dan Steps to Repro. Untuk detail dan persyaratan server/kolase yang berlaku untuk Azure DevOps lokal, lihat bidang, operator, nilai, dan variabel Query - Pencarian teks lengkap dan kata parsial.

Nama bidang

Description

Jenis item kerja

---

Kriteria Penerimaan ¹

Deskripsi kriteria yang harus dipenuhi sebelum bug atau item backlog produk dapat ditutup.

Sebelum pekerjaan dimulai, catat kriteria penerimaan yang jelas sehingga tim dan pelanggan berbagi harapan. Kriteria penerimaan membantu menentukan pengujian penerimaan dan mengonfirmasi apakah item selesai.

Nama referensi=Microsoft.VSTS.Common.AcceptanceCriteria, Tipe data=HTML

Bug, Epik, Fitur, Item backlog produk (Scrum)

Deskripsi ^{1, 2}

Gunakan bidang ini untuk memberikan informasi mendalam tentang item kerja.

Nama referensi=System.Description, Tipe data=HTML

All

ID

Pengidentifikasi unik yang diberikan kepada item kerja. ID unik di seluruh proyek dalam koleksi proyek.

Nama referensi=System.Id, Tipe data=Integer

All

Langkah-Langkah Repro (atau Langkah-langkah untuk mereprodurasi) ¹

Langkah-langkah yang diperlukan untuk mereproduksi perilaku tak terduga. Tangkap detail yang cukup sehingga orang lain dapat mereprodusi dan memvalidasi perbaikan.

Nama referensi=Microsoft.VSTS.TCM.ReproSteps, Tipe data=HTML

Bug

Resolution

Menjelaskan bagaimana penghambat diselesaikan.

Nama referensi=Microsoft.VSTS.Common.Resolution, Data type=HTML

Hambatan (Scrum)

Info Sistem¹

Informasi tentang perangkat lunak dan konfigurasi sistem yang relevan dengan bug atau umpan balik.

Nama referensi=Microsoft.VSTS.TCM.SystemInfo, Tipe data=HTML

Bug, Permintaan Peninjauan Kode, Permintaan Umpan Balik

Proyek Tim

Proyek yang memiliki item kerja. Tambahkan bidang ini ke kueri untuk memfilter menurut satu atau beberapa proyek. Untuk informasi lebih lanjut, lihat Kueri lintas proyek.

Nama referensi=System.TeamProject, Data type=String

All

Title

Deskripsi singkat yang meringkas item kerja dan membantu anggota tim membedakannya dari orang lain.

Nama referensi=System.Title, Data type=String

All

Tipe Item Kerja

Nama jenis item kerja, ditentukan oleh proses yang digunakan saat proyek dibuat. Untuk informasi selengkapnya, lihat Tentang proses dan templat proses dan Menambahkan atau mengubah jenis item kerja.

Untuk memfilter menurut penetapan kategori, gunakan In Group operator dan Not In Group dan pilih kategori dari menu drop-down.

Nama referensi=System.WorkItemType, Data type=String

All

Menggunakan AI untuk mengkueri menurut judul, ID, atau deskripsi

Jika Anda memiliki Azure Boards McP Server tersambung ke agen AI Anda dalam mode agen, Anda dapat menggunakan perintah bahasa alami untuk menemukan item kerja berdasarkan kata kunci, ID, atau konten teks.

Task	Contoh perintah
Cari menurut kata kunci	Find all work items with 'performance' in the title
Deskripsi pencarian	List bugs where the description contains 'null reference exception'
Temukan kolom kosong	Show user stories with empty acceptance criteria
Kueri menurut rentang ID	Find work items with IDs between 5000 and 5100
Menemukan judul serupa	List work items in <Contoso> with titles containing "login", "sign in", or "authentication"
Kualitas deskripsi audit	List active user stories in <Contoso> where the description is shorter than 50 characters
Langkah-langkah reproduksi pencarian	Find bugs in <Contoso> whose repro steps mention "intermittent" or "random"
Menemukan pola penamaan	List work items in <Contoso> whose title starts with "[SPIKE]" or "[POC]"
Mengidentifikasi potensi duplikat	Show pairs of active bugs in <Contoso> that have similar titles
Meninjau item yang tidak lengkap	List user stories in the current sprint for <Contoso> where either the title contains "TBD" or the description is empty

Note

Mode agen dan Server MCP menggunakan bahasa alami, sehingga Anda dapat menyesuaikan perintah ini atau mengajukan pertanyaan tindak lanjut untuk memperbaiki hasilnya.

Konten terkait

• Editor kueri
• Menambahkan item kerja
• Indeks bidang item kerja
• Tentang kueri yang dikelola

REST API

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

• Referensi API REST Azure DevOps Services
• Queries
• Bahasa pencarian item kerja
• Mengambil item kerja menggunakan kueri secara programatik