Tarihe veya geçerli yinelemeye göre sorgu
Veri türü
Desteklenen işleçler ve makrolar
Tarih Saat
= , <> , , , = , = , ><><<> =[Field], > [Field], < [Field], > =[Field], < =[Field], In, Not In, Was Ever
Makrolar:@StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYearve @Today; Bu makroların her biri bir +/- n tamsayı ile belirtilebilir.
TreePath
= , <> , Under, Not Under <>@CurrentIteration2 ve @CurrentIteration Yineleme Yolu alanıyla geçerli +/- n3
Tarih Saat
= , <> , , , = , = , ><><<> =[Field], > [Field], < [Field], > =[Field], < =[Field], In, Not In, Was Ever
Makrolar:@Today ** +/- n** tamsayı ile belirtilebilir.
TreePath
= , <> , Under, Not <>: @CurrentIteration2 Yineleme Yolu alanıyla geçerlidir
Notlar:
- @StartOfDay , @StartOfWeek, @StartOfMonth, @StartOfYear makroları Azure DevOps Server 2019.1 ve sonraki sürümler için ve yalnızca web portalında çalıştırıldıklarında de kullanılabilir.
- Bu @CurrentIteration, TFS 2015 ve sonraki sürümlerde ve yalnızca web portalında çalıştırıldıklarında de kullanılabilir.
- +/- @CurrentIteration 2019 ve sonraki sürümlerde Azure DevOps Server ve yalnızca web portalında çalıştırıldıklarında desteklenmeleri gerekir.
İpucu
WasEver işleci Yineleme Yolu alanıyla kullanılabilir, ancak yalnızca WIQL söz dizimi aracılığıyla tanımlandığı zaman kullanılabilir. Örnek için bkz. TBC.
Makroların kullanımıyla ilgili @CurrentIteration istemci kısıtlamaları
Aşağıdaki istemcilerden @CurrentIteration sorguda aşağıdaki sorguyu kullanabilirsiniz:
- Azure Boards'a bağlanan web Azure Boards
- Şirket içi sürüm 2015 veya Azure DevOps bağlanan web portalı
- Visual Studio veya TFS 2015 veya Takım Gezgini 2015 veya sonraki sürümlerine bağlı Azure Boards 2015 veya sonraki sürümleri.
- REST API’yi kullanma
@CurrentIteration +/- n makrosunu Azure Boards, Azure DevOps Server 2019 ve sonraki sürümlere karşı bir sorguda ve takımı parametre olarak içeren bir REST API ile kullanabilirsiniz, örneğin, .
@CurrentIteration'nin önceki sürümlerinde veya Visual Studio veya Excel içeren bir sorgu Project. Ayrıca, test paketlerini ve testçalışmalarını kopyalayıp kopyalayarak, uyarıları tanımlarken veya REST API'leri ile makroyu kullanaabilirsiniz.
Tarih tabanlı sorgular
İş öğeleri için değiştirildik tarihe veya belirli bir zaman dönemine göre filtre oluşturabilirsiniz. Sorgunun kapsamını sınırlarken, yalnızca dahil etmek istediğiniz tarih aralığına uygun sonuçları döndürerek performansta yardımcı olabilir. Sorgu oluşturmaya yeni başladıysanız bkz. Sorguları listele ve yönetmek için sorgu düzenleyicisini kullanma.
Tüm alanlar tüm iş öğesi türleri (WIT) için geçerli değildir. Sorgulara dahil etmek ve hangi WIT'ler için geçerli olduğunu alan kümesi için tarih alanlarına atlayın.
Filtresi:
Bu sorgu yan tümcelerini dahil etmek
Son 30 gün içinde oluşturulan öğeler
Belirli bir tarihte değiştirilen öğeler
Bugün çözümlenen öğeler
Belirtilen süre içinde kapatılan öğeler
Kapatılan öğeler (Kapalı Tarih null)
Durumu geçen hafta içinde güncelleştirilen öğeler
Geçerli sprint sırasında kapatılan öğeler @CurrentIteration (makro geçerli takım bağlamı için tanımlanan sprint'e başvurur)
İpucu
AND/OR yan tümceleri nasıl gruplandı anlamak için bkz. Yönetilen sorgular oluşturma ve kaydetme, Group yan tümceleri. 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.
Gün, hafta, ay veya yıl tarih tabanlı sorguların başlangıcını oluşturma
Aşağıdaki örneklerde, startOf... makrolarının çeşitli uzaklıklarla iş öğelerini filtrelemek için nasıl kullanılaları gösterildi. Bu makroları kullanma hakkında daha fazla örnek için bkz. WIQL söz dizimi.
Not
2019 Azure DevOps Server 1 veya sonraki bir sürümü gerektirir.
Filtresi:
Bu sorgu yan tümcelerini dahil etmek
Son iki hafta içinde kapatılan hatalar
Son 10 gün içinde değiştirilen öğeler
Önümüzdeki üç ay içinde tamamlanması planlanan özellikler
Tüm alanlar tüm iş öğesi türleri için geçerli değildir. Sorgulara dahil etmek istediğiniz alan kümesi ve bunların geçerli olduğu iş öğesi türleri için tarih alanlarına atlayın. Kişisel profiliniz için ayar varsayılan Tarih Düzeni'ne tarihleri girin. (Ayrıntılar için bkz. Kişisel tercihleri ayarlama.)
Takımınız için geçerli yineleme için sorgu oluşturma
Takımınız Scrum işlemlerini takip ediyorsa, işi sprint'lerde tamamlanacak şekilde zamanlarsanız. Geçerli sprint'te tamamlanması gereken gereksinimlerin, hataların ve diğer çalışmaların ilerlemesini, @CurrentIteration izleyebilirsiniz.
Takım için geçerli yineleme yoluna karşılık gelen bir sprint'e atanan herhangi bir öğe bulunur. Örneğin, bir takım Sprint 5'te ise, sorgu Sprint 5'e atanan öğeleri geri dönecektir. Daha sonra, takım Sprint 6'da çalışırken, aynı sorgu Sprint 6'ya atanan öğeleri geri dönecektir.
Not
Bu @CurrentIteration çalışması için ekip, tarih aralığının geçerli tarihi kapsamış olduğu bir Yineleme Yolu seçmiş olması gerekir. Ayrıntılar için bkz. Yineleme yollarını tanımlama (sprint olarak da adlandırılır) ve takım yinelemelerini yapılandırma. Ayrıca, bu makroyu içeren sorgular yalnızca web portalında çalıştırılarak geçerlidir.
Ayrıca, bu makalenin devamlarında, @CurrentIteration kullanımıyla ilgili İstemci kısıtlamalarına bakın.
Azure Boards +/- n makroları @CurrentIteration @CurrentIteration bir takım parametresi ekler. Takım parametresi, geçerli takım bağlamından türetildi.

İpucu
Yeni @CurrentIteration makrosu çalışmıyorsa, takımınız için beklenen yinelemenin seçili olup olmadığını ve bunun için tarihlerin ayar olup olmadığını kontrol edin.
Sistem tarafından otomatik olarak ayarlanır takım parametresini değiştirmek için, bu parametrenin altına eklenen parametre alanına takımın adını yazarak @CurrentIteration seçersiniz.

@CurrentIteration makrosunu kullanmak üzere bir sorgu oluşturmadan veya güncelleştirmeden önce, takımınızı seçin. Bu @CurrentIteration, web portalında seçilen geçerli takıma başvurur.

Takımınız için yineleme sorgusunun kayan penceresini oluşturma
Bir @CurrentIteration sprint'ler için planlandığı işi izlemek ve önceki sprint'lerde tamamlanmadı çalışmalarını anlamak için +/n makrosu kullanın.
Not
+/@CurrentIteration makronun çalışması için, takımın n ölçüte ve tarih aralığına uyan Yineleme Yolları'nın seçilen yineleme yolu için geçerli tarihi @CurrentIteration. Yineleme Yolları'nın takım seçimi hakkında ayrıntılar için bkz. Yineleme (sprint) yollarını tanımlama ve takım yinelemelerini yapılandırma.
Ayrıca, bu makalenin devamlarında, @CurrentIteration kullanımıyla ilgili İstemci kısıtlamalarına bakın.
Burada, Bulut Yöneticisi ve Araçları ekibi için seçilen son iki, geçerli ve sonraki iki sprint'e yayılan kayan pencereye atanan tüm Kullanıcı Hikayeleri ve Hataların nasıl listeleneceği gösterilir.

Bu makroyu kullanmak için, belirtilen takımın makro için girilen n değeri kapsayan bir sprint kümesi seçmiş olması gerekir.
Sprint'in dışında taşınan iş öğelerini listele
Bir sprint için tanımlanan ancak daha sonra Yineleme Yolu için Was Ever işleci içeren yan tümcesine sahip bir sorgu kullanarak dışarı taşınan iş öğelerini listeleyebilirsiniz. Bu sorguyu yalnızca WIQL söz dizimi kullanarak kurabilirsiniz. Wiql Düzenleyicisi Market uzantısını yükleyerek Sorgu Düzenleyicisi wiql söz dizimlerini düzenleyebilirsiniz.
Örneğin, aşağıdaki söz dizimi aşağıdaki ölçütlere uyan iş öğeleri için sorgular:
- Geçerli projede tanımlanmış
- İş öğesi türü, Kullanıcı Hikayesi veya Hata'ya eşittir
- İş öğeleri Fabrikam Fiber Web ekibi Alan Yolu altında
- İş öğeleri Kapalı, Tamamlandı, Kesildi veya Çözüldü durumda değil
- Fabrikam Fiber Web ekibi için geçerli yineleme yolunda değil
- Ancak Fabrikam Fiber Web ekibi için geçerli yineleme yoluna atandı
- Fabrikam Fiber Web ekibi için geçerli yineleme +1'e atandı
- Son 30 gün içinde de değiştirildi (sprint uzunluğu)
SELECT
[System.Id],
[System.WorkItemType],
[System.AssignedTo],
[System.Title],
[System.State],
[System.Tags],
[System.IterationPath],
[System.AreaPath]
FROM workitems
WHERE
[System.TeamProject] = @project
AND [System.WorkItemType] IN ('User Story', 'Bug')
AND [System.AreaPath] UNDER 'FabrikamFiber\Web'
AND NOT [System.State] IN ('Completed', 'Closed', 'Cut', 'Resolved')
AND NOT [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
AND (
EVER (
[System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
)
AND [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>') + 1
AND [System.ChangedDate] >= @today - 30
)
ORDER BY [System.Id]
Söz Sorgu Düzenleyicisi görünümü gösterildiği gibi görünür.
Not
Aşağıdaki Sorgu Düzenleyicisi Was Ever işlecinin yanında yan tümcesinde bir sorun olduğunu
belirten bir bilgi simgesi görüntüler. Ancak sorgu yine de çalıştırılır ve sorgu grafikleri oluşturabilirsiniz. Ancak sorguyu değiştirmek için WIQL düzenleyicisini kullanabilirsiniz.
Başlangıç tarihten sonra sprint'e eklenen iş öğelerini listele
Bir sprint'e başlangıç tarihi sonrasında eklenen yeni oluşturulan iş öğelerini listeleyebilirsiniz. Aşağıdaki görüntüde gösterilene benzer bir sorgu kullanabilirsiniz. Bu sorgu, geçerli sprint'e atanan ancak sprint tarihi başladıktan sonra oluşturulan iş öğelerini filtreleerek çalışır. Bu örnekte filtreleme, date = @Today - 28 yan tümcesi ile oluşturulduğunda elde edilir.
Sprint kapsamındaki değişiklikleri sorgulamaya diğer seçenekler için bkz. Sprint'ler hakkında, Scrum ve proje yönetimi, Sprint kapsamı değişikliği.
Tarih ve Yineleme Yolu alanları
Sorgularınızı filtrelemek için tarih alanlarını kullanabilirsiniz. Bu alanlardan bazıları, bir iş öğesi bir durumdan diğerine ilerlenkçe bilgilerle doldurulur. Bu alanların birkaçı iş öğesi formunda görünmez, ancak aşağıdaki tabloda listelenen WIT'ler için izlenmiştir.
Alan adı
Açıklama
İş öğesi türleri
Etkinleştirilen Tarih (Notlar 1 ve 2)
İş öğesinin oluşturulma tarihi ve saati ya da durumunun kapalı, tamamlanmış veya yeni ya da etkin bir durumdan ne zaman değiştirdiğini gösterir.
Başvuru adı=Microsoft.VSTS.Common.ActivatedDate, Veri türü=DateTime
Hata, Değişiklik İsteği, Epic, Özellik, Sorun, Ürün Biriktirme Listesi Öğesi, Gereksinim, Gözden Geçirme, Risk, Paylaşılan Adım, Görev, Test Çalışma, Kullanıcı Hikayesi
Değişiklik Tarihi
Bir iş öğesinin değiştiril olduğu tarih ve saat.
Başvuru adı=System.ChangedDate, Veri türü=DateTime
Tümü
Kapalı Tarih (Not 2)
Bir iş öğesinin kapatılan tarih ve saat.
Başvuru adı=Microsoft.VSTS.Common.ClosedDate, Veri türü=DateTime
Tümü
Oluşturulduğu Tarihi
Bir iş öğesinin oluşturulma tarihi ve saati.
Başvuru adı=System.CreatedDate, Veri türü=DateTime
Tümü
Son Tarih
Bir sorunun çözümleneceği tahmini son tarih.
Başvuru adı=Microsoft.VSTS.Scheduling.DueDate, Veri türü=DateTime
Sorun (Çevik)
Bitiş Tarihi (Not 3)
Zamanlamanın, görevin tamamlanacak olduğu tarih ve saat.
Başvuru adı=Microsoft.VSTS.Scheduling.FinishDate, Veri türü=DateTime
Gereksinim, Görev, Test Planı, Kullanıcı Hikayesi
Yineleme Yolu
İş öğelerini adlandırılmış sprint'lere veya zaman dönemlere göre gruplar. Yineleme, proje hiyerarşisinde geçerli bir düğüm olmalıdır. Bir proje için yineleme yolları tanımlar ve bir takım için yineleme yolları seçersiniz, bir proje için yineleme yolları tanımlar ve takım için yineleme yollarını seçersiniz.
Başvuru adı=System.IterationPath, Veri türü=TreePath
Tümü
Çözümlenen Tarih (Notlar 1 ve 2)
İş öğesinin Çözümlenmiş durumuna taşındığı tarih ve saat.
Başvuru adı=Microsoft.VSTS.Common.ResolvedDate, Veri türü=DateTime
Hata, Değişiklik İsteği, Epic, Özellik, Sorun, Ürün Biriktirme Listesi Öğesi, Gereksinim, Gözden Geçirme, Risk, Paylaşılan Adım, Görev, Test Çalışma, Kullanıcı Hikayesi
Başlangıç Tarihi (Not 3)
Zamanlamanın, görevin başlayacağını belirten tarih ve saat.
Başvuru adı=Microsoft.VSTS.Scheduling.StartDate, Veri türü=DateTime
Epic, Özellik, Gereksinim, Görev, Test Planı, Kullanıcı Hikayesi
Durum Değiştirme Tarihi
State alanı değerinin değiştir olduğu tarih ve saat.
Başvuru adı=Microsoft.VSTS.Common.StateChangeDate, Veri türü=DateTime
Tümü
Hedef Tarih
Bir özelliğin veya iş öğesinin tamamlanma tarihi.
Not
Teslim Planları, Özellikler, Epic'ler ve diğer portföy biriktirme listesi öğelerinin zaman dilimini göstermek için Başlangıç Tarihi ve Hedef Tarih'i kullanır.
Başvuru adı=Microsoft.VSTS.Scheduling.TargetDate, Veri türü=DateTime
Epic, Özellik
Notlar:
Ayrıca bkz. Atamaya veya iş akışı değişikliklerine, Tarihe ve Kimlik alanlarına göre sorgulama.
Bu alanların BIR WIT için tanımlan için WIT tanımının
WORKFLOWbölümüne dahil olması gerekir. Örneğin, bu söz dizimi ÇözümlenmişFIELDSdurumuna geçişte tanım içinde yer almaktadır:<FIELD refname="Microsoft.VSTS.Common.ResolvedDate" /> <SERVERDEFAULT from="clock" /> </FIELD >Başlangıç Tarihive Bitiş Tarihi alanları, Microsoft Project proje planı oluşturmanız ve ardından bu planı Azure Boards. Bu alanlar iş öğesi formunda görünese de, biriktirme listesi öğelerine bağlı olan bu biriktirme listesi öğeleri ve görevleri için hesaplanır. Bu değerlerin salt okunur değerlerini bir sorgudan veya sorgudan Microsoft Excel.
Önemli
Microsoft Project Integration ve TFSFieldMapping komutu aşağıdakiler için desteklenmiyor:
- Visual Studio 2019 ve Azure DevOps Office® Integration 2019
- Azure DevOps Server dahil olmak üzere 2019 ve sonraki Azure DevOps Services.
Ancak, iş öğelerinin toplu Microsoft Excel ve güncelleştirmesi için tam destek korunur. Uygulama kullanmanın Microsoft Project aşağıdakileri içerir:
- Teslim planları
- Project Bağlan veya GANTT grafiği gibi bir Market uzantısı.
İlgili makaleler:
Geçmiş alanına girilen metni temel alarak öğeleri sorgulamak için bkz. Geçmiş ve denetim.
- Atamaya veya iş akışı değişikliklerine göre sorgulama
- Sorgu hızlı başvurusu
- Yineleme (Sprint) yollarını tanımlama ve takım yinelemelerini yapılandırma
- Sorgu Düzenleyicisi ile yönetilen sorgular oluşturma
- Sorgu işleçleri makroları
- Çalışma öğesi alan dizini
- Sorgu izinleri
REST API
Programlı olarak sorgularla etkileşim kurmak için şu REST API kaynaklarından birine bakın:
SDK kaynakları
Programlı olarak sorgularla etkileşim kurmak için bkz. hatalar, görevler ve diğer Iş öğeleri Için sorgu.
Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013
@Today ve @CurrentIteration makroları, iş öğelerini göreli tarihlere veya bir ekibin geçerli yinelemesine atanmasına göre listelemek için faydalıdır. Çalışma öğelerini oluşturulma, kapatma, çözümlenmiş ya da değiştirilmiş duruma göre listelemek için, @Today kullanın veya tarihleri belirtin. İş öğelerini bir ekibin geçerli sprint 'e atanmasına göre listeeden sorgular için @CurrentIterationkullanın.
Örneğin, aşağıdaki sorguyla son üç gün içinde değiştirilmiş iş öğelerini bulabilirsiniz.

Ayrıca, takım yinelemelerinin kayan penceresini temel alan sorgular oluşturmak için @CurrentIteration +/- n makrosunu kullanabilirsiniz.
Desteklenen işleçler ve makrolar
Bir DateTime alanı veya yineleme yolu belirten sorgu yan tümceleri, aşağıdaki tabloda listelenen işleçleri ve makroları kullanabilir.