Alana veya yineleme yoluna göre sorgula
Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013
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 için tanımlar —alan yolları ve yineleme yolları— ve ardından bir takımla ilişkilendirmek istediklerinizi seçin.
Alan ve yineleme yollarıyla çalışmayı daha iyi anlamak için bkz. takımlar ve çevik araçlar hakkında.
Not
Aşağıdaki makrolar yalnızca Web portalından desteklenir: @CurrentIteration, @CurrentIteration +/-n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivityve @TeamAreas. bu makroları içeren sorgular, Visual Studio/team Explorer, Microsoft Excel veya Microsoft Project açıldığında çalışmaz.
Desteklenen işleçler ve makrolar
Sorgu oluştururken ve alan yolu ile 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 belirtin |
| <> | Bir, belirli bir alanı veya yineleme yolunu filtreleyin. |
| İçinde | Bir alan veya yineleme yolları kümesi için filtre. |
| Not ın | Bir alan veya yineleme yolları kümesine atanan öğeleri hariç tutun. |
| Alt | Bir seçim alanı veya yineleme yolu altındaki tüm yolları belirtin. |
| Altında değil | Belirli bir alan veya yineleme yolu altında atanan öğeleri hariç tutun. |
Bu işleçlerle birlikte, yineleme yolunu seçerken aşağıdaki makroları kullanabilirsiniz. Örnekler için bkz. tarihe veya geçerli yinelemeye göre sorgulama.
| Makroya | İstediğiniz zaman kullanın... |
|---|---|
| @CurrentIteration | Seçili takım bağlamıyla ilişkili geçerli yinelemeyi belirtin. |
| @CurrentIteration +/-n | Seçili takım bağlamıyla ilişkili Sprint 'lerin kayan penceresine atamaya göre öğeleri filtreleyin. |
| @TeamAreas | Öğeleri belirli bir takıma atanan alan yoluna göre filtreleyin. |
Not
@CurrentIteration makrosu TFS 2015 ve üzeri sürümlerde desteklenir. @CurrentIteration +/-n ve @TeamAreas makroları Azure DevOps Server 2019 ve sonraki sürümler için desteklenir. Bu makrolar yalnızca Web portalından desteklenir. bu makroları içeren sorgular, Visual Studio/team Explorer, Microsoft Excel veya Microsoft Project açıldığında çalışmaz.
Alan yolu sorguları
Aşağıdaki örnekte gösterildiği gibi, ın işlecini kullanarak birkaç alan yoluna atanan iş öğelerinin filtreleneceğini belirtebilirsiniz.
Düğüm adı ve anahtar sözcük tabanlı sorgular
Contains işlecini kullanarak bir anahtar sözcüğe göre 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 yolununson düğümünü belirtir.
Aşağıdaki sorgu, önceki örnekle aynı sonucu verir.
Bu örnekte, filtre, son düğümü "Azure" sözcüğünü içeren bir alan yoluna atanan iş öğelerini döndürür.
Düğüm adını ve ın işlecini kullanan başka bir örnek aşağıda verilmiştir.
Takım alanı yol sorguları
Belirli bir takıma atanan alan yollarına atanan öğeleri hızlı bir şekilde bulmak için @TeamAreas makrosunu kullanın. İşleci belirtin = . Sorgu Düzenleyicisi otomatik olarak takımın adını girmenizi ister. Takım adını yazarak ve arama filtresi ölçütlerinde görünen takım değerini seçerek ekleyebilirsiniz.
Sınıflandırma alanı başvurusu
| Alan adı | Açıklama | Başvuru adı |
|---|---|---|
| Alan yolu | İş öğelerini ürün özelliği veya ekip alanlarında gruplandırır. Alan, proje hiyerarşisinde geçerli bir düğüm olmalıdır. | System. AreaPath |
| Yineleme yolu | , İş öğelerini bir grup sprint veya zaman dönemine göre gruplandırır. Yineleme, proje hiyerarşisinde geçerli bir düğüm olmalıdır. | System. IterationPath |
Her alan için veri yolu = TreePath , raporlanabilir tür = Dimension , dizin özniteliği = True .
256 karakterden daha uzun bir yol adı tanımlarsanız, Microsoft Project belirtemezsiniz. Bu sorundan kaçınmak için, yol adlarını 10 ' dan fazla karakter tanımlayın ve 14 düzey derinlikten fazla düğüm iç içe kullanmayın.
System. AreaPath ve System. IterationPath alanları gibi sistem alanlarına en fazla 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 bir 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. Bu alanları sorguları filtrelemek ve rapor oluşturmak için 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 olur. | System. düğ, | Dize |
Varsayılan raporlanabilir tür None ' dır. Alan KIMLIĞI ve yineleme KIMLIĞI dizinlenir, düğüm adı değil. Alan öznitelikleri hakkında daha fazla bilgi için bkz. iş öğesi alanları ve öznitelikleri.
İlgili makaleler:
- Sorgu hızlı başvurusu
- Alan yollarını tanımlama ve bir takıma atama
- Yineleme (sprint) yollarını tanımlama ve takım yinelemelerini yapılandırma
- İş izleme için izinleri ve erişimi ayarlama
REST API
Sorgularla program aracılığıyla etkileşim kurmak için aşağıdaki kaynak kaynaklarından REST API bakın:
SDK kaynakları
Sorgularla program aracılığıyla etkileşim kurmak için bkz. Hatalar,Görevler ve Diğer İş Öğeleri için Sorgulama.