Aracılığıyla paylaş

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 için tanımlarsınız( alan yollarıveyineleme yollarını ) ve ardından bir ekiple ilişkilendirmek istediklerinizi seçersiniz.

Alan ve yineleme yollarıyla çalışmayı daha iyi anlamak için Ekipler ve Çevik araçlar hakkında ,başlıklarına bakın.

Önkoşullar

  • Erişim düzeyleri:
    • Paylaşılan sorguları görüntülemek ve çalıştırmak için: Project üyesi.
    • Paylaşılan sorgu eklemek ve kaydetmek için: En az Temel erişimi.
  • İzinleri:Katkıda Bulunma izni, sorgu eklemek istediğiniz klasör için İzin ver olarak ayarlanır. Varsayılan olarak, Katkıda Bulunanlar grubu bu izne sahip değildir.

Not

Ortak proje için Paydaş erişimi olan kullanıcılar, Temel erişimine sahip kullanıcılar gibi sorgu özelliklerine tam erişime sahiptir. Daha fazla bilgi için bkz. Paydaş erişimi hızlı referans.

  • Erişim düzeyleri:
    • Paylaşılan sorguları görüntülemek ve çalıştırmak için: Project üyesi.
    • Paylaşılan sorgu eklemek ve kaydetmek için: Temel erişimi en az .
  • İzinleri:Katkıda Bulunma izni, sorguyu eklemek istediğiniz klasör için İzin Ver olarak ayarlanır. Varsayılan olarak, Katkıda Bulunanlar grubu bu izne sahip değildir.

Not

Aşağıdaki makrolar yalnızca web portalında desteklenir: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivityve @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 sorgu.

Makro İstediğiniz zaman kullanın...
@CurrentIteration Seçili ekip kapsamıyla ilişkili geçerli iterasyonu belirtin.
@CurrentIteration +/- n Seçili ekip bağlamıyla ilişkili sprint'lerin kayan penceresine atamaya göre öğeleri filtreleyin.
@TeamAreas Belirli bir takıma 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 işlecini kullanarak birkaç alan yoluna atanan iş öğelerini filtrelemeyi belirtebilirsiniz.

çeşitli alanlar için Alan Yolu üzerinde sorgu

Düğüm Adı ve anahtar kelime tabanlı sorgular

Düğüm Adı alanını, bir anahtar kelimeye göre alan yollarına atanan iş öğelerini filtrelemek için, İçerir işlecini kullanarak kullanın. Düğüm Adı, ağaç hiyerarşisindeki son düğüme karşılık gelen Alan Yoluson düğümünü belirtir.

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

çeşitli alanlar için Düğüm Adı Üzerine 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.

Birkaç sprint için sorgu

İşte Düğüm Adı ve İçindeki işlecini kullanan başka bir örnek.

Çeşitli alanlar için Düğüm Adında Sorgu

Takım alan yolu sorguları

@TeamAreas makrosunu kullanarak belirli bir ekibe atanmış alan yollarında atanan öğeleri hızlıca bulun. = işlecini belirtin. Sorgu Düzenleyicisi otomatik olarak ekibin adını girmenizi ister. Ekibin adını girip arama filtresi ölçütlerinde görünen ekip değerini seçerek ekleyebilirsiniz.

Ekip için atanmış alan yolları hakkında sorgu

Sınıflandırma alanı referansı

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. Sistem.YinelemeYolu

Her alan için veri yolu=TreePath, raporlanabilir tür=Dimension, indeks özelliği=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ğerlendirme.

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 Tam sayı
Yineleme Kimliği Bu iş öğesinin atandığı yinelemenin benzersiz ID'si. System.IterationId Tam sayı
Düğüm Adı Bir bölge yolunun en son düğümünün adı. Örneğin, alan yolu Project\A1\B2\C3 ise düğüm adı C3'dür. System.NodeName Dizgi

Varsayılan raporlanabilir tür "yok" olarak ayarlanmıştır. Alan Kimliği ve Yineleme Kimliği dizine alınır, Düğüm Adı dizine alınmaz. 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: