FIELD-Element (WORKITEMTYPE-Element)

Aktualisiert: November 2007

Definiert ein Arbeitsaufgabenfeld und gibt die dafür geltenden Regeln und Bedingungen an.

Schemahierarchie

WITD-Element (Definitionsschema Arbeitsaufgabentyp)

    WORKITEMTYPE-Element (Definitionsschema Arbeitsaufgabentyp)

        FIELDS-Element (WORKITEMTYPE-Element)

            FIELD-Element (WORKITEMTYPE-Element)

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut

Beschreibung

name

Erforderliches FieldDefinition-Attribut

Der Anzeigename des Felds, in dem die Regeln und die Bedingung angewendet werden. Weitere Informationen finden Sie unter Feldnamen.

refname

Erforderliches FieldDefinition-Attribut

Der Verweisname des Felds, in dem die Regeln und Bedingungen angewendet werden. Der Verweisname muss mit dem im FIELD-Element der Felddefinition definierten Verweisnamen übereinstimmen. Weitere Informationen finden Sie unter Feldverweisnamen.

type

Erforderliches FieldDefinition-Attribut

Der für das Feld akzeptierte Werttyp. Weitere Informationen finden Sie unter Feldtypen.

reportable

Optionales FieldDefinition-Attribut.

Die Felddaten werden in das Data Warehouse exportiert und können in Berichte eingebunden werden. Weitere Informationen finden Sie unter Verwenden von Feldern für die Berichterstellung.

formula

Optionales FieldDefinition-Attribut.

Der Aggregationstyp für den reportable-Typ measure. Derzeit wird nur sum als Aggregationstyp für measure unterstützt. Weitere Informationen finden Sie unter witfields.

Untergeordnete Elemente

Element

Beschreibung

HELPTEXT-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert den in der QuickInfo des Felds angezeigten Text.

REQUIRED-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert das Feld als erforderlich.

READONLY-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert das Feld als schreibgeschützt.

EMPTY-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert das Feld als leer.

RROZEN-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert das Feld als fixiert. 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

Definiert, dass das Feld immer einen Wert ungleich NULL enthalten muss. Das heißt, nachdem dem aktuellen Feld ein Wert zugewiesen wurde, kann es weder gelöscht noch sein Inhalt entfernt werden.

NOTSAMEAS-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Gibt ein anderes Feld an, dessen Wert nicht dem Wert des aktuellen Felds entsprechen darf.

VALIDUSER-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Legt fest, dass die Liste zulässiger Werte nur gültige Systembenutzer enthalten darf.

ALLOWEXISTINGVALUE-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert, dass das Feld bereits vorhandene Werte beibehalten kann. Das heißt, dass bereits vorhandene Feldwerte zulässig sind, selbst wenn sie ungültig sind. Alle neuen Feldwerte müssen gültig sein.

MATCH-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert ein Muster für das Feld, mit dem der Feldwert übereinstimmen muss.

ALLOWEDVALUES-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert eine Liste zulässiger Werte für das Feld. 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

Definiert eine Liste mit Wertvorschlägen für das Feld. 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

Definiert eine Liste unzulässiger Werte für das Feld.

DEFAULT-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Definiert einen Standardwert für das Feld.

COPY-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Gibt ein anderes Feld mit einem Wert an, der in das aktuelle Feld kopiert werden soll.

SERVERDEFAULT-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Gibt eine Serverkomponente an, die den Feldwert bereitstellt.

WHEN-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Legt mindestens eine Regel fest, die auf das aktuelle Feld angewendet wird, wenn ein anderes Feld einen bestimmten Wert enthält.

WHENNOT-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Wendet mindestens eine Regel auf das aktuelle Feld an, wenn ein anderes Feld nicht einen bestimmten Wert enthält.

WHENCHANGED-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Wendet mindestens eine Regel auf das aktuelle Feld an, wenn der Wert eines bestimmten Felds geändert wird.

WHENNOTCHANGED-Element (Definitionsschema Arbeitsaufgabentyp)

Optionales Element

Wendet mindestens eine Regel auf das aktuelle Feld an, wenn der Wert eines bestimmten Felds nicht geändert wird.

Übergeordnete Elemente

Element

Beschreibung

FIELDS-Element (WORKITEMTYPE-Element)

Erforderliches Element

Enthält die Felddefinitionen für den Arbeitsaufgabentyp.

Hinweise

FIELD ist ein erforderliches untergeordnetes Element von FIELDS.

minOccurs="1"

maxOccurs="unbounded"

Beispiel

<FIELD name="field display name" refname="field reference name" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath" reportable="Dimension | Detail | Measure" formula="sum">
    <HELPTEXT>…</HELPTEXT>
    <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>…</WHEN>
    <WHENNOT>…</WHENNOT>
    <WHENCHANGED>…</WHENCHANGED>
    <WHENNOTCHANGED>…</WHENNOTCHANGED>
</FIELD>

Elementinformationen

Namespace

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

Schemaname

Definition des Arbeitsaufgabentyps

Validierungsdatei

WorkItemTypeDefinition.xsd

Elementtyp

FieldDefinition (Komplexer Typ) (WORKITEMTYPE-Element)

Kann leer sein

Ja

Siehe auch

Referenz

HELPTEXT-Element (Definitionsschema Arbeitsaufgabentyp)

Weitere Ressourcen

Definitionsschema "Arbeitsaufgabentyp"

Definieren von Arbeitsaufgaben-Typfeldern