Definieren eines Standardwerts oder Kopieren eines Werts in ein Feld

Artikel
11/18/2015

Sie können einen Standardwert für ein Feld angeben oder den Wert aus einem anderen Feld bzw. den systemdefinierten Wert kopieren. Standardwerte für Felder sind Regeln, die steuern, wie Feldwerte automatisch zugewiesen werden. Sie können mithilfe eines der folgenden Elemente einen Standardwert für ein Feld zuweisen: COPY, DEFAULT und SERVERDEFAULT. Diese Elemente können als untergeordnete Elemente des FIELD (Definition)-Elements oder des FIELD (Workflow)-Elements angegeben werden.

Fügen Sie diese Elemente der Definition für einen Arbeitsaufgabentyp hinzu. Weitere Informationen finden Sie unter Anpassen oder Hinzufügen eines benutzerdefinierten Arbeitsaufgabentyps (WIT).

Das COPY-Element und das DEFAULT-Elemente füllen zu Beginn der Bearbeitung Werte aus, durch dieSERVERDEFAULT-Regel wird jedoch ein Wert eingetragen, wenn für die Arbeitsaufgabe ein Commit in der Datenbank ausgeführt wird. Diese Aktion tritt auf, wenn ein Benutzer Änderungen an einer Arbeitsaufgabe vornimmt und der Benutzer den Wert nicht überschreiben kann. Suchfelder sind im Arbeitsaufgabenformular normalerweise schreibgeschützt. Die SERVERDEFAULT-Regel wird für Felder wie "Zuletzt geändert von" und "Zuletzt geändert am" verwendet, um sichere Überwachungspfade zu unterstützen.

Syntax

Sie können das COPY-, DEFAULT- und SERVERDEFAULT-Element verwenden, um einen Wert von einem Feld in ein anderes Feld zu kopieren, um einen Serverwert in ein Feld zu kopieren oder einen Standardwert anzugeben, der für ein Feld definiert werden soll.

Hinweis

Wenn die Arbeitsaufgabe geändert wird, wählt das COPY- oder das DEFAULT-Element entweder den aktuellen oder den vorherigen Wert aus dem Quellfeld aus.

Sie können einen Wert angeben, der aus einem anderen Feld kopiert werden soll, den Wert der Uhr oder den Namen des aktuellen Benutzers. Wenn Sie value oder field für das from-Attribut angeben, müssen Sie das value- oder das field-Attribut angeben. Wenn ein Benutzer eine Arbeitsaufgabe ändert oder erstellt, trägt die COPY-Regel unabhängig von Werten, die bereits in dem Feld vorhanden sind, einen Feldwert ein.
```
<COPY for="userGroupName" not="userGroupName"  from="value | field | clock | currentuser" value="valueToCopy" field="fieldReferenceName/>
```
Mithilfe der DEFAULT-Regel können Sie einen Standardwert für ein Feld angeben. Wenn ein Benutzer eine Arbeitsaufgabe erstellt oder bearbeitet, trägt die DEFAULT-Regel einen Wert ein, wenn das Feld leer ist. Sie können einen Wert angeben, der aus einem anderen Feld kopiert wird, den Datums-/Zeitstempel, den die Serveruhr aufzeichnet, oder den Namen des aktuellen Benutzers. Wenn das Feld bereits einen Wert hat, wird diese Regel ignoriert.
```
<DEFAULT for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="defaultValue" field="fieldReferenceName" />
```
Sie können einen Wert angeben, der vom Server in ein Feld kopiert werden soll, wenn die Arbeitsaufgabe gespeichert wird. Wenn ein Benutzer den Status einer Arbeitsaufgabe ändert, gibt die SERVERDEFAULT-Regel einen Wert an, der von einem Wert, der von einer Serverkomponenten abgeleitet ist, in das aktuelle Feld kopiert werden soll. Das DEFAULT- und das COPY-Element trägt Werte ein, wenn ein Benutzer eine Arbeitsaufgabe öffnet, um diese zu ändern; die SERVERDEFAULT-Regel trägt jedoch einen Wert ein, wenn für die Arbeitsaufgabe ein Commit in der Datenbank ausgeführt wird. Diese Aktion tritt auf, wenn der Benutzer die Arbeitsaufgabe speichert. Der Benutzer kann den Wert nicht überschreiben. Diese Felder sind im Formular normalerweise schreibgeschützt. Die SERVERDEFAULT-Regel wird für Felder wie "Zuletzt geändert von" und "Zuletzt geändert am" verwendet, um sichere Überwachungspfade zu unterstützen.
```
<SERVERDEFAULT for="userGroupName" not="userGroupName" from="clock | currentuser" />
```

Durch jedes dieser Regelelemente wird ein from="fromType"-Attribut angegeben, das die Quelle des Werts identifiziert. Je nach dem Wert von fromType sind möglicherweise zusätzliche Attribute erforderlich. In der folgenden Tabelle sind alle Attribute beschrieben, auf die das COPY, DEFAULT- und das SERVERDEFAULT-Regelelement verweisen.

Attribut	Beschreibung
for	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 Namen bestehen aus einer Textzeichenfolge mit bis zu 255 Zeichen. Musterwert: ^[^\\]+\\[^\\]+$ Musterwertbeispiel: Domäne\Benutzer-ID
not	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 Namen bestehen aus einer Textzeichenfolge mit bis zu 255 Zeichen. Musterwert: ^[^\\]+\\[^\\]+$ Musterwertbeispiel: Domäne\Benutzer-ID
from	Erforderlich. Gibt an, ob der Standardwert aus dem value-Attribut, dem field-Attribut, der Systemuhr oder von dem aktuellen Benutzer kopiert werden soll. Wenn Sie value oder field für das from-Attribut angeben, müssen Sie das value- bzw. das field-Attribut angeben. Sie können folgende Werte angeben: clock: Kopiert die Uhrzeit aus der Systemuhr. Verwendet das aktuelle Datum und die aktuelle Uhrzeit als Wert. Keine weiteren Attribute werden benötigt. Für die COPY- und die DEFAULT-Regel wird der Wert aus der lokalen Computeruhr übernommen. Für die SERVERDEFAULT-Regel wird der Wert aus der Serveruhr zur Commit-Zeit übernommen. Nur für DateTime-Felder gültig. currentuser: Kopiert den Namen des angemeldeten Benutzers. Verwendet den kurzen Benutzernamen des aktuellen Benutzers als Wert. Keine weiteren Attribute werden benötigt. Nur für Zeichenfolgenfelder gültig. field: Kopiert den Wert, der für das angegebene field-Attribut definiert wurde. 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.
value	Dies ist optional. Gibt den Wert an, der in das aktuelle Feld kopiert wird, wenn value für das from-Attribut angegeben ist. Gültige Werte bestehen aus Zeichenfolgen mit einer Länge zwischen 1 und 255 Zeichen. Der zu kopierende Wert darf nicht leer sein.
field	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. Sie müssen dieses Attribut definieren, wenn für das from-Attribut "Feld" als Wert angegeben ist. Der Verweisname des zu kopierenden Felds. Der Verweisname muss mit dem Verweisnamen übereinstimmen, der im FIELD (Definition)-Element definiert wurde. Weitere Informationen finden Sie unter FIELD (Definition)-Elementverweis. Musterwert: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Musterwertbeispiel: Company.Division.IssueType

Zurück nach oben