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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Bu makalede her alan veri türü, sorgu işleci ve sorgu makrosunun açıklamaları sağlanır. Bazı veri türleri, işleçler ve makrolar yalnızca belirtilen Azure DevOps sürümü için geçerlidir.

Daha fazla bilgi için bkz . Sorgu hızlı başvurusu ve Sorguları yönetme ve düzenleme.

Sorgu alanı veri türleri ve değerleri

Bir alan için belirttiğiniz değer, bu alanın veri türüne uygun olmalıdır. Aşağıdaki tabloda desteklenen veri türleri listelenmektedir:

Not

Azure Boards bulut hizmeti için veri türü, İşlem>Alanları sayfasında alan için listelenen türe karşılık gelir. Şirket içi dağıtımlar için veri türü, bir FIELD tanıma atanan özniteliğe type karşılık gelir. Daha fazla bilgi için bkz . İş öğesi alanları ve alan öznitelikleri.

Veri türü

Açıklama

Boolean

True/False değerini alan bir alan belirtir.

DateTime veya Date/Time

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.

Çift veya Ondalık

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

GUID

Benzersiz bir kimliği temsil eden karakter dizesi.

Geçmiş

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.

HTML

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.

Kimlik

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

Tamsayı

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

Düz Metin veya Metin alanı (çok satırlı)

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.

picklistDouble

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

picklistInteger

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

picklistString

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

Dize veya Metin alanı (tek satır)

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.

TreePath

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.

Not

Seçim listesi... veri türleri yalnızca devralınan bir işlem için tanımlanan özel alanlara atanır.

Tarih ve saat düzeni

DateTime alanları için girdiğiniz tarih ve saat deseni, profiliniz aracılığıyla seçtiğiniz tarih ve saat düzeniyle eşleşmelidir. Seçiminizi görüntülemek veya değiştirmek için bkz . Kullanıcı tercihlerini ayarlama.

Sorgu işleçleri

Yan tümcedeki her değerin bir iş öğesindeki karşılık gelen değerle nasıl ilişkilendirileceğini belirtmek için aşağıdaki tabloda yer alan sorgu işleçlerini kullanın. İş öğesi alanlarına atanan veri türü hakkında bilgi için bkz . İş öğesi alan başvurusu.

Daha fazla bilgi için bkz . Sorgu tanımlama.

Sorgu işleci

İş öğ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

=[Alan]

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

<>[Alan]

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

>[Alan]

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

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

<[Alan]

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

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

>=[Alan]

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

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

<=[Alan]

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

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

Içerir

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

Dize

İçermez

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

Dize

Sözcük İçer

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ı.

Sözcük İçermez

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ı.

In

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ş

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

Boş Değil

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

Içinde Değil

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

Grupta

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 .

Not

Grupta işlecini yalnızca Dize veri türünü veya İş Öğesi Türü alanını kullanan alanlarla kullanabilirsiniz. Ayrıca, Azure Boards hesabınız Microsoft Entra Id veya Şirket içi sunucu örneğiniz Active Directory tarafından yedeklendiğinde Active Directory tarafından yedeklendiğinde Microsoft Entra Id içinde tanımlanan grupları da kullanabilirsiniz.

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

Grupta Değil

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.

Not

Grupta Değil işlecini yalnızca Dize veri türünü veya İş Öğesi Türü alanını kullanan alanlarla kullanabilirsiniz. Ayrıca, Azure Boards hesabınız Microsoft Entra Id veya Şirket içi sunucu örneğiniz Active Directory tarafından yedeklendiğinde Active Directory tarafından yedeklendiğinde Microsoft Entra Id içinde tanımlanan grupları da kullanabilirsiniz.

Altında Değil

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

TreePath

Altında

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

TreePath

Hiç Olmadı

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

Dize , DateTime

Not

Sorgu Düzenleyicisi kullanıldığında tarih alanları şu anda desteklenmemektedir. Bunlar yalnızca doğrudan WIQL yaparken desteklenir.

İpucu

Listelenenlerden farklı veri türü alanları için Was Ever gibi bir işleç kullanan WIQL söz dizimi kullanarak bir sorguyu derlemek mümkündür. Örneğin, Yineleme Yolu'nu kullanarak was ever in a yan tümcesini kullanabilirsiniz. Bir örnek için bkz . Tarihe veya geçerli yinelemeye göre sorgulama, Sprint'in dışına taşınan iş öğelerini listeleme.

Makroları veya değişkenleri sorgulama

Sorgularınızı belirli alanlara göre filtrelemek için aşağıdaki tabloda açıklanan makroları kullanabilirsiniz.

Not

Aşağıdaki makrolar yalnızca web portalında desteklenir: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity ve @TeamAreas. Bu makroları içeren sorgular Visual Studio/Team Explorer, Microsoft Excel veya Microsoft Project'te açıldığında çalışmaz.

---

Makro

Açıklama

---

[Tümü]

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.

---

@CurrentIteration

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.

---

@CurrentIteration +/- n

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.

---

@Follows

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.

---

@Me

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.

---

@MyRecentActivity

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.

---

@Project

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.

---

@RecentMentions

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.

---

@RecentProjectActivity

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.

---

@StartOfDay

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.

---

@StartOfMonth

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.

---

@StartOfWeek

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.

---

@StartOfYear

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.

---

@TeamAreas

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.

---

@Today

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.

---

Tam metin ve kısmi sözcük aramaları

Bir sözcük veya tümceciğin tam veya kısmi eşleşmelerine karşı arama yapmak için İçerir veya İçermez seçeneğini belirtin. Bu işleçler, uzun metin alanları için oluşturulan tam metin arama dizinine göre öğeleri filtreler. Tam bir tümceciğe göre arama yapmak veya joker karakterini *kullanmak için Sözcük İçerir veya Sözcük İçermez seçeneğini belirtin. Bu işleçler tam metin arama dizinini kullanır. Joker karakteri yalnızca kısmi bir sözcük veya tümceciğin sonunda kullanabilirsiniz.

Örnekler için bkz . Örnek iş öğesi sorguları ve Geçmiş alanını kullanarak iş öğelerini sorgulama.

Not

Tüm dağıtımlar tam metin aramalarını desteklemez. Örneğin, bulut hizmetini destekleyen SQL Express ve SQL Azure tam metin aramayı desteklemez. Bu örneklerde yalnızca İçerir ve İçermez işleçlerini görürsünüz.

İlgili makaleler

• Sorgu hızlı başvurusunu kullanma
• Yönetilen sorgular hakkında bilgi edinin
• İş öğesi alan dizinine erişme
• İş Öğesi Sorgu Dili (WIQL) söz dizimini anlama

REST API

Sorgularla program aracılığıyla etkileşime geçmek için şu REST API kaynaklarından birine bakın:

• Azure DevOps Services REST API Başvurusu
• Sorgular
• İş öğesi sorgu dili
• Program aracılığıyla sorgularla iş öğelerini getirme