WHEN-Element (Definitionsschema Arbeitsaufgabentyp)
Aktualisiert: November 2007
Legt eine Bedingung fest, anhand derer eine oder mehrere Regeln auf das aktuelle Feld angewendet werden. Die Regeln gelten für das aktuelle Feld, wenn ein anderes Feld einen bestimmten Wert enthält. Das übergeordnete Element definiert das aktuelle Feld.
<xs:element name="WHEN" type="FieldValueCondition"/>
Attribute und Elemente
In den folgenden Abschnitten werden die Attribute und die untergeordneten Elemente beschrieben, die das WHEN-Element definieren. Außerdem werden die übergeordneten Elemente beschrieben, die definieren, wie das WHEN-Element angewendet wird. Sie müssen mindestens ein untergeordnetes Element definieren.
Attribute
Attribut |
Beschreibung |
|---|---|
field |
Erforderliches Attribut Identifiziert ein Feld, das über einen angegebenen Wert verfügen muss, damit die Regeln in diesem Element auf das aktuelle Feld angewendet werden. Dieses Attribut wird über den Feldverweisnamen angegeben. Weitere Informationen über Verweisnamen finden Sie unter FIELD-Element (WORKITEMTYPE-Element). |
value |
Erforderliches Attribut Gibt einen Wert an, den das vom field-Element identifizierte Feld aufweisen muss, damit die Regeln in diesem Element auf das aktuelle Feld angewendet werden. |
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
Optionales Element Gibt an, dass das aktuelle Feld (mit dem WHEN-Element) über einen Wert verfügen muss, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. |
|
Optionales Element Gibt an, dass das aktuelle Feld schreibgeschützt ist, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. |
|
Optionales Element Gibt an, dass das aktuelle Feld keinen Wert aufweisen darf, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. |
|
Optionales Element Gibt an, dass das aktuelle Feld fixiert ist, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. Ein fixiertes Feld kann nach der Übernahme von Änderungen nicht in einen beliebigen, nicht leeren Wert geändert werden. Sie können das Feld jedoch manuell löschen, die Arbeitsaufgabe speichern und anschließend einen anderen Wert angeben. |
|
CANNOTLOSEVALUE-Element (Definitionsschema Arbeitsaufgabentyp) |
Optionales Element Gibt an, dass das aktuelle Feld nach der Zuweisung eines Werts nicht gelöscht und sein Inhalt nicht entfernt werden kann, wenn der Wert des mit dem field-Attribut identifizierten Felds nicht geändert wurde. |
Optionales Element Gibt an, dass der Wert des aktuellen Felds nicht mit dem Wert eines dritten Felds übereinstimmen darf, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. Das dritte Feld wird im NOTSAMEAS-Element angegeben. |
|
Optionales Element Gibt an, dass die Liste der zulässigen Werte nur aus gültigen Benutzern des Systems bestehen darf, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. |
|
ALLOWEXISTINGVALUE-Element (Definitionsschema Arbeitsaufgabentyp) |
Optionales Element Gibt an, dass der bereits vorhandene Wert des aktuellen Felds zulässig ist, auch wenn er gegen andere Regeln verstößt, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. Wenn der Wert des aktuellen Felds geändert wird, wird dieses Element nicht angewendet. |
Optionales Element Gibt an, dass der Wert des aktuellen Felds dem angegebenen Muster entsprechen muss, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. |
|
ALLOWEDVALUES-Element (Definitionsschema Arbeitsaufgabentyp) |
Optionales Element Gibt an, dass das aktuelle Feld einen Wert der angegebenen Liste mit Werten enthalten muss, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. Zulässige Werte sind Werte, die in einer Feldliste auf Arbeitsaufgabenformularen und im Abfrage-Generator zur Auswahl stehen. Sie müssen einen dieser Werte auswählen. |
SUGGESTEDVALUES-Element (Definitionsschema Arbeitsaufgabentyp) |
Optionales Element Gibt an, dass die angegebene Liste für das aktuelle Feld vorgeschlagene Werte enthält, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. Vorgeschlagene Werte sind Werte, die in einer Feldliste auf Arbeitsaufgabenformularen und im Abfrage-Generator verfügbar sind. Neben den Werten in der Liste können Sie weitere Werte eingeben. |
PROHIBITEDVALUES -Element (Definitionsschema Arbeitsaufgabentyp) |
Optionales Element Gibt an, dass das aktuelle Feld in der Liste keine Werte enthalten darf, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. |
Optionales Element Gibt an, dass dieses Element den Standardwert für das aktuelle Feld angibt, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. |
|
Optionales Element Gibt an, dass der Wert aus einem dritten Feld automatisch in das aktuelle Feld kopiert wird, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. Das dritte Feld wird im COPY-Element angegeben. |
|
SERVERDEFAULT-Element (Definitionsschema Arbeitsaufgabentyp) |
Optionales Element Gibt an, dass das aktuelle Feld den Wert der angegebenen Serverkomponente verwendet, wenn das über das field-Attribut identifizierte Feld den angegebenen Wert enthält. Die Serverkomponenten sind clock (Uhrzeit, zu der eine Arbeitsaufgabe aktualisiert wird) und currentuser (Benutzer, der die Arbeitsaufgabe aktualisiert hat). |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
Erforderliches Element. Verweist auf eine Felddefinition für eine Arbeitsaufgabe und die Regeln und Bedingungen, die für das Feld gelten. Der Verweis basiert auf dem Element STATE, TRANSITION, DEFAULTREASON oder REASON, dem dessen übergeordnetes FIELDS-Element untergeordnet ist. |
|
Erforderliches Element. Definiert ein Arbeitsaufgabenfeld und gibt die dafür geltenden Regeln und Bedingungen an. |
Hinweise
WHEN ist ein optionales untergeordnetes Element von FIELD (Definitionsschema Arbeitsaufgabentyp) und FIELD (WORKITEMTYPE-Element).
Beispiel
<WHEN field="field reference name" value="value">
<REQUIRED>…</REQUIRED>
<READONLY>…</READONLY>
<EMPTY>…</EMPTY>
<FROZEN>…</FROZEN>
<CANNOTLOSEVALUE>…</CANNOTLOSEVALUE>
<NOTSAMEAS>…</NOTSAMEAS>
<VALIDUSER>…</VALIDUSER>
<ALLOWEXISTINGVALUE>…<ALLOWEXISTINGVALUE>
<MATCH>…</MATCH>
<ALLOWEDVALUES>…</ALLOWEDVALUES>
<SUGGESTEDVALUES>…</SUGGESTEDVALUES>
<PROHIBITEDVALUES>…</PROHIBITEDVALUES>
<DEFAULT>…</DEFAULT>
<COPY>…</COPY>
<SERVERDEFAULT>…</SERVERDEFAULT>
</WHEN>
Elementinformationen
Namespace |
https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef |
Schemaname |
Definition des Arbeitsaufgabentyps |
Validierungsdatei |
WorkItemTypeDefinition.xsd |
Elementtyp |
FieldValueCondition (komplexer Typ) (Definitionsschema Arbeitsaufgabentyp) |
Kann leer sein |
Nein |