Share via

Definieren von Auswahllisten

  • Artikel

Sie können eine Gruppe von Werten für ein Feld aufzählen, indem Sie eine Auswahlliste als Teil seiner Definition oder an einem Punkt während des Workflows definieren. Sie können angeben, dass die Liste nur zulässige Werte bzw. keine verbotenen Werte enthalten darf oder Werte vorschlagen kann. Wenn Sie Werte vorschlagen, können Benutzer einen Wert angeben, der von den Werten in der Auswahlliste abweicht.

Sie können zudem abhängige Auswahllisten definieren, in denen Sie mindestens zwei Listen für ein Feld definieren, wobei aber nur eine Liste auf Basis der Auswertung einer bedingten Regel zur Laufzeit angezeigt wird.

In diesem Thema

  • Syntaxstruktur

  • Syntaxstruktur für GLOBALLIST- und LISTITEM-Elemente

  • Erlauben eines vorhandenen Werts

  • Angeben einer Gruppe zulässiger Werte

  • Definieren von abhängigen Auswahllisten

Hinweis

Verwenden Sie zum Hinzufügen oder Ändern einer Liste für eine FIELD-Definition das witadmin-Befehlszeilentool, um die Definition für den Arbeitsaufgabentyp zu importieren und zu exportieren.Siehe Importieren, Exportieren und Verwalten von Arbeitsaufgabentypen [witadmin].

Syntaxstruktur

Sie können die ALLOWEDVALUES-, SUGGESTEDVALUES- und PROHIBITEDVALUES-Elemente verwenden, um eine Liste von Werten anzugeben, die ein Benutzer als einen Wert für ein Feld angeben muss, möglicherweise angeben muss oder nicht angeben muss. Wenn Sie jedes dieser Elemente verwenden, können Sie eine Liste an Elementen aufzählen oder eine globale Liste angeben. Sie können den ALLOWEXISTINGVALUE verwenden, damit ein Feld einen vorhandenen Wert speichern kann, wenn Sie ein Element aus der Auswahlliste entfernen.

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

  • Sie verwenden ALLOWEDVALUES zum Definieren einer Werteliste, die Benutzer in einem Arbeitsaufgabenformular oder in einem Abfrage-Editor angeben können. Benutzer müssen einen der Werte in der GLOBALLIST oder der Gruppe 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>

  • Sie verwenden PROHIBITEDVALUES zum Definieren einer Liste von Werten, die ein Feld nicht enthalten darf. Benutzer können die Arbeitsaufgabe nicht speichern, wenn ein Feld einen unzulässigen Wert enthält. Sie verwenden dieses Element, wenn Sie die Verwendung eines Werts einschränken möchten, der zuvor zulässig war, aber inzwischen 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>

  • Sie verwenden SUGGESTEDVALUES zum Definieren einer Liste von Werten, die ein Feld enthalten darf. Benutzer können zusätzlich zu den von Ihnen vorgeschlagenen Werten auch andere Werte angeben.

    <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 mindestens ein Attribut angeben, das in der folgenden Tabelle beschrieben wird:

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 durch das LISTITEM-Element identifizierte Gruppe um die untergeordneten Gruppen in der Liste erweitert werden soll. Der Standardwert ist true.

filteritems

Dies ist optional. Gibt an, dass die Liste nur Mitglieder von Gruppen und keine Gruppennamen enthält. Der einzige gültige Wert für dieses Attribut ist excludegroups.

Weitere Informationen finden Sie unter Erweitern von Listenelementen und Ausschließen von Gruppen aus Listen.

Syntaxstruktur für GLOBALLIST- und LISTITEM-Elemente

Sie können die Elemente GLOBALLIST und LISTITEM zum Auflisten einer Liste von Elementen verwenden, die global aktualisiert werden können oder die für ein einzelnes Feld spezifisch sind.

  • Sie verwenden GLOBALLIST, um einen Satz von LISTITEM-Elementen zu definieren, der für eine Teamprojektauflistung gespeichert wird und den alle Teamprojekte in einer Auflistung verwenden können. GLOBALLIST ist ein erforderliches untergeordnetes Element des GLOBALLISTS-Elements und ein optionales untergeordnetes Element der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES. Sie können eine globale Liste innerhalb eines Arbeitsaufgabentyps, einer globalen Liste oder eines globalen Workflows definieren.

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

    globalListName: Eine Textzeichenfolge mit 1 bis 255 Zeichen.

    Wichtig

    Wenn Sie eine globale Liste in einer XML-Datei definieren, die einen Typ der Arbeitsaufgabe definiert, müssen Sie die Liste eindeutig benennen.Ansonsten überschreiben Sie möglicherweise eine vorhandene Liste, die für die Auflistung definiert wurde.

  • Sie verwenden LISTITEM zum Aufzählen einer Gruppe von Werten. LISTITEM ist ein erforderliches untergeordnetes Element von GLOBALLIST und ein optionales untergeordnetes Element der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES.

    <LISTITEM value="listName" />

    listName: Eine Textzeichenfolge mit 1 bis 255 Zeichen.

Erlauben eines vorhandenen Werts

Sie können das ALLOWEXISTINGVALUE-Element verwenden, um einen Feld zu erlauben, vorhandene Werte verwalten zu können, nachdem Sie ein Auswahlliste der Elemente mithilfe des Elements ALLOWEDVALUES angegeben haben. Wenn Sie das ALLOWEXISTINGVALUE-Element nicht angeben, zwingen Sie den Benutzer zur Bearbeitungszeit, einen der aktuell gültigen Werte für dieses Feld anzugeben. Das ALLOWEXISTINGVALUE-Element ändert nur die Elemente, die sich im selben Block befinden.

<ALLOWEXISTINGVALUE />

Sie geben dieses Element unter dem Element "FIELD (Workflow)" an, um es auf die Regeln anzuwenden, die für das Feld definiert sind. Diese Anwendung bezieht die Regeln mit ein, die die STATE-, TRANSITION-, DEFAULTREASON- und REASON-Elemente des Felds angeben. Sie geben dieses Element unter dem STATE-Element an, um es nicht nur auf die Regeln anzuwenden, die im Status für das Feld definiert sind, sondern auch auf die Regeln, die für das Feld für alle Übergänge in den Status definiert sind.

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

Angeben einer Liste

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

Hinweis

Globale Listen dürfen keine Gruppen aus dem Projektumfang enthalten, da sie nicht auf ein Projekt begrenzt sind.

Verwenden Sie zum Angeben von Elementen in einer Feldliste 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 Elemente in einer Liste auf Basis der Sprache des Servers unter Visual Studio Team Foundation Server alphabetisch angezeigt.

Angeben einer Gruppe zulässiger Werte

In diesem Beispiel kann das Feld "Customer Severity" einen der drei Werte aufweisen: "Emergency", "Major" und "Minor". Das Feld wird nach Bedarf mit dem Standardwert von "Minor" definiert. Zur Laufzeit können Benutzer einen der Werte in 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>

Definieren von abhängigen Auswahllisten

Sie können eine Auswahlliste definieren, die nur aktiv ist, wenn ihre übergeordnete bedingte Klausel "true" aufweist. Im folgenden Beispiel werden zwei Gruppen von Auswahllisten für "My Field" definiert. Zur Laufzeit wird nur eine Liste angezeigt, und zwar abhängig davon, ob "Requirements" dem Feld MyCompany.MyTeam.Discipline zugewiesen.

Hinweis

Die Regeln WHEN und WHENNOT in diesem Beispiel können auch für andere Regeln gelten, 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>

Siehe auch

Weitere Ressourcen

Arbeitsaufgabennachverfolgung: Index für XML-Elementdefinitionen

Ändern oder Hinzufügen eines Felds zur Unterstützung von Abfragen, Berichten und Workflow