Aracılığıyla paylaş

İş öğesi sorgusu tanımlama

  • Makale

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.

Web portalından veya Visual Studio Ekip Gezgini gibi desteklenen bir istemciden sorgu oluşturabilirsiniz. Toplu güncelleştirmeleri veya eklemeleri desteklemek için Excel veya .csv dosyalarını kullanarak sorguları içeri veya dışarı aktarın.

Not

Bu makalede kullanılan tarayıcı görüntüleri, varsayılan olarak etkin olan New Boards Hubs özelliğinden alınıyor. Bu özellik etkinleştirilmediyse, önceki pano deneyimini kullanıyor olabilirsiniz. Önceki deneyimin görüntülerini görüntülemek için bu makalenin Azure DevOps Server 2022 sürümünü seçin.

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

Önkoşullar

  • Erişim düzeyleri:
    • Paydaşların paylaşılan sorguları görüntülemesine ve çalıştırmasına olanak sağlayın. Tüm proje üyeleri varsayılan olarak Paydaş erişimine sahiptir. Daha fazla bilgi için bkz . Paylaşılan sorgu veya klasörün izinlerini değiştirme.
    • Paylaşılan sorgu eklemek ve kaydetmek için Temel veya daha yüksek erişime sahip olun.
  • İzinler: Sorgu eklemek istediğiniz klasör için Katkıda Bulunma izninizin İzin Ver olarak ayarlanmasını sağlayın. Varsayılan olarak Katkıda Bulunanlar grubunun bu izni yoktur.

Not

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

  • Erişim düzeyleri: Varsayılan olarak, paydaş erişimi olan tüm proje üyeleri ve kullanıcılar tüm paylaşılan sorguları görüntüleyebilir ve çalıştırabilir. Paylaşılan sorgu klasörü veya paylaşılan sorgu için ayarlanan izinleri değiştirebilirsiniz. Daha fazla bilgi için bkz . Sorgu izinlerini ayarlama.
  • İzinler: Paylaşılan sorgular altında sorgu eklemek ve kaydetmek için Temel erişim veya daha yüksek bir değer verilmelidir. Ayrıca, sorguyu eklemek istediğiniz klasör için Katkıda Bulunma izninizin İzin Ver olarak ayarlanmış olması gerekir. Varsayılan olarak Katkıda Bulunanlar grubunun bu izni yoktur.

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.

Not

Yönetilen sorgular yakınlık aramalarını desteklemez, ancak anlamsal aramalar bunu yapar. Anlamsal aramalar hem hem de * ? joker karakter olarak da desteklenir ve birden fazla karakter eşleştirmek için birden fazla joker karakter kullanabilirsiniz. Daha fazla bilgi için bkz . İşlevsel iş öğesi arama.

Filtre özellikleri

Makrolar

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

Sorguları Aç

Web tarayıcınızdan(1) doğru projeyi seçtiğinizden emin olun, (2) Pano > Sorguları'nı seçin ve ardından (3) Tümü'ne tıklayın.

Sorgular sayfasının ekran görüntüsü.

Sorgular sayfası, sık kullanılan olarak ayarladığınız sorguları listeleyen Sık Kullanılanlar sekmesinde açılır. Tanımladığınız tüm sorguları ve proje için paylaşılan sorguları görüntülemek için Tümü sekmesini seçebilirsiniz.

İpucu

Sizin veya ekibinizin sık kullanılanlar olarak seçtiği sorgular Sık Kullanılanlar sayfasında görünür. Sık kullanılan sorgular ve diğer nesneler Project sayfanızda da görünür. Daha fazla bilgi için bkz . Kişisel veya ekip sık kullanılanlarını ayarlama.

Projenizden Pano > Sorguları'nı ve ardından Tümü'ne tıklayın.

Sorgular sayfasının ekran görüntüsü.

Sorgular sayfası, sık kullanılan olarak ayarladığınız sorguları listeleyen Sık Kullanılanlar sekmesinde açılır. Tanımladığınız tüm sorguları ve proje için paylaşılan sorguları görüntülemek için Tümü sekmesini seçebilirsiniz.

İpucu

Sizin veya ekibinizin sık kullanılanlar olarak seçtiği sorgular Sık Kullanılanlar sayfasında görünür. Sık kullanılan sorgular ve diğer nesneler Project sayfanızda da görünür. Daha fazla bilgi için bkz . Kişisel veya ekip sık kullanılanlarını ayarlama.

Düz liste sorgusu tanımlama

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

  1. Yeni Yeni sorgu'yu> seçin.

Yeni sorgu, yeni deneyim ekleme ekran görüntüsü.

Sorgu Düzenleyicisi şu varsayılan ayarlarla görüntülenir: İş öğelerinin düz listesi, İş Öğesi Türü=[Herhangi biri]ve State=[Any].

İş öğelerinin düz listesinin seçili olduğu Sorgu Düzenleyicisi ekran görüntüsü.

  1. Değerler'i değiştirin ve yan tümceleri ekleyin veya kaldırın ya da sorgu türünü İş öğeleri ve doğrudan bağlantılar ya da iş öğeleri ağacı olarak değiştirin.
  1. Yeni Yeni sorgu'yu> seçin.

Yeni sorgu, yeni deneyim ekleme ekran görüntüsü.

Sorgu Düzenleyicisi şu varsayılan ayarlarla görüntülenir: İş öğelerinin düz listesi, İş Öğesi Türü=[Herhangi biri]ve State=[Any].

İş öğelerinin düz listesinin seçili olduğu Sorgu Düzenleyicisi ekran görüntüsü.

  1. Değerler'i değiştirin ve yan tümceleri ekleyin veya kaldırın ya da sorgu türünü İş öğeleri ve doğrudan bağlantılar ya da iş öğeleri ağacı olarak değiştirin.

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.

İki veya daha fazla projede tanımlanan iş öğelerini listelemek için Projeler arasında sorgula onay işaretini işaretleyin. Örneğin, aşağıdaki sorgu son 30 gün içinde tüm projelerde oluşturulan tüm özellikleri bulur.

Projeler arasında sorgula seçeneği işaretli Sorgu Düzenleyicisi ekran görüntüsü.

Proje seçimlerinde sorgula'nın ekran görüntüsü.

Projeler arasında sorgu işaretlendiğinde, belirli sayıda projeye filtre uygulamak için Takım Projesi alanını ekleyebilirsiniz.

Takım Projesi ve filtreye eklenen diğer alanları içeren Sorgu Düzenleyicisi ekran görüntüsü.

Takım Projesi ve filtreye eklenen diğer alanları içeren Sorgu Düzenleyicisi ekran görüntüsü.

Not

  • birden çok proje adını, 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 ,.
  • Bir sorguda 'State' alanını birden çok projede kullandığınızda, görüntülenen değerler varsayılan projede tanımlanan değerlerle sınırlıdır. Başka bir deyişle, projeler arasında sorgu kullanıyorsanız, her projedeki tüm olası durum değerlerini göremeyebilirsiniz, ancak yalnızca projeden varsayılan olarak ayarlanan değerleri görebilirsiniz. Örneğin, üç projeniz (Proje A, Proje B ve Proje C) varsa ve yalnızca Proje A'nın 'Gözden Geçirildi' adlı bir durumu varsa, B ve C Projeleri farklı durumlara sahipse, bu projeler arasında sorgulama yalnızca Proje A'da tanımlanan durumları gösterir.
  • Takım Projesi alanı yalnızca projeler arasında sorgu seçeneğini işaretledikten sonra kullanılabilir.
  • Projeler arasında sorgu denetimi yapıldığında, koleksiyondaki tüm projelerde tanımlanan tüm iş öğesi türlerindeki tüm alanlar Alan açılan menüsünde görünür.
  • Projeler arasında sorgu seçeneğinin işareti kaldırıldığında, alan açılan menüsünde yalnızca geçerli projede tanımlandığı gibi bu iş öğesi türlerindeki alanlar görünür.

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

Ve/Veya Alan İşleç Değer
And Atanan = @Me

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.

Sorgunun sonuna başka bir yan tümce eklemek için Yeni yan tümce ekle'yi seçin ve ardından bu yan tümce için Alan, İşleç ve Değer'i seçin.

Yan tümcenin nasıl ekleneceğini gösteren Sorgu Düzenleyicisi ekran görüntüsü.

Yan tümcenin nasıl ekleneceğini gösteren Sorgu Düzenleyicisi ekran görüntüsü.

Örneğin, Atanan alanını, eşittir (=) işlecini ve kullanıcı kimliğinizi temsil eden @Me makroyu belirterek size atanan tüm iş öğelerini arayın.

İpucu

Sorgunun WIQL söz dizimini ve yan tümceleri gruplandırmak için parantezin nasıl kullanıldığını görüntülemek için Market Wiql Düzenleyicisi'ni yükleyin. Bu uzantı, WIQL söz dizimini görüntülemeyi ve REST API çağrılarında kullanılmak üzere bir WIQL dosyasına dışarı aktarmayı destekler. Daha fazla bilgi için bkz . İş Öğesi Sorgu Dili (WIQL) söz dizimi.

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.

Not

Test Planları, Test Paketleri ve Test Çalışmaları'nın hiyerarşik görünümünü gösteren bir sorgu oluşturamazsınız. Bu öğeler üst-alt bağlantı türleri kullanılarak birbirine bağlanmaz. Ancak, testle ilgili iş öğelerini listeleyen bir doğrudan bağlantılar sorgusu oluşturabilirsiniz. Ayrıca, Hiyerarşiyi Test Planları sayfasından görüntüleyebilirsiniz.

Ağaç Sorgusunu gösteren Sorgu Sonuçları Listesi'nin ekran görüntüsü.

Hem üst hem de alt iş öğeleri için filtre ölçütlerini tanımlayın. Bağlantılı alt öğeleri bulmak için önce Üst düzey iş öğelerini eşleştir'i seçin. Bağlantılı ana öğeleri bulmak için önce Bağlantılı iş öğelerini eşleştir'i seçin.

İş öğeleri ağacının Sorgu Düzenleyicisi görünümünün ekran görüntüsü.

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.

Doğrudan Bağlantılar Sorgu Sonuçlarının ekran görüntüsü.

Sorgu Düzenleyicisi, Doğrudan Bağlantılar Sorgusu'nun ekran görüntüsü.

aşağıdaki seçeneklerden birini belirleyerek ilk katman iş öğeleri listenizi filtreleyin:

  • Yalnızca eşleşen bağlantıları olan öğeleri döndür: birinci katman iş öğeleri, ancak bağlantılı iş öğeleri tarafından belirtilen iş öğelerine bağlantıları varsa filtre ölçütleri döndürür.
  • Tüm en üst düzey öğeleri döndür: Tüm birinci katman iş öğeleri, bağlı iş öğeleri filtre ölçütlerine rağmen geri döner. İlk katmana bağlı ikinci katman iş öğeleri, bağlı iş öğeleri filtre ölçütlerine uyuyorsa geri döner.
  • Yalnızca eşleşen bağlantıları olmayan öğeleri döndür: İlk katman iş öğeleri döndürülür, ancak yalnızca bağlı iş öğeleri tarafından belirtilen iş öğelerine bağlantıları yoksa filtre ölçütü.

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 Grup yan tümcesi sorgusunu gösteren ekran görüntüsü. Filtreler, İş öğesi türü alanı ve Durum alanı veya Atanan alanı için ayarlanır. Mantıksal ifadenin ekran görüntüsü. AND işleci İş öğesi türü, Durum ve Atanan alanlarını gruplandırr. OR işleci State ve Assigned alanlarını gruplandırabilir.
2 Hem İş öğesi türü alanı hem de Durum alanından biri veya Atanan alanı için filtreler içeren grup yan tümcesi sorgusunu gösteren ekran görüntüsü. Mantıksal ifadenin ekran görüntüsü. AND işleci, İş öğesi türünü, OR işlecine göre gruplandırılmış Durum veya Atanan alanlarıyla gruplandırıyor.
3 Grup yan tümcesi sorgusunu gösteren ekran görüntüsü. Filtreler, İş öğesi türü alanı veya hem State alanı hem de Atanan alanı için ayarlanır. Mantıksal ifadenin ekran görüntüsü. OR işleci, İş öğesi türünü hem State hem de Assigned alanlarına bağlar ve bu alanlar and işleci tarafından bağlanır.

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 .

Web portalı, Sorgu Düzenleyicisi, Seçili Sorgu Yan Tümcelerini Gruplandır seçeneğinin ekran görüntüsü.

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 .

Web portalı, Sorgu Düzenleyicisi, Birden çok sorgu yan tümcesini gruplandırma ekran görüntüsü.

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.

Üst başlıklarla sorgu sonuçlarını görüntüleme pencere öğesi

Üst başlık görüntülendiğinde sorgunun sonuçlarını görüntüleyebilirsiniz. Bunu yapmak için şu adımları gerçekleştirin:

  1. İlgilenen iş öğelerini filtreleyen sorguyu oluşturun. Sorgu düz liste, ağaç veya doğrudan bağlantılar sorgusu olabilir.
  2. Üst alanı sütun olarak ekleyin.
  3. Sorguyu Paylaşılan sorgu veya Ekip sık kullanılanı olarak kaydedin.
  4. Sorgu sonuçları pencere öğesini panonuza ekleyin ve sorguyu yapılandırın. Üst alanın görüntülenecek şekilde ayarlandığından emin olun.

Aşağıdaki resimde, Üst alanı görüntüleyen bir sorgu sonuçları pencere öğesi gösterilmektedir.

Üst sütun alanını gösteren sorgu sonuçları pencere öğesinin ekran görüntüsü.

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.

Not

Çoğu tarayıcı, URL dizesi için 2000 ile 2083 karakter arasında bir sınır uygular.

URL söz diziminin WIQL bölümünü kodlar. URL'nizi kodlamak için herhangi bir URL kodlayıcı aracını kullanabilirsiniz.

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

Örneğin, aşağıdaki köprü fabrikam kuruluşu için FabrikamFiber/Web alanı yolu altında tanımlanan tüm etkin hataların kimliğini ve başlığını listeler.

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'

Kodu çözülen WIQL aşağıdakilere uygundur:

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

Not

Azure Boards sorguları için WIQL uzunluğu 32K karakteri aşmamalıdır.

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

Örneğin, aşağıdaki köprü FabrikamFiber/Web alanı yolu altındaki tüm hataların kimliğini, başlığını ve durumunu listeler.

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

Örneğin, aşağıdaki kodlanmamış girişe bakın.

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.