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

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

Burada her alan veri türünün, sorgu işleçlerinin ve sorgu makrolarının ayrıntılı açıklamalarını bulabilirsiniz. Bazı veri türleri, işleçler ve makrolar yalnızca belirtilen Azure DevOps sürümü için geçerlidir.

Her veri türü için desteklenen sorgu görevlerine, işleçlere ve makrolara hızlı başvuru için bkz . Sorgu hızlı başvurusu. Ayrıca bkz. Sorgu oluşturma/En iyi yöntemler.

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 1/1/2023 gibi bir 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. Bir ağaç yapısının altında veya altında eşit olmayan, eşit olmayan iş öğelerini bulun ya da birkaç değer belirtmek için In veya Not In işleçlerini kullanın. Bir projenin ağaç yapısını (alan yolları ve yineleme yolları) tanımlar ve ardından bir ekiple ilişkilendirmek istediklerinizi seçersiniz.

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

1. Seçim listesi... veri türleri yalnızca devralınan bir işlem için tanımlanan özel alanlara atanır. Devralınan işlem modeli yalnızca Azure DevOps Services ve Azure DevOps Server 2019 için desteklenir.

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 . Saat ve Yerel Ayar için kullanıcı tercihlerini ayarlama.

Sorgu işleçleri

Yan tümcedeki her değerin 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 kullanabilirsiniz. İş öğesi alanlarına atanan veri türü hakkında bilgi için bkz . İş öğesi alan başvurusu.

Yan tümceleri ekleme ve And/Or işleçlerinin kullanımı hakkında bilgi edinmek 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ı

<>[Alan]

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

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

>[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

Içerme

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 dışlamak için bu işleci Sözcük İçerir işleciyle bir yan tümcesiyle birlikte 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 (bulut hizmeti), Azure DevOps Server 2019 ve sonraki sürümler 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 (bulut hizmeti), Azure DevOps Server 2019 ve sonraki sürümler 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.

Not In işleci Azure Boards ve TFS 2018.2 ve sonraki sürümlerde kullanılabilir.

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.

Kategori grupları hakkında 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.

Team Foundation Server'daki bir kullanıcı grubunun veya bir proje için tanımlanmış bir 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ılırken tarih alanları şu anda desteklenmiyor. 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 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 Azure Boards, Azure DevOps Server 2019 ve sonraki sürümler için desteklenir ve yalnızca web portalından çalıştırıldığında desteklenir.

---

@Follows

Projede takip ettiğiniz tüm iş öğelerini listelemek için Kimlik alanı ve In işleci ile kullanın. Takip Et özelliği hakkında daha fazla bilgi edinmek için bkz . İş öğ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 Kanban panosu değişikliklerine göre sorgulama.

---

^{@MyRecentActivity 1}

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 1}

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 1}

Yakın zamanda güncelleştirilmiş 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ştirilmiş olan 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 2}

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 2}

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 2}

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 2}

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, Azure DevOps Server 2019 ve sonraki sürümleri için ve yalnızca web portalından çalıştırıldığında 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.

---

Not

1. @MyRecentActivity, @RecentMentions ve @RecentProjectActivity makroları TFS 2018.2 ve sonraki sürümlerde desteklenir.
2. @StartOfDay, @StartOfWeek, @StartOfMonth ve @StartOfYear makroları Azure DevOps Server 2019 Güncelleştirme 1 ve sonraki sürümleri için desteklenir.

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şvurusu
• Yönetilen sorgular hakkında
• İş öğesi alan dizini
• İş Öğesi Sorgu Dili (WIQL) söz dizimi

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