Alana veya yineleme yoluna göre sorgulama

  • Makale

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

Alan Yolu ve Yineleme Yolu, tüm iş öğesi türleri için iş izleme formunda görünen iki alandır. Bunları bir proje (alan yolları ve yineleme yolları) için tanımlar ve ardından bir ekiple ilişkilendirmek istediklerinizi seçersiniz.

Alan ve yineleme yollarıyla çalışmayı daha iyi anlamak için bkz . Ekipler ve Çevik araçlar hakkında.

Not

Aşağıdaki makrolar yalnızca web portalında desteklenir: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity ve @TeamAreas. Bu makroları içeren sorgular Visual Studio/Team Explorer, Microsoft Excel veya Microsoft Project'te açıldığında çalışmaz.

Desteklenen işleçler ve makrolar

Sorgu oluştururken ve Alan Yolu ve Yineleme Yolu alanlarını belirtirken aşağıdaki işleçleri kullanabilirsiniz:

Operatör İstediğiniz zaman kullanın...
= Belirli bir alan veya yineleme yolu belirtme
<> Belirli bir alanı veya yineleme yolunu filtreleyin.
In Bir alan veya yineleme yolu kümesi için filtreleyin.
Not In Bir alan veya yineleme yolu kümesine atanan öğeleri dışlayın.
Under Seçme alanı veya yineleme yolu altındaki tüm yolları belirtin.
Not Under Belirli bir alan veya yineleme yolu altında atanan öğeleri dışlayın.

Bu işleçlerle birlikte, Yineleme Yolu'nu seçtiğinizde aşağıdaki makroları da kullanabilirsiniz. Örnekler için bkz . Tarihe veya geçerli yinelemeye göre sorgulama.

Makro İstediğiniz zaman kullanın...
@CurrentIteration Seçili ekip bağlamıyla ilişkili geçerli yinelemeyi belirtin.
@CurrentIteration +/- n Seçili ekip bağlamıyla ilişkili sprint'lerin kayan penceresine atamaya göre öğeleri filtreleyin.
@TeamAreas Belirli bir ekiliğe atanan alan yollarına göre öğeleri filtreleyin.

Not

@CurrentIteration +/- n ve @TeamAreas makroları Azure DevOps Server 2019 ve sonraki sürümlerde desteklenir. Bu makrolar yalnızca web portalında desteklenir. Bu makroları içeren sorgular Visual Studio/Team Explorer, Microsoft Excel veya Microsoft Project'te açıldığında çalışmaz.

Alan yolu sorguları

Aşağıdaki örnekte gösterildiği gibi In işlecini kullanarak birkaç alan yoluna atanan iş öğelerini filtrelemeyi belirtebilirsiniz.

Birkaç alan için Alan Yolu'nda sorgu

Düğüm Adı ve anahtar sözcük tabanlı sorgular

Contains işlecini kullanarak bir anahtar sözcüğü temel alarak alan yollarına atanan iş öğelerini filtrelemek için Düğüm Adı alanını kullanın. Düğüm Adı, ağaç hiyerarşisindeki son düğüme karşılık gelen Bir Alan Yolunun son düğümünü belirtir.

Aşağıdaki sorgu, önceki örnekle aynı sonucu verir.

Birkaç alan için Düğüm Adı'nda sorgu

Bu örnekte filtre, son düğümü "Azure" sözcüğünü içeren bir alan yoluna atanan tüm iş öğelerini döndürür.

Çeşitli sprint'ler için sorgu

Aşağıda Düğüm Adı ve In işlecini kullanan başka bir örnek verilmiştır.

Birkaç alan için Düğüm Adı'nda sorgu

Ekip alanı yolu sorguları

Belirli bir takıma atanan alan yollarına atanan öğeleri hızla bulmak için @TeamAreas makroyu kullanın. işlecini = belirtin. Sorgu Düzenleyicisi otomatik olarak takımın adını girmenizi ister. Ekibin adını girip arama filtresi ölçütlerinde görünen ekip değerini seçerek ekleyebilirsiniz.

Takıma atanan alan yollarını sorgulama

Sınıflandırma alanı başvurusu

Alan adı Açıklama Başvuru adı
Alan Yolu İş öğelerini ürün özelliği veya ekip alanları halinde gruplandırma. Alan, proje hiyerarşisinde geçerli bir düğüm olmalıdır. System.AreaPath
Yineleme Yolu İş öğelerini adlandırılmış sprint'lere veya zaman dönemlerine göre gruplandırma. Yineleme, proje hiyerarşisinde geçerli bir düğüm olmalıdır. System.IterationPath

Her alan için data path=TreePath, reportable type=Dimension, index attribute=True.

256 karakterden uzun bir yol adı tanımlarsanız, bunu Microsoft Project'te belirtemezsiniz. Bu sorunu önlemek için en fazla 10 karakterden oluşan yol adlarını tanımlayın ve 14 düzeyden daha derin düğümleri iç içe yerleştirmeyin.

System.AreaPath ve System.IterationPath alanları gibi sistem alanlarına çoğu alan kuralı uygulayamazsınız. Daha fazla bilgi için bkz . Kurallar ve kural değerlendirmesi.

Aşağıdaki alanlar iş öğesi formlarında görünmez, ancak her iş öğesi türü için izlenir. Bu alanlar, bir proje için tanımlanan her sınıflandırma değeri için sayısal bir değer sağlar. Sorguları filtrelemek ve rapor oluşturmak için bu alanları kullanabilirsiniz.

Alan adı Açıklama Başvuru adı Veri türü
Alan Kimliği Bu iş öğesinin atandığı alanın benzersiz kimliği. System.AreaId Tamsayı
Yineleme Kimliği Bu iş öğesinin atandığı yinelemenin benzersiz kimliği. System.IterationId Tamsayı
Düğüm Adı Bir alan yolunun son düğümünün adı. Örneğin, alan yolu Project\A1\B2\C3 ise düğüm adı C3'dür. System.NodeName String

Varsayılan raporlanabilir tür yok. Alan Kimliği ve Yineleme Kimliği dizine eklenir, Düğüm Adı dizine kaydedilmez. Alan öznitelikleri hakkında daha fazla bilgi edinmek için bkz . İş öğesi alanları ve öznitelikleri.

REST API

Sorgularla program aracılığıyla etkileşime geçmek için şu REST API kaynaklarından birine bakın: