Seçim listeleri tanımlama

Makale
06/09/2015

İş akışı sırasında parçası olarak tanımına veya bir noktada bir seçim listesi tanımlanarak bir alan için değerler sıralayabilirsiniz.Liste yalnızca izin verilen değerler içerebilir, izin verilmeyen bir değere sahip veya değerleri Öner belirtebilirsiniz.Değerleri Öner, kullanıcıların diğer seçim listesi olanlar bir değer belirtin.

Ayrıca, bir alan için iki veya daha fazla liste tanımladığınız ancak koşullu bir kuralın değerlendirmeye dayanarak çalışma zamanında yalnızca bir listesi görüntülenir bağımlı seçim listeleri tanımlayabilirsiniz.

Bu konuda

Sözdizimi yapısı
GLOBALLIST ve LISTITEM öğeleri için sözdizimi yapısı
Bir değere izin ver
İzin verilen değerler belirtin
Bağımlı seçim listelerini tanımlama

[!NOT]

Eklemek veya bir seçim listesi değiştirmek için bir FIELD tanım, kullanım witadmin almak ve iş öğesi türü için tanım vermek için komut satırı aracını.Bkz. İş öğesi türlerini içeri aktarma, dışarı aktarma ve yönetme [witadmin].

Sözdizimi yapısı

Kullanabileceğiniz ALLOWEDVALUES, SUGGESTEDVALUES, ve PROHIBITEDVALUES bir kullanıcı belirtmelisiniz, değerleri listesi belirtmek için öğesi belirtebilir veya bir alan için bir değer olarak belirtmeniz gerekir değil.Bu öğelerin her birini kullanırsanız, öğelerin listesini numaralandırır veya genel bir liste belirtebilirsiniz.Kullanabileceğiniz ALLOWEXISTINGVALUE seçim listesinden bir öğeyi kaldırırsanız, varolan bir değeri depolamak için alan sağlamak için.

Bu öğeleri alt öğeleri olarak belirtebilirsiniz FIELD (tanım) veya FIELD (iş akışı) öğesi.

Kullandığınız ALLOWEDVALUES kullanıcılar bir iş öğesi formu veya Sorgu Düzenleyici belirtebilirsiniz değerler listesini tanımlamak için.Kullanıcılar değerlerden birini belirtmeniz gerekir GLOBALLIST veya kümesini LISTITEM girişleri.

<ALLOWEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</ALLOWEDVALUES>

Kullandığınız PROHIBITEDVALUES bir alan içeremez değerler listesini tanımlamak için.Alan izin verilmeyen bir değer içeriyorsa, kullanıcılar bir iş öğesi kaydedemiyor.Daha önce izin verilen ancak artık geçersiz bir değer kullanımını kısıtlamak istiyorsanız bu öğeyi kullanın.
```
<PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</PROHIBITEDVALUES>
```

Kullandığınız SUGGESTEDVALUES bir alan içerebilir değerler listesini tanımlamak için.Kullanıcılar, diğer değerleri ek olarak, Öner belirtebilirsiniz.

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</SUGGESTEDVALUES>

Bu öğelerin her biri için bir veya daha fazla aşağıdaki tabloda açıklanan öznitelikleri belirtebilirsiniz:

Öznitelik	Açıklama
for	İsteğe bağlı.Bir kullanıcı veya grubu adını belirtir Team Foundation kuralın uygulandığı için.Geçerli adları 1 ila 255 karakter arasında içeren bir metin dizesi oluşur. Desen değeri: ^ [^ \\] + \\ [^ \\] + $ Desen değeri örneği: etki alanı\kullanıcı kimliği
not	İsteğe bağlı.Bir kullanıcı veya grubu adını belirtir Team Foundation için kim kural uygulanmaz.Geçerli adları 1 ila 255 karakter arasında içeren bir metin dizesi oluşur. Desen değeri: ^ [^ \\] + \\ [^ \\] + $ Desen değeri örneği: etki alanı\kullanıcı kimliği
expanditems	İsteğe bağlı.Tanımlanan bir grup olup olmadığını belirtir LISTITEM öğe, listede bağlı grupları içermek üzere genişletilmesini.Varsayılan değer true şeklindedir.
filteritems	İsteğe bağlı.Liste yalnızca grupları, grup adları üyeleri içerdiğini belirtir.Bu özniteliğin tek geçerli değer excludegroups.

Daha fazla bilgi için bkz. Liste öğelerini genişletme ve grupları listelerden çıkarma.

GLOBALLIST ve LISTITEM öğeleri için sözdizimi yapısı

Kullanabileceğiniz GLOBALLIST ve LISTITEM öğe, güncelleştirilebilir genel olarak veya tek bir alana özgü olan öğelerin listesini numaralandırır.

Kullandığınız GLOBALLIST kümesi tanımlamak için LISTITEM depolanan için bir takım projesi toplama ve toplama kullanabileceğiniz tüm ekip projelerinin.GLOBALLISTgerekli alt öğesidir GLOBALLISTS öğesini ve isteğe bağlı bir alt öğesi ALLOWEDVALUES, SUGGESTEDVALUES, ve PROHIBITEDVALUES öğeler.Bir iş öğesi tanımını, genel liste tanımını veya genel bir iş akışı içinde genel bir liste tanımlayabilirsiniz.

<GLOBALLIST name="globalListName">
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</GLOBALLIST>

globalListName: 1 ila 255 karakter arasında içeren bir metin dizesi.

Önemli
Genel bir liste iş öğesi türü tanımlayan bir XML dosyasına tanımlıyorsanız, liste benzersiz bir ad verin gerekir.Aksi takdirde, koleksiyon için tanımlanmış varolan bir listesini üzerine.

Kullandığınız LISTITEM değerler numaralandırılacak.LISTITEMgerekli alt öğesidir GLOBALLIST ve isteğe bağlı bir alt öğesi ALLOWEDVALUES, SUGGESTEDVALUES, ve PROHIBITEDVALUES öğeler.
```
<LISTITEM value="listName" />
```
listName: 1 ila 255 karakter arasında içeren bir metin dizesi.

Bir değere izin ver

Kullanabileceğiniz ALLOWEXISTINGVALUE öğesini kullanarak bir seçim liste öğelerini belirttikten sonra var olan değerlerin korumak bir alan sağlamak için ALLOWEDVALUES öğesi.Belirtmezseniz, ALLOWEXISTINGVALUE öğesi, sizi zorlayabilir kullanıcı düzenleme zaman, bu alan için geçerli değerlerden birini belirtmek için.ALLOWEXISTINGVALUE Öğesi yalnızca aynı blokta öğeleri değiştirir.

<ALLOWEXISTINGVALUE />

Bu öğe altında belirttiğiniz FIELD alan için tanımlanmış kuralları uygulamak için (iş akışı) öğesi.Bu uygulama kuralları içerir, STATE, TRANSITION, DEFAULTREASON, ve REASON öğelerini alan belirtin.Bu öğe altında belirttiğiniz STATE yalnızca alan durumu için tanımlanan kurallar ancak alanı durum bütün geçişleri için tanımlanmış kuralları uygulamak için öğe.

Bu öğe altında belirtin TRANSITION yalnızca geçiş alanı için tanımlanan kurallar ancak alan için tanımlanmış kuralları uygulamak için öğe REASON ve DEFAULTREASON öğeler.

Bir listesini belirtin

Alan listeleri tek tek liste öğelerinin oluşur.Her alan listesi en az bir öğe içermelidir.

[!NOT]

Bir proje için kapsamlı değildir çünkü genel listeler Proje kapsamlı grupları içermemelidir.

Alan listesindeki öğeleri belirtmek için kullanın <LISTITEM value=""> öğesi.Bir dize, bir kullanıcı adı veya bir grup adı belirtebilirsiniz.

<LISTITEM value="Emergency"/>
<LISTITEM value="Major"/>
<LISTITEM value="Minor"/>
<LISTITEM value="Domain\joe"/>
<LISTITEM value="[Global]\GlobalGroup" />
<LISTITEM value="[Project]\ProjectGroup" />

[!NOT]

Çalışma zamanında listesindeki öğeleri çalıştıran sunucunun diline göre alfabetik olarak görünür Visual Studio Team Foundation Server.

İzin verilen değerler belirtin

Bu örnekte, müşteri önem derecesi alanın üç değerlerden biri olabilir: Acil, büyük ve küçük.Alan tanımlanmıştır gerektiği gibi ikincil bir varsayılan değeri.Çalışma zamanında, kullanıcılar açılan listesinde değerlerden birini belirtebilir.

<FIELD refname="System.Title" name="Title" type="String">
<HELPTEXT>Provide a brief description of the work item</HELPTEXT>
<REQUIRED/>
</FIELD>
<FIELD refname="MyCorp.CusSeverity" name="Customer Severity" type="String">
<HELPTEXT>Indicate the severity of the problem</HELPTEXT>
    <ALLOWEDVALUES>
        <LISTITEM value="Emergency">
        <LISTITEM value="Major">
        <LISTITEM value="Minor">
    </ALLOWEDVALUES>
<DEFAULT from="value" value="Minor"/>
</FIELD>

Bağımlı seçim listelerini tanımlama

Yalnızca kendi üst koşullu yan tümcesi true olduğunda etkin olan bir seçim listesi tanımlayabilirsiniz.Aşağıdaki örnekte, iki seçtikleri listesinin My alan için tanımlanır.Çalışma zamanında, yalnızca bir liste olup olmadığını gereksinimleri atanır bağlı görünür MyCompany.MyTeam.Discipline alan.

[!NOT]

WHEN Ve WHENNOT kurallar Bu örnekte de olduğunda bu kurallar değerlendirilmesi gerektiğini belirtmek üzere diğer kuralları geçerlidir.Daha fazla bilgi için bkz. Koşula dayalı değerler ve kurallar atama.

<FIELD name="My Field" refname="MyCompany.MyProcess.MyField" type="String" reportable="dimension">
  <WHEN field="MyCompany.MyTeam.Discipline" value="Requirements"> 
    <ALLOWEDVALUES> 
      <LISTITEM value="Planning" /> 
      <LISTITEM value="Review" /> 
    </ALLOWEDVALUES> 
  </WHEN> 
  <WHENNOT field=" MyCompany.MyTeam.Discipline" value="Requirements"> 
    <ALLOWEDVALUES> 
      <LISTITEM value="Process Management" /> 
      <LISTITEM value="Planning" /> 
      <LISTITEM value="Review" /> 
    </ALLOWEDVALUES> 
  </WHENNOT>
</FIELD>

Ayrıca bkz.

Diğer Kaynaklar

İş öğesi izleme: XML öğe tanımları dizini

Çalışma Öğesi Alanları Tanımlama

Aracılığıyla paylaş