Azure Boards ve Azure DevOps başlıklar, kimlikler ve zengin metin alanlarına göre sorgulama
Veri türü
Desteklenen işleçler ve makrolar
Zengin metin (HTML)
Çok satırlı metin dizeleri (düz metin)
Sözcükler içeriyor, sözcük Içermiyor, boş (Not 1), boş değil (Not 1)
Çok satırlı metin dizeleri (düz metin)
Desteklenen işleçler ve makrolar
Tek metin (dize)
=, <> , > , < , > =, < =, = [Alan], <> [alan], > [alan], < [alan], > = [alan], < = [alan], Contains, içinde olmayan, içinde değil, grubunda değil
Makrolar: [any], iş öğesi türü alanıyla geçerli
@ Project (Note 2), takım Project alanıyla geçerli
'INI
=, <> , > , < , > =, < =, İçinde değil
makrolar: @Follows, @MyRecentActivity, @RecentMentions, kimlik alanı ile geçerli @RecentProjectActivity ve içindeki(not 2) işleç içinde değil , takım Project alanıyla geçerli
Durum ve iş öğesi türü alanları
=, <> , > , < , > =, < =, = [Alan], <> [alan], > [alan], < [alan], > = [alan], < = [alan], Contains, içinde olmayan, içinde değil, grubunda değil
Makrolar: [any] her iki alan ile geçerlidir
Not
- boş ve boş işleçler Azure DevOps Server 2019 RC2 ve sonraki sürümlerinde desteklenir
- @ Project makrosu Azure Boards ve TFS 2015,1 ve sonraki sürümlerinde desteklenir. Sistem otomatik olarak geçerli projeye göre filtreleme yapar. Daha fazla bilgi için bkz. Projeler arasında sorgu.
Contains wordsDize eşleşmeleri için kullanın
Bir dize eşleşmesi üzerinde filtre uygulamak istediğinizde, Contains Words yerine işlecini kullanmayı deneyin Contains . Contains Wordsİşleci, çoğu durumda daha hızlı olan belirtilen alanda tam metin araması çalıştırır. Metin dizesi 100 karakterle sınırlıdır.
Containsİşleci yalnızca daha yavaş olmayan, ancak daha fazla CPU döngüsü tüketen bir tablo taraması çalıştırıyor. Bu CPU döngüleri, kaynak tüketen hız limitine doğru katkıda bulunur.
Joker karakterlerle anahtar sözcük veya tümcecik sorgusu
Girdiğiniz sözcüklerle veya tümcecikle kısmen veya tam olarak eşleşen öğeleri listelemek için Contains veya sözcüklerini kullanın.
Bir sözcük veya tümceciğin tam veya kısmi eşleştirmelerinde arama yapmak için içerir veya içermez ' i seçin. Sözcük içeriyor ' u seçin veya tam bir ifadeye göre arama yapmak veya * joker karakterini kullanmak Için sözcükler içermez . Bu işleçler tam metin arama dizinini kullanır.
Örneğin, bilgilendiriciveya bilgiya da bilgilendirme Içeren bir metin alanını filtrelemek için sözcüklerini içerir ve bildir ' i belirtin.
İpucu
VE/veya yan tümcelerinin nasıl gruplandığını anlamak için bkz. yönetilen sorgular oluşturma ve kaydetme, grup yan tümceleri. Bir sorgunun WIQL söz dizimini görüntülemek için, herhangi bir sorgu Kullanıcı arabirimi girişinin WIQL sürümünü görmenizi sağlayacak wiql sorgu Düzenleyicisi uzantısını yükleyebilirsiniz.
Belirli sözcükleri sorgula, diğerlerini değil
, Sözcüklerini içerir ve girdiğiniz sözcüklerle tam olarak eşleşen öğeleri listelemek ve diğer sözcükleri veya tümceleri dışlamak için kelimeler işleci içermez . Bu işleçleri, joker karakteri (*) ile birlikte kullanabilirsiniz.
Aşağıdaki örnekte, bu işleçler iş aşamasını içeren öğeler için iş öğelerini filtreleyip phasorsözcüğüne değil.
Tanımsız alan değeri sorguları
Bir tanımsız alan değeri olan iş öğelerini eşittir işlecini (=) kullanarak ve alanın değerini boş bırakarak bulabilirsiniz. Örneğin, aşağıdaki filtreler, etkinlik alanı boş olan görev türündeki tüm iş öğelerini listeler.
Boş olmayan bir alana göre iş öğelerini listelemek için Not işlecini ( <> ) kullanın ve değeri boş bırakın.
Boş veya boş HTML alan sorguları
Açıklama girilmemiş iş öğelerini bulabilirsiniz. Boş veya boş olmayan bir HTML alanı, boş veya boş zengin metin alanları olan iş öğelerinin listelenmesini destekler. Bu işleçle bir değer belirtmezsiniz.
Örneğin, aşağıdaki sorgu filtrelerinde, bazı girdilerin Açıklama alanına yapıldığı tüm iş öğeleri listelenir.
Not
Kendisine ekli etiketi olmayan iş öğelerini sorgulama özelliği desteklenen bir özellik değildir. bu özelliği destekleme isteğini oylamak isterseniz, geliştirici Community sayfamızda bu şekilde, boş etiketler arayabilmeniziçin bunu yapabilirsiniz.
Kategori tabanlı sorgular
İş öğelerini ait oldukları kategoriye göre filtrelemek için, ın Group işlecini kullanın. Örneğin, aşağıdaki filtre ölçütleri, geçerli projede olan, ekip üyesine atanan ve hata kategorisine ait olarak tanımlanmış olan tüm çalışma öğelerini döndürür.
Gereksinim veya görev kategorilerinde hangi öğeler görünür?
Çalışma öğesi türlerinin her kategoriye varsayılan atamaları, her işlem için aşağıda listelenmiştir.
| İşleme | Gereksinim kategorisi | Görev kategorisi |
|---|---|---|
| Temel | Sorun | Görev |
| Çevik | Kullanıcı hikayesi | Görev |
| Takımınız | Ürün biriktirme listesi öğesi, hata | Görev |
| CMMı | Gereksinim | Görev |
Her ekip, hata çalışma öğesi türünün gereksinim ya da görev kategorisinde görünüp göründüğünü belirleyebilir. Bkz. biriktirme listeleri ve panolarda hataları gösterme. Bir biriktirme listesine özel iş öğesi türleri ekleyebilirsiniz. Ayrıntılar için bkz. bir iş öğesi türü ekleme veya değiştirme, bir biriktirme listesine veya panoya özel bır WıT ekleme.
Takip ettiğiniz iş öğeleri için sorgu
Diğer sorgu filtreleriyle birlikte, takip ettiğiniz iş öğelerine dayanarak bir listeyi filtrelemek için @Follows makrosunu kullanabilirsiniz.
Örneğin, aşağıdaki sorgu, takip ettiğiniz etkin iş öğeleri için tüm projeler genelinde nasıl sorgu yapılacağını gösterir. KIMLIK alanını ve ın işlecini @Follows makrosu ile birlikte kullanırsınız.
Son kullanılan iş öğesi etkinliği sorgusu
Son etkinliğe göre iş öğelerini listelemek için aşağıdaki makroları kullanabilirsiniz:
- @MyRecentActivity: en son görüntülediğiniz veya değiştirdiğiniz öğeleri listeleyin
- @RecentMentions: son 30 gün içindeki bir @mention üzerinden eklenen öğeleri listeleyin
- @RecentProjectActivity: projenizde son zamanlarda oluşturulmuş veya değiştirilmiş olan öğeleri listeleyin.
ID alanını ve içindedeğil işleçlerini belirtin.
Örneğin, aşağıdaki sorgu, son görüntülenen veya değiştirdiğiniz iş öğelerinin nasıl sorgulanalınacağını gösterir.
Çoğu iş öğesi türü için ortak alanlar
Aşağıdaki tabloda sorguları filtrelemek için kullanılan yaygın alanlar açıkmektedir. Kimlik alanları, bir listedeki iş öğelerini benzersiz bir şekilde tanımlamak için kullanılır. İş öğesini aynı türe sahip diğer tüm kişilerden ayırmak için Başlık alanını kullanın. Açıklama ve diğer zengin metin (data type=HTML) alanları, iş uygulamak ve değişiklikleri izlemek için gereken ek bilgileri sağlar. Bir iş öğesi oluşturulduktan sonra, kimliği dışındaki tüm alanları değiştirebilirsiniz. Bir iş öğesini ekp kaydederek, kimlik sistem tarafından atanır ve değiştirilemez.
Not
Sistem, tam metin araması için veri türü PlainText ve HTML alanları olan tüm uzun metin alanlarını otomatik olarak dizinler. Buna Başlık, AçıklamaveYeniden Proje Adımları alanları dahildir. Şirket içi ortamlar için geçerli olan sunucu ve harmanlama gereksinimleri hakkında daha fazla bilgi Azure DevOps bkz. Sorgu alanları, işleçler, değerler ve değişkenler - Tam metin ve kısmi sözcük aramaları.
Alan adı
Açıklama
İş öğesi türü
Kabul Ölçütleri 1
Hata veya ürün biriktirme listesi öğesi kapatılmadan önce karşıılacak ölçütlerin açıklaması.
Bir hata veya ürün biriktirme listesi öğesi üzerinde çalışmaya başlamadan önce müşteri kabulü ölçütleri mümkün olduğunca net bir şekilde açıkılmalıdır. Kabul ölçütlerini tanımlamak için ekip ve müşteriler arasındaki konuşmalar, takımınız tarafından müşterilerimizin beklentilerini anlayarak emin olmak için yardımcı olur. Kabul ölçütleri, kabul testlerinin temeli olarak kullanılabilir, böylece bir öğenin tatmin edici bir şekilde tamamlandıktan sonra daha etkili bir şekilde değerlendirebilirsiniz.
Başvuru adı=Microsoft.VSTS.Common.AcceptanceCriteria, Veri türü=HTML
Hata, Epic, Özellik, Ürün biriktirme listesi öğesi (Scrum)
Açıklama 1, 2
Bir iş öğesi hakkında ayrıntılı bilgi sağlamak için bu alanı kullanın.
Başvuru adı=System.Description, Veri türü=HTML
Tümü
ID
Bir iş öğesinin atandığı benzersiz tanımlayıcı. İş öğesi kimlikleri tüm projeler ve bir proje koleksiyonu içinde benzersizdir.
Başvuru adı=System.Id, Veri türü=Tamsayı
Tümü
Yeniden Oluşturma Adımları (veya Yeniden oluşturma adımları) 1
Beklenmeyen davranışları yeniden oluşturmak için gereken adımlar. Diğer ekip üyelerinin sorunun tam etkisini ve hatayı düzeltip düzeltip düzelte anlamaylarına yetecek kadar bilgi yakala. Bu, hatayı ve beklenen davranışı bulmak veya yeniden oluşturmak için alınan eylemleri içerir.
Başvuru adı=Microsoft.VSTS.TCM.ReproSteps, Veri türü=HTML
Hata
Çözüm
Bir empediment'in nasıl çözümlenmiş olduğunu açıklar.
Başvuru adı=Microsoft.VSTS.Common.Resolution, Veri türü=HTML
Impediment (Scrum)
Sistem Bilgileri1
Hata, kod incelemesi veya geri bildirimle ilgili yazılım ve sistem yapılandırması hakkında bilgiler.
Başvuru adı=Microsoft.VSTS.TCM.SystemInfo, Veri türü=HTML
Hata, Kod İnceleme İsteği, Geri Bildirim İsteği
Takım Project
bir iş öğesinin ait olduğu proje. Listenizi bir veya daha fazla projedeki öğelere filtrelemek istediğinizde bu alanı bir sorguya ekleyin.
Not
TFS 2015.1 ve sonraki sürümler için Azure Boards veya sonraki sürümler için, bu alanın açılan alan listesinde görünmesi için sorgu düzenleyicisinde Projeler arasında sorgula seçeneğini denetlemelisiniz. Daha fazla bilgi edinmek için bkz. Örnek sorgular, projeler arasında sorgulama.
Başvuru adı=System.TeamProject, Veri türü=Dize
Tümü
Başlık
İş öğesinin ne olduğunu özetleyen ve ekip üyelerinin bunu bir listedeki diğer iş öğelerinden ayırmalarına yardımcı olan kısa bir açıklama.
Başvuru adı=System.Title, Veri türü=Dize
Tümü
İş Öğesi Türü
İş öğesi türünün adı. İş öğesi türleri, projenizi oluşturulduğunda kullanılan işleme göre tanımlanır. Genel bakış için bkz. İşlem seçme. Özel iş öğesi türü ekleme hakkında bilgi edinmek için bkz. İş öğesi türü ekleme veya değiştirme.
İş öğelerini kategori atamalarına göre filtrelemek için, Grup içinde ve Grupta Değil işleçlerini kullanabilir ve açılan listeden bir kategori seçebilirsiniz.
Başvuru adı=System.WorkItemType, Veri türü=Dize
Tümü
Not
- Zengin metin alanlarıyla çalışma hakkında daha fazla bilgi edinmek için bkz. İş öğeleri içinde bilgi paylaşma.
- Team Foundation Server 2012'ye yükseltmeden sonra Açıklama alanı, PlainText alan türünden HTML olarak değiştirilmiştir. witadmin changefield komutunu kullanarak bu alanın veri türünü geri döndürebilirsiniz. Bkz. İş öğesi alanlarını yönetme (witadmin).
İlgili makaleler:
REST API
Sorgularla program aracılığıyla etkileşim kurmak için aşağıdaki kaynak kaynaklarından REST API bakın:
SDK kaynakları
Sorgularla program aracılığıyla etkileşim kurmak için bkz. Hatalar,Görevler ve Diğer İş Öğeleri için Sorgulama.
Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Bir anahtar sözcüğü veya tümceciği veya null metin alanını temel alan iş öğelerini bulmak istediğiniz zaman, bunu tek satırlı metin (Dize), çok satırlı metin (PlainText) ve zengin metin (HTML) alanlarına göre filtreleebilirsiniz. Sorgularının sonuç elde etmek için çok uzun zaman aldıklarını bulursanız, yüksek performanslı sorgular oluşturmak için Rehberlik'i gözden geçirin.
Desteklenen işleçler ve makrolar
Bir metin veya zengin metin alanı belirten sorgu yan tümceleri, aşağıdaki tabloda listelenen işleçleri ve makroları kullanabilir.