Verfügbare Feldregeln

Aktualisiert: November 2007

Durch Feldregeln werden das Verhalten und die Einschränkungen in Feldern definiert. Feldregeln sind zusätzliche Elemente, die innerhalb von <FIELD></FIELD>-Blöcken aufgelistet sind. Wenn ein Feld erforderlich ist, könnte die XML zur Definition des Felds beispielsweise wie folgt aussehen:

<FIELD refname="System.Priority" name="Priority" type="String">
<HELPTTEXT>Enter the business priority of the bug</HELPTEXT>
<REQUIRED />
</FIELD>

Verfügbare Feldregeln

Sie können die folgenden Feldregeln verwenden, um das Verhalten eines Felds zu ändern:

<REQUIRED />

Dieses Feld darf nicht leer sein. Sie können beliebige Feldtypen als erforderlich kennzeichnen. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter REQUIRED-Element (Definitionsschema Arbeitsaufgabentyp).

<READONLY />

Das Feld darf nicht geändert werden. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter READONLY-Element (Definitionsschema Arbeitsaufgabentyp).

<EMPTY />

Der Feldwert wird beim Commit gelöscht, und der Benutzer kann keinen Wert eingeben. Diese Regel wird hauptsächlich während des Zustandsübergangs verwendet, um die Werte von Feldern zu löschen, die auf den nach dem Übergang erreichten Zustand angewendet werden. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter EMPTY-Element (Definitionsschema Arbeitsaufgabentyp).

<FROZEN/>

Sobald ein Feld nach einem Commit über einen Wert verfügt, kann der Wert nicht mehr geändert werden. Das Feld kann jedoch mithilfe einer <EMPTY/>-Einschränkung gelöscht werden. Der Benutzer kann das Feld manuell löschen, die Arbeitsaufgabe speichern und anschließend beim erneuten Laden einen anderen Wert angeben. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter RROZEN-Element (Definitionsschema Arbeitsaufgabentyp).

<CANNOTLOSEVALUE/>

Wenn einem Feld ein Wert zugewiesen wurde, kann es weder gelöscht noch sein Inhalt entfernt werden. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter CANNOTLOSEVALUE-Element (Definitionsschema Arbeitsaufgabentyp).

<NOTSAMEAS field="MyCorp.Reviewer" />

Der Feldwert darf nicht mit dem Wert in einem anderen Feld identisch sein, in diesem Fall dem Feld "MyCorp.Reviewer". Der Feldwert muss einem gültigen Feldverweisnamen entsprechen. Weitere Informationen finden Sie unter Feldverweisnamen.

Beispiele für die Verwendung der NOTSAMEAS-Feldregel:

• Zwei Felder können nicht zum selben Zeitpunkt leer sein.

• Der Feldwert "code reviewer" darf dem Feldwert "assigned to" nicht genau entsprechen.

Verwenden Sie diese Regel für Felder desselben Typs. Sie kann nicht für PlainText- oder HTML-Felder verwendet werden. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter NOTSAMEAS-Element (Definitionsschema Arbeitsaufgabentyp).

<VALIDUSER group="group" />

Der Feldwert muss einen gültigen Benutzer enthalten, der Mitglied der Gruppe Gültige Team Foundation-Benutzer ist.

Diese Regel unterstützt das optionale Gruppenattribut, durch das angegeben wird, dass der Benutzer ein direktes oder indirektes Mitglied der angegebenen Gruppe sein muss. Standardmäßig aktiviert die Regel alle Benutzer, die Mitglieder der Gruppe Gültige Team Foundation-Benutzer sind. Weitere Informationen finden Sie unter Verwenden von Token zum Verweisen auf Benutzer und Gruppen. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter VALIDUSER-Element (Definitionsschema Arbeitsaufgabentyp).

Hinweis:
Wenn die <REQUIRED/>-Regel nicht angegeben ist, kann das Feld leer bleiben. Wird für Felder mit dem Typ String verwendet.

Hinweis:
Arbeitsaufgabenfelder unterscheiden nicht zwischen Benutzeridentitäten in unterschiedlichen Domänen. "Example1\jaepak" und "Example2\jaepak" werden folglich als derselbe Benutzer behandelt, wenn sie in ein Feld eingegeben werden, das die <VALIDUSER />-Regel verwendet. Ansonsten werden Benutzeridentitäten auf dem Team Foundation Server jedoch nach Domäne unterschieden.

<ALLOWEXISTINGVALUE/>

Ermöglicht das Beibehalten eines Feldwerts, auch wenn dieser Wert nicht mehr aktiviert ist. Das alternative und Standardverhalten besteht darin, den Benutzer bei der Bearbeitung dazu zu veranlassen, die zuletzt für dieses Feld aktualisierten Werte zu verwenden. Durch dieses Element werden nur die Elemente im selben Block geändert. Dieses Element akzeptiert kein for-Attribut und kein not-Attribut. Weitere Informationen finden Sie unter ALLOWEXISTINGVALUE-Element (Definitionsschema Arbeitsaufgabentyp).

<ALLOWEDVALUES/>

Eine Aufzählungsliste mit Werten, die dem Benutzer als Liste dargestellt wird. Benutzer müssen einen der Werte in dieser Liste auswählen. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter ALLOWEDVALUES-Element (Definitionsschema Arbeitsaufgabentyp).

<SUGGESTEDVALUES/>

Eine Aufzählungsliste mit Werten, die dem Benutzer als Liste dargestellt wird. Benutzer können beliebige Werte auswählen. Benutzer können auch ihren eigenen Wert eingeben, der keinem der Vorschläge entspricht. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter SUGGESTEDVALUES-Element (Definitionsschema Arbeitsaufgabentyp).

<PROHIBITEDVALUES/>

Benutzer können eine Arbeitsaufgabe nicht speichern, wenn das Feld unzulässige Werte enthält. Unzulässige Werte sind normalerweise Werte, die früher zulässig waren, mittlerweile aber nicht mehr gültig sind. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter PROHIBITEDVALUES -Element (Definitionsschema Arbeitsaufgabentyp).

<DEFAULT>

Wenn ein Benutzer eine Arbeitsaufgabe neu erstellt oder bearbeitet, wird ein leeres Feld von dem <DEFAULT>-Element mit einem Wert gefüllt. Wenn ein Feld bereits über einen Wert verfügt, wird die Standardregel ignoriert. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter DEFAULT-Element (Definitionsschema Arbeitsaufgabentyp).

Hinweis:
Diese Elementregel ist beim Ändern einer Arbeitsaufgabe nicht deterministisch, wenn ein aktueller oder vorheriger Wert aus einem anderen Feld ausgelesen wird.

<COPY>

Wenn ein Benutzer eine Arbeitsaufgabe neu erstellt oder bearbeitet, wird das Feld durch das <COPY>-Element mit einem Wert gefüllt, unabhängig davon, ob bereits ein Feldwert vorhanden ist. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter COPY-Element (Definitionsschema Arbeitsaufgabentyp).

Hinweis:
Diese Elementregel ist beim Ändern einer Arbeitsaufgabe nicht deterministisch, wenn ein aktueller oder vorheriger Wert aus einem anderen Feld ausgelesen wird.

<SERVERDEFAULT>

Im Unterschied zu <DEFAULT> und <COPY>, die zu Beginn der Bearbeitung Werte einfügen, fügt die <SERVERDEFAULT>-Regel einen Wert ein, wenn die Arbeitsaufgabe durch ein Commit in die Datenbank übertragen wird. Dies geschieht während des Speicherns, und der Wert kann vom Benutzer nicht überschrieben werden. Diese Felder werden im Formular schreibgeschützt angezeigt. Diese Regel wird für Felder wie "Zuletzt geändert von" und "Zuletzt geändert am" verwendet, um sichere Überwachungspfade zu unterstützen. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter SERVERDEFAULT-Element (Definitionsschema Arbeitsaufgabentyp).

<MATCH pattern="<pattern>"/>

Setzt den grundlegenden Mustervergleich nur für Zeichenfolgen durch. <pattern> sollte durch das Muster für den Vergleich ersetzt werden. Gültige Werte sind "A", "N" und "X". Alle übrigen Werte werden als Literale übernommen. "A" steht für ein alphabetisches Zeichen. "N" steht für ein numerisches Zeichen. "X" steht für ein alphanumerisches Zeichen. Dieses Muster wird nur für Felder mit dem Typ String unterstützt. Dieses Element kann for-Attribute und not-Attribute enthalten. Weitere Informationen finden Sie unter MATCH-Element (Definitionsschema Arbeitsaufgabentyp).

Beispiele für Mustervergleiche

In den folgenden Beispielen werden erfolgreiche und fehlgeschlagene Mustervergleiche für verschiedene Felder veranschaulicht:

Versionsnummer

Muster: ANN.NN.NN

Überprüfung erfolgreich	R01.03.04 oder V05.08.99
Überprüfung nicht erfolgreich	1.3.4 oder V5.8.99 oder v1.3

Ein flexibler Bezeichner

Muster: XXX-XXX

Überprüfung erfolgreich	001-abc oder a00-b02
Überprüfung nicht erfolgreich	1-abc oder 001.abc

Priorität

Muster: PN

Überprüfung erfolgreich	P1 oder P5 oder P9
Überprüfung nicht erfolgreich	1 oder P10

Bei der Übereinstimmung von Tags kommt es nicht auf Groß-/Kleinschreibung an, sowohl mit P1 als auch mit p1 wird eine Übereinstimmung für "PN" erzielt.

Hinweis:
Sie können mehrere <MATCH>-Elemente angeben. Wenn der Mustervergleich für mindestens ein Element erfolgreich ist, verfügt das Feld über einen gültigen Wert.

Siehe auch

Weitere Ressourcen

Definieren von Feldlisten