Seçim Listeleri Tanımlama

Makale
03/12/2013

Tanımının bir parçası olarak seçim listesini tanımlama yoluyla veya iş akışı sırasında bazı noktalarda bir alan için bir değerler kümesini numaralandırabilirsiniz.Listenin yalnızca izin verilen değerleri içerebileceğini, yasaklanan değerleri içeremeyeceğini ya da değerler öneremeyeceğini belirtebilirsiniz.Değerler önerirseniz, kullanıcılar seçim listesindekilerden farklı değer belirtebilir.

Ayrıca, bir alan için iki veya daha fazla liste tanımladığınız ancak koşullu bir kuralın değerlendirilmesine göre çalıştırma zamanında tek bir listenin göründüğü bağımlı seçim listeleri tanımlayabilirsiniz.

Bu konuda

Alma Listelerinin Sayımı için Sözdizimi Yapısı
GLOBALLIST ve LISTITEM Öğeleri için Sözdizimi Yapısı
Varolan Bir Değere İzin Verme
İzin Verilen Değerler Kümesini Numaralandırma
Bağımlı Seçim Listelerini Tanımlama

[!NOT]

Eklemek veya değiştirmek için seçim listesi 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ı.Bkz: İş Öğesi Türlerini Özelleştirme ve Yönetme [witadmin]

Alma Listelerinin Sayımı için Sözdizimi Yapısı

Kullanıcının bir alan için değer olarak belirlemesi gereken, belirleyebileceği ya da belirlememesi gereken değerlerin listesini oluşturmak için ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES öğelerini kullanabilirsiniz.Bu öğelerin her birini kullanırsanız, öğelerin bir listesini numaralandırabilir veya genel bir liste belirtebilirsiniz.Seçim listesinden bir öğe çıkardığınızda, varolan bir değeri depolamak için alan sağlamak üzere ALLOWEXISTINGVALUE öğesini kullanabilirsiniz.

Bu öğeleri FIELD (Tanım) veya FIELD (İş akışı) öğesinin alt öğeleri olarak belirtebilirsiniz.

Kullanıcıların iş öğesi formunda veya sorgu düzenleyicisinde belirtebileceği değerlerin listesini tanımlamak için ALLOWEDVALUES kullanın.Kullanıcıların GLOBALLIST öğesindeki değerlerden birini veya LISTITEM girdileri kümesini belirtmeleri gerekir.

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

Bir alanın içeremeyeceği değerler listesini tanımlamak için PROHIBITEDVALUES kullanın.Kullanıcılar, alan herhangi bir yasaklanmış değer içerirse iş öğesini kaydedemeyebilir.Önceden izin verilmiş olan ancak artık geçerli olmayan bir değerin 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>
```

Bir alanın içerebileceği değerler listesini tanımlamak için SUGGESTEDVALUES kullanın.Kullanıcılar önerdiğiniz değerlere ek olarak başka değerler de belirleyebilir.

<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, aşağıdaki tabloda açıklanan özniteliklerden bir veya daha fazlasını belirleyebilirsiniz:

Öznitelik	Tanımlama
for	İsteğe Bağlı.Kuralın uygulandığı Team Foundation'daki bir kullanıcının veya grubun adını belirtir.Geçerli adlar 1 ile 255 arasında karakter içeren bir metin dizesinden oluşmalıdır. Desen değeri: ^[^\\]+\\[^\\]+$ Desen değeri örneği: Domain\UserID
not	İsteğe Bağlı.Bu kuralın uygulanmadığı Team Foundation'daki bir kullanıcının veya grubun adını belirtir.Geçerli adlar 1 ile 255 arasında karakter içeren bir metin dizesinden oluşmalıdır. Desen değeri: ^[^\\]+\\[^\\]+$ Desen değeri örneği: Domain\UserID
expanditems	İsteğe Bağlı.LISTITEM öğesi tarafından tanımlanan bir grup, listedeki bağlı grupları içermek üzere genişletilmesini belirtir.true varsayılan değerdir.
filteritems	İsteğe Bağlı.Listenin grup adlarını değil yalnızca grup üyelerini içerdiğini belirtir.Bu özniteliğin geçerli değeri excludegroups öğesidir.

Daha fazla bilgi için bkz. Kullanıcı Listeleri, Seçim Listeleri ve Genel Listeler Tanımlama.

Başa dön

GLOBALLIST ve LISTITEM Öğeleri için Sözdizimi Yapısı

GLOBALLIST ve LISTITEM öğelerini genel olarak güncelleştirilebilen ya da belli bir alana özgü olan öğelerin listesini numaralandırmak için kullanabilirsiniz.

Bir ekip projesi toplaması için depolanan ve bu toplamada tüm ekip projelerinin kullanabileceği LISTITEM öğelerinin bir kümesini tanımlamak için GLOBALLIST öğesi kullanın.GLOBALLIST; GLOBALLISTS öğesinin gerekli bir alt öğesi ve ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES öğelerinin seçeneğe bağlı bir alt öğesidir.Bir genel listeyi bir iş öğesi türü tanımı, bir genel liste tanımı veya bir genel işi akışı içinde tanımlayabilirsiniz.

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

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

Önemli
İş öğesi tanımlayan bir XML dosyasında genel bir liste tanımlarsanız, listeye benzersiz bir isim vermelisiniz.Veya koleksiyon için tanımlanmış varolan listenin üzerine yazabilirsiniz.

Değerlerin bir kümesini numaralandırmak için LISTITEM kullanın.LISTITEM; GLOBALLIST'in gerekli bir alt öğesi ve ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES öğelerinin seçeneğe bağlı bir alt öğesidir.
```
<LISTITEM value="listName" />
```
listName 1 ila 255 arasında karakter içeren bir metin dizesi.

Başa dön

Varolan Bir Değere İzin Verme

ALLOWEXISTINGVALUE öğesini, ALLOWEDVALUES öğesini kullanarak seçim liste öğelerini belirledikten sonra varolan değerleri tutacak bir alan sağlamak için kullanabilirsiniz.ALLOWEXISTINGVALUE öğesini belirtmezseniz, düzenleme zamanında kullanıcıyı o alan için o anda geçerli değerlerden birini belirtmeye zorlarsınız. ALLOWEXISTINGVALUE öğesi sadece aynı blokta olan öğeleri değiştirir.

<ALLOWEXISTINGVALUE />

Alan için tanımlanmış kuralları uygulamak için FIELD (İş Akışı) öğesi altında bu öğeyi belirleyin.Bu uygulama, alanın STATE, TRANSITION, DEFAULTREASON ve REASON öğelerinin belirttiği kuralları içerir.Alan durumu için tanımlanmış kuralları ve de alandaki durumun bütün geçişleri için tanımlanmış kuralları uygulamak için değil bu öğeyi STATE altında belirleyin.

Alandaki geçişte tanımlı kuralları ve ayrıca REASON ile DEFAULTREASON öğelerinde alan için tanımlanmış kuralları uygulamak için değil bu öğeyi TRANSITION altında belirtin.

Başa dön

Liste Numaralandırma

Alan listeleri tek tek liste öğeleri halinde oluşur.Her alan listesi en az bir öğe içermesi gerekir.

[!NOT]

Genel listeler proje kapsamlı grupları içermemelidir çünkü bunlar proje kapsamında değildir.

Alan listesindeki öğeleri belirlemek için <LISTITEM value=""> öğesini kullanın.Bir dize, kullanıcı adı veya 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, bir liste içindeki öğeler Visual Studio Team Foundation Server çalıştıran sunucunun diline göre alfabetik olarak görünür.

Başa dön

İzin Verilen Değerler Kümesini Numaralandırma

Bu örnekte, Customer Severity alanı üç değerden herhangi birine sahip olabilir: Emergency, Major ve Minor.Alan İkincilin varsayılan değeri ile gerektiği gibi tanımlanır.Çalıştırma zamanında, kullanıcılar açılan listedeki değerlerden herhangi 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şa dön

Bağımlı Seçim Listelerini Tanımlama

Sadece üst koşullu yan tümcesi gerçek olduğunda etkin olan bir çekme listesi tanımlayabilirsiniz.Aşağıdaki örnekte, Benim Alanım için iki malzeme çekme listesi kümesi tanımlanmıştır.Çalışma zamanında yalnızca bir liste görünür olup gereksinimleri atanmamışsa, temel alarak MyCompany.MyTeam.Discipline alan.

[!NOT]

Bu örnekteki WHEN ve WHENNOT kuralları, bu kuralların değerlendirilmesi gerektiğinde bunları belirlemek için diğer kurallara da uygulanabilir.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>

Başa dön