Azure Boards'de iş öğesi sorgusu tanımlama

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

Visual Studio 2019 | Visual Studio 2022

İş öğesi sorguları, sağladığınız filtre ölçütlerine göre iş öğelerinin listesini oluşturur. Daha sonra bu yönetilen sorguları kaydedebilir ve başkalarıyla paylaşabilirsiniz. Buna karşılık, anlamsal aramalar iş öğelerini listeler, ancak kaydedilemez veya paylaşılamaz.

Web portalından veya Visual Studio Team Explorer ve Team Explorer Everywhere gibi desteklenen bir istemciden sorgular oluşturun. Ayrıca WIQL söz dizimi ve .wiq dosyası kullanarak bir iş öğesi sorgusu tanımlayabilir ve içeri aktarabilirsiniz. Toplu güncelleştirmeleri veya eklemeleri desteklemek için , Excel veya .csv dosyalarını kullanarak sorguları içeri veya dışarı aktarın.

Web portalından veya Visual Studio Team Explorer ve Team Explorer Everywhere gibi desteklenen bir istemciden sorgular oluşturun. Ayrıca WIQL söz dizimi ve .wiq dosyası kullanarak bir iş öğesi sorgusu tanımlayabilir ve içeri aktarabilirsiniz. Toplu güncelleştirmeleri veya eklemeleri desteklemek için , Excel'i kullanarak sorguları içeri veya dışarı aktarın.

Sorgu Düzenleyicisi, web tarayıcısı.

Sorgularınızın sonuç döndürmesinin çok uzun sürdüğünü fark ederseniz , yüksek performanslı sorgular oluşturmak için Kılavuz'u gözden geçirin.

Bu makalede şunları öğreneceksiniz:

  • Sorgu ekleme veya oluşturma
  • Projeler arasında sorgulama
  • Sorgu yan tümcelerini gruplandırma ve gruplarını çözme
  • İş öğeleri ağacı veya doğrudan bağlantılar sorgusu oluşturma

Alan veri türüne ve sorgu örneklerine göre tüm sorgu görevlerine, desteklenen işleçlere (örneğin, Contains, In, In Groupve <>(işleç değil) hızlı erişim için bkz. Sorgu hızlı başvurusu.

Sorgu filtresi seçme

Sorgu Düzenleyicisi aşağıdaki filtre işlevlerini uygulayın. Ö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 destekler. Buna ek olarak, anlamsal aramalar hem hem de *? joker karakter olarak destekler ve birden fazla karakter eşleştirmek için birden fazla joker karakter kullanabilirsiniz. Daha fazla bilgi edinmek için bkz . İşlevsel iş öğesi araması.


Filtre özellikleri

Makrolar



Sorgu Düzenleyicisi kullandığınız filtrelerle birlikte Filter işlevini kullanarak sorgu sonucunu etkileşimli olarak filtreleyebilirsiniz. Nasıl yapılacağını öğrenmek için bkz. Kapsamları, panoları, sorguları ve planları etkileşimli olarak filtreleme.

Önkoşullar

  • Varsayılan olarak, tüm proje üyeleri ve Paydaş erişimi olan 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. Ayrıntılar için bkz. Sorgu izinlerini ayarlama.
  • 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.

Not

Genel bir proje için Paydaş erişimi olan kullanıcılar, Temel erişime sahip kullanıcılar gibi sorgu özelliklerine tam erişime sahiptir. Ayrıntılar için bkz . Paydaş erişimi hızlı başvurusu.

  • Varsayılan olarak, tüm proje üyeleri ve Paydaş erişimi olan 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. Ayrıntılar için bkz. Sorgu izinlerini ayarlama.
  • 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.

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.

PanoLarı>Aç Sorguları, dikey gezinti

Sorgular'ı ilk kez açıyorsanız, sayfa Sık Kullanılanlar olarak açılır. Bu sayfada sık kullanılan olduğunu belirttiğiniz sorgular listelenir. Aksi takdirde, tanımladığınız tüm sorguları ve proje için tanımlanan sorguları paylaşılan tüm sorguları görüntülemek için Tümü'nü seçebilirsiniz.

İpucu

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

Web tarayıcınızdan Boards Sorguları'nı> açın.

Web tarayıcınızdan Boards Sorguları'nı>açın

Düz liste sorgusu tanımlama

Web portalındaki Sorgular sekmesinden veya Takım Gezgini'ndeki İş Öğeleri sekmesinden yeni ve yeni bir sorgu başlatabilirsiniz.

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ü=[Any]ve State=[Any].

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

Değerler'i değiştirebilir ve yan tümceleri ekleyebilir veya kaldırabilirsiniz. Ya da sorgunun Türü'nüİş öğeleri ve doğrudan bağlantılar olarak ya da iş öğeleri ağacı olarak değiştirebilirsiniz.

Sorgular sayfasının ekran görüntüsü, açılan menüden Yeni sorgu seç'i seçin.

Sorgu Düzenleyicisi şu varsayılan ayarlarla görüntülenir: İş öğelerinin düz listesi, Takım Projesi=@Project (geçerli proje), İş Öğesi Türü=[Any]ve State=[Any].

TFS 2018 ve önceki sürümler gibi iş öğelerinin düz listesinin seçili olduğu Sorgu Düzenleyicisi ekran görüntüsü.

Değerler'i değiştirebilir ve yan tümceleri ekleyebilir veya kaldırabilirsiniz. Ya da sorgunun Türü'nüİş öğeleri ve doğrudan bağlantılar olarak ya da iş öğeleri ağacı olarak değiştirebilirsiniz.

Projeler arasında veya proje içinde sorgulama

Yeni sorgular varsayılan olarak geçerli projenin kapsamıdır. 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 sorgu onay kutusunu 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ü.

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 diğer alanların filtreye eklendiği 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 (,).

Takım Projesi alanı yalnızca Projeler arasında sorgu'yu denetledikten sonra kullanılabilir. Ayrıca , 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üntülenir. Projeler arasında sorgu seçeneği işaretlendiğinde, koleksiyondaki tüm projelerde tanımlanan tüm iş öğesi türlerindeki tüm alanlar Alan açılan menüsünde görüntülenir.

Yan tümce tanımlama

Bir veya daha fazla yan tümce tanımlayarak sorgu oluşturursunuz. Her yan tümcesi, tek bir alan için bir filtre ölçütü tanımlar.

Örnek sorgu yan tümcesi

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

Alan veri türüne göre kullanılabilir işleçlerin listesi için bkz. Sorgu dizini hızlı başvurusu.

Eklediğiniz tüm yan tümceler And deyimi olarak eklenir. Gruplandırmayı değiştirmek için Veya'yı seçin. Yan tümce deyimlerinin gerekli sırayla çalıştırıldığından emin olmak için yan tümceleri gruplandırabilirsiniz.

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ümcesinin 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 parantezlerin 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 edinmek için bkz. İş Öğesi Sorgu Dili (WIQL) söz dizimi.

Sorgu yan tümcesi tanımlama denetim listesi

  1. İlk boş satırda, Alan sütun başlığı 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 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 yazın veya aşağı oku seçin ve listeden bir öğe seçin.

    Geçerli projeyi, kullanıcıyı, tarihi veya diğer seçimi belirtmek için 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
    • Ungroup yan tümceleri

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

İş öğelerinin çok katmanlı, iç içe yerleştirilmiş 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 Plans, 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 Plans sayfasından görüntüleyebilirsiniz.

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

Ağaç Sorgusu, TFS 2018 görünümünü 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ğımlı 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 yaptığı taahhütleri 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ü.

şu 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 yalnızca bağ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ı olan ikinci katman iş öğeleri, bağlantı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 filtre ölçütleri tarafından belirtilen iş öğelerine bağlantıları yoksa döndürülür.

Her bağlantı türü hakkında daha fazla bilgi edinmek için bkz. Bağlama, izlenebilirlik ve bağımlılıkları yönetme.

And/Or mantıksal ifadesi

Sorgu yan tümcelerinizin mantıksal ifadelerini oluşturmak için And veya Or belirtirsiniz. Hem geçerli yan tümcedeki hem de önceki yan tümcedeki ölçütlere uyan iş öğelerini bulmak için Ve belirtin. Geçerli yan tümcede veya önceki yan tümcede ölçüte uyan iş öğelerini bulmak için Or belirtin.

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. Yan tümceleri gruplandırma, matematiksel denklemde veya mantık deyiminde ifadenin etrafına parantezler koymaya benzer. Yan tümceleri gruplandırdığınızda, gruptaki ilk yan tümce için AND 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 ilk yan tümcenin And veya 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.

İpucu

Bir sorgunun WIQL söz dizimini görüntülemek için, herhangi bir Sorgu UI girişinin WIQL sürümünü görmenize olanak tanıyan WIQL sorgu düzenleyicisi uzantısını yükleyin. Bu uzantı, AND/OR gruplandırılmış yan tümcelerinin nasıl işlendiğini görmenizi sağlar.

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ı gruplar. OR işleci State ve Assigned alanlarını gruplar.
2 Hem İş öğesi türü alanının hem de Durum alanının veya Atanan alanının filtrelerini 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. Bu alanlar AND işleciyle bağlantılıdı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ının Sorgu Düzenleyicisi, Seçili Sorgu Yan Tümcelerini Gruplandırma ekran görüntüsü.

Gruplandırılmış birkaç yan tümceyi de gruplandırabilirsiniz. Zaten gruplandırılmış olan 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 şu adımları izleyin:

  • Her yan tümcenin istediğiniz şekilde tanımlandığından emin olun.
  • Her yan tümceye Ve/Veya atamalarını doğrulayın. Sonuçlarınız beklenenden daha fazla iş öğesi içeriyorsa, genellikle And yan tümcesi yerine or yan tümcesi bulunur.
  • Sorgu yan tümcelerinin ve gruplandırılmış yan tümcelerinin 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ılabilecek seçenekleri gözden geçirin.

Yan tümcesi grubunu çözme

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

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.

Panoya pencere öğeleri ekleme hakkında daha fazla bilgi edinmek 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 görüntüde , Ü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ü.

Sorguları tanımlamanın temelleri bunlardır. Sorgu örneklerinin dizini için bkz . Sorgu hızlı başvurusu.