Azure Boards ve Azure DevOps'ta başlıklara, kimliklere ve zengin metin alanlarına göre sorgulama

  • Makale

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

Bir anahtar sözcük, tümcecik veya null metin alanına dayalı iş öğelerini bulmak istediğinizde, tek satırlı metin (Dize), çok satırlı metin (Düz Metin) ve zengin metin (HTML) alanlarına filtreleyerek bunu yapabilirsiniz. Sorgularınızın sonuç döndürmesi çok uzun sürüyorsa bkz . Sorgu oluşturma/En iyi yöntemler.

Desteklenen işleçler ve makrolar

Metin veya zengin metin alanı 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

Zengin metin (HTML)
Çok satırlı metin dizeleri (Düz Metin)

Contains Words, Does Not Contain Words, Is Empty1, Is Not Empty1

Tek metin (Dize)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMakrolar: [Any], İş Öğesi Türü alanıyla geçerlidir ve @Project2, Takım Projesi alanıyla geçerlidir.

Kimlik

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was EverMakrolar: @Follows, @MyRecentActivity, , @RecentMentions, @RecentProjectActivity Kimlik alanı ve In işleç @Project2 ile geçerlidir ve Not In Takım Projesi alanıyla geçerlidir.

Durum ve İş Öğesi Türü alanları

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], İçerenler, , , , Her iki alanla da Geçerli Olan, , Grupta **Macros**:, Değil[Herhangi Biri]' içinde yer almaz.

Not

  1. Is Empty ve Is Not Empty işleçleri Azure DevOps Server 2019 RC2 ve sonraki sürümler için desteklenir
  2. Sistem otomatik olarak geçerli projeye göre filtrelemeye geçer. Daha fazla bilgi için, bkz. Projeler arasında sorgulama.

Dize eşleşmeleri için kullanın Contains words

Bir dize eşleşmesine filtre uygulamak istediğinizde yerine işlecini Contains Words Containskullanmayı deneyin. işleç Contains Words , belirtilen alanda tam metin araması çalıştırır ve bu çoğu durumda daha hızlıdır. Metin dizesi 100 karakterle sınırlıdır.

İşleç Contains yalnızca daha yavaş olmakla kalmaz, aynı zamanda daha fazla CPU döngüsü tüketen bir tablo taraması çalıştırır. Bu CPU döngüleri, kaynak tüketen hız sınırınıza katkıda bulunur.

Not

işleci, Contains Words SQL'in tam metin arama dizini oluşturmayı kullanır. Uzun metin alanına yeni bir değer kaydedildiğinde SQL Server şunları yapacaktır:

  • Tümceciği tek tek sözcüklere bölme
  • Aramaya gerçekten değer eklemeyen tüm yaygın sözcükleri kaldırın (İngilizcede "a" veya "is" gibi)
  • Sözcükleri ortak köklerine dönüştürün (örn. çalışan, çalıştırılan ve çalıştıran tüm sözcük çeşitlemeleri olduğu için "çalıştır"a dönüştürülebilir)
  • Bu benzersiz anahtar sözcükleri bir dizinde depolayın.

Kullanıcı daha sonra işlecini Contains Words kullanarak bu alanda bir sorgu çalıştırdığında, arama dizinde depolanan benzersiz anahtar sözcüklerle çalıştırılır. Uzun metin alanları için bu, aramayı alt dize aramasından çok daha verimli ve daha hızlı hale getirir. Varsayılan olarak, SQL noktalama işaretleri arasında bir karakter kümesi olarak bir "sözcük" tanımlar. Örneğin, nokta bir sözcüğün sonunu belirtir, ancak nokta sözcüğün bir parçası olarak kabul edilmez. Tam metin arama dizini tam tümcecikler yerine anahtar sözcükler içerdiğinden, dizin oluşturma tarafından belirlenen aynı anahtar sözcükleri içeren tüm sonuçları alırsınız.

Joker karakterler içeren anahtar sözcük veya tümcecik sorgusu

Girdiğiniz sözcükler veya tümceciklerle kısmen veya tam olarak eşleşen öğeleri listelemek için Sözcük İçerir veya İçerir'i kullanın.

Anahtar sözcükleri filtrelemeye yönelik düz liste sorgusu düzenleyicisi.

Bir sözcük veya tümceciğin tam veya kısmi eşleşmelerine karşı arama yapmak için İçerir veya İçermez'i seçin. Tam bir tümceciğe göre arama yapmak veya joker karakter olan *'ı kullanmak için Sözcük İçer veya Sözcük İçermez'i seçin. Bu işleçler tam metin arama dizinini kullanır.

Örneğin, bilgi veya bilgi içeren veya bilgilendirici bir metin alanına filtre uygulamak için Sözcük İçerir ve bilgilendir* seçeneğini belirtin.

Sözcük İçeren joker karakter kullanın.

İpucu

Yan tümcelerin nasıl AND/OR gruplandırildiğini anlamak için bkz . Yönetilen sorgular oluşturma ve kaydetme, Grup yan tümceleri. Sorgunun WIQL söz dizimini görüntülemek için, herhangi bir sorgu düzenleyicisi girişinin WIQL sürümünü görmenize olanak tanıyan WIQL sorgu düzenleyicisi uzantısını yükleyin.

Diğer sözcükleri değil belirli sözcükleri sorgulama

Girdiğiniz sözcüklerle veya tümceciklerle tam olarak eşleşen öğeleri listelemek ve diğer sözcükleri veya tümcecikleri dışlamak için Sözcükleri İçerir ve Sözcük İçermez işleçlerini kullanın. Bu işleçleri birlikte ve joker karakter (*) ile kullanabilirsiniz.

Aşağıdaki örnekte, bu işleçler çalışma aşamasını içeren ancak Phasor sözcüğünü içermeyen öğeler için iş öğelerini filtrelemektedir.

Tam sözcükleri dahil etmek ve hariç tutmak için Sorgu Düzenleyicisi ekran görüntüsü.

Tanımlanmamış alan değeri sorguları

Equals işlecini = kullanarak ve alanın Değerini boş bırakarak tanımlanmamış alan değerine sahip iş öğelerini bulabilirsiniz. Örneğin, aşağıdaki filtreler, Etkinlik alanı boş olan Görev türündeki tüm iş öğelerini listeler.

Boş girdilere göre filtreleme

İş öğelerini boş olmayan bir alana göre listelemek için not işlecini <> kullanın ve Değer'i boş bırakın.

Boş veya boş olmayan HTML alanı sorguları

Boş Açıklamaiçeren iş öğelerini bulabilirsiniz. Html alanıyla Boş veya Boş Değil alanını kullanmak, zengin metin alanları boş veya boş olmayan iş öğelerinin listelenmesine yardımcı olur. Bu işleçle bir değer belirtemezsiniz.

Örneğin, aşağıdaki sorgu filtrelerinde bazı Açıklama alanı girişlerine sahip tüm iş öğeleri listelenir.

Boş olmayan HTML alanlarını filtreleme

Özel karakterler için filtre uygulama

veya -gibi / özel karakterler içeren bir URL veya tümceciği filtrelemek için, bu karakterlerden kaçmak için ters eğik çizgi kullanın. Aşağıdaki örneklerde, URL ve tümcecik için tireyle filtreleme gösterilmektedir:

  • URL'yi filtreleme: tümceciği https://example.com/path-to-resourceiçeren bir iş öğesi başlığı arayın.

    • Sorgu: Title ~ "https:\/\/example.com\/path-to-resource"
    • Sonuçlar: Belirtilen alanda tam URL'ye sahip tüm iş öğelerini döndürür.

  • Tireli bir tümceciği filtreleme: içeren "your-phrase-with-dash"bir iş öğesi başlığı arayın.

    • Sorgu: Title ~ "feature-update\-2023"
    • Sonuçlar: Belirtilen alanda kısa çizgilerle tam tümceciği içeren tüm iş öğelerini döndürür.

Not

Hiçbir etiketi olmayan iş öğelerini sorgulayamazsınız. Bu özellik isteğine oy vermek için Geliştirici Topluluğu sayfamızda boş etiket arayabilirsiniz.

Kategori tabanlı sorgular

İş öğelerini ait oldukları kategoriye göre filtrelemek için Grupta işlecini kullanın. Örneğin, aşağıdaki filtre ölçütleri geçerli projede yer alan, ekip üyesine atanan ve Hata Kategorisine ait olarak tanımlanan tüm iş öğelerini döndürür.

Kategoriye göre iş öğelerini bulmak için sorgu yan tümcesi

Gereksinim veya Görev kategorilerinde hangi öğeler görüntülenir?

Her kategoriye iş öğesi türlerinin varsayılan atamaları, her işlem için aşağıdaki gibi listelenir.

İşlem Gereksinim kategorisi Görev kategorisi
Temel Sorun Görev
Çevik Kullanıcı Hikayesi Görev
Scrum Ürün Kapsam Öğesi, Hata Görev
CMMI Gereksinim Görev

Her ekip Hata iş öğesi türünün Gereksinim veya Görev kategorisinde görünüp görünmediğini belirleyebilir. Bkz. Kapsamlarda ve panolarda hataları gösterme. Bir kapsam içine özel iş öğesi türleri ekleyebilirsiniz. Daha fazla bilgi için bkz . bir iş öğesi türü ekleme veya değiştirme, Kapsam veya panoya özel WIT ekleme.

Takip ettiğiniz iş öğelerini sorgulama

@Follows makrosunu kullanarak, takip ettiğiniz iş öğelerine ve diğer sorgu filtrelerine göre bir listeyi filtreleyebilirsiniz.

Örneğin aşağıdaki sorguda, takip ettiğiniz etkin iş öğeleri için tüm projeler arasında nasıl sorgu yapılacağı gösterilmektedir. kimlik alanını ve In işlecini @Follows makroyla birlikte kullanırsınız.

Sorgu Düzenleyicisi, id in @Follows sorgu yan tümcesi

Son iş öğesi etkinliğini sorgulama

İş öğelerini son etkinliklere göre listelemek için aşağıdaki makroları kullanabilirsiniz:

  • @MyRecentActivity: Son görüntülediğiniz veya değiştirdiğiniz öğeleri listeleyin.
  • @RecentMentions: Son 30 gün içinde bir @mention aracılığıyla eklediğiniz öğeleri listeleyin.
  • @RecentProjectActivity: Projenizde yeni oluşturulan veya değiştirilen öğeleri listeleyin.

Kimlik alanını ve In veya Not in işleçlerini belirtin.

Örneğin, aşağıdaki sorguda son görüntülediğiniz veya değiştirdiğiniz iş öğelerinin nasıl sorgulandığı gösterilir.

Sorgu Düzenleyicisi, id in @MyRecentActivity sorgu yan tümcesi

Çoğu iş öğesi türü için ortak alanlar

Aşağıdaki tabloda sorguları filtrelemek için kullanılan yaygın alanlar açıklanmaktadır. Kimlik alanları, listedeki iş öğelerini benzersiz olarak tanımlar. İş öğesini aynı türdeki diğer tüm öğelerden ayırmak için Başlık alanını kullanın. Açıklama ve diğer zengin metin (veri türü=HTML) alanları, iş uygulamak ve değişiklikleri izlemek için gereken ek bilgileri sağlar. Bir iş öğesi oluşturulduktan sonra, kimlik dışındaki tüm alanları değiştirebilirsiniz. Bir iş öğesi ekleyip kaydettiğinizde, kimlik sistem tarafından atanır ve değiştirilemez.

Not

Sistem, tam metin araması için düz metin ve HTML alanları veri türüyle tüm uzun metin alanlarını otomatik olarak dizine alır. Buna Başlık, Açıklama ve Yeniden Oluşturma Adımları alanları dahildir. Şirket içi Azure DevOps için geçerli olan sunucu ve harmanlama gereksinimleri hakkında daha fazla bilgi için bkz . Sorgu alanları, işleçler, değerler ve değişkenler - Tam metin ve kısmi sözcük aramaları.

Alan adı

Açıklama

İş öğesi türü

Kabul Ölçütleri 1

Hata veya ürün kapsamı öğesi kapatılmadan önce karşılanacak ölçütlerin açıklaması.

Bir hata veya ürün kapsamı öğesi üzerinde çalışma başlamadan önce, müşteri kabulü ölçütleri mümkün olduğunca açık bir şekilde açıklanmalıdır. Kabul ölçütlerini tanımlamak için ekiple müşteriler arasındaki konuşmalar, ekibinizin müşterilerinizin beklentilerini anlamasını sağlamaya yardımcı olur. Kabul ölçütleri kabul testleri için temel olarak kullanılabilir, böylece bir öğenin tatmin edici bir şekilde tamamlanıp tamamlanmadığını daha etkili bir şekilde değerlendirebilirsiniz.

Başvuru adı=Microsoft.VSTS.Common.AcceptanceCriteria, Veri türü=HTML

Hata, Epic, Özellik, Ürün kapsamı öğesi (Scrum)

Açıklama 1, 2

Bir iş öğesi hakkında ayrıntılı bilgi sağlamak için bu alanı kullanın.

Başvuru adı=System.Description, Veri türü=HTML

Tümü

Kimlik

Bir iş öğesine atanan benzersiz tanımlayıcı. İş öğesi kimlikleri tüm projelerde ve proje koleksiyonu içinde benzersizdir.

Başvuru adı=System.Id, Veri türü=Tamsayı

Tümü

Yeniden Oluşturma Adımları (veya Yeniden oluşturma adımları) 1

Beklenmeyen davranışı yeniden oluşturmak için gereken adımlar. Diğer ekip üyelerinin sorunun tam etkisini ve hatayı düzeltip düzeltmediklerini anlayabilmeleri için yeterli bilgiyi yakalayın. Bu girdi, hatayı ve beklenen davranışı bulmak veya yeniden oluşturmak için hesaba katılması gereken eylemleri içerir.
Başvuru adı=Microsoft.VSTS.TCM.ReproSteps, Veri türü=HTML

Hata

Çözüm

Bir engelin nasıl çözümlendiğini açıklar.

Başvuru adı=Microsoft.VSTS.Common.Resolution, Veri türü=HTML

Impediment (Scrum)

Sistem Bilgileri1

Hata, kod gözden geçirme veya geri bildirimle ilgili yazılım ve sistem yapılandırması hakkında bilgi.

Başvuru adı=Microsoft.VSTS.TCM.SystemInfo, Veri türü=HTML

Hata, Kod Gözden Geçirme İsteği, Geri Bildirim İsteği

Takım Projesi

Bir iş öğesinin ait olduğu proje. Listenizi bir veya daha fazla projedeki öğelere filtrelemek istediğinizde bu alanı sorguya ekleyin. Daha fazla bilgi için bkz . Örnek sorgular, projeler arasında sorgulama.

Başvuru adı=System.TeamProject, Veri türü=Dize

Tümü

Başlık

İş öğesinin ne olduğunu özetleyen ve ekip üyelerinin listedeki diğer iş öğelerinden ayırt etmesine yardımcı olan kısa bir açıklama.

Başvuru adı=System.Title, Veri türü=Dize

Tümü

İş Öğesi Türü

İş öğesi türünün adı. İş öğesi türleri, projenizi oluştururken kullanılan işleme göre tanımlanır. Daha fazla bilgi için bkz . İşlemler ve işlem şablonları hakkında ve İş öğesi türü ekleme veya değiştirme.

İş öğelerini kategori atamalarına göre filtrelemek için, Grupta Değil işleçlerini kullanabilir ve açılan listeden bir kategori seçebilirsiniz.

Başvuru adı=System.WorkItemType, Veri türü=Dize

Tümü

Not

Team Foundation Server 2012'ye yükseltildiğinde, Açıklama alanı Düz Metin alan türünden HTML'ye değiştirildi. witadmin changefield komutunu kullanarak bu alanın veri türünü geri alabilirsiniz. Bkz. İş öğesi alanlarını yönetme (witadmin).

REST API

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