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

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.

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.

Notlar:

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

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 . Kullanıcı tercihlerini ayarlama.

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 yaklaşım, yalnızca eklediğiniz tarih aralığına uyan sonuçları döndürerek performans konusunda yardımcı olabilir. Sorgu oluşturmaya yeniyseniz bkz . İş öğesi sorgusu tanımlama.

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. Daha fazla bilgi için bkz . Sprint zaman çizelgelerini yönetme.

Sorgu, sprint'e atanan ve takımın geçerli yineleme yoluna karşılık gelen herhangi bir öğeyi bulur. Ö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.

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şturabilirsiniz. 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.

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.

Sprint kapsamındaki değişiklikleri sorgulamaya yönelik diğer seçenekler için bkz . Sprint kapsamı değişikliği.

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.

Notlar:

1. Ayrıca bkz. Atamaya veya iş akışı değişikliklerine göre sorgulama.

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 FIELDS Resolved 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 sağlanır ve iş öğelerinin toplu içeri aktarılmasına ve güncelleştirilmesini sağlar. Microsoft Project'i kullanmanın alternatifleri şunlardır:

   • Teslimat Planları
   • Project Connect veya GANTT grafiği gibi market uzantıları

İlgili makaleler

• Atamaya veya iş akışı değişikliklerine göre sorgulama
• Yineleme (sprint) yollarını tanımlama ve takım yinelemelerini yapılandırma
• Azure Boards'ta iş öğesi sorgusu tanımlama
• Sorgu alanları, işleçler ve makrolar
• İş öğesi alanları ve öznitelikleri
• İş Öğesi Sorgu Dili (WIQL) söz dizimi

REST API

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

• Azure DevOps Services REST API Başvurusu
• Sorgular
• İş öğesi sorgu dili
• Program aracılığıyla sorgularla iş öğelerini getirme