Bidang kueri, operator, dan makro di Azure Boards

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Di sini Anda akan menemukan deskripsi terperinci tentang setiap jenis data bidang, operator kueri, dan makro kueri. Beberapa jenis data, operator, dan makro hanya valid untuk versi Azure DevOps yang ditunjukkan.

Untuk referensi cepat tugas kueri dan operator dan makro yang didukung untuk setiap jenis data, lihat Referensi cepat kueri. Lihat juga Membuat kueri/Praktik terbaik.

Tipe dan nilai data bidang kueri

Nilai yang Anda tentukan untuk bidang harus sesuai dengan jenis data untuk bidang tersebut. Tabel berikut ini mencantumkan tipe data yang didukung:

Catatan

Untuk layanan awan Azure Boards, jenis data sesuai dengan yang tercantum untuk bidang di halaman Bidang Proses>. Untuk penyebaran lokal, jenis data sesuai dengan atribut yang typeFIELD ditetapkan ke definisi. Untuk informasi selengkapnya, lihat Bidang item kerja dan atribut bidang.

Jenis data

Keterangan

Boolean

Menentukan bidang yang mengambil nilai True/False.

TanggalWaktu atau Tanggal/Waktu

Bidang tanggal di mana Anda dapat menentukan variabel, seperti @Today atau @Today-1, atau nilai, seperti 1/1/2023. Masukkan tanggal dalam Pola Tanggal yang Anda tetapkan untuk profil pribadi Anda. (Lihat Atur preferensi pribadi untuk detailnya.) Untuk contoh kueri, lihat Query by date or @CurrentIteration.

Untuk kueri WIQL, Anda juga dapat menentukan tanggal dalam pola Waktu Universal Terkoordinasi (UTC). Untuk informasi selengkapnya, lihat Sintaks untuk Work Item Query Language (WIQL).

Ganda atau Desimal

Angka riil, seperti 0,2 atau 3,5. Untuk contoh kueri, lihat Kueri menurut bidang numerik.

GUID

String karakter yang mewakili ID unik.

Riwayat

Bidang terformat kustom yang digunakan untuk melacak informasi historis. Tipe data ini hanya digunakan untuk mendukung bidang Riwayat . Bidang ini secara otomatis diindeks untuk pencarian teks lengkap saat pencarian teks lengkap tersedia. Lihat Pencarian teks lengkap dan kata parsial yang dijelaskan nanti di artikel ini. Untuk contoh kueri, lihat Riwayat dan audit.

HTML

String teks yang mendukung deskripsi berformat, seperti bidang Deskripsi atau Langkah Repro. Bidang ini secara otomatis diindeks untuk pencarian teks lengkap saat pencarian teks lengkap tersedia. Lihat Pencarian teks lengkap dan kata parsial yang dijelaskan nanti di artikel ini. Untuk mengkueri bidang teks kaya, lihat Kueri menurut judul, ID, dan bidang teks kaya.

Identitas

String teks pendek yang mengidentifikasi identitas pengguna.

Bilangan bulat

Bilangan bulat 32-bit yang ditandatangani, seperti 0, 1, 2, 34.

Bidang Teks Biasa atau Teks (multibaris)

String teks yang mendukung deskripsi panjang, seperti bidang Informasi Mulai Aplikasi. Bidang ini secara otomatis diindeks untuk pencarian teks lengkap, saat pencarian teks lengkap tersedia. Lihat Pencarian teks lengkap dan kata parsial yang dijelaskan nanti di artikel ini. Untuk mengkueri bidang teks biasa, lihat Kueri menurut judul, ID, dan bidang teks kaya.

picklistDouble¹

Bidang kustom yang ditentukan untuk berisi daftar pemilihan nilai Desimal.

picklistInteger¹

Bidang kustom yang ditentukan untuk berisi daftar pemilihan nilai Bilangan Bulat.

picklistString¹

Bidang kustom yang ditentukan untuk berisi daftar pemilihan nilai string teks pendek (255 karakter atau kurang).

Bidang String atau Teks (baris tunggal)

String teks pendek yang dapat berisi hingga 255 karakter Unicode. Bidang teks string sering digunakan untuk mendukung daftar pilih atau menu drop-down.

TreePath

Struktur pohon bercabang, seperti Jalur Area atau jalur Iterasi. Pilih item dari daftar nilai yang valid. Temukan item kerja yang sama, tidak sama, di bawah atau tidak di bawah struktur pohon, atau gunakan operator Masuk atau Tidak Dalam untuk menentukan beberapa nilai. Anda menentukan struktur pohon untuk proyek—jalur area dan jalur iterasi—lalu pilih yang ingin Anda kaitkan dengan tim.

Untuk informasi selengkapnya tentang membuat kueri, lihat Kueri menurut area atau jalur perulangan atau Kueri menurut tanggal atau perulangan saat ini.

Catatan

1. Daftar pilih... jenis data hanya ditetapkan ke bidang kustom yang ditentukan untuk proses yang diwariskan. Model proses yang diwariskan hanya didukung untuk Azure DevOps Services dan Azure DevOps Server 2019.

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 untuk Waktu dan Lokal.

Operator kueri

Anda bisa menggunakan operator kueri dalam tabel berikut untuk menentukan bagaimana setiap nilai dalam klausa harus berhubungan dengan nilai yang sesuai dalam item kerja. Untuk informasi tentang tipe data yang ditetapkan ke bidang item kerja, lihat Referensi bidang item kerja.

Untuk mempelajari tentang menambahkan klausa dan penggunaan operator Dan/Atau, lihat Menentukan kueri.

Operator kueri

Mengembalikan item kerja jika nilai dalam item kerja cocok dengan kriteria yang tercantum

Jenis data yang berlaku

=

Cocok dengan nilai dalam klausa.

Angka—yang mencakup Double, GUID, Integer—dan String, DateTime, dan TreePath

<>

Tidak cocok dengan nilai dalam klausa.

Angka, String, DateTime, dan TreePath

>

Lebih besar dari nilai dalam klausa.

Angka, String, dan DateTime

<

Kurang dari nilai dalam klausa.

Angka, String, dan DateTime

>=

Lebih besar dari atau sama dengan nilai dalam klausa.

Angka, String, dan DateTime

<=

Kurang dari atau sama dengan nilai dalam klausa.

Angka, String, dan DateTime

=[Bidang]

Cocok dengan nilai yang terkandung dalam bidang yang ditentukan.

Nama bidang dengan tipe data yang sama dengan bidang yang ditentukan

<>[Bidang]

Tidak cocok dengan nilai yang terkandung dalam bidang yang ditentukan.

Nama bidang dengan tipe data yang sama dengan bidang yang ditentukan

>[Bidang]

Lebih besar dari nilai yang terkandung dalam bidang yang ditentukan.

Nama bidang dengan tipe data yang sama dengan bidang yang ditentukan

<[Bidang]

Kurang dari nilai yang terkandung dalam bidang yang ditentukan.

Nama bidang dengan tipe data yang sama dengan bidang yang ditentukan

>=[Bidang]

Lebih besar dari atau sama dengan nilai yang terkandung dalam bidang yang ditentukan.

Nama bidang dengan tipe data yang sama dengan bidang yang ditentukan

<=[Bidang]

Kurang dari atau sama dengan nilai yang terkandung dalam bidang yang ditentukan.

Nama bidang dengan tipe data yang sama dengan bidang yang ditentukan

Berisi

Berisi kecocokan persis atau parsial string teks dalam bidang yang Anda pilih untuk pemfilteran.

String

Tidak Berisi

Tidak berisi kecocokan persis atau parsial dari string teks dalam bidang yang Anda pilih untuk pemfilteran.

String

Berisi Kata-kata

Berisi string teks atau kata yang tepat dalam bidang yang Anda pilih untuk pemfilteran. Anda juga dapat memasukkan sebagian kata atau frasa yang berisi karakter kartubebas, *. String teks dibatasi hingga 100 karakter. Untuk pembatasan, lihat Pencarian teks lengkap untuk server dan persyaratan kolase.

Bidang teks panjang yang diindeks untuk pencarian teks lengkap, yang sesuai dengan semua bidang Teks Biasa dan HTML , dan bidang Riwayat dan Judul .

Tidak Berisi Kata

Tidak berisi string teks atau kata yang tepat dalam bidang yang Anda pilih untuk pemfilteran. String teks dibatasi hingga 100 karakter.

Gunakan operator ini dalam kombinasi dengan klausul dengan operator Contains Words untuk menyertakan dan mengecualikan kata kunci tertentu.

Bidang teks yang diindeks untuk pencarian teks lengkap.

In

Cocok dengan nilai apa pun dalam set yang dibatasi. Misalnya, Anda dapat menemukan item kerja yang ID-nya adalah 100, 101, dan 102 jika Anda menentukan nilai tersebut untuk bidang ID. Pisahkan nilai dengan pemisah daftar yang sesuai dengan pengaturan regional yang ditentukan untuk komputer klien Anda. Misalnya, Anda mungkin menggunakan koma(,).

Angka, String, DateTime, TreePath

Kosong

Mencantumkan item kerja yang berisi bidang HTML kosong. Anda tidak menentukan nilai dengan operator ini. Operator ini didukung untuk Azure Boards (layanan cloud), Azure DevOps Server 2019, dan versi yang lebih baru.

HTML

Tidak Kosong

Mencantumkan item kerja yang berisi beberapa konten di bidang HTML. Anda tidak menentukan nilai dengan operator ini. Operator ini didukung untuk Azure Boards (layanan cloud), Azure DevOps Server 2019, dan versi yang lebih baru.

HTML

Tidak Dalam

Tidak cocok dengan nilai apa pun dalam set yang dibatasi. Anda dapat mengecualikan item kerja yang statusnya tidak Diselesaikan, Selesai, atau Ditutup dari hasil kueri jika Anda menentukan nilai tersebut untuk bidang Status. Pisahkan nilai dengan pemisah daftar yang sesuai dengan pengaturan regional yang ditentukan untuk komputer klien Anda. Misalnya, Anda mungkin menggunakan koma(,).

Operator Not In tersedia dari Azure Boards dan TFS 2018.2 dan versi yang lebih baru.

Angka, String, DateTime, TreePath

Dalam Grup

Cocok dengan nilai yang merupakan anggota grup dalam klausa. Grup sesuai dengan nama tim, grup keamanan, atau kategori pelacakan kerja. Misalnya, Anda dapat membuat kueri untuk menemukan semua item kerja yang ditetapkan untuk anggota grup Kontributor atau ke tim. Grup tim dibuat saat Anda membuat tim. Nama grup tim mengikuti pola [Nama Proyek Tim]\Nama Tim.

Misalnya kueri, lihat Kueri menurut penugasan atau perubahan alur kerja.

String yang cocok dengan nama tim, grup keamanan, atau kategori yang ditentukan dalam sistem.

Catatan

Anda bisa menggunakan operator Dalam Grup hanya dengan bidang yang menggunakan tipe data String atau bidang Tipe Item Kerja. Anda juga dapat menggunakan grup yang ditentukan dalam ID Microsoft Entra saat akun Azure Boards Anda didukung oleh ID Microsoft Entra, atau Direktori Aktif saat instans server lokal Anda didukung oleh Direktori Aktif.

Untuk informasi tentang grup kategori, lihat Menggunakan kategori untuk mengelompokkan jenis item kerja.

Tidak dalam Grup

Tidak cocok dengan nilai yang merupakan anggota grup dalam klausa.

String yang cocok dengan nama grup pengguna di Team Foundation Server atau grup kategori yang ditentukan untuk proyek.

Catatan

Anda bisa menggunakan operator Tidak Dalam Grup hanya dengan bidang yang menggunakan jenis data String atau bidang Tipe Item Kerja. Anda juga dapat menggunakan grup yang ditentukan dalam ID Microsoft Entra saat akun Azure Boards Anda didukung oleh ID Microsoft Entra, atau Direktori Aktif saat instans server lokal Anda didukung oleh Direktori Aktif.

Tidak Di Bawah

Tidak cocok dengan nilai dalam klausul dan tidak terkandung di bawah simpul dalam klausa.

TreePath

Di bawah

Cocok dengan nilai dalam klausa atau terkandung di bawah simpul dalam klausa.

TreePath

Pernah

Cocok dengan nilai dalam klausa pada titik sebelumnya.

String , DateTime

Catatan

Pernah berada di bidang tanggal saat ini tidak didukung saat menggunakan Editor Kueri. Mereka hanya didukung saat melakukan WIQL langsung.

Tip

Dimungkinkan untuk menyimpulkan kueri menggunakan sintaks WIQL yang menggunakan operator, seperti Was Ever, untuk bidang tipe data lainnya daripada yang tercantum. Misalnya, Anda dapat menggunakan Was Ever dalam klausul menggunakan Jalur Iterasi. Misalnya, lihat Kueri menurut tanggal atau perulangan saat ini, Mencantumkan item kerja yang dipindahkan dari sprint.

Makro atau variabel kueri

Anda bisa menggunakan makro yang dijelaskan dalam tabel berikut untuk memfilter kueri Anda berdasarkan bidang tertentu.

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 bidang Tipe Item Kerja atau Status untuk mencari di semua jenis item kerja atau di semua status. Misalnya, Work Item Type=[Any] tidak akan menempatkan filter apa pun berdasarkan jenis item kerja.

---

@CurrentIteration

Gunakan dengan bidang Jalur Perulangan untuk memfilter item kerja yang ditetapkan ke sprint saat ini secara otomatis berdasarkan fokus atau konteks tim saat ini. Untuk contoh tertentu, lihat Kueri menurut tanggal atau perulangan saat ini.
Makro @CurrentIteration hanya berfungsi saat dijalankan dari portal web. Anda tidak dapat menggunakan makro saat menyalin atau mengkloning rangkaian pengujian dan kasus pengujian, menentukan pemberitahuan, atau dengan REST API.

---

@CurrentIteration +/- n

Gunakan dengan bidang Jalur Perulangan untuk memfilter kumpulan item kerja yang ditetapkan ke sprint saat ini +/- n sprint berdasarkan fokus atau konteks tim saat ini. Untuk contoh tertentu, lihat Kueri menurut tanggal atau perulangan saat ini.
Makro @CurrentIteration +/- n didukung untuk Azure Boards, Azure DevOps Server 2019 dan versi yang lebih baru, dan hanya saat dijalankan dari portal web.

---

@Follows

Gunakan dengan bidang ID dan Operator di untuk mencantumkan semua item kerja yang Anda ikuti dalam proyek. Untuk mempelajari selengkapnya tentang fitur Ikuti, lihat Mengikuti item kerja atau permintaan pull. Anda bisa menampilkan daftar yang sama ini dari halaman Item Kerja, Tampilan pivot berikut.
Makro @Follows hanya didukung saat dijalankan dari portal web.

---

@Me

Gunakan dengan bidang identitas atau akun pengguna untuk mencari item yang terkait dengan nama pengguna atau akun Anda secara otomatis. Misalnya, Anda dapat menemukan item kerja yang Anda buka dengan klausa Created By=@Me. Untuk contoh selengkapnya, lihat Kueri menurut penetapan, alur kerja, atau perubahan papan Kanban.

---

^{@MyRecentActivity 1}

Gunakan dengan bidang ID dan Operator di untuk mencantumkan item kerja yang telah Anda lihat atau perbarui dalam proyek dalam 30 hari terakhir. Anda dapat melihat daftar yang sama ini dari halaman Item Kerja, Tampilan pivot aktivitas saya.

---

@Project

Gunakan dengan bidang Proyek Tim untuk memfilter item kerja di proyek lain. Misalnya, Anda dapat menemukan semua item kerja di proyek yang saat ini dipilih dengan klausa Team Project=@Project. Sistem secara otomatis default untuk memfilter berdasarkan proyek saat ini. Untuk informasi selengkapnya, lihat Menentukan kueri, Kueri di seluruh proyek.

---

^{@RecentMentions 1}

Gunakan dengan bidang ID dan Operator di untuk mencantumkan item kerja tempat Anda disebutkan di bagian Diskusi. Anda dapat melihat daftar yang sama ini dari halaman Item Kerja, Tampilan pivot yang disebutkan.

---

^{@RecentProjectActivity 1}

Gunakan dengan bidang ID dan Operator di untuk mencantumkan item kerja yang baru saja diperbarui. Jumlah item kerja yang tercantum tergantung pada aktivitas pelacakan kerja proyek. Untuk proyek yang sangat aktif, makro mencantumkan item kerja yang telah diperbarui dalam proyek dalam 30 hari terakhir atau lebih. Namun, untuk proyek yang kurang aktif, daftar ini dapat mencakup item kerja yang lebih lama dari 30 hari. Anda dapat melihat daftar serupa dari halaman Item Kerja, Tampilan pivot yang baru saja dibuat, Baru diperbarui, dan Yang baru selesai. Jumlah item kerja yang dikembalikan dibatasi pada 5000.

---

^{@StartOfDay 2}

Gunakan dengan DateTime bidang untuk memfilter item kerja yang terkait dengan tanggal saat ini atau dengan offset plus/minus. Misalnya, Anda dapat menemukan semua item yang ditutup dalam seminggu terakhir dengan klausa Closed Date>=@StartOfDay-7. Untuk contoh selengkapnya, lihat Kueri menurut tanggal atau perulangan saat ini.

---

^{@StartOfMonth 2}

Gunakan dengan DateTime bidang untuk memfilter item kerja yang terkait dengan bulan ini atau dengan offset plus/minus. Misalnya, Anda dapat menemukan semua item yang dibuat dalam tiga bulan terakhir dengan klausa Created Date>=@StartOfMonth-3. Untuk contoh selengkapnya, lihat Kueri menurut tanggal atau perulangan saat ini.

---

^{@StartOfWeek 2}

Gunakan dengan DateTime bidang untuk memfilter item kerja yang terkait dengan minggu ini atau dengan offset plus/minus. Misalnya, Anda dapat menemukan semua item yang diubah dalam dua minggu terakhir dengan klausa Changed Date>=@StartOfWeek-2. Untuk contoh selengkapnya, lihat Kueri menurut tanggal atau perulangan saat ini.

---

^{@StartOfYear 2}

Gunakan dengan DateTime bidang untuk memfilter item kerja yang terkait dengan tahun ini atau dengan offset plus/minus. Misalnya, Anda dapat menemukan semua fitur yang memiliki Tanggal Target yang dijadwalkan dalam tahun ini dengan klausa Target Date>=@StartOfYear. Untuk contoh selengkapnya, lihat Kueri menurut tanggal atau perulangan saat ini.

---

@TeamAreas

Hanya gunakan dengan bidang Jalur Area untuk memfilter item kerja yang jalur areanya sesuai dengan yang ditetapkan ke tim tertentu. Mengharuskan = Anda menggunakan operator. Misalnya, Anda dapat menemukan semua item yang ditetapkan ke jalur area yang ditetapkan ke tim Web dengan klausa Area Path=@TeamAreas [Fabrikam Fiber]\Web. Untuk contoh selengkapnya, lihat Kueri menurut area atau jalur perulangan.
Makro @TeamAreas didukung untuk Azure DevOps Server 2019 dan versi yang lebih baru, dan hanya saat dijalankan dari portal web.

---

@Today

Gunakan dengan bidang untuk memfilter item kerja yang terkait dengan DateTime tanggal saat ini atau ke tanggal sebelumnya. Anda juga dapat mengubah makro @Today dengan mengurangi hari. Misalnya, Anda dapat menemukan semua item yang dibuat dalam seminggu terakhir dengan klausa Created Date>=@Today-7. Untuk contoh selengkapnya, lihat Kueri menurut tanggal atau perulangan saat ini.

---

Catatan

1. Makro @MyRecentActivity, @RecentMentions, dan @RecentProjectActivity didukung untuk TFS 2018.2 dan versi yang lebih baru.
2. Makro @StartOfDay, @StartOfWeek, @StartOfMonth, dan @StartOfYear didukung untuk Azure DevOps Server 2019 Update 1 dan versi yang lebih baru.

Pencarian teks lengkap dan kata parsial

Tentukan Berisi atau Tidak Berisi untuk mencari kecocokan tepat atau sebagian kata atau frasa. Operator ini memfilter item berdasarkan indeks pencarian teks lengkap yang dibuat untuk bidang teks panjang. Tentukan Berisi Kata atau Tidak Berisi Kata untuk mencari terhadap frasa yang tepat atau untuk menggunakan karakter kartubebas, *. Operator ini menggunakan indeks pencarian teks lengkap. Anda hanya dapat menggunakan karakter kartubebas di akhir kata atau frasa parsial.

Misalnya, lihat Contoh kueri item kerja dan Kueri untuk item kerja menggunakan bidang Riwayat.

Catatan

Tidak semua penyebaran mendukung pencarian teks lengkap. Misalnya, SQL Express dan SQL Azure, yang mendukung layanan cloud, tidak mendukung pencarian teks lengkap. Dalam instans ini, Anda hanya melihat operator Berisi dan Tidak Berisi .

Artikel terkait

• Referensi cepat kueri
• Tentang kueri terkelola
• Indeks bidang item kerja
• Sintaks untuk Bahasa Kueri Item Kerja (WIQL)

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