Freigeben über

Verweis für alle FIELD-XML-Elemente

  • Artikel

In diesem Thema können Sie die Syntax des FIELD-Elements und der untergeordneten Elemente nachschlagen.

Sie geben diese Elemente im FIELD (Definition)-Elementcontainer an. Sie fügen ein Feld für einen Arbeitsaufgabentyp (Work Item Type WIT) hinzu, indem Sie ein FIELD (Definition)-Element innerhalb des FIELDS (Definition)-Elements angeben. Sie können diese Elemente innerhalb einer WIT-Definition oder als Teil des globalen Workflow angeben.

Sie können untergeordnete Elemente hinzufügen, um das Verhalten eines Felds festzulegen, Standardwerte anzugeben oder eine Auswahlliste von Werten zu definieren. Sie können Feldregelelemente in Kombination miteinander verwenden. Für den Geltungsbereich der meisten Regeln können Sie festlegen, dass diese für einen oder mehrere Benutzer bzw. Gruppen angewendet bzw. ignoriert werden sollen.

FIELD (Definition)-Containerelement

Mit der folgenden Syntax können Sie die Datenfelder für einen Arbeitsaufgabentyp festlegen. Dieses Beispiel zeigt das Format des FIELD (Definition)-Elements und aller optionalen untergeordneten Elemente. Weitere Informationen finden Sie unter FIELD (Definition)-Elementverweis.

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID "
syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

FIELD - untergeordnete Elemente

Mit den untergeordneten Elementen können Sie verschiedene Einschränkungen für die möglichen Eingaben in ein Feld festlegen. Sie können Werte für Auswahllisten angeben (Dropdownmenü), Standardwerte vergeben, Einträge löschen oder Änderungen einschränken. Die folgende Tabelle beschreibt die Syntaxstruktur der untergeordneten Elemente.

Unter Anwenden einer Regel auf ein Arbeitsaufgabenfeld finden Sie eine Anleitung zur Verwendung dieser Elemente. Für die Anwendung der meisten Regeln auf Systemfelder gelten Einschränkungen. Alle untergeordneten Elemente sind optional.

Element

Beschreibung und Syntax

ALLOWEDVALUES

Definiert eine Liste auswählbarer Werte für Benutzer in Arbeitsaufgabenformularen und im Abfrage-Editor. Benutzer müssen einen der aufgelisteten Werte auswählen.

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

Weitere Informationen finden Sie unter Definieren von Auswahllisten.

ALLOWEXISTINGVALUE

Gibt ein Feld an, dass einen bereits ausgewählte Werte beibehalten kann, selbst wenn diese nicht mehr Teil der Auswahlliste sind. Alle neuen Feldwerte müssen Teil der Liste sein.

<ALLOWEXISTINGVALUE />

Weitere Informationen finden Sie unter Definieren von Auswahllisten.

CANNOTLOSEVALUE

Gibt an, dass Benutzer die Werte eines Felds nicht mehr löschen dürfen, nachdem ein Wert angegeben wurde. Nachdem das Feld einen Wert enthält, muss es immer einen von NULL abweichenden Wert enthalten.

<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />

Weitere Informationen finden Sie unter Anwendung einer Feldregel.

COPY

Kopiert einen angegebenen Wert in ein Feld, wenn ein Benutzer eine Arbeitsaufgabe erstellt oder bearbeitet.

<COPY for="userGroupName" not="userGroupName"  
from="value | field | clock | currentuser" 
value="valueToCopy" field="fieldReferenceName" />

Weitere Informationen finden Sie unter Definieren eines Standardwerts oder Kopieren eines Werts in ein Feld.

DEFAULT

Gibt einen Wert in ein Feld an, das leer ist, wenn ein Benutzer eine Arbeitsaufgabe erstellt oder bearbeitet. Wenn das Feld bereits einen Wert hat, wird die Standardregel ignoriert.

<DEFAULT for="userGroupName" not="userGroupName" 
from="value | field | clock | currentuser" 
value="value to copy" field="field reference name" />

Weitere Informationen finden Sie unter Definieren eines Standardwerts oder Kopieren eines Werts in ein Feld.

EMPTY

Löscht alle vorhandenen Werte eines Felds. Die EMPTY-Regel legt das Feld außerdem als schreibgeschützt fest und sollte nicht zusammen mit der READONLY-Regel verwendet werden.

Der Feldwert wird gelöscht, wenn ein Benutzer die Arbeitsaufgabe speichert, und es kann kein Wert angegeben werden. Diese Regel wird hauptsächlich beim Zustandsübergang verwendet, um Felder zu löschen, die sich auf den Zustand beziehen, in den das Element wechselt.

<EMPTY for="userGroupName" not=" userGroupName" />

Weitere Informationen finden Sie unter Anwendung einer Feldregel.

FROZEN

Gibt an, dass das Feld nach der Übernahme von Änderungen nicht in einen nicht leeren Wert geändert werden kann. Sobald ein Benutzer die Arbeitsaufgabe mit einem Wert in diesem Feld speichert, kann der Wert nicht mehr geändert werden.

<FROZEN for="userGroupName" not="userGroupName" />

Weitere Informationen finden Sie unter Anwendung einer Feldregel.

HELPTEXT

Definiert den Text, der angezeigt wird, wenn ein Benutzer mit dem Mauszeiger über ein Feld in einem Arbeitsaufgabenformular fährt.

tooltipText: Eine Textzeichenfolge mit 1 bis 255 Zeichen.

<HELPTEXT>tooltipText </HELPTEXT>

Weitere Informationen finden Sie unter Anwendung einer Feldregel.

MATCH

Definiert ein Muster, mit dem der Wert eines Zeichenfolgenfelds übereinstimmen muss.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Weitere Informationen finden Sie unter Anwenden eines Musterabgleichs auf ein Zeichenfolgefeld.

NOTSAMEAS

Definiert, dass ein Feld nicht denselben Wert wie ein bestimmtes anderes Feld annehmen kann. Der Wert des field-Attributs muss ein gültiger Verweisname eines Felds sein.

<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />

Weitere Informationen finden Sie unter Anwendung einer Feldregel.

PROHIBITEDVALUES

Definiert eine 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.

<PROHIBITEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</PROHIBITEDVALUES>

Weitere Informationen finden Sie unter Definieren von Auswahllisten.

READONLY

Legt fest, dass der zugewiesene Wert eines Felds nicht geändert werden kann.

<READONLY for="userGroupName" not="userGroupName" />

Hinweis

Verwenden Sie dieses Element nicht zusammen mit dem EMPTY-Element, da EMPTY ein Feld ebenfalls als schreibgeschützt setzt.Kombinationen dieser Elemente führen zu inkonsistenten Ergebnissen.

Weitere Informationen finden Sie unter Anwendung einer Feldregel.

REQUIRED

Gibt an, dass Benutzer einen Wert in dieses Feld eingeben müssen. Pflichtfelder dürfen nicht leer sein. Benutzer können die Arbeitsaufgabe erst speichern, nachdem alle Pflichtfelder ausgefüllt wurden.

<REQUIRED for="userGroupName" not="userGroupName" />

Weitere Informationen finden Sie unter Anwendung einer Feldregel.

SERVERDEFAULT

Kopiert einen angegebenen Serverwert in ein Feld, wenn ein Benutzer eine Arbeitsaufgabe speichert. Diese Felder sind im Formular normalerweise schreibgeschützt.

<SERVERDEFAULT for="userGroupName" not="userGroupName" 
from="clock | currentuser" />

Weitere Informationen finden Sie unter Definieren eines Standardwerts oder Kopieren eines Werts in ein Feld.

SUGGESTEDVALUES

Definiert eine Liste mit Vorschlägen für auswählbare Werte für Benutzer in Arbeitsaufgabenformularen und im Abfrage-Editor. Benutzer können auch Werte angeben, die nicht Teil der vorgeschlagenen Liste sind.

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

Weitere Informationen finden Sie unter Definieren von Auswahllisten.

VALIDUSER

Gibt an, dass Arbeitsaufgaben nicht von Benutzern bearbeitet werden darf, die Mitglieder der angegebenen Gruppe sind. Die Standardgruppe ist die Team Foundation-Gruppe "Gültige Benutzer".

Alle Attribute sind optional. Bei allen Attributen muss es sich um eine Zeichenfolge mit 1 bis 255 Zeichen handeln. Gruppen können mithilfe von Token angegeben werden.

< VALIDUSER group="groupName" for="userName" not="userName" />

Weitere Informationen finden Sie unter Anwendung einer Feldregel.

WHEN

Legt mindestens eine Regel fest, die auf das aktuelle Feld angewendet wird, wenn ein anderes Feld einen bestimmten Wert enthält. Das übergeordnete FIELD-Element definiert das aktuelle Feld.

<WHEN field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHEN>

Weitere Informationen finden Sie unter Zuweisen bedingter Werte und Regeln

WHENNOT

Gibt an, dass mindestens eine Regel auf das aktuelle Feld angewendet werden soll, wenn ein anderes Feld nicht einen bestimmten Wert enthält. Das übergeordnete FIELD-Element definiert das aktuelle Feld.

<WHENNOT field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOT>

Weitere Informationen finden Sie unter Zuweisen bedingter Werte und Regeln.

WHENCHANGED

Gibt an, dass mindestens eine Regel auf das aktuelle Feld angewendet werden soll, wenn ein anderes Feld bei der Prüfung der Arbeitsaufgabe geändert wird. Das übergeordnete FIELD-Element definiert das aktuelle Feld.

<WHENCHANGED field="fieldReferenceName" >
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>      
</WHENCHANGED>

Weitere Informationen finden Sie unter Zuweisen bedingter Werte und Regeln.

WHENNOTCHANGED

Gibt an, dass mindestens eine Regel auf das aktuelle Feld angewendet werden soll, wenn ein anderes Feld bei der Prüfung der Arbeitsaufgabe nicht geändert wird. Das übergeordnete Element definiert das aktuelle Feld.

<WHENNOTCHANGED field="fieldReferenceName">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOTCHANGED>

Weitere Informationen finden Sie unter Zuweisen bedingter Werte und Regeln.

Untergeordnete Elemente von GLOBALLIST und LISTITEM

Sie geben die GLOBALLIST- und LISTITEM-Elemente als untergeordnete Elemente der ALLOWEDVALUES-, SUGGESTEDVALUES- und PROHIBITEDVALUES-Elemente an. Sie können diese Elemente verwenden, um eine Auflistung angezeigter Werte zu erstellen. Benutzer können Werte in einer Auswahlliste oder einem Dropdownmenü auswählen. Weitere Informationen finden Sie unter Definieren von globalen Listen.

Element

Beschreibung

GLOBALIST

Definiert einen Satz von LISTITEM-Elementen, der für eine Teamprojektauflistung gespeichert wird und den alle Teamprojekte in einer Auflistung verwenden können.

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

globalListName: Eine Textzeichenfolge mit 1 bis 255 Zeichen.

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.

LISTITEM

Definiert einen gültigen Listenwert.

<LISTITEM value="listName" />

LISTITEM ist ein erforderliches untergeordnetes Element von GLOBALLIST und ein optionales untergeordnetes Element der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES.

Attribute der untergeordneten Elemente von FIELD

Mit den for- und not-Attributen können Sie für die meisten FIELD-Regeln festlegen, dass diese für bestimmte Benutzer oder Gruppen gelten bzw. nicht gelten sollen. Weitere Informationen finden Sie unter Anwendung einer Feldregel.

Attribut

Syntax

Beschreibung

expanditems

expanditems="true | false"

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 dieses Attributs ist true.

filteritems

filteritems="excludegroups"

Dies ist optional. Gibt an, dass nur Mitglieder von Gruppen in der Liste enthalten sind, und keine Gruppennamen. Der einzige erlaubte Wert für dieses Attribut ist excludegroups.

for

for="userGroupName"

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 Werte bestehen aus Zeichenfolgen mit einer Länge zwischen 1 und 255 Zeichen.

not

not="userGroupName"

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 Werte bestehen aus Zeichenfolgen mit einer Länge zwischen 1 und 255 Zeichen.

from

from="value | field | clock | currentuser"

Erforderlich. Gibt die Quelle des Werts an, aus der ein Wert kopiert bzw. ein Standardwert definiert wird. Folgende Werte sind gültig:

  • clock: Kopiert das aktuelle Datum und die aktuelle Uhrzeit aus der Systemuhr in DateTime-Felder. Keine weiteren Attribute werden benötigt. Für COPY- und DEFAULT-Regeln stammt dieser Wert aus der Uhrzeit des lokalen Computers. Für SERVERDEFAULT stammt der Wert aus der Serveruhr, wenn der Benutzer die Arbeitsaufgabe speichert.

  • currentuser: Kopiert den Namen des aktuell angemeldeten Benutzers. Verwendet den kurzen Benutzernamen des aktuellen Benutzers als Wert. Keine weiteren Attribute werden benötigt. Wird für Zeichenfolgenfelder verwendet.

  • field: Kopiert den Wert des angegebenen field-Attributs. Ein field="abc"-Attribut wird benötigt. Standardmäßig wird keine Aktion ausgeführt, wenn das angegebene "from"-Feld leer ist. Das field-Attribut wird nur für <COPY>- und <DEFAULT>-Regeln verwendet.

  • value: Kopiert den Wert des angegebenen value-Attributs. Verwendet den Wert einer angegebenen Zeichenfolgenkonstante. Ein value="abc"-Attribut wird benötigt. value wird nur für <COPY>- und <DEFAULT>-Regeln verwendet.

Wenn Sie "value" oder "field" angeben, müssen Sie auch das jeweilige "value"- bzw. "field"-Attribut angeben.

field

field="fieldReferenceName"

Dies ist optional. Gibt den Namen des Felds an, dessen Wert in das aktuelle Feld kopiert wird, wenn field für das from-Attribut angegeben ist.

pattern

pattern="patternValue"

Erforderlich. Erzwingt einen einfachen Musterabgleich für Zeichenfolgen. patternValue ist eine Zeichenfolge aus 1 bis 255 Zeichen. Diese Zeichenfolge darf keinen umgekehrten Schrägstrich (\) enthalten. Jedes Zeichen in der Zeichenfolge wird als Literal interpretiert, mit Ausnahme der folgenden sechs Metazeichen:

  • "A" oder "a" stellt ein einfaches alphabetisches Zeichen dar.

  • "N" oder "n" stellt ein einfaches numerisches Zeichen dar.

  • "X" oder "x" stellt ein einfaches alphanumerisches Zeichen dar.

Musterwert: ^[^\\]*$

pattern="xxxxx.nn.nn" sucht z. B. nach fünf beliebigen alphanumerischen Zeichen, dann ein Punkt, dann zwei numerische Zeichen, dann ein Punkt, und zwei weitere numerische Zeichen.

value

value="valueToCopy"

Dies ist optional. Gibt den Wert an, der in das aktuelle Feld kopiert wird, wenn value für das from-Attribut angegeben ist.

Siehe auch

Konzepte

Definieren und Anpassen von Arbeitsaufgabenfeldern

Ändern des Workflows für einen Arbeitsaufgabentyp