Azure Boards'da iş öğesi sorgusu tanımlama
Özellikleri filtreleme
Makrolar
Filtre işlevinden kullanabileceğiniz filtrelerle Sorgu Düzenleyicisi, Filter işlevini kullanarak sorgu sonuçlarını etkileşimli olarak 
filtrelebilirsiniz. Nasıl olduğunu öğrenmek için bkz. Biriktirme planlarını, panoları, sorguları ve planları etkileşimli olarak filtreleme.
Ö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 kaydetmekiç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 kaydetmekiçin Temel erişim veya daha yüksek bir erişime sahipsiniz. Ayrıca, sorguyu eklemek istediğiniz klasöre izin vermek Için katkıda bulunma izninizin olması gerekir. Varsayılan olarak, katkıda bulunanlar grubu bu izne sahip değildir.
Sorguları aç
web tarayıcınızdan, (1) doğru projeyi seçtiğinizden emin olun, (2) sorguları Boardsseçin ve (3) tümünüseç ' i seçin.
Sorgularıilk kez açtığınızda, sayfa Sık Kullanılanlar' a açılır. Bu sayfada, belirttiğiniz sorgular listelenir. Aksi takdirde, tanımladığınız tüm sorguları ve proje için tanımlanan paylaşılan sorguları görüntülemek için Tümü seçeneğini belirleyebilirsiniz.
İpucu
Sık Kullanılanlar sayfasında Sık Kullanılanlar sayfası görünür olarak sizin veya ekibinizin seçtiği sorgular. diğer nesnelerle birlikte sık kullanılan sorgular da Project sayfanızda görünür. Daha fazla bilgi için bkz. kişisel veya takım sık kullanılanları ayarlama.
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 ' deki iş öğeleri sekmesinde yeni bir sorgu başlatabilirsiniz.
Sorgu Düzenleyicisi şu varsayılan ayarlarla görüntülenir: iş öğelerinin düz listesi, iş öğesi türü = [any]ve State = [any].
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.
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].
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
Yeni sorgular varsayılan olarak geçerli projeye yönelik kapsamdadı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ındaonay 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.
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.
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 (,).
Team Project alanı yalnızca projeler arasında sorguyudenetledikten sonra kullanılabilir. Ayrıca, Projeler arasında sorgu işaretlenmediğinde, yalnızca geçerli projede tanımlanan bu çalışma öğesi türlerindeki alanlar, alan açılan menüsünde görüntülenir. 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.
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 üzere sorguyu kapsamı için Team Project = @ Project 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 | = | @Me |
Alan veri türüne göre kullanılabilir işleçlerin bir listesi 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 çalıştırılmasını 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.
Örneğin, Atanan alanını, equals ( ) işlecini ve kullanıcı kimliğinizi temsil eden @Me makroyu belirterek size atanan tüm iş öğelerini arayabilirsiniz.
Yan Tümcesi'ne tıklayın.
Kaydet'i seçin.İpucu
Bir sorgunun WIQL söz dizimlerini ve yan tümceleri grup için parantezin nasıl kullanılanı 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 edinmek için bkz. İş Öğesi Sorgulama Dili (WIQL) için söz dizimi.
Sorgu yan tümcesi tanımlama denetim listesi
İlk boş satırdaki Alan sütunu 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.
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.
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.
Yan tümce eklemek için Yeni yan tümce ekle'yi seçin.
Sorgunun sonuna bir yan tümcesi ekleyebilir, mevcut yan tümceden sonra bir yan tümcesi ekleyebilir (
tümce simgesi ) ve gerektiğinde remove (
tümce simgesi), grup (
yan tümcesi simgesi ) ve ungroup (
tümcesi simgesi ) yan tümcelerini kaldırabilirsiniz.
Hiyerarşileri görüntülemek için iş öğesi ağacı kullanma
İş 
öğelerinin çok katmanlı, iç içe geçmiş listesini görüntülemek için İş Öğeleri Ağacı sorgusunu kullanın. Örneğin, tüm biriktirme listesi öğelerini ve bunların bağlı görevlerini görüntüebilirsiniz. Ağacın farklı bölümlerine
düğümleri genişletin (Düğümü genişlet ( Düğümü genişlet, web portalı ) veya daraltın ( Düğümü
portalı).
Not
Test Plans, Test Paketleri ve Test Örnekleri'nin hiyerarşik görünümünü gösteren bir sorgu oluşturmaz. Bu öğeler, üst-alt bağlantı türleri kullanılarak birbirine bağlı değil. Ancak, testle ilgili iş öğelerini listeleen bir doğrudan bağlantılar sorgusu oluşturabilirsiniz. Ayrıca, hiyerarşiyi Test Test Plans görüntüleyebilirsiniz.
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'yi seçin. Bağlantılı ebeveynleri bulmak için önce Bağlantılı iş öğelerini eşle'yi 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 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.
Ekipler arasındaki bağımlılıkları izlemek için doğrudan bağlantılar sorgusunu kullanın. Sorgu, takımınıza verilen taahhütleri yönetmenize de yardımcı olur. Üst ve bağlı iş öğeleri için filtre ölçütlerini seçin. Bağımlılıkları filtrelemek için bağlantı türlerini seçin.
İ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, ancak bağlı iş öğeleri filtre ölçütleri tarafından belirtilen iş öğelerine bağlantılar varsa geri döner.
Tüm üst düzey öğeleri geri dön:Bağlı iş öğeleri filtre ölçütlerine rağmen tüm birinci katman iş öğeleri geri döner. İlk katmana bağlı ikinci katman iş öğeleri, bağlı iş öğeleri filtre ölçütleriyle eşdülerse geri döner.
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 geliştirmek için her iş öğesi alanı için bir yeni yan tümcesi ekleyin. Yalnızca istediğiniz iş öğeleri kümesine dönüş yapmak için yan tümceleri ekleyin. Sorgudan beklediğiniz sonuçları alsanız da daraltabilirsiniz. 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 grupla. Yan tümceleri gruplama, matematiksel denklem veya mantık deyiminde bir ifadenin çevresine parantez koymaya benzer. Yan tümceleri gruplarken, gruptaki ilk yan tümce için AND veya OR tüm gruba uygulanır.
Group yan tümceleri
Grup halindeki yan tümceler, sorgunun geri kalanından ayrı tek bir birim olarak çalışır. Yan tümceleri gruplama, matematiksel denklem veya mantık ifadesinin çevresine parantez koymaya benzer. 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 |  |
 |
| 2 |  |
 |
| 3 |  |
 |
Bu sorgular Hata türünde iş öğelerini ve aşağıdaki mantıksal ifadeleri karşılar:
- Sorgu 1: ve durum = etkin veya @Me atandı
- Sorgu 2: ve (durum = etkin veya @Me atandı)
- Sorgu 3: OR (durum = etkin ve @Me atandı)
Bir veya daha fazla yan tümceyi gruplandırmak için, bunları seçin ve sonra 
Grup yan tümceleri simgesini seçin.
Ayrıca, çeşitli gruplanmış yan tümceleri de gruplandırabilirsiniz. Zaten gruplandırılmış olan her bir 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ı izleyin:
- Her bir yan tümcenin amaçladığınız şekilde tanımlandığından emin olun.
- Her bir yan tümce için ve/veya atamalarını doğrulayın. Sonuçlarınız beklenenden daha fazla iş öğesi içeriyorsa, ve yan tümcesi yerine genellikle OR yan tümcesi vardır.
- Sorgu yan tümcelerinin gruplanmasının ve gruplandırılıp gruplandırılmasının gerekip gerekmediğini ve her gruplanmış yan tümcesinin ve/veya atamalarını belirlemeniz gerekip gerekmediğini belirleme.
- Sorgu filtresi ölçütlerinizi iyileştirmek için daha fazla sorgu yan tümcesi ekleyin.
- Alanları, işleçleri ve değerleribelirtmek için kullanılabilir seçenekleri gözden geçirin.
Yan tümce grubunu çözme
Bir yan tümcenin grubunu çözmek için 
gruplanmış yan tümce için yan tümceleri Çöz simgesini seçin.
gruplandırılmış yan tümce için Visual Studio yan tümceleri seçin simgesini seçin.İlgili makaleler:
Sorguları tanımlama hakkında temel bilgiler vardır. Sorgu örnekleri dizini için bkz. sorgu hızlı başvurusu.
- Sorgu SSS
- Düz liste sorgusu grafik
- Sütun seçeneklerini değiştir
- Çalışma öğesi alan dizini
- Klavye kısayolları
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 sorgular oluşturun. 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 sorgular oluşturun. 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.
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,,,, ve gibi desteklenen işleçler Contains — InIn Group<> alan veri türüne göre ve sorgu örnekleri için bkz. Contains.
Bir sorgu filtresi seçin
Sorgu Düzenleyicisi 'nde aşağıdaki filtre işlevlerini uygulayın. Örnek sorgularla bir makaleye gitmek için filtreyi seçin. Sorgu filtreleriyle birlikte, 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.