Bagikan melalui


Melacak pekerjaan Anda dengan menggunakan kueri terkelola di Azure Boards

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

Cantumkan bug, cerita pengguna, atau item kerja lainnya berdasarkan kriteria bidang yang Anda tentukan menggunakan kueri. Anda kemudian dapat meninjau daftar ini dengan tim, pekerjaan triase, atau item kerja pembaruan massal Anda. Bersama dengan kueri terkelola, alat pencarian semantik menyediakan beberapa fungsionalitas yang tumpang tindih dan berbeda yang layak dijelajahi.

Gunakan kueri terkelola untuk mendukung operasi ini:

  • Pembaruan massal item kerja menggunakan portal web
  • Triase dan perbarui item kerja
  • Meninjau hierarki item kerja
  • Berbagi daftar item kerja dengan anggota tim

Anda dapat membuat kueri dan folder kueri dari portal web atau dari Visual Studio Team Explorer. Perubahan yang Anda buat dalam satu klien tercermin di klien lain karena semua perubahan disimpan di penyimpanan data pelacakan kerja.

Mulai menggunakan kueri

Jika Anda baru memulai, baca Menampilkan, menjalankan, atau mengirim kueri item kerja melalui email. Untuk referensi cepat ke tugas editor kueri dan kueri sampel, lihat Referensi cepat kueri.

  • Untuk menemukan item kerja yang ditetapkan untuk Anda, tambahkan makro @Me sebagai nilai untuk bidang Ditetapkan Ke di salah satu klausa kueri.
  • Semua pengguna yang valid dengan akses standar dapat membuat kueri dan folder di bawah area Kueri Saya. Untuk membuat kueri dan folder kueri di bawah Kueri Bersama, Anda harus memiliki kumpulan izin Kontribusi. Untuk informasi selengkapnya, lihat Mengatur izin pada kueri.
  • Anda dapat mengubah kueri apa pun dengan menambahkan kriteria untuk fokus pada area produk, iterasi, atau bidang lain. Untuk mengubah kueri, buka editor kueri.
  • Anda bisa membuka kueri apa pun di Excel. Anda juga bisa memperbarui bidang dari satu atau beberapa item kerja dan menerbitkan perubahan Anda ke database untuk melacak item kerja.
  • Anda bisa memvisualisasikan status atau kemajuan dengan membuat bagan pai, bagan kolom, atau bagan tren untuk kueri daftar datar.

Kemampuan kueri

Bagian berikut ini memberikan gambaran umum tentang fungsi yang didukung untuk menentukan dan mengelola kueri item kerja.

  • Filter kueri ditentukan melalui Editor Kueri.
  • Makro kueri dapat dipilih untuk bidang tertentu untuk membuat klausa kueri.
  • Hasil kueri dan fitur manajemen kueri adalah kemampuan yang tersedia melalui halaman Hasil Kueri.

Filter kueri

Tabel berikut ini meringkas fungsi filter kueri yang didukung oleh setiap versi Azure DevOps.

Catatan

Kueri terkelola tidak mendukung pencarian kedekatan, namun pencarian semantik melakukannya. Selain itu, pencarian semantik mendukung dan * ? sebagai karakter kartubebas dan Anda dapat menggunakan lebih dari satu karakter kartubebas untuk mencocokkan lebih dari satu karakter. Untuk informasi selengkapnya, lihat Pencarian item kerja fungsi.


Fungsi filter

Dukungan kueri

Versi yang didukung


Pencarian string teks (teks tunggal, teks multibaris, teks kaya)

Pencarian tidak peka huruf besar/kecil.

Semua versi


Kartubebas = *

Semua versi


Temukan item kerja berdasarkan tautan langsung atau jenis tautan topologi/hierarkis.
Memfilter item kerja tertaut berdasarkan MODE (sintaks WIQL)

Semua versi


Klausa grup dan sarang menggunakan operator AND dan OR Boolean.

Semua versi


Temukan item kerja berdasarkan kecocokan bidang dengan nilai sebelumnya. Operator yang didukung: Was Ever Temukan item kerja berdasarkan nilai yang ditentukan pada tanggal tertentu. Operator yang didukung: ASOF (sintaks WIQL)

Semua versi


Gunakan makro untuk membuat kueri relatif terhadap tanggal, alat lain, seperti jalur area tim, perulangan tim, dan lainnya.

Semua versi


Temukan item kerja dalam satu atau beberapa proyek di organisasi atau koleksi. Defaultnya adalah proyek saat ini. Gunakan bidang Proyek Tim untuk mengkueri dua proyek atau lebih.

Semua versi


Temukan item kerja berdasarkan bagaimana dua bidang dibandingkan satu sama lain.
Operator yang didukung: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]

Semua versi


Temukan item kerja berdasarkan apakah item tersebut berisi atau tidak berisi tag. Operator yang didukung: Contains, Does Not Contain

Semua versi


Temukan item kerja berdasarkan bidang teks HTML/kaya kosong atau tidak kosong.
Operator yang didukung: Is Empty, Is Not Empty

Azure DevOps 2019 melalui Azure DevOps Server 2022, Azure DevOps Services


Temukan pekerjaan yang nilai bidangnya cocok dengan nilai apa pun dalam set yang dibatasi, seperti sekumpulan jenis item kerja, status alur kerja, atau nilai daftar pilih. Pisahkan nilai dengan pemisah daftar yang sesuai dengan pengaturan regional yang ditentukan untuk komputer klien Anda. Misalnya, Anda mungkin menggunakan koma(,).

Semua versi


Temukan item kerja berdasarkan nilai bidang boolean.

Semua versi


Temukan item kerja berdasarkan kata kunci atau frasa yang ditambahkan melalui Diskusi.

Semua versi


Temukan item kerja berdasarkan kolom, swimlane, atau status Doing/Done.

Azure DevOps 2019 melalui Azure DevOps Server 2022, Azure DevOps Services


Memfilter hasil kueri berdasarkan kata kunci atau pilih bidang.

Azure DevOps 2019 melalui Azure DevOps Server 2022, Azure DevOps Services


Untuk memindahkan, menyalin, atau menempelkan klausa kueri secara massal, instal dan gunakan editor WIQL.

Makro yang didukung

Tabel berikut ini meringkas makro atau variabel kueri yang didukung oleh versi Azure DevOps. Anda dapat menggunakan beberapa makro ini untuk memfilter pemberitahuan.

Catatan

Anda hanya dapat menggunakan makro tertentu dari portal web. Ini termasuk makro @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity, dan @TeamAreas . Makro ini tidak didukung saat mengekspor kueri ke Excel, filter pemberitahuan, atau yang dilakukan dari Team Explorer, atau REST API.

Untuk deskripsi dan tautan yang lebih rinci ke contoh, lihat Bidang kueri, operator, dan makro.


Makro

Dukungan kueri

Versi yang didukung


Temukan jenis item kerja apa pun, Work Item Type=[Any], atau Status apa pun, State=[Any].

Semua versi


@Me

Temukan pekerjaan di mana Identity field=logged in user.

Semua versi


Temukan pekerjaan di mana Date-Time field=today.

Semua versi


Temukan pekerjaan yang ditentukan dalam satu atau beberapa proyek.

Semua versi


Temukan pekerjaan yang ditentukan dalam iterasi saat ini untuk tim.

Semua versi


Temukan pekerjaan yang ditentukan dalam +/- n perulangan saat ini untuk tim.

Azure DevOps 2019 melalui Azure DevOps Server 2022, Azure DevOps Services


Temukan pekerjaan saat ini yang masuk pengguna adalah berikut, ID In @Follows.

Semua versi


Temukan item kerja yang baru saja diubah, ID In @MyRecentActivity Lihat juga Menampilkan dan menambahkan item kerja, halaman Item Kerja.

Semua versi


Temukan pekerjaan di mana bidang tanggal-waktu yang dipilih berada dalam hari, bulan, minggu, atau tahun saat ini dengan offset plus/minus, misalnya: Closed Date>=@StartOfDay-7.

Azure DevOps 2019 melalui Azure DevOps Server 2022, Azure DevOps Services


Temukan pekerjaan yang ditetapkan ke Jalur Area atau Jalur Perulangan tim tertentu, misalnya, lihat Kueri menurut area atau jalur perulangan.

Azure DevOps 2019 melalui Azure DevOps Server 2022, Azure DevOps Services


Hasil kueri dan fitur manajemen kueri

Fitur berikut ini menyediakan dukungan untuk bekerja dengan hasil kueri, menyimpan dan berbagi kueri, dan banyak lagi.



Fitur yang tidak didukung

Kueri item kerja hanya mendukung kueri item kerja dan item kerja yang ditautkan ke item kerja lainnya. Berikut adalah beberapa tugas yang tidak didukung kueri terkelola:

  • Tampilan hierarkis Rencana Pengujian, Test Suites, dan Kasus Pengujian. Item ini tidak ditautkan bersama-sama menggunakan jenis tautan induk-turunan. Sebagai gantinya, Anda dapat melihat hierarki melalui>halaman Uji Paket.
  • Tampilan memperlihatkan objek tertaut seperti build, rilis, kode, atau objek item non-kerja lainnya.
  • Mencantumkan item kerja yang ditautkan dari satu proyek ke proyek lainnya.
  • Ekspor kueri lintas proyek ke Excel. Kueri tautan langsung diekspor ke Excel sebagai daftar datar.

Azure Boards mendukung tiga jenis kueri. Ikon di samping setiap kueri menunjukkan jenis kueri. Gunakan panduan berikut untuk memilih jenis kueri berdasarkan apa yang ingin Anda capai dengan kueri.

Daftar ikon tipe kueri


Jenis kueri

Panduan penggunaan


Daftar datar item kerja

  • Mencantumkan item untuk melakukan pembaruan massal ke bidang
  • Triase daftar item kerja
  • Membuat bagan kueri dan menambahkannya ke dasbor
  • Membuat bagan untuk mendapatkan hitungan item atau menjumlahkan bidang
  • Mengekspor daftar item ke Excel untuk memperbarui bidang

Item kerja dan tautan langsung

  • Mencantumkan item yang bergantung pada item kerja lainnya
  • Menemukan item yang terkait atau bergantung pada item kerja lainnya
  • Mencantumkan item kerja tertaut untuk melakukan pembaruan massal ke bidang
  • Triase daftar item kerja tertaut
  • Mencantumkan item kerja tertaut terkait pengujian
  • Menemukan item backlog tanpa induk, item kerja yang tidak memiliki induk

Catatan

Item kerja dan kueri tautan langsung diekspor ke Excel sebagai daftar datar. Kueri tautan langsung diimpor sebagai daftar datar karena memodifikasi beberapa tipe tautan bukanlah fitur yang didukung di Excel.


Pohon item kerja

  • Mencantumkan pohon item kerja terkait Induk-Anak, atau jenis tautan topologi pohon lainnya
  • Triase daftar hierarkis item kerja
  • Mengekspor daftar hierarkis item ke Excel untuk memperbarui bidang atau mengubah hierarki

Untuk mempelajari selengkapnya tentang jenis tautan, lihat Referensi jenis tautan.

Kueri, Kueri Bersama, dan Favorit Saya

Hanya Anda yang dapat melihat dan menjalankan kueri yang Anda simpan di bawah Kueri Saya dengan direktori kueri. Selain itu, Anda dapat memfavoritkan salah satu kueri ini agar muncul dalam pemilih kueri Anda.

Kueri yang Anda dan orang lain simpan di bawah Kueri Bersama dapat dilihat oleh semua orang dengan akses ke proyek. Kueri bersama dapat diatur dalam folder dan disukai oleh Anda atau untuk tim. Selain itu, Anda dapat mengatur izin pada folder dan kueri untuk mencegah orang lain memindahkan atau mengeditnya.

Untuk informasi selengkapnya, lihat:

Direktori kueri, folder kueri, dan remah roti

Halaman Kueri berisi tampilan berfokus pada direktori yang bisa Anda filter untuk menemukan kueri tertentu yang menarik. Saat bekerja di halaman Kueri , Anda bisa masuk ke subfolder, folder, atau halaman.

Kueri remah roti

Selain itu, Anda dapat memilih kueri yang telah Anda favoritkan dari menu pemilih. Atau, Anda dapat memilih untuk menelusuri semua kueri yang mengembalikan Anda ke halaman Semua Kueri .

Cuplikan layar Kueri, Pemilih kueri.

Untuk informasi selengkapnya, lihat Tanya Jawab Umum Kueri, Navigasi, dan Folder.

Bagan dan widget kueri

Anda dapat dengan cepat membuat bagan pai, batang, pivot, dan tren dari kueri daftar datar. Kueri harus berupa daftar datar dan mengembalikan 1000 item kerja atau kurang. Anda bisa menambahkan bagan kueri Anda ke dasbor, mengganti, dan mengonfigurasi ulang bagan kueri.

Contoh bagan pai. Contoh bagan pivot.Contoh bagan batang. Contoh bagan tren.

Widget berbasis kueri menyediakan dukungan untuk menyajikan informasi kueri di dasbor. Misalnya, jumlah bug aktif atau daftar item kerja yang dapat Anda berinteraksi. Untuk mempelajari tentang bagan kueri dan widget, lihat artikel berikut ini:

Menambahkan bidang kustom untuk mendukung kueri

Untuk menambahkan bidang kustom untuk mendukung kebutuhan kueri Anda, lihat Mengkustomisasi pengalaman pelacakan kerja Anda.

Papan tugas versus item daftar kueri

Anda mungkin melihat dan bertanya-tanya mengapa konten papan tugas berbeda dari konten yang tercantum dengan kueri yang dibuat? Untuk informasi selengkapnya, lihat item papan tugas versus item daftar kueri.

Kueri pencarian teks lengkap dan pengaturan kolase

Untuk mendukung kueri pencarian teks lengkap, pengaturan kolase database SQL Server harus sesuai dengan bahasa yang memiliki pemecah kata yang terdaftar di SQL Server. Jika menggunakan bahasa yang tidak didukung, Anda dapat menerima hasil yang tidak terduga saat menjalankan kueri item kerja yang menentukan operator Berisi atau Berisi Kata dengan string teks.

Untuk informasi lebih lanjut, baca artikel berikut:

REST API

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