Tarihe veya geçerli yinelemeye göre sorgulama

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Bu makalede, çalışma öğelerini oluşturma, değiştirme, çözümleme veya kapalı tarihlere göre listeleme işlemi gösterilmektedir. Ayrıca, @Todaytakım sprint'leri için gibi tarih makrolarının ve yineleme makrolarının nasıl kullanılacağını da gösterir. Yineleme yolunun temelleri ve istemci veya makro kısıtlamaları için bkz. Alana veya yineleme yoluna göre sorgulama.

Tip

Bu makalenin devamında bu görevle ilgili yardım almak için yapay zekayı kullanabilir veya başlamak için Azure DevOps MCP Server ile yapay zeka yardımlarını etkinleştirme bölümüne bakın.

Prerequisites

Category	Requirements
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.
Permissions	Katkıda Bulunma izni, sorgu eklemek istediğiniz klasör için İzin Ver olarak ayarlanmalıdır. Varsayılan olarak, Katkıda Bulunanlar grubu bu izne sahip değildir.

Note

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şim hızlı başvuru.

Desteklenen işleçler ve tarih makroları

Sorgu Düzenleyicisi'nde DateTime ve Yineleme Yolu alanları için aşağıdaki işleçleri ve makroları kullanın.

• DateTime işleçleri: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
• Tarih makroları: @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear, , @Today
+/- n'ü bu makrolarla birleştirebilirsiniz. Örneğin, kullanın @Today - 7.
• Yineleme makroları: @CurrentIteration ve @CurrentIteration +/- n. İstemci kısıtlamaları ve takım parametresi davranışı için aşağıdaki nota ve bağlantıya bakın.

Note

Alana veya yineleme yoluna göre sorgulama yineleme sayfası, yineleme makrolarını ve istemci kısıtlamalarını ayrıntılı olarak kapsar. Web dışı istemcilerde veya web kullanıcı arabirimi dışında REST veya WIQL aracılığıyla çalıştırılacak sorgulara ihtiyacınız varsa ortamınızda makro desteğini doğrulayın. Makroları açık yollara genişletmeyi göz önünde bulundurun.

Hızlı tarih örnekleri (yaygın sorgular)

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

• Belirli bir tarihte değiştirilen öğeler: Belirli bir tarihte

• Bugün çözümlenen öğeler:

• Belirtilen süre içinde kapatılan öğeler: Belirli bir süre

• Kapalı Tarihi null olan (kapatılmayan)

• Durumu geçen hafta içinde değişen öğeler: Durumu

@CurrentIteration Makroları kullanma (kısa kılavuz)

@CurrentIteration takımın geçerli sprint'ini hedeflemek ve sprint'lerin kayan bir penceresini (örneğin, önceki iki, geçerli ve sonraki iki sprint) oluşturmak için @CurrentIteration +/- n kullanın. Önemli noktalar:

• @CurrentIteration sorgu çalıştırılırken kullanılan takım bağlamı için geçerli sprint'e atanan öğeleri döndürür.
• @CurrentIteration +/- n bu sprint penceresini n'ye göre kaydırıyor; eğilim veya taşıma analizleri için kullanışlıdır.
• Makro davranışı ve istemci desteği farklılık gösterdiği için ekip parametreleri, hangi istemcilerin makroları değerlendirdiği ve sorguları kaydederken makroların nasıl depolandığı ve genişletildiği hakkındaki ayrıntılar için Alana veya yineleme yoluna göre sorgula'ya başvurun.

Örnek görüntüler (web portalı Sorgu Düzenleyicisi):

Tip

@CurrentIteration Beklenen sonuçları döndürmezse, Ekip ayarları'nda ekibin seçtiği yinelemeyi ve yineleme tarihi aralıklarını onaylayın.

Tarih makroları: gün, hafta, ay ve yılın başlangıcı

Makro başlangıçları, tutarlı göreli tarih aralıkları oluşturmaya yardımcı olur:

• @StartOfDay, @StartOfWeek, @StartOfMonthve @StartOfYear—ile birlikte bu makroları +/- n kullanarak "haftanın başından beri" veya "son 3 ay" gibi aralıklar oluşturun.
• Web portalı kullanıcı arabirimi bu makroları değerlendirir. Web dışı senaryolardaki davranışları farklı olabilir, bu nedenle hedef istemcinizde test edin.

Örnek sorgular:

Tarih alanları

Aşağıdaki tabloda, iş öğelerini filtrelemek ve sorgulamak için kullanabileceğiniz tarihle ilgili alanlar açıklanmaktadır. Bu alanlar, iş öğeleri için zamanlama bilgilerini izlemeye yardımcı olur.

Alan adı	Description	Referans adı	Veri türü
Son Tarih	Sorunun veya iş öğesinin çözümlenmesi için tahmini son tarih. (Çevik işlem)	Microsoft.VSTS.Scheduling.DueDate	DateTime
Bitiş Tarihi	Zamanlamanın iş öğesinin tamamlanacağını gösterdiği tarih ve saat.	Microsoft.VSTS.Scheduling.FinishDate	DateTime
Başlangıç Tarihi	İşin başlaması için bir iş öğesine atanan tarih ve saat.	Microsoft.VSTS.Scheduling.StartDate	DateTime
hedef tarih	Bir sorunun veya başka bir iş öğesinin çözümlenmesi veya tamamlanması için tahmini son tarih.	Microsoft.VSTS.Scheduling.TargetDate	DateTime

Note

İş öğesi zaman çizelgelerini görselleştirmek için Teslim Planları ile Başlangıç Tarihi ve Hedef Tarih alanlarını kullanın. Daha fazla bilgi için bkz . Ekip Teslim Planlarını Gözden Geçirme.

WIQL doğrudan ne zaman kullanılır?

WiQL'i şu durumlarda kullanın:

• Yineleme Yolu değişiklikleri gibi WAS EVER gelişmiş işleçlere ihtiyacınız vardır.
• Sorgu Editörü bir yan tümceyi desteklenmediği için engelleyebilir veya işaretleyebilir. Örneğin, bazı Was Ever kullanımlarını. WIQL Düzenleyicisi uzantısı, bu sorguları yazmanıza ve kaydetmenize olanak tanır.

Örnekler için İş Öğesi Sorgu Dili (WIQL) söz dizimi ve WIQL Düzenleyicisi marketplace uzantısına bakın.

Tarihe veya yinelemeye göre sorgulamak için yapay zeka kullanma

Azure DevOps MCP Sunucusunu yapılandırırsanız, sorgu yan tümcelerini el ile oluşturmak yerine doğal dilde tarih tabanlı ve yineleme tabanlı sorular sorabilirsiniz.

Görev	Örnek komut
Yakın zamanda oluşturulan öğeleri bulma	copilot-prompt Show all work items created in the last 7 days in project <Contoso>
Geçerli sprint'e göre sorgulama	copilot-prompt List all active bugs in the current sprint for team <Contoso Team>
Eski öğeleri bulma	copilot-prompt Show user stories that haven't been updated in the last 30 days in <Contoso>
Çözümlenen öğeleri tarih aralığına göre sorgulama	copilot-prompt List bugs resolved between January 1 and January 31 in project <Contoso>
Haftalık kapalı özet	copilot-prompt Show the count of work items closed each day this week in <Contoso> broken down by type
Son tarihe yaklaşan öğeleri bulma	copilot-prompt List work items in <Contoso> with a target date within the next 5 days that are still active
Sprint iş azalma denetimi	copilot-prompt Show how many story points remain incomplete vs total planned for the current sprint in <Contoso>
Geç sprint eklemeleri	copilot-prompt List work items added to the current sprint in <Contoso> in the second half of the sprint
Aydan aya karşılaştırma	copilot-prompt Compare the number of bugs created this month vs last month in <Contoso>
Tatil etkisi analizi	copilot-prompt Show work items in <Contoso> that had no updates between December 23 and January 2

Note

Visual Studio Code kullanıyorsanız aracı modu özellikle karmaşık tarih tabanlı sorgular için yararlıdır.

İlgili içerik

• Alana veya yineleme yoluna göre sorgulama
• İş Öğesi Sorgu Dili (WIQL) söz dizimi
• Sorgu alanları, işleçler ve makrolar
• İş öğ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:

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