Menampilkan, menjalankan, atau mengirim kueri item kerja melalui email

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

Visual Studio 2022

Artikel ini menjelaskan cara mengakses dan berinteraksi dengan item kerja di Azure Boards dengan menjalankan dan berbagi kueri. Anda dapat melihat dan menjalankan kueri bawaan atau bersama untuk mengidentifikasi item kerja yang ditetapkan untuk Anda atau yang memenuhi kriteria lain.

Petunjuk / Saran

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

Prasyarat

• Proyek Azure DevOps yang memiliki item kerja yang ditetapkan atau diikuti oleh Anda, atau kueri yang ditentukan oleh atau dibagikan dengan Anda. Untuk menentukan kueri, lihat Menentukan kueri item kerja.

Kategori	Persyaratan
Tingkat akses	- Untuk melihat dan menjalankan kueri bersama: anggota proyek. - Untuk menambahkan dan menyimpan kueri bersama: Akses Dasar setidaknya .
Permissions	Setelan izin Kontribusi diubah menjadi Izinkan untuk folder yang ingin Anda tambahkan kueri ke dalamnya. 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.

Buka halaman Kueri

Untuk membuka halaman Kueri untuk proyek Anda, pilih Papan>Kueri. Halaman Kueri terbuka ke tab Favorit , memperlihatkan kueri yang Anda atau tim Anda pilih sebagai favorit. Untuk informasi selengkapnya, lihat Mengatur favorit pribadi atau tim.

Tab Favorit juga memperlihatkan kueri terakhir yang Anda buka di bawah Lanjutkan dari tempat terakhir Anda tinggalkan.

Untuk melihat semua kueri pribadi dan bersama di proyek Anda, pilih tab Semua di halaman Kueri . Tab Semua memperlihatkan kueri bawaan, kueri yang Anda tentukan, dan kueri yang dibagikan dalam proyek Anda. Perluas Kueri Saya, Kueri Bersama, dan folder lainnya untuk mengakses kuerinya.

Pada tab Semua dari halaman Kueri , folder Kueri Saya berisi kueri bawaan berikut ini selain yang Anda tentukan:

• Ditetapkan kepada saya menggunakan @Me makro untuk mencantumkan semua item kerja yang ditetapkan untuk Anda dalam proyek saat ini.
• Item kerja yang diikuti menggunakan makro @Follows , ID di @Follows, untuk mencantumkan semua item kerja yang Anda ikuti. Untuk informasi selengkapnya, lihat Mengikuti item kerja atau permintaan tarik.

Tugas yang didukung tab Semua dan Favorit

Anda bisa melakukan sebagian besar tugas untuk menampilkan dan menjalankan kueri dari tab Semua atau Favorit dari halaman Kueri , seperti yang ditunjukkan dalam tabel berikut ini.

Tugas	Favorit	Semua
Cantumkan semua kueri favorit, milik Anda atau tim tempat Anda berada	✔️
Daftar semua kueri atau kueri yang dibagikan untuk proyek saat ini		✔️
Tambahkan kueri ke favorit		✔️
Hapus favorit kueri	✔️	✔️
Saring daftar kueri	✔️	✔️
Memperluas atau menciutkan folder	✔️	✔️
Menjalankan kueri atau membuka menu konteks untuk kueri	✔️	✔️

Hanya kueri dan kueri bawaan yang Anda simpan di bawah Kueri Saya yang muncul di bawah Kueri Saya. Hanya kueri yang Anda favoritkan yang muncul di Favorit Saya. Hanya kueri yang disimpan di bawah Kueri Bersama yang dapat dibuat favorit oleh tim.

Saring daftar kueri

Masukkan kata kunci ke dalam kotak filter pada tab Favorit atau Semua halaman Kueri untuk memfilter kueri yang ditampilkan. Untuk informasi selengkapnya, lihat cara memfilter backlog, papan, kueri, dan rencana secara interaktif di Memfilter backlog, papan, kueri, dan rencana secara interaktif.

Menavigasi ke kueri dan folder

Dari tab Favorit atau Semua dari halaman Kueri , Anda bisa menavigasi untuk menemukan dan membuka kueri tertentu.

Pada tab Semua , halaman kueri bisa muncul secara langsung atau berada di folder atau subfolder. Anda bisa menavigasi ke folder, subfolder, atau halaman kueri.

Saat Anda membuat pilihan dan membuka folder, remah roti ditampilkan di bagian atas halaman.

Anda dapat memilih folder dalam navigasi breadcrumb untuk membuka folder.

Anda juga bisa membuka kueri favorit atau kembali ke halaman Semua kueri dari menu dropdown kueri yang terbuka.

Menjalankan kueri

Untuk menjalankan kueri dari tab Favorit atau Semua dari halaman Kueri , perluas foldernya jika perlu dan pilih kueri. Halaman Hasil kueri terbuka.

Anda juga bisa memilih ikon Tindakan lainnya di samping kueri pada halaman Kueri dan pilih Jalankan kueri atau opsi lain dari menu konteks.

Menjalankan kueri dari CLI Azure DevOps

Anda bisa menjalankan kueri Azure Boards dengan menggunakan perintah az boards di antarmuka baris perintah Azure DevOps. Untuk memulai, lihat Mulai dengan Azure DevOps CLI.

az boards query [--id] [--org] [--path] [--project] [--wiql] 

Parameter

• id: ID kueri yang sudah ada. Diperlukan kecuali --path atau --wiql ditentukan.
• wiql: Kueri dalam format Work Item Query Language (WIQL). Diabaikan jika --id atau --path ditentukan.
• path: Jalur kueri yang sudah ada. Diabaikan jika --id ditentukan.
• org: URL organisasi Azure DevOps, seperti --org https://dev.azure.com/MyOrganizationName/. Diperlukan kecuali dikonfigurasi sebagai default atau diambil menggunakan git config. Konfigurasikan organisasi default menggunakan az devops configure -d organization=ORG_URL.
• project: Nama proyek atau ID. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config. Konfigurasikan proyek default menggunakan az devops configure -d project=NAME_OR_ID.

Examples

Perintah berikut menjalankan kueri dengan ID yang ditentukan dan memperlihatkan hasilnya dalam format tabel.

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form

Perintah berikut menjalankan kueri WIQL dan memperlihatkan hasilnya dalam format tabel.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions

Mengirim email atau berbagi kueri

Dari tampilan Editor atau Hasil kueri, Anda bisa mengirim email daftar item kueri yang diformat ke anggota proyek atau menyalin URL kueri untuk dibagikan.

Pilih ikon Tindakan lainnya di kanan atas lalu pilih Kueri email atau Salin URL kueri dari menu konteks.

Anda hanya dapat mengirim email ke masing-masing anggota proyek yang dikenali sistem. Mengirim ke grup tim atau grup keamanan tidak didukung. Penerima harus memiliki izin untuk membaca item kerja yang dikirim.

Email dikirim melalui klien email default Anda, dan menyertakan tautan ke kueri yang hanya mengembalikan item kerja yang tercantum. Untuk informasi selengkapnya, lihat Menyalin atau mengkloning item kerja.

Catatan

Untuk mengirim daftar yang diformat melalui email kepada orang-orang yang bukan anggota proyek, lihat Menyalin atau mengirim email daftar item kerja.

Menampilkan item kerja di Visual Studio

Pada halaman Work Items Visual Studio Team Explorer, Anda dapat mencantumkan item kerja untuk proyek yang tersambung. Pembuatan dan manajemen kueri harus dilakukan di antarmuka web Azure Boards.

Di panel Pencarian Item Kerja , Anda bisa menerapkan filter untuk menampilkan item kerja yang tercantum menurut Ditetapkan ke, Dibuat oleh, Status, atau Tipe Item Kerja.

Anda bisa mengembangkan daftar Item Kerja dan memilih panah dropdown di samping tampilan saat ini untuk memilih tampilan default Ditetapkan kepada Saya, Mengikuti, Disebutkan, atau Aktivitas Saya.

Untuk item kerja individual yang tercantum, Anda dapat:

• Arahkan mouse ke atas item kerja untuk menampilkan informasi.
• Pilih judul item kerja untuk mengganti nama item kerja.
• Klik kanan item kerja untuk menetapkannya kepada diri Anda sendiri atau untuk menyelesaikan item kerja.
• Klik dua kali item atau klik kanan dan pilih Buka untuk membuka item kerja di UI Azure Boards.

Anda juga dapat membuat item kerja dengan memilih Item Kerja Baru dan memasukkan judul item kerja. Perubahan yang Anda lakukan melalui Visual Studio tercermin dalam Azure Boards.

Langkah selanjutnya

Mendefinisikan kueri item kerja

Menggunakan AI untuk menelusuri item kerja

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 tanpa membangun kueri formal.

Tugas	Contoh perintah
Temukan item kerja saya	Show all active work items assigned to <me> in my project
Kueri menurut status	List all bugs in the Resolved state for the current sprint
Cari di seluruh kriteria	Find user stories created in the last 7 days that are still in the New state
Mendapatkan detail item kerja	Show me the details for work item 1234 including all comments
Dasbor cepat untuk tim	Show active work items for each team member in the current sprint for <Contoso> with their states
Daftar triase pagi	List all new and unassigned work items in <Contoso> created since yesterday, sorted by priority
Ringkasan akhir hari	Show work items I updated today in <Contoso> with what changed
Mengidentifikasi pekerjaan yang terblokir	Find active work items in the current sprint for <Contoso> that are tagged "blocked" or have the word "blocked" in their latest comment
Meninjau hasil kueri menurut jenis	Show active work items in <Contoso> grouped by work item type with counts
Daftar siap ekspor	List all completed user stories in the current sprint for <Contoso> with ID, title, story points, and closed date

Catatan

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

Konten terkait

• Mengelola permintaan dan folder permintaan
• Memfilter daftar tugas tertunda, papan tugas, kueri, dan rencana secara interaktif
• FAQ tentang kueri di Azure Boards