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 modelleri için proje özelleştirmesi için geçerlidir. Barındırılan XML özelleştirmesi, genel listelerin bir işlem güncelleştirmesi ile ekleyip güncelleştirmesini destekler. Daha fazla bilgi edinmek için bkz. İşlem şablonu özelleştirme farkları.

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

Genel listeleri kullanarak, birkaç iş öğesi türü (WIT) tanımında görünen bir listeyi güncelleştirmek için gereken işi en aza ekleyebilirsiniz. Genel listeler, bir veya daha fazla alan ve WIT tanımına dahil etmek için seçki listeleridir.

Liste öğelerini bir veya daha fazla öğeye dahil kullanarak bir koleksiyon için birkaç WIT arasında liste öğelerini GLOBALLIST paylaşabilirsiniz.

WIT'leri tanımlarken bazı alanların aynı değerleri paylaştığını bulabilirsiniz. Sık sık, çeşitli WIT'ler arasında ve hatta birkaç proje arasında paylaşımda bulundurabilirsiniz. Gecelik derlemelerin derleme sayısı gibi bu değerlerden bazıları sıklıkla değişir ve bu da yöneticinin bu listeleri birçok konumda sık sık güncelleştirmesini gerektirir. Genel listeler özellikle bir listenin dış sistemden türetilenler için yararlı olabilir. Örneğin, bir şirketin ayrı bir müşteri veritabanına sahip olduğunu varsayalım. Müşterinin keşfetti olduğu bir hatayı dosyalasanız, müşterinin adı özel bir alana Found By Customer girilir.

Bir koleksiyonun genel listelerini liste, içeri aktarma, dışarı aktarma ve silme gibi 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 liste yoktur.

Gereksinimler

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

  • Genel listeleri dışarı veya liste olarak görüntülemek için, Project Koleksiyonu Geçerli Kullanıcılar grubunun üyesi veya Koleksiyon düzeyindeki bilgileri görüntüle izinnizin İzin Ver olarak ayarlanmış olması gerekir.

  • Genel listeleri içeri aktar almak için Koleksiyon Yöneticileri güvenlik grubunun Project üyesisiniz.

Genel liste eklemek veya değiştirmek için witadmin komut satırı aracını kullanarak genel listelerin tanımını içeri ve dışarı aktarın. Bkz. Genel listeleri yönetme. Genel bir liste kullanmak için bir iş öğesi FIELD türü içindeki tanıma ekleyin. Bkz. Tüm ALAN öğeleri.

Genel listeler ekleme ve yönetme

Genel liste, bir koleksiyonda LISTITEM yer alan tüm projeler tarafından genel olarak depolanan ve kullanılan öğeler kümesidir. Genel listeler İşletim Sistemi, Derlemede Bulunan ve Derlemede Sabit gibi çeşitli iş öğeleri türleri içinde tanımlanan alanlar için kullanışlıdır.

Bir veya daha fazla genel liste ve öğelerini, aşağıdaki yöntemlerden birini kullanarak, kullanmakta olduğu işlem modeline göre tanımlayabilirsiniz:

  • Bir proje veya işlem şablonuna (Barındırılan XML ve Şirket İçi XML) ekley istediğiniz WIT XML tanımı içinde
  • Bir proje koleksiyonuna aktardınız genel liste XML tanım dosyası içinde (Şirket içi XML)
  • Bir proje koleksiyonuna aktardınız genel iş akışı XML tanım dosyasında (Şirket içi XML).

Not

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

  • Toplam 64 genel liste
  • Liste başına toplam 512 öğe
  • Tüm WIT'ler arasında belirtilen tüm genel listelerde yaklaşık 10.000 öğe tanımlanabilir.

Söz dizimi yapısı

Aşağıdaki tabloda GLOBALLIST ve LISTITEM öğeleri açık almaktadır. Bu öğeleri kullanarak kullanıcıya seçim listesi veya öğe açılan menüsü olarak sunulan değerlerin listesini listeleebilirsiniz.

Öğe

Açıklama

GLOBALLIST

Bir koleksiyon için depolanan ve bir koleksiyonda yer alan tüm projelerin kullanabileceği bir listITEM öğeleri kümesi tanımlar.

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

globalListName:1 ile 255 karakter arasında bir metin dizesi.

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

LİSTITEM

Geçerli bir liste değeri tanımlar. Bir projenin kapsamına dahil olmayan genel listeler proje kapsamındaki grupları içermez.

<LISTITEM value="Name" />

LISTITEM, GLOBALLIST'in gerekli bir alt öğesi ve , ve öğelerinin isteğe bağlı ALLOWEDVALUES bir alt SUGGESTEDVALUES PROHIBITEDVALUES öğesidir.

Örnek genel liste

Aşağıdaki söz dizimi ekleyerek, bir iş öğesi türü veya genel iş akışı için bir XML tanım dosyasında genel 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öz dizimi kullanarak, iş öğesi türü için bir XML tanım dosyasındaki genel 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 bilgi için sırasıyla Tüm WITD öğeleri veya GLOBALWORKFLOW' a bakın.

Proje koleksiyonu için bakımı yapılan örnek genel liste

Bir proje koleksiyonuna genel liste eklemek için witadmin importgloballist komutunu kullanarak aşağıdaki söz dizimlerini 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 olması gerekir.

Verilerle otomatik olarak doldurulan genel listeler var mı?

Şirket içi TFS için evet. Builds adlı genel liste. TeamProjectName, bir derleme her çalıştırıldında eklenir. Zaman içinde liste çok uzun olabilir. En iyi yöntem, kullanılmayan öğeleri listeden düzenli olarak kaldırmaktır.

Bu listeyi kullanma hakkında daha fazla bilgi edinmek için bkz. Derleme ve test tümleştirme alanlarına göre sorgulama.