Freigeben über


XML-Elementreferenz für FIELD

Die im vorliegenden Thema enthaltenen Informationen können als Kurzübersicht für alle Elemente und Hauptattribute genutzt werden, die ein Datenfeld für einen Typ von Arbeitsaufgabe definieren.Sie geben diesen Elementen im FIELD (Definition)-Elementcontainer an.Sie fügen einem Arbeitsaufgabentyp ein Feld hinzu, indem Sie ein FIELD (Definition)-Element im FIELDS (Definition)-Element angeben.Sie können diese Elemente innerhalb der Definition eines Arbeitsaufgabentyps oder als Teil eines globalen Workflows angeben.Sie können die in diesem Thema beschriebenen untergeordneten Elemente erstellen, um das Verhalten eines Felds anzugeben und um Standardwerte oder eine Auswahlliste von Werten zu definieren.Sie können miteinander kombinierte Feldregelelemente verwenden.Der Geltungsbereich der meisten Regeln lässt sich so festlegen, dass sie auf einen oder mehrere Benutzer oder Gruppen angewendet oder bei bestimmten Benutzern oder Gruppen ignoriert werden.

Alle untergeordneten Elemente des FIELD-Elements sind optional.Neben dem HELPTEXT-Element können alle Elemente als untergeordnete Elemente der Elemente FIELD (Definition), FIELD (Workflow) und FIELD (globaler Workflow) angeben.Sie verwenden das FIELD (Definition)-Element, um ein Arbeitsaufgabenfeld zu definieren und die dafür geltenden Regeln und Bedingungen anzugeben.Sie geben Regeln für ein FIELD (Workflow)-Element an, um den Wert eines Felds zu definieren oder um Regeln auf ein Feld anzuwenden, wenn eine Arbeitsaufgabe vom einem Zustand in einen anderen übergeht.Sie können Feldregeln auf Grundlage des Elements STATE, TRANSITION, DEFAULTREASON oder REASON angeben, das seinem übergeordneten FIELDS-Element übergeordnet ist.Weitere Informationen finden Sie unter Arbeiten mit Arbeitsaufgabenfeldern und Entwerfen des Workflows.

In diesem Thema

  • Containerelement: FIELD (Definition)

  • Untergeordnete FIELD-Elemente

  • Untergeordnete Elemente: GLOBALLIST und LISTITEM

  • Von untergeordneten FIELD-Elementen angegebene Attribute

Containerelement: FIELD (Definition)

Verwenden Sie die folgende Syntax, um die Datenfelder eines Arbeitsaufgabentyps zu definieren.Dieses Beispiel veranschaulicht das Format des FIELD (Definition)-Elements sowie alle optionalen untergeordneten Elemente.Weitere Informationen finden Sie unter FIELD (Definition)-Element.

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

Untergeordnete FIELD-Elemente

In der folgenden Tabelle werden die untergeordneten Elemente beschrieben, die Sie angeben können, um Regeln zum Zuweisen von Feldwerten anzuwenden.Alle untergeordneten Elemente sind optional.Sie können den Geltungsbereich der meisten untergeordneten Elemente so festlegen, dass sie nur auf die Benutzer, die einer bestimmten Gruppe angehören, oder auf alle Benutzer, die nicht einer bestimmten Gruppe angehören, angewendet werden.

Element

Beschreibung und Syntax

ALLOWEDVALUES

Definiert eine Liste mit Werten, die die Benutzer in einer Feldliste in Arbeitsaufgabenformularen sowie im Abfrage-Editor angeben können.Die Benutzer müssen einen der Werte, die Sie aufführen, angeben.

<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 an, dass ein Feld selbst dann einen vorhandenen Wert beibehalten kann, wenn dieser in keiner Auswahlliste mehr enthalten ist.Alle neuen Feldwerte müssen in der Liste enthalten sein.

<ALLOWEXISTINGVALUE />

Weitere Informationen finden Sie unter Definieren von Auswahllisten.

CANNOTLOSEVALUE

Gibt an, dass die Benutzer nicht alle Werte aus einem Feld löschen können, nachdem ein Wert angegeben wurde.Nachdem ein Wert in das Feld eingetragen wurde, muss dieses Feld immer einen Wert ungleich NULL enthalten.

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

Weitere Informationen finden Sie unter Festlegen von Bedingungen für ein Arbeitsaufgabenfeld.

COPY

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

<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 für ein Feld an, das leer ist, wenn ein Benutzer eine Arbeitsaufgabe erstellt oder ändert.Wenn ein Feld bereits über einen Wert verfügt, 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 jeden beliebigen Wert aus dem Feld.Die EMPTY-Regel versieht ein Feld auch mit einem Schreibschutz, und sie sollten nicht in Verbindung mit der READONLY-Regel verwendet werden.

Der Feldwert wird gelöscht, wenn ein Benutzer die Arbeitsaufgabe speichert, und Sie können keinen Wert angeben.Diese Regel wird hauptsächlich während eines Zustandsübergangs verwendet, um die Werte von Feldern zu löschen, die auf den nach dem Übergang erreichten Zustand angewendet werden.

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

Weitere Informationen finden Sie unter Festlegen von Bedingungen für ein Arbeitsaufgabenfeld.

FROZEN

Gibt an, dass der Wert eines Felds 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 Festlegen von Bedingungen für ein Arbeitsaufgabenfeld.

HELPTEXT

Definiert den Text, der angezeigt wird, wenn ein Benutzer im Arbeitsaufgabenformular auf das Feld zeigt.

tooltipText: Eine Textzeichenfolge mit 1 bis 255 Zeichen.

<HELPTEXT>tooltipText </HELPTEXT>

Weitere Informationen finden Sie unter Definieren des Hilfetexts für ein Arbeitsaufgabenfeld.

MATCH

Definiert ein Muster, dem die Werte von Zeichenfolgenfeldern entsprechen müssen.

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

Weitere Informationen finden Sie unter Festlegen von Zeichenfolgenfeldern zur Übereinstimmung mit Mustern.

NOTSAMEAS

Gibt an, dass ein Feld nicht den gleichen Wert wie die zugewiesen wird, zu dem ein anderes festgelegtes Feld zugewiesen wird.Beim Wert des field-Attributs muss es sich um einen gültigen Feldverweisnamen handeln.

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

Weitere Informationen finden Sie unter Festlegen von Bedingungen für ein Arbeitsaufgabenfeld.

PROHIBITEDVALUES

Definiert eine Liste von Werten, die ein Feld nicht enthalten kann.Benutzer können eine Arbeitsaufgabe nicht speichern, wenn das 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

Gibt an, dass Sie den Wert nicht ändern können, dem das Feld zugewiesen wird.

<READONLY for="userGroupName" not="userGroupName" />
HinweisHinweis
Verwenden Sie dieses Element nicht in Verbindung mit dem EMPTY-Element, da die Verwendung des EMPTY-Elements ebenfalls dazu führt, dass das Feld schreibgeschützt wird.Wenn Sie diese Elemente kombinieren, sind die Ergebnisse inkonsistent.

Weitere Informationen finden Sie unter Festlegen von Bedingungen für ein Arbeitsaufgabenfeld.

REQUIRED

Gibt an, dass die Benutzer einen Wert für das Feld angeben müssen.Pflichtfelder dürfen nicht leer sein.Die Benutzer können eine Arbeitsaufgabe erst speichern, nachdem allen Pflichtfeldern Werte zugewiesen wurden.

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

Weitere Informationen finden Sie unter Festlegen von Bedingungen für ein Arbeitsaufgabenfeld.

SERVERDEFAULT

Kopiert einen angegebenen Serverwert in ein Feld, wenn ein Benutzer eine Arbeitsaufgabe speichert.Diese Felder werden im Formular in der Regel schreibgeschützt angezeigt.

<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 vorgeschlagenen Werten, die die Benutzer in einer Feldliste in Arbeitsaufgabenformularen sowie im Abfrage-Editor angeben können.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="Name" />
. . . 
   </GLOBALLIST>    
</SUGGESTEDVALUES>

Weitere Informationen finden Sie unter Definieren von Auswahllisten.

VALIDUSER

Schränkt Arbeitsaufgaben ein, sodass sie von den Benutzern, die zur von der von Ihnen angegebenen Gruppe gehören, nicht geändert werden können.Die Standardgruppe ist die Gruppe "Gültige Team Foundation-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.Weitere Informationen finden Sie unter Verwenden von Token zum Verweisen auf Benutzer und Gruppen.

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

Weitere Informationen finden Sie unter Verwalten der Berechtigungen zum Erstellen oder Ändern von Arbeitsaufgaben.

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

Legt mindestens eine Regel fest, die auf das aktuelle Feld angewendet wird, wenn ein anderes Feld einen bestimmten Wert nicht 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 mindestens eine Regel an, die auf das aktuelle Feld werden soll, wenn sich der Wert eines anderen Felds während der Revision einer Arbeitsaufgabe ändert.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 mindestens eine Regel an, die auf das aktuelle Feld werden soll, wenn sich der Wert eines anderen Felds während der Revision einer Arbeitsaufgabe nicht ändert.Mit dem übergeordneten Element wird das aktuelle Feld definiert.

<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: GLOBALLIST und LISTITEM

In der folgenden Tabelle werden die Elemente GLOBALLIST und LISTITEM beschrieben.Diese Elemente werden als untergeordnete Elemente der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES angegeben.Mithilfe dieser Elemente können Sie eine Liste von Werten aufführen, die als Auswahlliste oder Dropdownmenü angezeigt werden und vom Benutzer angegeben werden können.Weitere Informationen finden Sie unter Definieren von Benutzerlisten, Auswahllisten und globalen Listen.

Element

Syntax

Beschreibung

GLOBALIST

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

Dient zum Definieren eines Satzes von LISTITEM-Elementen, der für eine Teamprojektsammlung gespeichert wird und von allen in der Auflistung definierten Teamprojekten verwendet werden kann.

globalListName: Eine Textzeichenfolge mit bis zu 255 Zeichen.

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.

LISTITEM

<LISTITEM value="listName" />

Definiert einen gültigen Listenwert.

LISTITEM ist ein erforderliches untergeordnetes Element des GLOBALLIST-Elements sowie ein optionales untergeordnetes Element der Elemente ALLOWEDVALUES, SUGGESTEDVALUES und PROHIBITEDVALUES.

Zurück nach oben

Von untergeordneten FIELD-Elementen angegebene Attribute

Durch Angabe des Attributs for oder not lassen sich die meisten FIELD-Regeln so qualifizieren, dass sie für einen Satz von Gruppen oder Benutzern gelten bzw. nicht gelten.Weitere Informationen finden Sie unter Festlegen des Gültigkeitsbereichs einer Feldregel auf eine Gruppe.

Attribut

Syntax

Beschreibung

expanditems

expanditems = "true | false"

Dies ist optional.Gibt an, ob eine Gruppe, die das LISTITEM-Element identifiziert, erweitert werden soll, um untergeordnete Gruppen in die Liste aufzunehmen.Der Standardwert dieses Attributs ist true.

filteritems

filteritems" =excludegroups"

Dies ist optional.Legt fest, dass nur die Mitglieder der Gruppen in die Liste aufgenommen werden, nicht die Gruppennamen.Als Wert dieses Attributs ist nur excludegroups zulässig.

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 einer Textzeichenfolge mit 1 bis 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 einer Textzeichenfolge mit 1 bis 255 Zeichen.

from

from="value | field | clock | currentuser"

Erforderlich.Gibt die Quelle des Werts an, von der ein Wert kopiert oder ein Standardwert festgelegt werden soll.Folgende Werte sind gültig:

  • clock: Kopiert das aktuelle Datum und die Uhrzeit der Systemuhr in DateTime-Felder. Es sind keine zusätzlichen Attribute erforderlich.Bei COPY-Regeln und DEFAULT-Regeln entspricht dieser Wert der Uhrzeit des lokalen Computers.Bei SERVERDEFAULT-Regeln wird der Wert von der Serveruhr übernommen, wenn ein Benutzer die Arbeitsaufgabe speichert.

  • currentuser: Kopiert den Namen des Benutzers, der gerade angemeldet ist.Verwendet den kurzen Benutzernamen des aktuellen Benutzers als Wert.Es sind keine zusätzlichen Attribute erforderlich.Wird für Zeichenfolgenfelder verwendet.

  • field: Kopiert den Wert des field-Attributs, das Sie angeben.Erfordert ein field="abc"-Attribut.Wenn das angegebene "from"-Feld leer ist, wird standardmäßig keine Aktion ausgeführt.Das field-Attribut wird nur für <COPY>- und <DEFAULT>-Regeln verwendet.

  • value: Kopiert den Wert des value-Attributs, das Sie angeben.Verwenden Sie den Wert einer Zeichenfolgenkonstante, die Sie angeben.Erfordert ein value="abc"-Attribut.value wird nur für <COPY>- und <DEFAULT>-Regeln verwendet.

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

field

field="fieldReferenceName"

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

pattern

pattern= "patternValue"

Erforderlich.Setzt den grundlegenden Mustervergleich nur für Zeichenfolgen durch.patternValue ist eine Zeichenfolge, die zwischen 1 und 255 Zeichen besteht, liegt.Diese Zeichenfolge darf keinen umgekehrten Schrägstrich (\) enthalten.Jedes Zeichen in der Zeichenfolge wird als Literal interpretiert, es sei denn, es ist eines der folgenden sechs Metazeichen ist:

  • "A" oder "a" stellen einen Buchstaben dar.

  • "N" oder "n" stellen ein einzelnes numerisches Zeichen.

  • "X" oder "x" stellen ein einzelnes alphanumerisches Zeichen dar.

Musterwert: ^[^\\]*$

Beispielsweise entspricht pattern="xxxxx.nn.nn" alle fünf alphanumerischen Zeichen, auf einen Punkt, dann zwei Ziffern, dann ein Punkt, dann zwei weitere numerische Zeichen.

value

value="valueToCopy"

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

Zurück nach oben

Siehe auch

Konzepte

Definieren von Benutzerlisten, Auswahllisten und globalen Listen

Arbeiten mit Arbeitsaufgabenfeldern

Entwerfen des Workflows