Azure Boards'ta tarihe veya geçerli yinelemeye göre sorgulama

  • Makale

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

Bu makalede, iş öğelerini oluşturma, kapatma, çözme veya değiştirme durumlarına göre listelemeyi öğrenin. Bir tarih belirtebilir veya desteklenen bir makro kullanabilirsiniz. Makroyu @Today kullanın ve göreli tarihler için artı veya eksi gün sayısını belirtin. Bir ekibin geçerli sprint'ine atamalarına göre iş öğelerini listeleyen sorgular için kullanın @CurrentIteration.

Örneğin, aşağıdaki sorguyla son üç gün içinde değiştirilmiş iş öğelerini bulun.

Değiştirme Tarihi alanının = 3 olarak ayarlandığını >gösteren Sorgu Düzenleyicisi gösteren ekran görüntüsü.

Ayrıca, ekip yinelemelerinin kayan CurrentIteration +/- _n_ penceresine dayalı sorgular oluşturmak için makroyu kullanabilirsiniz.

Desteklenen işleçler ve makrolar

DateTime alanını veya Yineleme Yolu alanını belirten sorgu yan tümceleri, aşağıdaki tabloda listelenen işleçleri ve makroları kullanabilir.

Veri türü

Desteklenen işleçler ve makrolar

DateTime

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Makrolar: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYearve @Today. Desteklenen makroların her biriyle kullanabilirsiniz +/- _n_ .

TreePath

= , <> , Altında, Altında Değil
Makrolar: @CurrentIteration1 ve @CurrentIteration +/- n2 Yineleme Yolu alanıyla geçerlidir.

Notlar:

  1. @StartOfDay, @StartOfWeek, @StartOfMonthve @StartOfYear makroları Azure DevOps Server 2019.1 ve sonraki sürümleri için ve yalnızca web portalından çalıştırıldığında desteklenir.
  2. Makro @CurrentIteration +/- n , Azure DevOps Server 2019 ve sonraki sürümleri için ve yalnızca web portalından çalıştırıldığında desteklenir.

İpucu

İşleç WasEver Yineleme Yolu alanıyla birlikte kullanılabilir, ancak yalnızca WIQL söz dizimi aracılığıyla tanımlandığında kullanılabilir. Örnek için bkz . İş Öğesi Sorgu Dili (WIQL) söz dizimi başvurusu.

Tarih ve saat düzeni

DateTime alanları için girdiğiniz tarih ve saat deseni, profiliniz aracılığıyla seçtiğiniz tarih ve saat düzeniyle eşleşmelidir. Seçiminizi görüntülemek veya değiştirmek için bkz . Saat ve Yerel Ayar için kullanıcı tercihlerini ayarlama.

Saat ve Yerel Ayar bölmesinde tarih düzeni açılan seçeneklerini gösteren ekran görüntüsü.Saat ve Yerel Ayar bölmesindeki Zaman Düzeni açılan seçeneklerini gösteren ekran görüntüsü.

Tarih deseni ve Saat deseni alanlarını içeren Saat ve Yerel Ayar bölmesini gösteren ekran görüntüsü.

Makroların kullanımıyla @CurrentIteration ilgili istemci kısıtlamaları

Makroyu @CurrentIteration aşağıdaki istemcilerden bir sorguda kullanabilirsiniz:

  • Azure Boards'a bağlanan web portalı
  • Azure Boards'a bağlı Visual Studio 2019 veya sonraki sürümleri
  • REST API

Makroyu @CurrentIteration +/- n Azure Boards, Azure DevOps Server 2019 ve sonraki sürümlerde sorguda ve ekibi parametre olarak içeren bir REST API ile kullanabilirsiniz. @CurrentIteration('[Project]/Team') bunun bir örneğidir.

Makroyu içeren bir sorguyu @CurrentIteration Visual Studio'nun önceki sürümlerinde veya Microsoft Excel ya da Microsoft Project'ten açtığınızda hata oluşur. Ayrıca, test paketlerini ve test çalışmalarını kopyalarken veya kopyalarken, uyarıları tanımlarken veya REST API'lerle makroyu kullanamazsınız.

Tarih tabanlı sorgular

İş öğelerini değiştirildiği tarihe veya belirli bir zaman aralığına göre filtreleyin. Sorgunuzun kapsamını sınırlayın; bu, yalnızca eklediğiniz tarih aralığına uyan sonuçları döndürerek performansa yardımcı olabilir. Sorgu oluşturmaya yeniyseniz bkz . Sorguları listelemek ve yönetmek için sorgu düzenleyicisini kullanma.

Tüm alanlar tüm iş öğesi türleri için geçerli değildir. Sorgulara ve uygulandıkları iş öğesi türlerine ekleyebileceğiniz alan kümesinin tarih alanlarına atlayın.

İpucu

  • Kişisel profiliniz için ayarladığınız Tarih Düzeni alanına tarihleri girmeyi unutmayın.
  • Yan tümcelerin nasıl AND/OR gruplandırılacağını anlamak için Azure Boards'taiş öğesi sorgusu tanımlama bölümündeki Grup yan tümceleri bölümüne bakın. Sorgunun WIQL söz dizimini görüntülemek için, herhangi bir Sorgu Düzenleyicisi girdisinin WIQL sürümünü görmenize olanak tanıyan WIQL düzenleyicisi uzantısını yükleyin.

Filtre uygula:

Bu sorgu yan tümcelerini ekle

Son 30 gün içinde oluşturulan öğeler.

Son 30 gün içinde oluşturulan öğeleri bulmaya yönelik Sorgu Düzenleyicisi yan tümcesini gösteren ekran görüntüsü.

Belirli bir tarihte değiştirilen öğeler.

Belirli bir tarihte değiştirilmiş öğeleri bulmak için Sorgu Düzenleyicisi yan tümcesini gösteren ekran görüntüsü.

Öğeler bugün çözüldü.

Bugün çözümlenen öğeleri bulmak için Sorgu Düzenleyicisi yan tümcesini gösteren ekran görüntüsü.

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

Belirtilen süre içinde kapatılan öğeleri bulmak için Sorgu Düzenleyicisi yan tümcesini gösteren ekran görüntüsü.

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

Kapalı Tarihi boş veya null olan öğeleri bulmaya yönelik Sorgu Düzenleyicisi yan tümcesini gösteren ekran görüntüsü.

Durumu son hafta içinde güncelleştirilen öğeler.

Durumu geçen hafta güncelleştirilen öğeler için Sorgu Düzenleyicisi yan tümcesini gösteren ekran görüntüsü.

Geçerli sprint sırasında kapatılan öğeler. (Makro, <xref href="CurrentIteration" data-throw-if-not-resolved="False" data-raw-source="@CurrentIteration"></xref> geçerli takım bağlamı için tanımlanan sprint'e başvurur.)

Geçerli sprint sırasında kapatılan öğeler için Sorgu Düzenleyicisi yan tümcesini gösteren ekran görüntüsü.

Gün, hafta, ay veya yıl başlangıç tarihi tabanlı sorgular oluşturma

Aşağıdaki örneklerde, çeşitli uzaklıklara sahip iş öğelerini filtrelemek için makroların nasıl kullanılacağı StartOf... gösterilmektedir. Daha fazla bilgi için bkz . İş Öğesi Sorgu Dili (WIQL) söz dizimi.

Not

Azure DevOps Server 2019 Güncelleştirme 1 veya sonraki bir sürümü gerektirir.

Filtre uygula:

Bu sorgu yan tümcelerini ekle

Hatalar son iki hafta içinde kapatıldı.

Son iki hafta içinde kapatılan hataları bulmaya yönelik Sorgu Düzenleyicisi yan tümcesini gösteren ekran görüntüsü.

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

Son 10 gün içinde değiştirilen öğeleri bulmak için Sorgu Düzenleyicisi yan tümcelerini gösteren ekran görüntüsü.

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

Sonraki üç ay içinde tamamlanması planlanan özelliklerin Sorgu Düzenleyicisi yan tümcelerini gösteren ekran görüntüsü.

Tüm alanlar tüm iş öğesi türleri için geçerli değildir. Sorgulara ve uygulandıkları iş öğesi türlerine ekleyebileceğiniz alan kümesinin tarih alanlarına atlayın.

Ekibinizin geçerli yinelemesi için sorgu oluşturma

Ekibiniz Scrum işlemlerini izlerse, sprint'lerde tamamlanması için çalışma zamanlayabilirsiniz. Makroyu kullanarak geçerli sprint'te tamamlanacak gereksinimlerin, hataların ve diğer çalışmaların ilerleme durumunu @CurrentIteration izleyebilirsiniz.

Bir sprint'e atanan ve takımın geçerli yineleme yoluna karşılık gelen tüm öğeler bulunur. Örneğin, bir ekip Sprint 5'teyse, sorgu Sprint 5'e atanmış öğeleri döndürür. Daha sonra, ekip Sprint 6'da çalışırken, aynı sorgu Sprint 6'ya atanmış öğeleri döndürür.

Not

Makronun @CurrentIteration çalışması için, takımın tarih aralığı geçerli tarihi kapsayan bir yineleme yolu seçmiş olması gerekir. Daha fazla bilgi için bkz . Yineleme yollarını tanımlama (sprint olarak da adlandırılır) ve ekip yinelemelerini yapılandırma. Ayrıca, bu makroyu içeren sorgular yalnızca web portalından çalıştırıldığında geçerlidir.

Bu makalenin önceki bölümlerinde de Client restrictions on the use of the @CurrentIteration macros bakın.

@CurrentIteration veya @CurrentIteration +/- n makroları seçtiğinizde Azure Boards bir ekip parametresi ekler. Team parametresi geçerli ekip bağlamınıza göre türetilir.

Team parametresiyle CurrentIteration makrosunu kullanarak Sorgu filtresini gösteren ekran görüntüsü.

İpucu

@CurrentIteration Makro çalışmıyorsa, ekibiniz için beklenen yinelemenin seçili olup olmadığını ve bunun için tarihlerin ayarlanıp ayarlanmadığını denetleyin.

Sistemin otomatik olarak ayarladığı takım parametresini değiştirmek için, @CurrentIteration makrosunun altına eklenen parametre alanına takımın adını girerek bunu seçersiniz.

Ekip parametresi seçmeyi gösteren ekran görüntüsü.

Ekibinizin yineleme sorgusunun kayan penceresini oluşturma

Bir ekibin @CurrentIteration +/- <i>n</i> yaklaşan sprint'ler için planlanan çalışmasını izlemek ve önceki sprint'lerde tamamlanmamış olan işleri anlamak için makroyu kullanın.

Not

Makronun @CurrentIteration +/- <i>n</i> çalışması için ekibin ölçütlere uyan +/- _n_ yineleme yollarını seçmiş olması gerekir. Tarih aralıkları için @CurrentIterationgeçerli tarihi kapsamalıdır. Yineleme yollarının ekip seçimi hakkında daha fazla bilgi için bkz . Yineleme (sprint) yollarını tanımlama ve takım yinelemelerini yapılandırma.

Bu makalenin önceki bölümlerinde de Client restrictions on the use of the @CurrentIteration macros bakın.

Aşağıdaki görüntüde, Bulut Yönetici 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ı Hikayesi ve Hata iş öğesi türlerinin nasıl listelendiğini gösterir.

CurrentIteration artı ve eksi yan tümcelerini gösteren ekran görüntüsü.

Bu makroyu kullanmak için, belirtilen ekibin makro için girilen değere +/- _n_ yayılan bir sprint kümesi seçmesi gerekir.

Sprint'in dışına taşınan iş öğelerini listeleme

Sprint için tanımlanmış ancak daha sonra Yineleme Yolu alanının işlecini içeren Was Ever bir yan tümcesi olan bir sorgu kullanarak dışarı taşınan iş öğelerini listeleyin. Bu sorguyu yalnızca WIQL söz dizimini kullanarak oluşturur. WIQL Düzenleyicisi Market uzantısını yükleyerek Sorgu Düzenleyicisi WIQL söz dizimini düzenleyin.

Örneğin, iş öğeleri için aşağıdaki söz dizimi sorguları aşağıdaki ölçütleri karşılar:

  • Geçerli projede tanımlanmış.
  • İş öğesi türü, Kullanıcı Hikayesi veya Hata'ya eşittir.
  • İş öğeleri Fabrikam Fiber Web ekibi Alan Yolu altındadır.
  • İş öğeleri , Closed, CompletedCutveya Resolved durumunda değildir.
  • Fabrikam Fiber Web ekibi için geçerli yineleme yolunda değil.
  • Fabrikam Fiber Web ekibi için geçerli yineleme yoluna atandı.
  • Artık Fabrikam Fiber Web ekibi için geçerli yineleme +1'e atanmıştır.
  • Son 30 gün içinde 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 diziminin Sorgu Düzenleyicisi görünümü gösterildiği gibi görünür.

Not

Sorgu Düzenleyicisi, işlecin yanında Was Ever yan tümcesiyle ilgili bir sorunu gösteren bir bilgi simgesi görüntüler. Ancak sorgu çalışmaya devam eder ve sorgu grafikleri oluşturabilirsiniz. Sorguyu değiştirmek için WIQL Düzenleyicisi'ni kullanmanız gerekir.

Sprint'in dışına taşınan Sorgu Düzenleyicisi iş öğelerini gösteren ekran görüntüsü.

Başlangıç tarihinden sonra sprint'e eklenen iş öğelerini listeleme

Sprint'e başlangıç tarihinden sonra eklenen yeni oluşturulan iş öğelerini listelemek için aşağıdaki görüntüde gösterilene benzer bir sorgu kullanın. Bu sorgu, geçerli sprint'e atanan ancak sprint tarihinin başlangıcından sonra oluşturulmuş iş öğelerini filtreleyerek çalışır. yan tümcesini created Date = @Today - 28kullanın.

Yeni oluşturulan ve başlangıç tarihinden sonra sprint'e eklenen Sorgu Düzenleyicisi iş öğelerini gösteren ekran görüntüsü.

Sprint kapsamındaki değişiklikleri sorgulamaya yönelik diğer seçenekler için bkz . Sprint'ler, Scrum ve proje yönetimi, Sprint kapsamı değişikliği hakkında.

Tarih ve Yineleme Yolu alanları

Sorgularınızı filtrelemek için Tarih alanlarını kullanın. Bu alanlardan bazıları, bir iş öğesi bir durumdan diğerine ilerledikçe bilgilerle doldurulur. Bu alanların birkaçı iş öğesi formunda görünmez, ancak aşağıdaki tabloda listelenen iş öğesi türleri için izlenir.

Alan adı

Açıklama

İş öğesi türleri

Etkinleştirilmiş Tarih (Not 1 ve 2)

İş öğesinin oluşturulduğu veya durumunun , Completedveya DoneNewActive veya durumundan değiştirildiği Closedtarih ve saat. Başvuru adı=Microsoft.VSTS.Common.ActivatedDate, Veri türü=DateTime

Hata, Değişiklik İsteği, Epic, Özellik, Sorun, Ürün Kapsamı Öğesi, Gereksinim, Gözden Geçirme, Risk, Paylaşılan Adım, Görev, Test Çalışması, Kullanıcı Hikayesi

Tarihi Değiştir

Bir iş öğesinin değiştirildiği tarih ve saat. Başvuru adı=System.ChangedDate, Veri türü=DateTime

Tümü

Kapalı Tarih (Not 2)

Bir iş öğesinin kapatıldığı tarih ve saat. Başvuru adı=Microsoft.VSTS.Common.ClosedDate, Veri türü=DateTime

Tümü

Oluşturulma Tarihi

Bir iş öğesinin oluşturulduğu tarih ve saat. Başvuru adı=System.CreatedDate, Veri türü=DateTime

Tümü

Son Tarih

Sorunun çözümlenmesi için tahmini son tarih. Başvuru adı=Microsoft.VSTS.Scheduling.DueDate, Veri türü=DateTime

Sorun (Çevik)

Bitiş Tarihi (Not 3)

Zamanlamanın görevin tamamlandığını gösterdiği 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önemlerine göre gruplandırma. Yineleme, proje hiyerarşisinde geçerli bir düğüm olmalıdır. Bir proje için yineleme yolları tanımlar ve bir ekip için yineleme yollarını seçersiniz. Başvuru adı=System.IterationPath, Veri türü=TreePath

Tümü

Çözümlenme Tarihi (Not 1 ve 2)

İş öğesinin bir Resolved duruma 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 Kapsamı Öğesi, Gereksinim, Gözden Geçirme, Risk, Paylaşılan Adım, Görev, Test Çalışması, Kullanıcı Hikayesi

Başlangıç Tarihi (Not 3)

Zamanlamanın görevin başlatıldığını gösterdiği tarih ve saat.

Not

Teslim Planları özellikler, epic'ler ve diğer portföy kapsamı öğelerinin aralığını göstermek için Başlangıç Tarihi ve Hedef Tarih alanlarını kullanır.

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ının değerinin değiştiği tarih ve saat. Başvuru adı=Microsoft.VSTS.Common.StateChangeDate, Veri türü=DateTime

Tümü

Hedef Tarih

Bir özelliğin, iş öğesinin veya sorunun tamamlanma veya çözümlenme tarihi.

Not

Teslim Planları özellikler, epic'ler ve diğer portföy kapsamı öğelerinin aralığını göstermek için Başlangıç Tarihi ve Hedef Tarih alanlarını 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 göre sorgulama, Tarih ve Kimlik alanları.

  2. Bu alanların bir iş öğesi türü için tanımlanması için, iş öğesi türü tanımının bölümüne eklenmesi WORKFLOW gerekir. Örneğin, bu söz dizimi bir duruma geçirilirken tanımın FIELDSResolved içinde yer alır.

     <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
    <SERVERDEFAULT from="clock"  />  
 </FIELD >

  3. Project'te bir proje planı oluşturur ve ardından bu planı Azure Boards'ta depolanan görevlerle eşitlerseniz Başlangıç Tarihi ve Bitiş Tarihi değerleri hesaplanır. Bu alanlar iş öğesi formunda görünmeyebilir, ancak kapsam öğelerine bağlı kapsam öğeleri ve görevler için hesaplanır. Salt okunur değerlerini bir sorgudan veya Excel'den sonuçlarda görüntüleyebilirsiniz.

    Önemli

    Microsoft Project Tümleştirmesi TFSFieldMapping ve komutu aşağıdakiler için desteklenmez:

    • Visual Studio 2019 ve Azure DevOps Office Tümleştirmesi 2019.
    • Azure DevOps Services dahil olmak üzere Azure DevOps Server 2019 ve sonraki sürümleri.

    Microsoft Excel tümleştirmesi için tam destek korunur ve iş öğelerinin toplu içeri aktarılmasını ve güncelleştirilmesini destekler. Microsoft Project'i kullanmanın alternatifleri şunlardır:

REST API

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