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:

  1. @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.
  2. Bu @CurrentIteration, TFS 2015 ve sonraki sürümlerde ve yalnızca web portalında çalıştırıldıklarında de kullanılabilir.
  3. +/- @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

Son 30 gün içinde oluşturulan öğeleri bulmak için yan tümcesi

Belirli bir tarihte değiştirilen öğeler

Belirli bir tarihte değiştirilen öğeleri bulmak için yan tümcesi

Bugün çözümlenen öğeler

Bugün çözümlenen öğeleri bulmak için yan tümcesi

Belirtilen süre içinde kapatılan öğeler

Belirli bir süre içinde kapatılan öğeleri bulmak için yan tümcesi

Kapatılan öğeler (Kapalı Tarih null)

Kapalı Tarihi boş veya null olan öğeleri bulmak için yan tümcesi

Durumu geçen hafta içinde güncelleştirilen öğeler

Durumu geçen hafta içinde güncelleştirilen öğeleri bulmak için yan tümcesi

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)

Geçerli sprint sırasında kapatılan öğeleri bulmak için yan tümcesi

İ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 iki hafta içinde kapatılan hataları bulmaya ilişkin yan tümceler

Son 10 gün içinde değiştirilen öğeler

Son 10 gün içinde değiştirilen öğeleri bulmak için yan tümcesi

Önümüzdeki üç ay içinde tamamlanması planlanan özellikler

Sonraki 3 ay içinde tamamlanması planlanan özelliklerin yan tümceleri

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.

Takım parametresiyle @CurrentIteration kullanarak sorgu filtresi

İ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.

Takım parametresini seçme

@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.

@CurrentIteration makrosunu kullanarak sorgu filtresi

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.

CurrentIteration artı ve eksi yan tümceleri

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:

  1. Geçerli projede tanımlanmış
  2. İş öğesi türü, Kullanıcı Hikayesi veya Hata'ya eşittir
  3. İş öğeleri Fabrikam Fiber Web ekibi Alan Yolu altında
  4. İş öğeleri Kapalı, Tamamlandı, Kesildi veya Çözüldü durumda değil
  5. Fabrikam Fiber Web ekibi için geçerli yineleme yolunda değil
  6. Ancak Fabrikam Fiber Web ekibi için geçerli yineleme yoluna atandı
  7. Fabrikam Fiber Web ekibi için geçerli yineleme +1'e atandı
  8. 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.

İş Öğelerinin Sorgu Düzenleyicisi sprint'inden taşındığını gösterir.

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.

Yeni Sorgu Düzenleyicisi ve başlangıç tarihine kadar sprint'e eklenen İş Öğeleri'nin ekran görüntüsü.

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:

  1. Ayrıca bkz. Atamaya veya iş akışı değişikliklerine, Tarihe ve Kimlik alanlarına göre sorgulama.

  2. Bu alanların BIR WIT için tanımlan için WIT tanımının WORKFLOW bölümüne dahil olması gerekir. Örneğin, bu söz dizimi Çözümlenmiş FIELDS durumuna geçişte tanım içinde yer almaktadır:

     <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
        <SERVERDEFAULT from="clock"  />  
     </FIELD >  
    
  3. 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:

Geçmiş alanına girilen metni temel alarak öğeleri sorgulamak için bkz. Geçmiş ve denetim.

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.

Sorgu Düzenleyicisi, değiştirme tarihi  = 3 ekran görüntüsü.

Son değişikliklere göre düzenleyici sorgu filtresi.

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.