Azure Boards'ta sorgu alanları, işleçler ve makrolar

Açıklama

True/False değerini alan bir alan belirtir.

veya @Today-1gibi @Today bir değişken veya gibi 01/01/2025bir değer belirtebileceğiniz bir tarih alanı. Kişisel profiliniz için ayarladığınız Tarih Düzenine tarihleri girin. (Bkz. Ayrıntılar için kişisel tercihleri ayarlayın.) Sorgu örnekleri için bkz Query by date or @CurrentIteration. .

WIQL sorguları için tarihi Eşgüdümlü Evrensel Saat (UTC) düzeninde de belirtebilirsiniz. Daha fazla bilgi için bkz . İş Öğesi Sorgu Dili (WIQL) söz dizimi.

0,2 veya 3,5 gibi gerçek bir sayı. Sorgu örnekleri için bkz . Sayısal alanlara göre sorgulama.

Benzersiz bir kimliği temsil eden karakter dizesi.

Geçmiş bilgileri izlemek için kullanılan özel biçimlendirilmiş alan. Bu veri türü yalnızca Geçmiş alanını desteklemek için kullanılır. Bu alan, tam metin araması kullanılabilir olduğunda tam metin araması için otomatik olarak dizine eklenir. Bu makalenin devamında açıklanan Tam Metin ve kısmi sözcük aramalarına bakın. Sorgu örnekleri için bkz . Geçmiş ve denetim.

Açıklama veya Yeniden Oluşturma Adımları alanları gibi biçimlendirilmiş açıklamaları destekleyen metin dizeleri. Bu alanlar, tam metin araması kullanılabilir olduğunda tam metin araması için otomatik olarak dizine eklenir. Bu makalenin devamında açıklanan Tam Metin ve kısmi sözcük aramalarına bakın. Zengin metin alanlarını sorgulamak için bkz . Başlıklara, kimliklere ve zengin metin alanlarına göre sorgulama.

Kullanıcı kimliğini tanımlayan kısa metin dizesi.

0, 1, 2, 34 gibi imzalı 32 bitlik bir tamsayı.

Uygulama Başlangıç Bilgileri alanı gibi uzun açıklamaları destekleyen metin dizeleri. Bu alanlar, tam metin araması kullanılabilir olduğunda tam metin araması için otomatik olarak dizine eklenir. Bu makalenin devamında açıklanan Tam Metin ve kısmi sözcük aramalarına bakın. Düz metin alanlarını sorgulamak için bkz . Başlıklara, kimliklere ve zengin metin alanlarına göre sorgulama.

Ondalık değerlerin seçim listesini içerecek şekilde tanımlanan özel alan.

Tamsayı değerlerinin seçim listesini içerecek şekilde tanımlanan özel alan.

Kısa metin dizesi (255 karakter veya daha az) değerlerinin seçim listesini içerecek şekilde tanımlanan özel alan.

En fazla 255 Unicode karakter içerebilen kısa metin dizesi. Dize metin alanları genellikle seçim listelerini veya açılan menüleri desteklemek için kullanılır.

Alan Yolu veya Yineleme yolu gibi dallanma ağacı yapısı. Geçerli değerler listesinden bir öğe seçin. Ağaç yapısına eşit, buna eşit değil, altında veya altında olmayan iş öğelerini bulun. Birden çok değer belirtmek için veya Not In işleçlerini de kullanabilirsinizIn. Bir projenin ağaç yapısını (alan yolları ve yineleme yolları) tanımlayın ve ardından bir ekiple ilişkilendirmek istediklerinizi seçin.

Sorgu oluşturma hakkında daha fazla bilgi için bkz . Alana veya yineleme yoluna göre sorgulama ya da Tarihe veya geçerli yinelemeye göre sorgulama.

İş öğesindeki değer listelenen ölçütle eşleşiyorsa iş öğelerini döndürür

Geçerli veri türleri

yan tümcesindeki değerle eşleşir.

Double, GUID, Integer ve String, DateTime ve TreePath içeren sayı

Yan tümcesindeki değerle eşleşmiyor.

Sayı, Dize, DateTime ve TreePath

yan tümcesindeki değerden daha büyüktür.

Sayı, Dize ve DateTime

Yan tümcesindeki değerden küçüktür.

Sayı, Dize ve DateTime

Yan tümcesindeki değerden büyük veya buna eşittir.

Sayı, Dize ve DateTime

Yan tümcesindeki değerden küçük veya buna eşittir.

Sayı, Dize ve DateTime

Belirtilen alanda bulunan değerle eşleşir.

Belirtilen alanla aynı veri türünde bir alanın adı
Boole alanının başka bir alana eşit olup olmadığını denetler

Belirtilen alanda bulunan değerle eşleşmiyor.

Belirtilen alanla aynı veri türünde bir alanın adı
Boole alanının başka bir alana eşit olup olmadığını denetler

Belirtilen alanda bulunan değerden daha büyük.

Belirtilen alanla aynı veri türünde bir alanın adı

Belirtilen alanda bulunan değerden küçüktür.

Belirtilen alanla aynı veri türünde bir alanın adı

Belirtilen alanda bulunan değerden büyük veya buna eşit.

Belirtilen alanla aynı veri türünde bir alanın adı

Belirtilen alanda bulunan değerden küçük veya buna eşit.

Belirtilen alanla aynı veri türünde bir alanın adı

Filtreleme için seçtiğiniz alan içindeki metin dizesinin tam veya kısmi eşleşmesini içerir.

Dize

Filtreleme için seçtiğiniz alan içindeki metin dizesinin tam veya kısmi eşleşmesini içermez.

Dize

Filtreleme için seçtiğiniz alanın içinde tam metin dizesini veya sözcükleri içerir. Ayrıca* joker karakterini içeren kısmi sözcükler veya tümcecikler de girebilirsiniz. Metin dizesi 100 karakterle sınırlıdır. Kısıtlamalar için bkz . Sunucu ve harmanlama gereksinimleri için tam metin aramaları .

Tüm Düz Metin ve HTML alanlarına ve Geçmiş ve Başlık alanlarına karşılık gelen, tam metin araması için dizine alınan uzun metin alanları.

Filtreleme için seçtiğiniz alanın içinde tam metin dizesini veya sözcükleri içermez. Metin dizesi 100 karakterle sınırlıdır.

Belirli anahtar sözcükleri dahil etmek ve hariç tutmak için bu işleci işleci işlecini işleciyle birlikte Contains Words kullanın.

Tam metin araması için dizine alınan metin alanları.

Sınırlandırılmış kümedeki herhangi bir değerle eşleşir. Örneğin, kimlik alanı için bu değerleri belirtirseniz, kimlikleri 100, 101 ve 102 olan iş öğelerini bulabilirsiniz. değerleri, istemci bilgisayarınız için tanımlanan bölgesel ayarlara karşılık gelen liste ayırıcısıyla ayırın. Örneğin, virgül ,kullanabilirsiniz.

Sayı, Dize, DateTime, TreePath

Boş bir HTML alanı içeren iş öğelerini listeler. Bu işleçle bir değer belirtemezsiniz. Bu işleç Azure Boards ve Azure DevOps Server için desteklenir.

HTML

HTML alanında içerik içeren iş öğelerini listeler. Bu işleçle bir değer belirtemezsiniz. Bu işleç Azure Boards ve Azure DevOps Server için desteklenir.

HTML

Sınırlandırılmış kümedeki hiçbir değerle eşleşmiyor. Durum alanı için bu değerleri belirtirseniz, durumları Çözüldü, Tamamlandı veya Kapatıldı olmayan iş öğelerini sorgu sonuçlarından dışlayabilirsiniz. değerleri, istemci bilgisayarınız için tanımlanan bölgesel ayarlara karşılık gelen liste ayırıcısıyla ayırın. Örneğin, virgül ,kullanabilirsiniz.

In Değil işleci Azure Boards ve Azure DevOps Server için desteklenir.

Sayı, Dize, DateTime, TreePath

yan tümcesindeki grubun üyesi olan bir değerle eşleşir. Gruplar bir ekibin, güvenlik grubunun veya iş izleme kategorisinin adına karşılık gelir. Örneğin, Katkıda Bulunanlar grubunun üyelerine veya bir takıma atanan tüm iş öğelerini bulmak için bir sorgu oluşturabilirsiniz. Ekip oluşturduğunuzda ekip grupları oluşturulur. Ekip gruplarının adı [Takım Projesi Adı]\Takım Adı desenini izler.

Örneğin sorgular için bkz . Atamaya veya iş akışı değişikliklerine göre sorgulama.

Sistemde tanımlanan bir ekibin, güvenlik grubunun veya kategorinin adıyla eşleşen dize .

Bilgi için bkz . İş öğesi türlerini gruplandırmak için kategorileri kullanma.

Yan tümcesindeki grubun üyesi olan bir değerle eşleşmiyor.

Azure DevOps Server'daki bir kullanıcı grubunun veya bir proje için tanımlanan kategori grubunun adıyla eşleşen dize.

Yan tümcesindeki değerle eşleşmez ve yan tümcesindeki düğümün altında yer almaz.

TreePath

yan tümcesindeki değerle eşleşir veya yan tümcesindeki düğümün altında yer alır.

TreePath

Önceki herhangi bir noktada yan tümcesindeki değerle eşleşir.

Dize , DateTime

Açıklama

Tüm iş öğesi türlerinde veya tüm eyaletlerde arama yapmak için İş Öğesi Türü veya Durum alanlarıyla kullanın. Örneğin, Work Item Type=[Any] iş öğesi türüne göre herhangi bir filtre yerleştirmez.

Geçerli ekip odağını veya bağlamını temel alarak geçerli sprint'e atanan iş öğelerini otomatik olarak filtrelemek için Yineleme Yolu alanıyla birlikte kullanın. Belirli örnekler için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.
@CurrentIteration makrosu yalnızca web portalından çalıştırıldığında çalışır. Makroyu test paketlerini ve test çalışmalarını kopyalarken veya kopyalarken, uyarı tanımlarken veya REST API'leriyle kullanamazsınız.

Geçerli ekip odağına veya bağlamını temel alarak geçerli sprint +/- n sprint'lerine atanan iş öğeleri kümesini filtrelemek için Yineleme Yolu alanıyla birlikte kullanın. Belirli örnekler için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.
@CurrentIteration +/- n makrosu web portalından çalıştırıldığında Azure Boards, Azure DevOps Server için desteklenir.

Projede takip ettiğiniz tüm iş öğelerini listelemek için Kimlik alanı ve In işleci ile kullanın. Daha fazla bilgi için bkz . bir iş öğesini veya çekme isteğini izleme. Aynı listeyi İş Öğeleri sayfasından görüntüleyebilirsiniz( Özet görünümden takip edilen).
@Follows makrosu yalnızca web portalından çalıştırıldığında desteklenir.

Kullanıcı veya hesap adınız ile ilişkili öğeleri otomatik olarak aramak için kimlik veya kullanıcı hesabı alanıyla kullanın. Örneğin, yan tümcesiyle Created By=@Meaçtığınız iş öğelerini bulabilirsiniz. Daha fazla örnek için bkz . Atamaya, iş akışına veya pano değişikliklerine göre sorgulama.

Son 30 gün içinde projede görüntülediğiniz veya güncelleştirdiğiniz iş öğelerini listelemek için Kimlik alanı ve In işleci ile kullanın. Bu listeyi, Etkinlik özet görünümüm iş öğeleri sayfasından görüntüleyebilirsiniz.

Diğer projelerdeki iş öğelerini filtrelemek için Takım Projesi alanıyla kullanın. Örneğin, şu anda seçili olan projedeki tüm iş öğelerini yan tümcesiyle Team Project=@Projectbulabilirsiniz. Sistem otomatik olarak geçerli projeye göre filtrelemeye geçer. Daha fazla bilgi için bkz . Sorgu tanımlama, Projeler arasında sorgulama.

Tartışma bölümünde bahsedilen iş öğelerini listelemek için Kimlik alanı ve In işleci ile kullanın. Aynı listeyi İş Öğeleri sayfasından, Bahsedilen özet görünümünde görüntüleyebilirsiniz.

Yakın zamanda güncelleştirilen iş öğelerini listelemek için Kimlik alanı ve In işleci ile kullanın. Listelenen iş öğelerinin sayısı, projenin iş izleme etkinliğine bağlıdır. Son derece etkin projeler için makro, son 30 gün içinde projede güncelleştirilen iş öğelerini listeler. Ancak daha az etkin projeler için bu liste 30 günden eski iş öğelerini içerebilir. Benzer listeleri İş Öğeleri sayfasından, Son oluşturulan, Son güncelleştirilen ve Son tamamlanan özet görünümlerden görüntüleyebilirsiniz. Döndürülen iş öğelerinin sayısı 5000 ile eşlenir.

Geçerli tarihle DateTime veya artı/eksi uzaklığıyla ilişkili iş öğelerini filtrelemek için bir alanla kullanın. Örneğin, son hafta içinde kapatılan tüm öğeleri yan tümcesiyle Closed Date>=@StartOfDay-7bulabilirsiniz. Daha fazla örnek için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.

Geçerli aya veya artı/eksi uzaklığına sahip iş öğelerini filtrelemek için bir alanla DateTime kullanın. Örneğin, son üç ay içinde oluşturulan tüm öğeleri yan tümcesiyle Created Date>=@StartOfMonth-3bulabilirsiniz. Daha fazla örnek için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.

Geçerli haftayla DateTime veya artı/eksi uzaklığıyla ilişkili iş öğelerini filtrelemek için bir alanla birlikte kullanın. Örneğin, son iki hafta içinde değiştirilen tüm öğeleri yan tümcesiyle Changed Date>=@StartOfWeek-2bulabilirsiniz. Daha fazla örnek için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.

Geçerli yılla DateTime ilişkili veya artı/eksi uzaklığı olan iş öğelerini filtrelemek için bir alanla kullanın. Örneğin, geçerli yıl içinde zamanlanmış bir Hedef Tarihi olan tüm özellikleri yan tümcesiyle Target Date>=@StartOfYearbulabilirsiniz. Daha fazla örnek için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.

Alan yolu belirli bir ekiliğe atanmış iş öğelerine karşılık gelen iş öğelerini filtrelemek için yalnızca Alan Yolu alanıyla kullanın. işlecini = kullanmanız gerekir. Örneğin, web ekibine atanan alan yollarına atanan tüm öğeleri yan tümcesiyle Area Path=@TeamAreas [Fabrikam Fiber]\Webbulabilirsiniz. Daha fazla örnek için bkz . Alana veya yineleme yoluna göre sorgulama.
@TeamAreas makrosu yalnızca web portalından çalıştırıldığında Azure DevOps Server için desteklenir.

Geçerli tarihle veya önceki bir DateTime tarihle ilişkili iş öğelerini filtrelemek için bir alanla birlikte kullanın. Ayrıca, günleri çıkararak @Today makroyu değiştirebilirsiniz. Örneğin, son hafta içinde oluşturulan tüm öğeleri yan tümcesiyle Created Date>=@Today-7bulabilirsiniz. Daha fazla örnek için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.