İş öğesi sorgusu tanımlama

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

Visual Studio 2019 | Visual Studio 2022

Azure Boards'taki iş öğesi sorguları, sizin sağladığınız filtre ölçütlerine göre iş öğelerinin listesini oluşturur. Bu yönetilen sorguları kaydedebilir ve başkalarıyla paylaşabilirsiniz.

Bu makalenin devamında önerilen en iyi yöntemlerimize göz atın.

Önkoşullar

Sorgu filtresi seçme

Sorgu Düzenleyicisi, örnek sorgular içeren bir makaleye atlamak için filtreyi seçin. Sorgu filtreleri ile birlikte, sorgu sonuçlarına etkileşimli olarak filtre uygulayabilirsiniz.

Filter işlevini kullanarak sorguyu etkileşimli olarak filtreleyebilirsiniz.

Sorguları Aç

Düz liste sorgusu tanımlama

Web portalındaki Sorgular sekmesinden veya Ekip Gezgini'ndeki İş Öğeleri sekmesinden yeni bir sorgu başlatın.

Projeler arasında veya proje içinde sorgulama

Yeni sorgular, varsayılan olarak geçerli projenin kapsamına girer. Ancak, kuruluş veya proje koleksiyonu içinde tanımlanan iş öğelerini bulmak için sorgular oluşturabilirsiniz. Ancak kaydettiğiniz tüm sorgular belirli bir proje altına kaydedilir.

Yan tümce tanımlama

Sorgu oluşturmak için bir veya daha fazla yan tümce tanımlayın. Her yan tümce, tek bir alan için bir filtre ölçütü tanımlar.

Örnek sorgu yan tümcesi

Alan veri türünü temel alan kullanılabilir işleçlerin listesi için bkz . Sorgu dizini hızlı başvurusu.

Tüm yan tümceler And deyimi olarak eklenir. Gruplandırma işlemini değiştirmek için Veya'ı seçin. Yan tümce deyimlerinin gerekli sırada çalıştırıldığından emin olmak için yan tümceleri gruplandırın.

Sorgu yan tümcesi tanımlamak için denetim listesi

1. İlk boş satırda, Alan sütunu başlığının altında, kullanılabilir alanların listesini görüntülemek için aşağı oku seçin ve listeden bir öğe seçin. Daha fazla bilgi için bkz . Sorgu Alanları ve Değerler.

2. Aynı satırda, İşleç sütun başlığı altında, kullanılabilir işleçlerin listesini görüntülemek için aşağı oku seçin ve ardından listeden bir öğe seçin. Daha fazla bilgi için bkz . İşleçler.

3. Aynı satırda, Değer sütun başlığı altında bir değer girin veya aşağı oku seçin ve ardından listeden bir öğe seçin. Geçerli projeyi, kullanıcıyı, tarihi veya diğer seçimi belirtmek üzere makro veya değişken kullanma hakkında daha fazla bilgi için bkz . Değişkenler.

4. Yan tümce eklemek için Yeni yan tümce ekle'yi seçin.

   Sorgunun sonuna bir yan tümce ekleyebilir veya karşılık gelen simgelerle aşağıdaki görevleri gerçekleştirebilirsiniz:

   • Yeni filtre satırı ekle
   • Bu filtre satırını kaldır
   • Seçili yan tümceleri gruplandırma
   • Yan tümcelerini çözme

Hiyerarşileri görüntülemek için iş öğesi ağacı kullanma

çok katmanlı, iç içe yerleştirilmiş iş öğelerinin listesini görüntülemek için İş Öğeleri Ağacı sorgusunu kullanın. Örneğin, tüm kapsam öğelerini ve bağlantılı görevlerini görüntüleyebilirsiniz. Ağacın farklı bölümlerine odaklanmak için Tümünü genişlet veya Tümünü daralt'ı seçin.

Bağımlılıkları görüntülemek için doğrudan bağlantıları kullanma

Görevler, hatalar, sorunlar veya özellikler gibi diğer izlenen işlere bağlı iş öğelerini izlemek için İş öğeleri ve Doğrudan bağlantılar sorgusunu kullanın. Örneğin, uygulanan diğer öğelere veya düzeltilen bir hataya bağlı kapsam öğelerini görüntüleyebilirsiniz.

Ekipler arasında bağımlılıkları izlemek için doğrudan bağlantılar sorgusunu kullanın. Sorgu ayrıca ekibinizin taahhütlerini yönetmenize de yardımcı olur. En üstteki ve bağlantılı iş öğeleri için filtre ölçütlerini seçin. Bağımlılıkları filtrelemek için bağlantı türlerini seçin.

Her bağlantı türü hakkında daha fazla bilgi için bkz . Bağlantı türü başvurusu.

ve/veya mantıksal ifade kullanma

Sorgu yan tümcelerinizin mantıksal ifadelerini oluşturmak için veya Or belirtinAnd. Hem geçerli yan tümcede hem de önceki yan tümcede ölçütleri karşılayan iş öğelerini bulmak için kullanın And . Geçerli yan tümcede veya önceki yan tümcede ölçüte uyan iş öğelerini bulmak için kullanın Or .

Arama ölçütlerinizi daraltmak için her iş öğesi alanı için yeni bir yan tümce ekleyin. Yalnızca istediğiniz iş öğeleri kümesini döndürmek için yan tümceler ekleyin. Sorgunuzdan beklediğiniz sonuçları almazsanız, daraltın. Sorgu sonuçlarınızı geliştirmek için sorgu yan tümceleri ekleyebilir, kaldırabilir, gruplandırabilir veya grubu çözebilirsiniz.

Sorgu yan tümcelerini, sorgunun geri kalanından ayrı tek bir birim olarak çalışacak şekilde gruplandırın. Gruplandırma yan tümceleri, matematiksel denklemde veya mantıksal deyimde ifadenin çevresine parantez yerleştirmeye benzer. Yan tümceleri gruplandırdığınızda, And gruptaki ilk yan tümce için veya Or tüm gruba uygulanır.

Grup yan tümceleri

Gruplandırılmış yan tümceler, sorgunun geri kalanından ayrı tek bir birim olarak çalışır. Yan tümceleri gruplandırma, matematiksel denklemin veya mantık ifadesinin etrafına parantezler koymaya benzer. Gruptaki And ilk yan tümcenin or Or işleci grubun tamamı için geçerlidir.

Aşağıdaki örneklerde gösterildiği gibi, gruplandırılmış yan tümceler ilgili mantıksal ifadeye çevrilir.

Sorgu	Gruplandırılmış yan tümceler	Mantıksal ifade
1
2
3

Bu sorgular Hata türündeki iş öğelerini döndürür ve aşağıdaki mantıksal ifadeleri karşılar:

• Sorgu 1: AND State=Active OR Assigned to @Me
• Sorgu 2: AND (State=Active OR Assigned to @Me)
• Sorgu 3: OR (State=Active AND Assigned to @Me)

Bir veya daha fazla yan tümceyi gruplandırmak için, bunları seçin ve ardından grup yan tümceleri simgesini seçin .

Gruplandırılmış birkaç yan tümceyi de gruplandırabilirsiniz. Her yan tümcenin kutularını işaretleyin. Ardından grup yan tümceleri simgesini seçin .

Sorgu sonuçlarınız beklenen sonuçları döndürmezse aşağıdaki adımları uygulayın:

• Her yan tümcenin istediğiniz gibi tanımlandığından emin olun.
• Her yan tümceye atamaları doğrulayın And/Or . Sonuçlarınız beklenenden daha fazla iş öğesi içeriyorsa, genellikle yan Or tümce yerine bir And yan tümcesi bulunur.
• Sorgu yan tümcelerinin ve gruplandırılan her yan tümcenin And/Or atamalarının gruplandırılması veya değiştirilmesi gerekip gerekmediğini belirleyin.
• Sorgu filtresi ölçütlerinizi daraltmak için daha fazla sorgu yan tümcesi ekleyin.
• Alanları, işleçleri ve değerleri belirtmek için kullanılabilen seçenekleri gözden geçirin.
• Bu makalenin devamında yer alan en iyi yöntemlere bakın.

Yan tümcenin grubunu çözme

Bir yan tümcenin grubunu çözmek için gruplandırılmış yan tümcesi için yan tümceleri gruplandır simgesini seçin.

Sorgu sonuçlarında varsayılan sütun genişliğini ayarlama

Sorgu sonuçlarında varsayılan sütun genişliğini ayarlamak için aşağıdaki adımları uygulayın:

1. Değiştirmek istediğiniz sorguyu açın.
2. Sütun başlıklarının kenarlarını sürükleyerek sütun genişliklerini istediğiniz boyuta el ile ayarlayın.
3. Yeni bir sorgu olarak kaydetmek istiyorsanız Kaydet veya Farklı Kaydet'i seçin.
4. Sütun genişliklerinin korunmasını sağlamak için sorguyu kapatıp yeniden açın.

Azure DevOps şu anda tüm oturumlarda kalıcı olan varsayılan bir sütun genişliği ayarlamayı desteklememektedir. Sütun genişlikleri sorgu başına kaydedilir, bu nedenle bunları her sorgu için ayrı ayrı ayarlamanız ve kaydetmeniz gerekir.

Panoda sorgu sonuçlarını görüntüleme

Aşağıdaki iki pencere öğesi sorgu sonuçlarını görüntüler. İş öğelerini doğrudan bu pencere öğelerinden açabilirsiniz.

• Bana atanan çalışma: Oturum açmış kullanıcıya atanan tüm önerilen veya etkin iş öğelerini listeler. Kimlik, Durum ve Başlık alanlarını listeler.
• Sorgu sonuçları pencere öğesi: Düz, ağaç veya doğrudan bağlantılar sorgusunun sonuçlarını görüntüler. Pencere öğesi aracılığıyla görüntülenen alanları yapılandırabilir, sütun alanlarını yeniden boyutlandırabilir, ağaç ve doğrudan bağlantılar sorgusunu genişletip daraltabilirsiniz.

Daha fazla bilgi için bkz . Panoya pencere öğeleri ekleme.

Sorguyu köprü olarak tanımlama

Sorgu köprüsü Transact-SQL'e benzeyen İş Öğesi Sorgu Dili'ni (WIQL) kullanır. Daha fazla bilgi için bkz . İş Öğesi Sorgu Dili (WIQL) söz dizimi.

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

https://{ServerName}/{CollectionName}/{ProjectName}/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%2C%20%5BSystem.State%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'%20%20

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=
SELECT [System.ID], [System.Title], [System.State] 
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug' 
   AND [System.AreaPath]='FabrikamFiber\Web'   

En iyi yöntemler

Aşağıdaki en iyi yöntemler, oluşturabileceğiniz aşağıdaki sorgular için geçerlidir:

Odaklanmış, seçmeli sorgular oluşturma

Sorgunuz için gerekli olan tüm filtreleri uygulayarak yüksek oranda seçmeli bir sorgu tanımlayın. Sorgu ne kadar seçmeli olursa sonuç kümesi o kadar küçük olur. Sonuç kümesi ne kadar küçük olursa sorgunuz o kadar hedefli ve seçmeli olur.

İş öğelerini kategorilere ayırmak için etiketleri kullanma

İş öğelerinizi özel alan yerine kategorilere ayırmak için iş öğesi etiketlerini kullanın. Etiketlere göre filtre uygulayan sorgular genellikle dize eşleşmelerine göre filtre uygulayan sorgular üzerinde daha hızlı çalışır.

Özel alan eşleşmelerinin veya kısmi eşleşmelerin aksine, işlemi olan bir Tags Contains sorgu tüm iş öğesi tablolarının tam olarak taranması gerekmez.

Dize eşleşmeleri için kullanın Contains words

Bir dize eşleşmesini filtrelemek için işleci yerine öğesini Contains Words Contains kullanın. İşleç Contains Words , belirtilen alanda tam metin araması çalıştırır ve bu arama daha hızlı tamamlanma eğilimindedir.

işleci Contains , işleçten daha Contains Words yavaş bir işlem olan bir tablo taraması çalıştırır. Ayrıca daha fazla CPU döngüsü kullanır. Bu CPU döngüleri hız sınırlamalarıyla karşılaşmanıza neden olabilir. Daha fazla bilgi için bkz . Oran ve kullanım sınırları.

işleciyle In Group küçük gruplar belirtme

işleç, In Group bir değer grubu içindeki eşleşmelere göre iş öğelerini filtreler. Değer grubu bir ekip, güvenlik grubu veya iş izleme kategorisi içinde yer alan değerlere karşılık gelir. Örneğin, bir ekibin herhangi bir üyesine atanan tüm iş öğelerini bulmak için bir sorgu oluşturabilirsiniz. İsterseniz, gereksinimler kategorisine (Microsoft.RequirementCategory ) ait tüm iş öğelerini de bulabilirsiniz.

Çok sayıda üye içeren bir gruba filtre eklediğinizde, sonuç kümeniz daha büyük ve seçimsiz olma eğilimindedir. Ayrıca, bir grup büyük bir Microsoft Entra grubuna karşılık geliyorsa, sorgu bu grubu Microsoft Entra Id'den çözümlemek için oldukça büyük bir maliyet oluşturur.

Olumsuz işleçler kullanmaktan kaçının

Örneğin <>, Not In, Not Under, Not In Group, olumsuzlanan işleçler, seçici olmayan sorgular ve büyük sonuç kümeleri oluşturma eğilimindedir.

Yalnızca gerektiğinde olumsuz işleçler kullanın. Her zaman önce alternatifleri bulmaya çalışın. Örneğin, Alan1 A, B, C, D değerlerine sahipse, negatif yan Field1 <> D tümcesi yerine yan tümcesini belirtinField1 In A, B, C.

Dize karşılaştırmalarından kaçının

Dize karşılaştırmaları içeren sorgular, doğası gereği verimsiz tablo taramaları oluşturur. Bunun yerine, özellikle bir sorgu kötü performans sergilediğinde alternatif olarak etiketleri veya belirli bir özel alanı kullanmanızı öneririz.

İşleçleri sınırlama Or

Sorgunuzda tanımlanan işleç sayısını Or sınırlayın. Daha az Or işleç kullanıldığında sorgular daha iyi çalışır. Çok fazla Or işleç sorgunuzun seçimsiz olmasını sağlayabilir. Sorgunuz yavaş çalışıyorsa, işleç yan tümcesini sorgu yan tümcelerinin en üstüne doğru yeniden sıralar Or .

Sorgunuzu kaydetme

İç iyileştirmeler nedeniyle kaydedilen sorgular kaydedilmemiş sorgulara göre daha iyi performans gösterme eğilimindedir. Sorgunuzu yeniden kullanmak istediğinizde her zaman kaydedin. WIQL sorguları rest API üzerinden çalıştırılsa bile, REST API çağrılarınızı yapmak için web portalı aracılığıyla WIQL'i kaydedin; böylece gelecekteki performans regresyonlarına daha az eğilimli olurlar.

Sorgunuzu çalıştırma

Bazen doğru iyileştirme planına ulaşmak için sorgunuzu birkaç kez çalıştırmanız gerekir. Sorgunuzu kaydettiğinizden ve 30 dakikalık bir süre boyunca en fazla 10 kez çalıştırdığınızdan emin olun. Bu şekilde, sistem sorgunuz için en uygun iyileştirme planını inceleyebilir ve arayabilir.

İlgili makaleler

• Sorgu hızlı başvurusu.
• Sorgu hakkında SSS
• Düz liste sorgusu grafiği oluşturma
• Sütun seçeneklerini değiştirme
• İş öğesi alan dizini
• Klavye kısayolları