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.
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.
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.
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.
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.
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.
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.
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.
Weitere Informationen finden Sie unter Definieren des Hilfetexts für ein Arbeitsaufgabenfeld. |
MATCH |
Definiert ein Muster, dem die Werte von Zeichenfolgenfeldern entsprechen müssen.
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.
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.
Weitere Informationen finden Sie unter Definieren von Auswahllisten. |
READONLY |
Gibt an, dass Sie den Wert nicht ändern können, dem das Feld zugewiesen wird.
Hinweis
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.
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.
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.
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.
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.
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.
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.
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.
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 |
|
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 |
|
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:
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:
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