Genel listeleri tanımlama

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013

Önemli

Bu makale barındırılan XML ve şirket içi XML işlem modelleriyle ilgili proje özelleştirmesi için geçerlidir. Barındırılan XML özelleştirmesi, genel listeleri bir işlem güncelleştirmesiyle ekleme ve güncelleştirme işlemlerini destekler. Daha fazla bilgi edinmek için bkz. işlem şablonu özelleştirme farklılıkları.

Devralma işlemi modeli genel listeleri desteklemez. İşlem modellerine genel bakış için bkz. iş izleme deneyiminizi özelleştirme.

Genel listeleri kullanarak, birkaç çalışma öğesi türünün (WTS) tanımlarında görüntülenen bir listeyi güncelleştirmek için gereken çalışmayı en aza indirmenize olanak sağlayabilirsiniz. Genel listeler, bir veya daha fazla alana ve WıT tanımlarına dahil ettiğiniz seçim listeleridir.

Liste öğelerini bir veya daha fazla öğeye ekleyerek liste öğelerini bir koleksiyon için çeşitli WTS 'ler arasında paylaşabilirsiniz GLOBALLIST .

WTS 'yi tanımladıysanız bazı alanların aynı değerleri paylaşıp paylaşacağınızı fark edebilirsiniz. Sık sık, birden fazla proje arasında ve hatta çeşitli projelerde paylaşabilirsiniz. Gecelik derleme sayısı gibi bu değerlerden bazıları, bir yöneticinin genellikle bu listeleri birçok konumda güncelleştirmesini gerektiren, sık değişir. Genel listeler özellikle bir listenin bir dış sistemden türetilmesi gerektiğinde yararlı olabilir. Örneğin, bir şirketin ayrı bir müşteri veritabanının koruduğunu varsayalım. Müşterinin bulduğu bir hatayı dosyalandıradığınızda, müşterinin adı özel bir Found By Customer alana girilir.

Bir koleksiyon için genel listeleri, listelerken, içeri aktarabileceğiniz, dışarı aktarabileceğiniz ve silebilmeniz için bir XML dosyası olarak yönetebilirsiniz. Her genel listenin adı en fazla 254 Unicode karakter içerebilir ve bir koleksiyon içinde benzersiz olmalıdır.

Not

Varsayılan işlemlerde veya işlem şablonlarında belirtilen sistem tanımlı veya önceden tanımlanmış genel listeler yoktur.

Gereksinimler

Genel listelerin tanımlandığı proje koleksiyonu için aşağıdaki izinlerin ayarlanmış olması gerekir:

  • genel listeleri dışarı aktarmak veya listelemek için, Project koleksiyonu geçerli kullanıcılar grubunun bir üyesi olmanız veya koleksiyon düzeyi bilgilerini görüntüle izninin izin verolarak ayarlanmış olması gerekir.

  • genel listeleri içeri aktarmak için Project Collection Administrators güvenlik grubunun bir üyesi olmanız gerekir.

Genel liste eklemek veya değiştirmek için, genel listeler tanımını içeri ve dışarı aktarmak üzere witadmin komut satırı aracını kullanın. Bkz. genel listeleri yönetme. Genel bir liste kullanmak için, FIELD bir iş öğesi türü içindeki tanımına ekleyin. Tüm alan öğelerinebakın.

Genel listeler ekleme ve yönetme

Genel liste, LISTITEM bir koleksiyondaki tüm projeler tarafından genel olarak depolanan ve kullanılan bir dizi öğe kümesidir. Genel listeler, Işletim sistemi gibi çeşitli türlerde iş öğeleri içinde tanımlanan alanlar için yararlıdır, derlemede bulunur ve derleme içinde düzeltildi.

Aşağıdaki yöntemlerden birini kullanarak bir veya daha fazla genel liste ve öğelerini, kullandığınız işlem modeline göre aşağıdaki yöntemlerle tanımlayabilirsiniz:

  • Bir proje veya işlem şablonuna eklediğiniz bir WıT XML tanımı içinde (barındırılan XML ve şirket içi XML)
  • Bir proje koleksiyonuna (Şirket içi XML) aktardığınız bir genel liste XML tanım dosyası içinde
  • Bir proje koleksiyonuna (Şirket içi XML) aktardığınız bir genel iş akışı XML tanım dosyası içinde.

Not

Barındırılan XML işlem modeli için, genel liste içeri aktarma üzerine aşağıdaki sınırlar yerleştirilir:

  • Toplam 64 genel liste
  • Liste başına toplam 512 öğe
  • Yaklaşık 10.000 öğe, tüm WTS 'lerde belirtilen tüm genel listeler içinde toplam tanımlanabilir.

Sözdizimi yapısı

Aşağıdaki tabloda GLOBALLIST ve ListItem öğeleri açıklanmaktadır. Bu öğeleri, öğelerin seçim listesi veya açılan menü menüsü olarak kullanıcıya sunulan bir değer listesini numaralandırmak için kullanabilirsiniz.

Öğe

Açıklama

LıST

Bir koleksiyon için depolanan ve bir koleksiyondaki tüm projelerin kullanabileceği bir ListItem öğeleri kümesi tanımlar.

<GLOBALLIST name="globalListName">  
<LISTITEM> . . . </LISTITEM>  
</GLOBALLIST>

globalbir: 1 ile 255 arasında karakter içeren bir metin dizesi.

GLOBALLIST , globallists öğesinin gerekli bir alt öğesidir ve, ve öğelerinin isteğe bağlı bir alt öğesidir PROHIBITEDVALUES . Daha fazla bilgi için bkz. ALLOWEDVALUES, SUGGESTEDVALUES ve PROHıBıTEDVALUES XML öğeleri.

LISTE

Geçerli bir liste değeri tanımlar. Genel listeler proje kapsamında olmayan grupları içermemelidir çünkü bunlar bir proje kapsamında değildir.

<LISTITEM value="Name" />

ListItem , globalın gerekli bir alt öğesidir ve ,, ve öğelerinin isteğe bağlı bir alt öğesidir PROHIBITEDVALUES .

Örnek genel liste

Aşağıdaki sözdizimini ekleyerek bir iş öğesi türü veya genel iş akışı için bir XML tanım dosyası içinde genel bir liste tanımlayabilirsiniz:

<GLOBALLISTS>  
       <GLOBALLIST name="name of global list">  
          <LISTITEM value="List item 1" />  
          <LISTITEM value="List item 2" />  
          <LISTITEM value="List item 3" />  
          <LISTITEM value="List item 4" />  
          . . .  
          <LISTITEM value="List item n" />  
       </GLOBALLIST>  
</GLOBALLISTS>  

Aşağıdaki sözdizimini kullanarak, bir iş öğesi türü için bir XML tanım dosyası içinde genel bir listeye başvurabilirsiniz:

<GLOBALLISTS>  
      <GLOBALLIST name=" name of global list 1" />  
      <GLOBALLIST name=" name of global list 2" />  
      . . .  
      <GLOBALLIST name=" name of global list n" />  
</GLOBALLISTS>  

İş öğeleri veya genel iş akışı türleri için tanım dosyalarının yapısı ve konumu hakkında daha fazla bilgi için sırasıyla Tüm WıTD öğeleri veya GLOBALWORKFLOWöğelerine bakın.

Proje koleksiyonu için korunan örnek genel liste

Bir proje koleksiyonuna genel liste eklemek için, witadmin ımportgloballıst komutunu kullanarak aşağıdaki sözdizimini içeri aktarabilirsiniz:

<gl:GLOBALLISTS xmlns:gl="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">  
       <GLOBALLIST name="NameOfGlobalList">  
       <LISTITEM value="ListItem1" />  
       <LISTITEM value="ListItem2" />  
       <LISTITEM value="ListItem3" />  
       <LISTITEM value="ListItem4" />  
  . . .  
       <LISTITEM value="ListItemN" />  
       </GLOBALLIST>  
</gl:GLOBALLISTS>  

Genel liste boş olamaz. Her GLOBALLIST öğenin tanımlanmış en az bir LISTITEM öğesi olmalıdır.

Tüm genel listeler verilerle otomatik olarak doldurulur mi?

Şirket içi TFS için Evet. Derlemeleradlı genel liste. Her derleme çalıştırıldığında TeamProjectName eklenir. Zaman içinde, liste çok uzun olabilir. En iyi yöntem kullanılmayan öğeleri listeden düzenli olarak kaldıralım.

Bu listeyi kullanma hakkında daha fazla bilgi edinmek için bkz. derleme ve test tümleştirmesi alanlarına dayalı sorgu.