Menampilkan, menjalankan, atau mengirim kueri item kerja melalui email

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

Visual Studio 2019 | Visual Studio 2022

Untuk menemukan item kerja yang ditetapkan untuk Anda atau tim Anda, Anda bisa menjalankan kueri. Proses Anda dapat mencakup beberapa kueri yang telah ditentukan sebelumnya yang dapat Anda akses dan jalankan. Seringkali, lebih mudah untuk membuat kueri baru dengan memodifikasi definisi kueri yang sudah ada.

Catatan

Gambar browser yang digunakan dalam artikel ini berasal dari fitur hub papan baru, yang diaktifkan secara default. Jika fitur ini tidak diaktifkan, Anda mungkin menggunakan pengalaman papan sebelumnya. Untuk menampilkan gambar untuk pengalaman sebelumnya, pilih versi Azure DevOps Server 2022 dari artikel ini.

Prasyarat

• Tingkat akses:
  • Memiliki akses Pemangku Kepentingan untuk melihat dan menjalankan kueri bersama. Semua anggota proyek memiliki akses Pemangku Kepentingan secara default. Untuk informasi selengkapnya, lihat Mengubah izin untuk kueri atau folder bersama.
  • Memiliki akses Dasar atau yang lebih tinggi untuk menambahkan dan menyimpan kueri bersama.
• Izin: Atur izin Kontribusi Anda ke Izinkan folder yang ingin Anda tambahkan kuerinya. 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 Kueri

Browser

Dari proyek Anda, pilih Kueri Papan>, lalu pilih Semua.

Halaman Kueri terbuka ke tab Favorit yang mencantumkan kueri yang Anda tetapkan sebagai favorit. Anda dapat memilih tab Semua untuk melihat semua kueri yang Anda tentukan dan bagikan kueri untuk proyek.

Tip

Kueri yang Anda atau tim Anda pilih sebagai favorit muncul di halaman Favorit . Kueri favorit bersama dengan objek lain juga muncul di halaman Proyek Anda. Untuk informasi selengkapnya, lihat Mengatur favorit pribadi atau tim.

Visual Studio

Penting

Kami sangat menyarankan agar semua orang menggunakan tampilan default alih-alih tampilan warisan ini. Ini dirancang bagi Anda untuk dengan cepat mengakses daftar item kerja berdasarkan tugas Anda, mengikuti, disebutkan, atau pembaruan terbaru. Tampilan warisan tidak lagi ditingkatkan dan kami berharap untuk menghapusnya dalam rilis Visual Studio di masa mendatang.

1. Dari beranda Team Explorer, pilih Item Kerja.

   

2. Untuk membuka kueri, buka menu konteks untuk kueri (klik kanan dengan mouse Anda), dan pilih Tampilkan Hasil. Atau, klik dua kali kueri untuk membukanya.

   

Atau, pilih salah satu opsi berikut:

• Edit Kueri: Membuka Editor Kueri untuk kueri yang dipilih.
• Kueri Baru: Membuka Editor Kueri dengan opsi kueri baru default.
• Buka di Microsoft Excel (Datar): Membuka kueri di Microsoft Excel.
• Kirim ke Microsoft Outlook: Buka
• Potong: Memotong kueri. Anda kemudian dapat menempelkan kueri di bawah folder lain.
• Salin: Menyalin kueri. Anda kemudian dapat menempelkan kueri di bawah folder yang sama atau folder lain.
• Hapus: Menghapus kueri.
• Ganti nama: Memungkinkan Anda mengganti nama kueri.
• Tambahkan ke Favorit Saya: Menambahkan kueri ke bagian Favorit Saya.
• Tambahkan ke Favorit Tim: Menambahkan kueri ke bagian Favorit Tim.
• Keamanan: Membuka dialog Izin untuk kueri.

Menjalankan kueri di Azure Boards

Untuk menjalankan kueri apa pun, perluas folder dan pilih judul kueri. Tampilan terbuka untuk menampilkan Hasil kueri.

Anda juga dapat menjalankan kueri dengan menggunakan antarmuka baris perintah Azure DevOps.

Browser

Tip

Halaman Kueri , seperti halnya halaman portal web lainnya, mengingat tampilan yang terakhir Anda buka dan mengembalikan Anda ke tampilan tersebut.

1. Pilih Semua untuk membuka halaman tempat Anda bisa melihat semua kueri yang Anda tentukan atau yang dibagikan dalam proyek Anda.

   

2. Pilih Kueri Saya sesuai kebutuhan.

   • Untuk melihat semua item kerja yang ditetapkan untuk Anda, pilih Ditetapkan untuk saya. Kueri ini menggunakan makro @Me untuk mencantumkan semua item kerja yang ditetapkan untuk Anda.
   • Untuk menampilkan semua item kerja yang Anda ikuti, pilih Item kerja yang diikuti. Kueri ini menggunakan makro @Follows (ID masuk @Follows) untuk mencantumkan semua item kerja yang Anda ikuti. Untuk informasi selengkapnya, lihat Mengikuti item kerja atau permintaan pull.

3. Pilih Kueri Bersama untuk memperluas folder dan mengakses kueri yang disimpan sebagai kueri bersama.

Visual Studio

Penting

Kami sangat menyarankan agar semua orang menggunakan tampilan default alih-alih tampilan warisan ini. Ini dirancang bagi Anda untuk dengan cepat mengakses daftar item kerja berdasarkan tugas Anda, mengikuti, disebutkan, atau pembaruan terbaru. Tampilan warisan tidak lagi ditingkatkan dan kami berharap untuk menghapusnya dalam rilis Visual Studio di masa mendatang.

• Dari halaman Item Kerja Team Explorer, buka menu konteks untuk kueri (klik kanan dengan mouse Anda), dan pilih Tampilkan Hasil. Atau, klik dua kali kueri untuk membukanya.

  

Menjalankan kueri dari baris perintah

Anda bisa menjalankan kueri di CLI dengan perintah kueri papan az. Untuk memulai, lihat Mulai menggunakan Azure DevOps CLI.

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

Parameter

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

Contoh

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
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0 

Perintah berikut menjalankan kueri dengan WIQL yang ditentukan 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], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] 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
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in 

Direktori kueri, folder kueri, dan remah roti

Catatan

Anda tidak dapat menambahkan folder ke Favorit Saya atau Favorit Tim.

Browser

Halaman Kueri berisi Favorit dan tab Semua . Masing-masing berisi tampilan berfokus pada direktori yang dapat Anda filter untuk menemukan kueri tertentu yang menarik.

Saat Anda bekerja di halaman Kueri , Anda bisa masuk ke folder, subfolder, atau halaman kueri.

Anda juga bisa memilih kueri favorit atau kembali ke halaman Semua kueri dari menu drop-down kueri yang terbuka.

Visual Studio

Halaman Item Kerja menampilkan struktur folder yang sama seperti yang ditentukan di portal web. Perubahan yang Anda buat melalui Visual Studio tercermin di portal web.

Anda dapat memperluas dan menciutkan folder, mengganti nama folder, dan menyeret dan meletakkan kueri dari satu folder ke folder lainnya. Untuk informasi selengkapnya, lihat Mengelola dan menata kueri

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

Semua tugas yang didukung dan Favorit

Anda bisa melakukan sebagian besar tugas untuk menampilkan dan menjalankan kueri dari setiap halaman daftar kueri seperti yang ditunjukkan dalam tabel berikut ini. Hanya kueri yang Anda simpan di bawah Kueri Saya dan telah disukai muncul di bawah Favorit Saya. Hanya kueri yang disimpan di bawah Kueri Bersama yang dapat disukai oleh tim.

Tugas	Favorit (Browser)	Semua (Browser)	Item Pekerjaan (Team Explorer)
Lihat semua kueri favorit, milik Anda, atau tim milik Anda	✔️		✔️
Menampilkan semua kueri atau kueri bersama Anda untuk proyek saat ini		✔️	✔️
Jalankan kueri, buka menu konteks untuk kueri	✔️	✔️	✔️
Memperluas atau menciutkan folder kontainer atau folder kueri	✔️	✔️	✔️
Memfilter daftar kueri	✔️	✔️
Favoritkan kueri (untuk portal web, pilih )		✔️
Membatalkan favorit kueri (untuk portal web, pilih )	✔️	✔️	✔️
Menambahkan kueri baru: Pilih	✔️	✔️	✔️

Memfilter daftar kueri

Masukkan kata kunci ke dalam kotak filter untuk memfilter kumpulan kueri yang ditampilkan di halaman Favorit atau Semua . Untuk mempelajari selengkapnya tentang pemfilteran, lihat Memfilter backlog, papan, kueri, dan paket.

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

Mengirim email item kueri atau berbagi URL kueri

Browser

Dari tampilan Editor Kueri atau Hasil, Anda bisa mengirim email daftar item kueri yang diformat atau menyalin URL kueri.

Pilih ikon tindakan lainnya untuk membuka menu dan memilih dari opsi yang tercantum, Kueri email, atau Salin URL kueri.

Anda hanya dapat mengirim email ke alamat individual untuk anggota proyek yang dikenali sistem. Menambahkan grup tim atau grup keamanan ke baris "Ke" tidak didukung. Jika Anda menambahkan akun email yang tidak dikenali sistem, Anda menerima pesan bahwa satu atau beberapa penerima email Anda tidak memiliki izin untuk membaca item kerja yang dikirim.

Catatan

Untuk mengirim daftar berformat melalui email kepada orang-orang yang bukan anggota proyek, Anda harus menggunakan opsi Salin sebagai HTML yang dijelaskan dalam Menyalin daftar item kerja. Untuk Azure DevOps lokal, semua tindakan email memerlukan server SMTP untuk dikonfigurasi. Jika Anda tidak memiliki server SMTP yang dikonfigurasi, Anda dapat mengatasinya dengan menggunakan Salin sebagai HTML.

Visual Studio

Anda bisa mengirim daftar kueri yang diformat melalui email dengan memilih opsi Kirim ke Microsoft Outlook dari menu konteks.

Catatan

Fitur ini mengharuskan Anda menginstal Microsoft Outlook. Untuk Azure DevOps lokal, semua tindakan email memerlukan server SMTP untuk dikonfigurasi. Jika Anda tidak memiliki server SMTP yang dikonfigurasi, Anda dapat mengatasinya dengan menggunakan Salin sebagai HTML dari portal web.

Langkah berikutnya

Menentukan kueri

Artikel terkait

• Mengelola kueri dan folder kueri
• Memfilter backlog, papan, kueri, dan paket secara interaktif
• Ubah opsi kolom
• Mengatur favorit pribadi atau tim
• Pintasan keyboard