Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Artikel ini menjelaskan tipe data bidang, operator kueri, dan makro kueri yang Anda gunakan di Query Editor. Beberapa jenis, operator, dan makro hanya berlaku untuk versi Azure DevOps tertentu.
Untuk contoh cepat dan tugas editor, lihat Referensi cepat kueri dan Mengelola dan menata kueri.
Prasyarat
| Kategori | Persyaratan |
|---|---|
| Tingkat akses | - Untuk melihat dan menjalankan kueri bersama-sama: anggota proyek. - Untuk menambahkan dan menyimpan kueri bersama: Setidaknya akses Dasar. |
| Permissions | Izin Kontribusi diatur ke Izinkan untuk folder yang ingin Anda tambahkan kueri ke dalamnya. Secara default, grup Kontributor |
| Kategori | Persyaratan |
|---|---|
| Tingkat akses | - Untuk melihat dan menjalankan kueri bersama-sama: anggota proyek. - Untuk menambahkan dan menyimpan kueri yang dibagikan: Setidaknya akses Basic. |
| Permissions | Izin Kontribusi diatur ke Izinkan untuk folder yang ingin Anda tambahkan kueri ke dalamnya. Secara default, grup Kontributor |
Tipe dan nilai data bidang kueri
Anda harus menentukan nilai yang cocok dengan tipe data untuk bidang. Tabel di bawah ini mencantumkan jenis data yang didukung:
Catatan
Untuk Azure Boards (cloud), jenis data cocok dengan bidang yang ditampilkan pada halaman Process > Fields. Untuk implementasi lokal, tipe data sesuai dengan atribut
Jenis data
Keterangan
Boolean
Menyimpan nilai True/False.
TanggalWaktu atau Tanggal/Waktu
Gunakan variabel tanggal (misalnya, @Today atau @Today-1) atau tanggal eksplisit seperti 01/01/2025. Masukkan tanggal dalam pola yang diatur di profil Anda. Untuk contoh kueri, lihat Query by date or @CurrentIteration.
Untuk kueri WIQL, Anda juga dapat menentukan tanggal dalam UTC. Lihat Sintaks untuk Bahasa Kueri Item Kerja (WIQL).
Double atau Decimal
Menyimpan angka riil, seperti 0,2 atau 3,5. Lihat Kueri menurut bidang numerik misalnya.
GUID
Menyimpan teks pengidentifikasi unik.
Riwayat
Bidang terformat kustom yang digunakan untuk informasi historis (bidang Riwayat ). Saat pencarian teks lengkap tersedia, bidang ini diindeks untuk kueri teks lengkap. Lihat Riwayat dan audit.
HTML
Menyimpan teks berformat (misalnya, Deskripsi atau Langkah Repro). Saat pencarian teks lengkap tersedia, bidang ini diindeks. Untuk mengkueri bidang teks kaya, lihat Kueri menurut judul, ID, dan bidang teks kaya.
Identitas
Menyimpan string teks pendek yang mengidentifikasi identitas pengguna.
Bilangan bulat
Menyimpan bilangan bulat 32-bit yang ditandatangani (misalnya, 0, 1, 2, 34).
Bidang Teks Biasa atau Teks (multibaris)
Menyimpan nilai teks panjang (misalnya, Informasi Mulai Aplikasi). Bidang ini mengindeks untuk pencarian teks lengkap ketika didukung. Lihat Kueri menurut judul, ID, dan bidang teks kaya.
picklistDouble
Bidang kustom yang menyimpan daftar pilihan nilai Desimal.
picklistInteger
Bidang kustom yang menyimpan daftar pilihan nilai bilangan bulat.
picklistString
Bidang kustom yang menyimpan daftar pilihan nilai teks pendek (255 karakter atau kurang).
String atau Kolom Teks (satu baris)
Menyimpan teks pendek hingga 255 karakter Unicode. Teams sering menggunakan bidang ini untuk menu drop-down atau daftar pilihan.
TreePath
Mewakili pohon percabangan (misalnya, Jalur Area atau Jalur Iterasi). Pilih nilai simpul yang valid. Anda dapat memfilter kesetaraan, ketidaksetaraan, "Di bawah" / "Tidak Di Bawah," atau menggunakan In / Not In operator untuk menentukan beberapa nilai. Tentukan struktur pohon untuk proyek—jalur area dan jalur iterasi—dan pilih simpul yang akan dikaitkan dengan tim.
Untuk contoh kueri, lihat Kueri menurut area atau jalur perulangan dan Kueri menurut tanggal atau iterasi saat ini.
Catatan
Jenis picklist... hanya berlaku untuk bidang kustom yang ditentukan untuk proses yang diwariskan.
Pola tanggal dan waktu
Pola tanggal dan waktu yang Anda masukkan untuk bidang DateTime harus cocok dengan yang Anda pilih melalui profil Anda. Untuk melihat atau mengubah pilihan Anda, lihat Mengatur preferensi pengguna.
Operator kueri
Gunakan operator untuk menentukan bagaimana nilai klausul harus terkait dengan nilai bidang item kerja. Untuk tipe data bidang, lihat Referensi bidang item kerja. Untuk bantuan membangun kueri, lihat Menentukan kueri.
Operator kueri
Saat operator mengembalikan item kerja yang cocok
Jenis data yang berlaku
=
Cocok dengan nilai klausa.
Angka (Double/Desimal/GUID/Bilangan Bulat), String, TanggalWaktu, TreePath
<>
Tidak cocok dengan nilai klausul.
Angka, String, DateTime, TreePath
>
Lebih besar dari nilai klausul.
Angka, Teks, TanggalWaktu
<
Kurang dari nilai klausa.
Angka, Teks, TanggalWaktu
>=
Lebih besar dari atau sama dengan nilai klausul.
Angka, Teks, TanggalWaktu
<=
Kurang dari atau sama dengan nilai klausa.
Angka, Teks, TanggalWaktu
=[Bidang]
Cocok dengan nilai di bidang lain yang ditentukan (harus jenis data yang sama).
Nama bidang dengan tipe data yang sama (bidang Boolean membandingkan kesetaraan dengan bidang lain).
<>[Bidang]
Tidak cocok dengan nilai di bidang lain yang ditentukan.
Nama bidang dengan tipe data yang sama.
>[Bidang]
Lebih besar dari nilai di bidang lain yang ditentukan.
Nama bidang dengan tipe data yang sama.
<[Bidang]
Kurang dari nilai di dalam bidang lain yang telah ditentukan.
Nama bidang dengan tipe data yang sama.
>=[Bidang]
Lebih besar dari atau sama dengan nilai di bidang lain yang ditentukan.
Nama bidang dengan tipe data yang sama.
<=[Bidang]
Kurang dari atau sama dengan nilai di bidang lain yang ditentukan.
Nama bidang dengan tipe data yang sama.
Berisi
Berisi kecocokan teks yang tepat atau parsial.
String
Tidak Berisi
Tidak berisi kecocokan teks yang tepat atau parsial.
String
Berisi Kata-kata
Cocok dengan frasa atau kata yang tepat (mendukung wildcard * berikutnya). Batas: 100 karakter. Operator ini menggunakan pengindeksan teks lengkap; lihat bagian Teks lengkap dalam artikel ini untuk persyaratan server dan kolatasi.
Bidang teks panjang diindeks untuk pencarian teks lengkap (Teks Biasa, HTML, Riwayat, dan Judul).
Tidak Berisi Kata
Mengecualikan item yang berisi frasa atau kata yang ditentukan. Batas: 100 karakter. Gunakan dengan Contains Words dalam klausa pendamping untuk menyertakan atau mengecualikan kata kunci.
Bidang teks diindeks untuk pencarian teks lengkap.
Di
Cocok dengan nilai apa pun dalam set yang dibatasi (gunakan pemisah daftar regional OS Anda, biasanya koma).
Angka, String, DateTime, TreePath
Kosong
Cocok dengan item di mana bidang HTML tidak berisi konten (tidak ada nilai yang ditentukan). Didukung untuk Azure Boards dan Azure DevOps Server.
HTML
Tidak Kosong
Cocok dengan item di mana bidang HTML berisi isi. Didukung untuk Azure Boards dan Azure DevOps Server.
HTML
Tidak Termasuk
Mengecualikan nilai dalam set yang dibatasi (gunakan pemisah daftar regional). Didukung untuk Azure Boards dan Azure DevOps Server.
Angka, String, DateTime, TreePath
Dalam Grup
Mencocokkan nilai yang merupakan anggota dari grup bernama (tim, grup keamanan, atau kategori). Misalnya, gunakan grup Kontributor atau grup tim bernama dalam pola [Project Name]\Team Name. Lihat Kueri menurut penugasan atau perubahan alur kerja misalnya.
String (cocok dengan grup atau nama tim) atau Jenis Item Kerja
Catatan
Gunakan Di Dalam Grup hanya dengan bidang tipe String atau Tipe Item Kerja. Anda dapat menggunakan grup Microsoft Entra ID ketika akun Anda menggunakan Microsoft Entra ID, atau grup Active Directory untuk lokal. :::column-end:::
Tidak dalam Grup
Mengecualikan anggota grup bernama.
String yang cocok dengan grup pengguna atau kategori proyek.
Tidak di Bawah
Mengecualikan item yang sama dengan atau terkandung di bawah simpul pohon yang ditentukan.
TreePath
Di bawah
Mencocokkan item yang sama dengan atau yang terkandung di bawah simpul pohon yang ditentukan.
TreePath
Apakah Pernah
Cocok dengan nilai yang pernah disimpan oleh bidang pada waktu sebelumnya.
String, TanggalWaktu
Catatan
Query Editor saat ini tidak mendukung Was Ever pada bidang tanggal; gunakan WIQL langsung untuk kasus tersebut.
:::column-end:::
Tips
Anda dapat membuat kueri WIQL yang menggunakan operator (misalnya, Was Ever) terhadap jenis data lain seperti Jalur Perulangan. Lihat Daftar item kerja yang dipindahkan dari sprint sebagai contoh.
Kueri makro dan variabel
Gunakan makro berikut untuk memfilter kueri secara dinamis.
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.
Makro
Keterangan
[Apa saja]
Gunakan dengan Tipe Item Kerja atau Status untuk mencari di semua jenis atau status. Misalnya, Work Item Type=[Any] menghapus pemfilteran berbasis jenis.
@CurrentIteration
Gunakan dengan Jalur Perulangan untuk memfilter item kerja dalam sprint saat ini berdasarkan konteks tim saat ini. Lihat Kueri menurut tanggal atau perulangan saat ini misalnya. @CurrentIteration hanya berfungsi saat dijalankan dari portal web (bukan di REST API atau beberapa operasi salin/kloning).
@CurrentIteration +/- n
Gunakan dengan Jalur Perulangan untuk menyertakan sprint relatif terhadap iterasi saat ini (misalnya, @CurrentIteration-1 atau @CurrentIteration+2). Didukung di portal web untuk Azure Boards dan Azure DevOps Server.
@Follows
Gunakan dengan ID dan In operator untuk mencantumkan item kerja yang Anda ikuti dalam proyek. Lihat Mengikuti item kerja atau permintaan pull. Makro ini hanya berfungsi dari portal web.
@Me
Gunakan dengan bidang identitas untuk memfilter item yang ditautkan ke akun Anda (misalnya, Created By=@Me). Lihat Pencarian berdasarkan penugasan, alur kerja, atau perubahan pada papan.
@MyRecentActivity
Gunakan dengan ID dan In untuk mencantumkan item kerja yang Anda lihat atau perbarui dalam ~30 hari terakhir. Lihat halaman Item Kerja di tab Aktivitas Saya untuk daftar yang sama.
@Project
Gunakan dengan Proyek Tim untuk memfilter item kerja dalam proyek saat ini (misalnya, Team Project=@Project). Lihat Kueri antarproyek.
@RecentMentions
Gunakan dengan ID dan In untuk mencantumkan item kerja tempat Anda disebutkan dalam Diskusi. Lihat pivot yang Disebutkan di halaman Item Kerja.
@RecentProjectActivity
Gunakan dengan ID dan In untuk mencantumkan item kerja yang baru diperbarui di seluruh proyek. Makro mengembalikan hingga 5.000 item; jendela aktual tergantung pada aktivitas proyek.
@StartOfDay
Gunakan dengan bidang DateTime untuk memfilter relatif terhadap hari ini (misalnya, Closed Date>=@StartOfDay-7).
@StartOfMonth
Gunakan dengan bidang DateTime untuk memfilter relatif terhadap awal bulan (misalnya, Created Date>=@StartOfMonth-3).
@StartOfWeek
Gunakan dengan bidang DateTime untuk memfilter relatif terhadap awal minggu (misalnya, Changed Date>=@StartOfWeek-2).
@StartOfYear
Gunakan dengan bidang DateTime untuk memfilter relatif terhadap awal tahun (misalnya, Target Date>=@StartOfYear).
@TeamAreas
Gunakan hanya dengan Jalur Area dan operator = untuk menemukan item yang ditetapkan ke jalur area tim (misalnya, Area Path=@TeamAreas [Fabrikam Fiber]\Web). Didukung di portal web untuk Azure DevOps Server.
@Today
Gunakan dengan bidang DateTime untuk memfilter relatif terhadap hari ini (misalnya, Created Date>=@Today-7). Lihat Kueri menurut tanggal atau iterasi saat ini.
Pencarian teks lengkap dan kata parsial
Gunakan Berisi atau Tidak Berisi untuk mencari kecocokan persis atau parsial terhadap bidang teks panjang (operator ini menggunakan indeks kueri). Gunakan Berisi Kata atau Tidak Berisi Kata untuk mencari frasa yang tepat atau menggunakan wildcard berikutnya (*); operator ini memerlukan indeks teks lengkap.
Anda hanya dapat menggunakan wildcard di akhir sebagian kata atau frasa. Misalnya, lihat Contoh kueri item kerja dan Kueri untuk item kerja menggunakan kolom Riwayat.
Catatan
Tidak semua implementasi mendukung pencarian teks lengkap. Misalnya, SQL Express dan beberapa konfigurasi SQL cloud tidak mendukung pencarian teks lengkap. Dalam penerapan tersebut, operator Berisi dan Tidak Berisi adalah satu-satunya yang terlihat.
Azure DevOps Server mengindeks bidang teks panjang (Teks Biasa dan HTML) dan bidang Judul untuk pencarian teks lengkap saat SQL Server yang mendasarinya mendukung pengindeksan teks lengkap.
Pencarian teks lengkap juga memerlukan kolase SQL dengan pemecah kata terdaftar untuk bahasa yang Anda gunakan. Jika kolatasi database koleksi tidak cocok dengan bahasa yang didukung, hasil mungkin tidak cocok dengan harapan; dalam kasus tersebut gunakan Berisi atau Tidak Berisi sebagai gantinya.
Untuk informasi selengkapnya, lihat Pencarian Teks Penuh dan Pengaturan Kolasi.
Konten terkait
- Gunakan referensi cepat kueri
- Pelajari tentang kueri terkelola
- Mengakses indeks bidang item kerja
- Memahami sintaks WIQL
REST API
Untuk berinteraksi secara terprogram dengan kueri, lihat salah satu sumber daya REST API ini: