Definieren von Auswahllisten

Artikel
03/12/2013

Sie können einen Satz von Werten für ein Feld auflisten, indem Sie eine Auswahlliste definieren – entweder als Teil der Definition oder an einem Punkt des Workflows.Sie können angeben, dass die Liste nur zulässige Werte, keine unzulässigen Werte oder vorgeschlagene Werte enthalten darf.Wenn Werte vorgeschlagen werden, können die Benutzer einen anderen Wert als in der Auswahlliste angeben.

Sie können auch abhängige Auswahllisten definieren. Zu diesem Zweck werden für ein Feld mindestens zwei Listen definiert, und zur Laufzeit wird dann lediglich eine Liste angezeigt, deren Auswahl von der Auswertung einer bedingten Regel abhängig ist.

In diesem Thema

Syntaxstruktur zum Auflisten von Auswahllisten
Syntaxstruktur für GLOBALLIST- und LISTITEM-Elemente
Zulassen eines vorhandenen Werts
Auflisten eines Satzes zulässiger Werte
Definieren abhängiger Auswahllisten

Hinweis
Um eine Auswahlliste für eine FIELD Definition hinzuzufügen oder zu ändern, verwenden Sie das Befehlszeilentool witadmin um die Definition für den Arbeitsaufgabentyp zu importieren und exportieren.Siehe Anpassen und Verwalten von Arbeitsaufgabentypen [witadmin].

Syntaxstruktur zum Auflisten von Auswahllisten

Sie können mithilfe der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES eine Liste von Werten angeben, die ein Benutzer als Wert für ein Feld angeben muss, angeben darf oder nicht angeben darf.Mit jedem dieser Elemente können Sie eine Liste von Elementen auflisten oder eine globale Liste angeben.Mithilfe von ALLOWEXISTINGVALUE können Sie das Speichern eines vorhandenen Werts in einem Feld zulassen, wenn ein Element aus der Auswahlliste entfernt wird.

Sie können diese Elemente als untergeordnete Elemente des FIELD (Definition)-Elements oder des FIELD (Workflow)-Elements angeben.

Sie definieren mithilfe von ALLOWEDVALUES eine Liste von Werten, welche die Benutzer in einem Arbeitsaufgabenformular oder dem Abfrage-Editor angeben können.Die Benutzer müssen einen der Werte aus dem GLOBALLIST-Element oder aus dem Satz von LISTITEM-Einträgen angeben.

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

Mithilfe von PROHIBITEDVALUES können Sie eine Liste unzulässiger Feldwerte definieren.Benutzer können eine Arbeitsaufgabe nicht speichern, wenn das Feld einen unzulässigen Wert enthält.Verwenden Sie das Element, wenn Sie die Verwendung eines Werts einschränken möchten, der zuvor zulässig war, jedoch nicht mehr gültig ist.
```
<PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</PROHIBITEDVALUES>
```

Mithilfe von SUGGESTEDVALUES können Sie eine Liste zulässiger Feldwerte definieren.Die von den Benutzern angegebenen Werte müssen nicht den vorgeschlagenen Werten entsprechen.

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

Für jedes dieser Elemente können Sie eines oder mehrere der in der folgenden Tabelle beschriebenen Attribute angeben:

Attribut	Beschreibung
for	Dies ist optional.Dient zum Angeben des Namens eines Benutzers oder einer Gruppe in Team Foundation, für den bzw. für die die Regel gelten soll.Gültige Namen bestehen aus einer Textzeichenfolge mit bis zu 255 Zeichen. Musterwert: ^[^\\]+\\[^\\]+$ Musterwertbeispiel: Domäne\Benutzer-ID
not	Dies ist optional.Dient zum Angeben des Namens eines Benutzers oder einer Gruppe in Team Foundation, für den bzw. für die die Regel nicht gelten soll.Gültige Namen bestehen aus einer Textzeichenfolge mit bis zu 255 Zeichen. Musterwert: ^[^\\]+\\[^\\]+$ Musterwertbeispiel: Domäne\Benutzer-ID
expanditems	Dies ist optional.Gibt an, ob eine im LISTITEM-Element genannte Gruppe erweitert werden soll, um untergeordnete Gruppen in die Liste aufzunehmen.Der Standardwert ist true.
filteritems	Dies ist optional.Legt fest, dass die Liste nur die Mitglieder der Gruppen und nicht die Gruppennamen enthält.Der einzige gültige Wert dieses Attributs lautet excludegroups.

Weitere Informationen finden Sie unter Definieren von Benutzerlisten, Auswahllisten und globalen Listen.

Zurück nach oben

Syntaxstruktur für GLOBALLIST- und LISTITEM-Elemente

Mithilfe der Elemente GLOBALLIST und LISTITEM können Sie Elemente auflisten, die global aktualisiert werden können oder die für ein einzelnes Feld spezifisch sind.

Verwenden Sie GLOBALLIST, um einen Satz von LISTITEM-Elementen zu definieren, der für eine Teamprojektsammlung gespeichert wird und von allen Teamprojekten dieser Auflistung verwendet werden kann.GLOBALLIST ist ein erforderliches untergeordnetes Element des GLOBALLISTS-Elements sowie ein optionales untergeordnetes Element der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES.Eine globale Liste kann in der Definition einer Arbeitsaufgabe, in der Definition einer globalen Liste oder in einem globalen Workflow definiert werden.

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

globalListName: Eine Textzeichenfolge mit bis zu 255 Zeichen.

Wichtig
Wenn Sie eine globale Liste in einer XML-Definitionsdatei für einen Arbeitsaufgabentyp definieren, müssen Sie die globale Liste eindeutig benennen.Andernfalls wird unter Umständen eine vorhandene globale Liste überschrieben, die für die Auflistung definiert wurde.

Sie listen mithilfe von LISTITEM einen Satz von Werten auf.LISTITEM ist ein erforderliches untergeordnetes Element des GLOBALLIST-Elements sowie ein optionales untergeordnetes Element der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES.
```
<LISTITEM value="listName" />
```
listName: Eine Textzeichenfolge mit 1 bis 255 Zeichen.

Zurück nach oben

Zulassen eines vorhandenen Werts

Mithilfe des ALLOWEXISTINGVALUE-Elements können Sie festlegen, dass vorhandene Werte in einem Feld beibehalten werden sollen, nachdem Sie mithilfe des ALLOWEDVALUES-Elements eine Auswahlliste mit Elementen angegeben haben.Wenn Sie das ALLOWEXISTINGVALUE-Element nicht angeben, zwingen Sie den Benutzer, während der Bearbeitung einen der aktuellen gültigen Werte für dieses Feld anzugeben.Das ALLOWEXISTINGVALUE-Element ändert nur Elemente im gleichen Block.

<ALLOWEXISTINGVALUE />

Sie geben dieses Element unter dem FIELD (Workflow)-Element an, um es auf die für das Feld definierten Regeln anzuwenden.Diese Anwendung schließt die in den Elementen STATE, TRANSITION, DEFAULTREASON und REASON des Felds angegebenen Regeln ein.Sie geben dieses Element unterhalb des STATE-Elements an, um es nicht nur auf die Regeln anzuwenden, die für den Zustand des Felds definiert sind, sondern auch auf die Regeln, die für alle Übergänge in den Zustand für das Feld definiert sind.

Sie geben dieses Element unterhalb des TRANSITION-Elements an, um es nicht nur auf die Regeln anzuwenden, die im Übergang des Felds definiert sind, sondern auch auf die Regeln, die für das Feld in den Elementen REASON und DEFAULTREASON definiert sind.

Zurück nach oben

Auflisten einer Liste

Feldlisten bestehen aus einzelnen Listenelementen.Jede Feldliste muss mindestens ein Element enthalten.

Hinweis
Globale Listen müssen keine durch Projekte festgelegten Gruppen enthalten, da sie nicht für ein Projekt festgelegt werden.

Um Elemente in einer Feldliste anzugeben, verwenden Sie das <LISTITEM value="">-Element.Sie können eine Zeichenfolge, einen Benutzernamen oder einen Gruppennamen angeben.

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

Hinweis
Zur Laufzeit werden die Elemente einer Liste auf der Grundlage der Sprache des Servers, auf dem Visual Studio Team Foundation Server ausgeführt wird, alphabetisch sortiert.

Zurück nach oben

Auflisten eines Satzes zulässiger Werte

In diesem Beispiel kann das Feld "Customer Severity" einen von drei Werten haben: "Emergency", "Major" und "Minor".Das Feld wird als Pflichtfeld mit dem Standardwert "Minor" definiert.Zur Laufzeit können Benutzer einen der Werte einer Dropdownliste angeben.

<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>

Zurück nach oben

Definieren abhängiger Auswahllisten

Sie können eine Auswahlliste definieren, die nur aktiv ist, wenn die übergeordnete bedingte Klausel erfüllt ist.Im folgenden Beispiel werden zwei Auswahllistensätze für "My Field" definiert.Zur Laufzeit wird lediglich eine Liste nach, ob Anforderungen an den MyCompany.MyTeam.Discipline Feld zugewiesen wird.

Hinweis
Die in diesem Beispiel verwendeten Regeln WHEN und WHENNOT können auch auf andere Regeln angewendet werden, um anzugeben, wann diese Regeln ausgewertet werden sollen.Weitere Informationen finden Sie unter Zuweisen bedingter Werte und Regeln.

<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>

Zurück nach oben