Sorgu tanımlama

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

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

web portalından veya Visual Studio Takım Gezgini ve Team Explorer Everywhere gibi desteklenen bir istemciden sorgu oluşturabilirsiniz. Ayrıca WIQL söz dizimi ve bir. 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 Takım Gezgini ve Team Explorer Everywhere gibi desteklenen bir istemciden sorgu oluşturabilirsiniz. Ayrıca WIQL söz dizimi ve bir. wiq dosyasıkullanarak bir iş öğesi sorgusu tanımlayabilir ve içeri aktarabilirsiniz. Toplu güncelleştirmeleri veya eklemeleri desteklemek için Excelkullanarak sorguları içeri veya dışarı aktarın.

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

Sorgularınızın sonuçları döndürmesi çok uzun sürdüğünü fark ederseniz, yüksek performanslı sorgular oluşturma kılavuzunugözden geçirin.

Bu makalede şunları öğreneceksiniz:

  • Sorgu ekleme veya oluşturma
  • Projeler arasında sorgu oluşturma
  • Sorgu yan tümcelerini gruplama ve grubunu çözme
  • İş öğeleri ağacı veya doğrudan bağlantılar sorgusu oluşturma

Tüm sorgu görevlerine hızlı erişim için, — Contains In In Group alan veri türüne göre,,,, ve <> (işleç değil) gibi desteklenen işleçler — ve sorgu örnekleri için bkz. sorgu hızlı başvurusu.

Sorgu filtreleri

Sorgu Düzenleyicisi ' nden aşağıdaki filtre işlevlerini uygulayabilirsiniz. Örnek sorgularla bir makaleye gitmek için filtreyi seçin. Sorgu filtrelerine ek olarak, sorgu sonuçlarına etkileşimli filtreler uygulayabilirsiniz.

Not

Yönetilen sorgular, yakınlık aramalarını desteklemez, ancak anlamsal aramalar bunu yapar. Ayrıca, semantik aramalar hem hem de * ? joker karakter olarak destekler ve birden fazla karakterle eşleşen birden fazla joker karakter kullanabilirsiniz. Daha fazla bilgi için bkz. işlevsel iş öğesi arama.


Filtre Özellikleri

Makrolar



Sorgu düzenleyicisinden kullandığınız filtrelerin yanı sıra, filtre işlevini kullanarak bir sorgu sonucunu etkileşimli olarak filtreleyebilirsiniz . Nasıl yapılacağını öğrenmek için bkz. etkileşimli olarak biriktirme listeleri, panolar, sorgular ve planlar.

Önkoşullar

  • Varsayılan olarak, Paydaş erişimi olan tüm proje üyeleri ve kullanıcılar tüm paylaşılan sorguları görüntüp çalıştırabilirsiniz. Paylaşılan sorgu klasörü veya paylaşılan sorgu için ayarlanmış izinleri değiştirebilirsiniz. Ayrıntılar için bkz. Sorgu izinlerini ayarlama.
  • Paylaşılan sorgular altına bir sorgu eklemek ve kaydetmek için Temel erişim veya daha yüksek bir erişime sahipsiniz. Ayrıca, sorguyu eklemek istediğiniz klasör için Katkıda Bulun iznini İzin Ver olarak ayarlayabilirsiniz. Varsayılan olarak Katkıda Bulunanlar grubunun bu izni yok.

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, Paydaş erişimi olan tüm proje üyeleri ve kullanıcılar tüm paylaşılan sorguları görüntüp çalıştırabilirsiniz. Paylaşılan sorgu klasörü veya paylaşılan sorgu için ayarlanmış izinleri değiştirebilirsiniz. Ayrıntılar için bkz. Sorgu izinlerini ayarlama.
  • Paylaşılan sorgular altına bir sorgu eklemek ve kaydetmek için Temel erişim veya daha yüksek bir erişime sahipsiniz. Ayrıca, sorguyu eklemek istediğiniz klasör için Katkıda Bulun iznini İzin Ver olarak ayarlayabilirsiniz. Varsayılan olarak Katkıda Bulunanlar grubunun bu izni yok.

Sorguları aç

Web tarayıcınızdan (1) doğru projeyi seçtikten sonra (2) Sorgular'ı seçin Boards>(3) Tamam'ı seçin.

Sorgular Boards>dikey gezintiyi açın

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

İpucu

Sık kullanılan olarak seçtiğiniz veya takımınız tarafından seçilen sorgular Sık Kullanılanlar sayfasında görüntülenir. Sık kullanılan sorgular ve diğer nesneler de Project görüntülenir. Daha fazla bilgi için bkz. Kişisel veya takım sık kullanılanlarını ayarlama.

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

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

Düz liste sorgusu tanımlama

Web portalındaki sorgular sekmesinden veya Takım Gezgini ' deki iş öğeleri sekmesinde yeni bir sorgu başlatabilirsiniz.

Yeni Sorgu Ekle, yeni deneyim

Sorgu Düzenleyicisi şu varsayılan ayarlarla görüntülenir: iş öğelerinin düz listesi, iş öğesi türü = [any] ve State = [any].

Sorgu Düzenleyicisi 'nin düz bir iş öğeleri listesi seçiliyken ekran görüntüsü.

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

Sorgular sayfası, açılan menüden yeni sorgu ' yı seçin.

sorgu düzenleyicisi şu varsayılan ayarlarla görüntülenir: iş öğelerinin düz listesi, **takım Project = @Project** (geçerli proje), iş öğesi türü = [any] ve State = [any].

Seçili iş öğelerinin düz listesi olan sorgu Düzenleyicisi 'nin ekran görüntüsü, TFS 2018 ve önceki sürümleri.

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

Projeler genelinde veya içinde sorgulama

Varsayılan olarak, yeni sorgular geçerli projenin kapsamına alını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 projenin altına kaydedilir.

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

Web portal, Queries page, Query Editor, Checkbox, Query across projects

Not

Projeler arası sorgu özelliği TFS 2015,1 ve sonraki sürümlerde desteklenir.

projeler genelinde sorgu denetimli olduğunda, seçilmiş sayıda projeye filtrelemek için takım Project alanını ekleyebilirsiniz.

Azure Boards and TFS 2015.1, Web portal, Query across select projects using the In operator

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 Project alanı yalnızca projeler arasında sorguyu denetledikten sonra kullanılabilir hale gelir. Üstelik, Projeler arasında sorgu işaretlenmediğinde yalnızca geçerli projede tanımlanan iş öğesi türlerinden alınan alanlar, alan açılır menüsünde görünür. Projeler arasında sorgu 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.

son 30 gün içindeki tüm projelerde oluşturulan tüm özellikleri bulmak için, sorgudan **takım Project = @Project** yan tümcesini kaldırın.

TFS 2013-2015, Web portal, Query across select projects using the In operator

Koleksiyondaki tüm projelerde tanımlanan tüm iş öğesi türlerindeki tüm alanlar, her zaman alan açılan menüsünde görünür.

yalnızca geçerli proje için tanımlanan iş öğelerini bulmak için sorguyu kapsamındaki **takım Project = @Project** öğesini kullanın.

Yan tümce tanımlama

Bir veya daha fazla yan tümce tanımlayarak bir sorgu oluşturursunuz. 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
' Atanan = @

Alan veri türüne göre kullanılabilir operatörlerin hızlı bir başvurusu için bkz. sorgu dizini hızlı başvurusu.

Eklediğiniz tüm yan tümceler bir ve deyimleri olarak eklenir. Gruplandırmayı değiştirmek için veya öğesini seçin. Yan tümce deyimlerinin gereken sırada yürütülmesini sağlamak 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, işleç ve değeri seçin.

Bir yan tümce tanımlayın.

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

İpucu

Bir sorgunun WIQL söz dizimlerini ve yan tümceleri grup için parantezin nasıl kullan olduğunu görüntülemek için Market Wiql Düzenleyicisi'ni yükleyin. Bu uzantı, WIQL söz dizimlerini görüntülemeyi ve bu söz dizimlerini çağrılarda kullanmak üzere bir WIQL dosyasına REST API destekler. Daha fazla bilgi için bkz. İş Öğesi Sorgulama Dili (WIQL) için söz dizimi.

Sorgu yan tümcesinin nasıl tanımlanacağını gösteren denetim listesi

  1. İlk boş satırda, alan sütun başlığı altında, kullanılabilir alanların listesini göstermek için aşağı oku seçin ve listeden bir öğe seçin.

    Daha fazla bilgi için bkz. sorgu alanları ve değerleri.

  2. Aynı satırda, işleç sütun başlığı altında, kullanılabilir işleçler listesini göstermek için aşağı oku seçin ve listeden bir öğe seçin.

    Daha fazla bilgi için bkz. işleçler.

  3. Aynı satırda, değer sütun başlığı altında bir değer yazın ya da aşağı oku seçin ve listeden bir öğe seçin.

    Geçerli projeyi, Kullanıcı, tarihi veya diğer seçimi belirtmek için bir makro veya değişken kullanma hakkında daha fazla bilgi için bkz. değişkenler.

  4. Bir yan tümce eklemek için Yeni yan tümce Ekle' yi seçin.

    Sorgunun sonuna bir yan tümce ekleyebilir, var olan bir yan tümcesinden sonra bir yan tümce ekleyebilirsiniz (INSERT yan tümcesi simgesi) ve Kaldır (yan tümce simgesini kaldır), Grup (Grup yan tümcesi simgesi) ve Grubu Çöz (Grubu Çöz yan tümcesi simgesi) yan tümceleri gereklidir.

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

Çok katmanlı, iç içe geçmiş iş öğelerinin listesini görüntülemek Için iş öğeleri sorgusu ağacını kullanın. Örneğin, tüm biriktirme listesi öğelerini ve bunların bağlı görevlerini görüntüleyebilirsiniz. Ağacın farklı bölümlerine odaklanmak için (Node, Web portalını Genişlet ) veya daraltma (  düğüm, Web portalı ) düğümlerini genişletin.

Not

Test Plans, test paketleri ve test çalışmalarının hiyerarşik bir görünümünü gösteren bir sorgu oluşturamazsınız. Bu öğeler üst-alt bağlantı türleri kullanılarak birlikte bağlanmazlar. Ancak, sınamalarla ilgili iş öğelerini listeleyen bir doğrudan bağlantılar sorgusu oluşturabilirsiniz. ayrıca, Test>Test Plans sayfası aracılığıyla hiyerarşiyi görüntüleyebilirsiniz.

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

Görevler, hatalar, sorunlar veya özellikler gibi diğer izilen 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üzeltilecek bir hataya bağlı olan biriktirme listesi öğelerini görüntüebilirsiniz.

Diğer takımların üzerinde çalışma yaptığı bağımlılıkları izlemek veya takımınız tarafından diğer takımlara yapılan taahhütleri yönetmek için doğrudan bağlantılar sorgusunu kullanın. Hem üst hem de bağlı iş öğeleri için filtre ölçütlerini belirtin ve bağımlılıkları filtrelemek için kullanılan bağlantı türlerini seçin.

Doğrudan Bağlantılar Sorgu Sonuçları

Doğrudan Bağlantılar Sorgusu, düzenleyici

Doğrudan Bağlantılar Sorgu Düzenleyicisi

İlk katmandaki iş öğeleri listenizi filtrelemek için şu seçeneklerden birini belirleyin:

  • Yalnızca eşleşen bağlantıları olan öğeleri iade edin: Birinci 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 varsa döndürülür.

  • Tüm üst düzey öğeleri geri getir: Bağlı iş öğeleri filtre ölçütlerine bakılmaksızın tüm birinci katman iş öğeleri döndürülür. İlk katmana bağlı olan ikinci katman iş öğeleri, bağlı iş öğeleri filtre ölçütleriyle eş olursa döndürülür.

  • Yalnızca eşleşen bağlantıları olmayan öğeleri döndürülür: Birinci katman iş öğeleri döndürülür, ancak 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ğımlılıkları bağlama, izlenebilirlik ve yönetme.

And/Or mantıksal ifadesi

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

Arama ölçütlerinizi yalnızca istediğiniz iş öğesi kümesi döndüren şekilde geliştirmek için her iş öğesi alanı için yeni bir yan tümce ekebilirsiniz. Sorgudan beklediğiniz sonuçları alasanız, sorgu sonuçlarınızı geliştirmek için sorgu yan tümceleri ekleyebilir, kaldırabilir, gruplandırabilirsiniz veya gruplandırabilirsiniz.

Sorgu yan tümcelerini sorgunun geri kalanından ayrı tek bir birim olarak çalışacak şekilde, matematiksel denklemde veya mantık deyiminde bir ifadenin çevresine parantezler koymaya benzer şekilde gruplaabilirsiniz. Yan tümceleri gruplatırken, gruptaki ilk yan tümce için AND veya OR tüm gruba uygulanır.

Group yan tümceleri

Grup halindeki yan tümceler, matematiksel denklem veya mantık ifadesinin etrafına parantezler koymaya benzer şekilde sorgunun geri kalanından ayrı tek bir birim olarak çalışır. Gruptaki ilk yan tümcenin And veya Or işleci grubun tamamı için geçerlidir.

Aşağıdaki örneklerde de olduğu gibi, gruplandı yan tümceleri karşılık gelen mantıksal ifadeye çevrilir.

İpucu

Bir sorgunun WIQL söz dizimlerini görüntülemek için, herhangi bir Sorgu Kullanıcı Arabirimi girişinin WIQL sürümünü görmene olanak sağlayan WIQL sorgu düzenleyicisi uzantısını yükleyin. Bu uzantı, AND/OR gruplamış yan tümcelerin nasıl işlen olduğunu görmeni sağlar.

Sorgu Gruplandı yan tümceleri 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ünü, Durumu ve Atanan alanlarını gruplar. OR işleci State ve Assigned to alanlarını gruplar.
2 Hem İş öğesi türü alanı hem de Durum alanı veya Atanan alanından biri için filtrelerle birlikte 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ü Bir OR işleci tarafından gruplandırarak Durum veya Atanan alanları ile gruplar.
3 Grup yan tümcesi sorgusunu gösteren ekran görüntüsü. Filtreler İş öğesi türü alanı veya Hem Durum 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 to alanlarına bağlar. Bu alanlar bir AND işleci tarafından bağlantılıdır.

Bu sorgular Hata türü olan ve aşağıdaki mantıksal ifadeleri karşılar:

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

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

Web portalı, Grup Seçilen Sorgu Yan Tümceleri

Ayrıca önceden gruplandırmış olan her yan tümcenin kutularını işaretleyin ve ardından grup yan tümceleri simgesini seçerek birkaç gruplandırmış yan tümceleri de grupabilirsiniz.

Birden çok sorgu yan tümcesini grupla

Sorgu sonuçlarınız beklenen sonuçları getirene kadar aşağıdaki adımları izleyin:

  • Her yan tümcenin amaçlandığı gibi tanımlandığına emin olun.
  • Verify And/Or her yan tümcesine atamalar. Sonuçlarınız beklenenden daha fazla iş öğeleri içeriyorsa genellikle And yan tümcesi yerine Or yan tümcesi vardır.
  • Her bir gruplama yan tümcesi için sorgu yan tümcelerinin ve And/Or atamalarının gruplama veya değiştirme gerektirerek gerek olup olmadığını belirler.
  • Sorgu filtresi ölçütlerinizi geliştirmek 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çirme.

Yan tümcenin grubunu çöz

Bir yan tümcenin grubunu çözmek için gruplandıran yan tümcenin ungroup yan tümceleri simgesini seçin.

Sorgu tanımlamayla ilgili temel bilgiler bu şekildedir. Sorgu örnekleri dizini için bkz. Sorgu hızlı başvurusu.