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.
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.
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.
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.
Sorgu Düzenleyicisi şu varsayılan ayarlarla görüntülenir: İş öğelerinin düz listesi, İş Öğesi Türü=[Any]ve State=[Any].
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].
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 sorgu işaretlendiğinde, belirli sayıda projeye filtre uygulamak için Takım Projesi 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 (,).
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.
Ö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
İ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.
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ü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.
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.
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ğı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.
ş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|
|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. Zaten gruplandırılmış olan 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 ş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:
- İlgilenen iş öğelerini filtreleyen sorguyu oluşturun. Sorgu düz liste, ağaç veya doğrudan bağlantılar sorgusu olabilir.
- Üst alanı sütun olarak ekleyin.
- Sorguyu Paylaşılan sorgu veya Ekip sık kullanılanı olarak kaydedin.
- 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.
İlgili makaleler:
Sorguları tanımlamanın temelleri bunlardır. Sorgu örneklerinin dizini için bkz . Sorgu hızlı başvurusu.