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 Sorgu hızlı başvurusu ve Sorguları yönetme ve düzenleme bölümüne bakın.

Önkoşullar

Kategori	Gereksinimler
Erişim Düzeyleri	- Paylaşılan sorguları görüntülemek ve çalıştırmak için: Project üyesi. - Paylaşılan sorgu eklemek ve kaydetmek için: En az Temel erişimi.
İzinler	Katkıda Bulunma izni, sorgu eklemek istediğiniz klasör için olarak ayarlanmalıdır. Varsayılan olarak, Katkıda Bulunanlar grubu bu izne sahip değildir.

Not

Ortak proje için Paydaş erişimi olan kullanıcılar, Temel erişimine sahip kullanıcılar gibi sorgu özelliklerine tam erişime sahiptir. Daha fazla bilgi için bkz. Paydaş erişimi hızlı referans.

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ü, type özniteliği atanan bir FIELD tanımına 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

Değişkenler, @Today veya @Today-1 gibi, ya da 01/01/2025 gibi bir değer belirtebileceğiniz bir tarih alanı. Kişisel profiliniz için ayarladığınız Tarih Düzenine tarihleri girin. Ayrıntılar için bkz. 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 İş Öğesi Sorgu Dili (WIQL) söz dizimi'ne bakın.

Double veya Decimal

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

Dallanan bir ağaç yapısı, örneğin Alan Yolu veya Yineleme yolu gibi. Geçerli değerler listesinden bir öğe seçin. Ağaç yapısına eşit olan, eşit olmayan, ağacın altında olan veya olmayan iş öğelerini bulun. Ayrıca birden çok değer belirtmek için In veya Not In işleçlerini kullanabilirsiniz. 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, İş öğesi alanı başvurusu'na bakın.

Daha fazla bilgi için bkz Sorgu Tanımla.

Sorgu işleci

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

Geçerli veri türleri

=

Maddede yer alan değerle eşleşir.

Sayı—Double, GUID, Integer ve String, DateTime ve TreePath içerir

<>

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ümcedeki belirli bir 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 cümledeki değere eşit veya ondan küçüktür.

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ı

İç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.

String

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 Sunucu ve harmanlama gereksinimleri için tam metin aramaları bölümüne bakın.

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

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 kelimeleri dahil etmek ve hariç tutmak için bu işleci, Contains Words operatörü ile birlikte bir madde ile 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 operatör, Azure Boards ve Azure DevOps Server tarafından desteklenir.

HTML

Boş Değil

HTML alanında içerik içeren iş öğelerini listeler. Bu işleçle bir değer belirtemezsiniz. Bu operatör, 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

Grup İçinde

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. Azure Boards hesabınız Microsoft Entra ID tarafından yedeklendiğinde Microsoft Entra ID'de tanımlanan grupları veya şirket içi sunucu örneğiniz Active Directory tarafından yedeklendiğinde Active Directory gruplarını da kullanabilirsiniz.

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

Grupta Değil

İfadenin içindeki grubun bir üyesi olan bir değere 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. Azure Boards hesabınız Microsoft Entra ID tarafından desteklendiğinde Microsoft Entra ID içinde tanımlanan grupları veya şirket içi sunucu örneğiniz Active Directory tarafından desteklendiğinde Active Directory içinde tanımlanan grupları da kullanabilirsiniz.

Altında Değil

Yan tümcedeki değerle eşleşmez ve bu tümcedeki düğümün altında bulunmaz.

TreePath

Altında

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

TreePath

Hiç Olmadı

Daha önceki bir noktada, madde içindeki değerle eşleşir.

Dize , TarihSaat

Not

Was Ever işlevi Sorgu Düzenleyicisi kullanıldığında tarih alanları için ş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 sorgu oluşturmak mümkündür. Örneğin, Yineleme Yolu kullanarak, bir tümce içinde Was Ever'i kullanabilirsiniz. Bir örnek için bkz Tarihe veya geçerli yinelemeye göre sorgulama, sprint 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

Yineleme Yolu alanını, geçerli ekip odağı veya bağlamı temel alınarak geçerli sprint'e atanan iş öğelerini otomatik olarak filtrelemek için 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ına temel alarak, Yineleme Yolu alanıyla birlikte, geçerli sprint +/- n sprint'lerine atanan iş öğeleri kümesini filtrelemek için 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 ID alanı ve In işleci ile kullanın. Daha fazla bilgi için Bir iş öğesini veya çekme isteğini izleme bölümüne bakın. Aynı listeyi, İş Öğeleri sayfasından Takip edilen pivot görünümünden görüntüleyebilirsiniz.
@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, Created By=@Me yan tümcesiyle aç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 aynı listeyi İş Öğeleri sayfasının Etkinliklerim pivot görünümünden 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

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

---

@RecentProjectActivity

Yakın zamanda güncellenen iş öğelerini listelemek için ID alanı ve İçinde operatörü 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 sınırlıdır.

---

@StartOfDay

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

---

@StartOfMonth

Geçerli aya veya artı/eksi sapmasına göre iş öğelerini filtrelemek için bir DateTime alanıyla 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 ilişkili veya artı/eksi farkı olan iş öğelerini filtrelemek için bir DateTime alanı ile kullanarak. Ö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

Bir alanla DateTime kullanarak, geçerli yıl veya artı/eksi sapması olan iş öğelerini filtreleyin. Örneğin, geçerli yıl içinde bir Hedef Tarih ile zamanlanmış olan tüm özellikleri Target Date>=@StartOfYear yan tümcesiyle bulabilirsiniz. Daha fazla örnek için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.

---

@TeamAreas

Belirli bir takıma atanmış olan alan yoluyla eşleşen iş öğelerini filtrelemek için yalnızca Alan Yolu alanıyla kullanın. = işlecini sizin kullanmanız gerekir. Örneğin, web ekibine atanan alan yollarına atanmış olan tüm öğeleri yan tümcesiyle Area Path=@TeamAreas [Fabrikam Fiber]\Web bulabilirsiniz. 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 tarihe veya önceki bir tarihe ilişkin iş öğelerini filtrelemek için DateTime alanıyla 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. "Sözcük İçerir" veya "Sözcük İçermez" belirtin, ardından tam bir ifade için arama yapmak veya joker karakteri kullanmak amacıyla * karakterini kullanın. 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şvuru kılavuzunu kullan
• 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