Sorgu alanları, işleçler ve makrolar

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Bu makalede, Sorgu Düzenleyicisi'nde kullandığınız alan veri türleri, sorgu işleçleri ve sorgu makroları açıklanmaktadır. Bazı türler, işleçler ve makrolar yalnızca belirli Azure DevOps sürümleri için geçerlidir.

Hızlı örnekler ve düzenleyici görevleri için Hızlı Sorgu Başvurusu ve Sorguları Yönetme ve Düzenleme bölümlerine 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.

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şim.
İ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.

Sorgu alanı veri türleri ve değerleri

Bir alanın veri türüyle eşleşen bir değer belirtmeniz gerekir. Aşağıdaki tabloda desteklenen veri türleri listelenmektedir:

Not

Azure Boards (bulut) için veri türü İşlem > Alanları sayfasında gösterilen alanla eşleşir. Şirket içi dağıtımlar için veri türü bir type özniteliğe FIELD karşılık gelir. Ayrıntılar için bkz . İş öğesi alanları ve alan öznitelikleri .

Veri türü

Açıklama

Boolean

True/False değerini depolar.

DateTime veya Date/Time

Bir tarih değişkeni (örneğin, @Today veya @Today-1) veya gibi 01/01/2025açık bir tarih kullanın. Profilinizde ayarlanan desene uygun olarak tarihleri girin. Sorgu örnekleri için bkz Query by date or @CurrentIteration. .
WIQL sorguları için tarihleri UTC olarak da belirtebilirsiniz. Bkz. İş Öğesi Sorgu Dili (WIQL) için Söz Dizimi.

Double veya Decimal

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

GUID

Benzersiz bir tanımlayıcı dizesi depolar.

Geçmiş

Geçmiş bilgileri için kullanılan özel biçimlendirilmiş alan ( Geçmiş alanı). Tam metin araması kullanılabilir olduğunda, bu alan tam metin sorguları için dizine eklenir. Bkz . Geçmiş ve denetim.

HTML

Biçimlendirilmiş metni depolar (örneğin, Açıklama veya Yeniden Oluşturma Adımları). Tam metin araması kullanılabilir olduğunda, bu alanlar dizine eklenir. 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 bir metin dizesi depolar.

Tamsayı

İmzalı bir 32 bit tamsayıyı (örneğin, 0, 1, 2, 34) depolar.

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

Uzun metin değerlerini (örneğin, Uygulama Başlangıç Bilgileri) depolar. Bu alanlar desteklendiğinde tam metin araması için dizin oluşturur. Bkz . Başlıklara, kimliklere ve zengin metin alanlarına göre sorgulama.

picklistDouble

Ondalık değerlerin seçim listesini tutan özel alan.

picklistInteger

Tamsayı değerlerinin seçim listesini tutan özel alan.

picklistString

Kısa metin değerlerinin (255 karakter veya daha az) seçim listesini tutan özel alan.

Dize veya Metin alanı (tek satır)

En fazla 255 Unicode karakter uzunluğunda kısa metin depolar. Ekipler bu alanları genellikle seçim listeleri veya açılan menüler için kullanır.

TreePath

Dallanma ağacını temsil eder (örneğin, Alan Yolu veya Yineleme Yolu). Geçerli bir düğüm değeri seçin. Eşitlik, eşitsizlik, "Alt" / "Altı Değil" için filtreleyebilir veya işleçleri kullanarak birden çok değer belirtebilirsiniz In / Not In . Proje için ağaç yapılarını (alan yolları ve yineleme yolları) tanımlayın ve ekiplerle ilişkilendirilecek düğümleri seçin. Sorgu örnekleri için bkz . Alana veya yineleme yoluna göre sorgulama ve Tarihe veya geçerli yinelemeye göre sorgulama.

Not

Türler picklist... yalnızca devralınan bir işlem için tanımlanan özel alanlara uygulanı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.

Saat ve Yerel Ayar bölmesinde tarih düzeni açılan seçeneklerini gösteren ekran görüntüsü. Saat ve Yerel Ayar bölmesindeki Zaman Düzeni açılan seçeneklerini gösteren ekran görüntüsü.

Tarih deseni ve Saat deseni alanlarını içeren Saat ve Yerel Ayar bölmesini gösteren ekran görüntüsü.

Sorgu işleçleri

Bir yan tümce değerinin bir iş öğesinin alan değeriyle ilişkisini tanımlamak için işleçleri kullanın. Alan veri türleri için, İş öğesi alanı başvurusu'na bakın. Sorgu oluşturmayla ilgili yardım için bkz. Sorgu tanımlama.

Sorgu işleci

İşleç eşleşen iş öğelerini döndürdüğünde

Geçerli veri türleri

Yan tümce değeriyle eşleşir.

Sayı (Çift/Ondalık/GUID/Tamsayı), Dize, DateTime, TreePath

Koşul değeriyle eşleşmiyor.

Sayı, Dize, DateTime, TreePath

Yan tümce değerinden büyüktür.

Sayı, Dize, DateTime

Yan tümce değerinden küçüktür.

Sayı, Dize, DateTime

Madde değerinden büyük veya ona eşittir.

Sayı, Dize, DateTime

Koşul değerinden küçük veya buna eşittir.

Sayı, Dize, DateTime

=[Alan]

Belirtilen başka bir alandaki değerle eşleşir (aynı veri türü olmalıdır).

Aynı veri türündeki bir alanın adı (Boole alanları eşitliği diğer alanlarla karşılaştırır).

<>[Alan]

Belirtilen başka bir alandaki değerle eşleşmiyor.