Bagikan melalui


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.

  • Tingkat akses: Secara default, semua anggota proyek dan pengguna dengan akses Pemangku Kepentingan dapat melihat dan menjalankan semua kueri bersama. Anda bisa mengubah izin yang diatur untuk folder kueri bersama atau kueri bersama. Untuk informasi selengkapnya, lihat Mengatur izin kueri.
  • Izin: Untuk menambahkan dan menyimpan kueri di bawah Kueri bersama, Anda harus diberikan akses Dasar atau yang lebih tinggi. Selain itu, Anda harus mengatur izin Kontribusi ke Izinkan folder yang ingin Anda tambahkan kuerinya. Secara default, grup Kontributor tidak memiliki izin ini.

Buka Kueri

Dari browser web Anda, (1) periksa apakah Anda memilih proyek yang tepat, (2) pilih Kueri Papan>, lalu (3) pilih Semua.

Cuplikan layar halaman kueri.

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.

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

Cuplikan layar halaman kueri.

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.

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.

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 dibagikan dalam proyek Anda.

    Cuplikan layar semua tampilan kueri.

  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 pilih untuk diikuti. 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.

  4. Pilih folder dalam remah roti untuk membuka folder kueri.

    Cuplikan layar contoh remah roti kueri.

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.

    Cuplikan layar semua tampilan kueri.

  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.

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.

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.

Cuplikan layar halaman kueri.

Saat Anda membuat pilihan, remah roti ditampilkan di bagian atas halaman. Anda bisa menavigasi ke folder, subfolder, atau halaman kueri.

Cuplikan layar remah roti di halaman kueri.

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

Cuplikan layar dropdown kueri.

Cuplikan layar dropdown navigasi 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 Favorit) ✔️
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.

Cuplikan layar memperlihatkan semua kueri dalam proyek yang difilter menurut kriteria kata kunci.

Cuplikan layar memperlihatkan semua kueri dalam proyek yang difilter menurut kriteria kata kunci.

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

Mengirim email item kueri atau berbagi URL kueri

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

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

Cuplikan layar Pilih Kueri email atau Salin URL kueri.

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

Cuplikan layar Pilih 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.

Langkah berikutnya