Specify work item form controls

Artikel
11/18/2015

Dieses Thema enthält eine Kurzübersicht über das Element Control sowie dessen untergeordnete Elemente und Attribute. Für jedes Feld oder jedes Formularsteuerelement, das Sie in einem Arbeitsaufgabenformular anzeigen möchten, wird ein Control-Element hinzugefügt.

Ein Arbeitsaufgabenformular kann angepasst werden, um Informationen anzuzeigen, die das Team bei der richtigen Verwendung des Formulars unterstützen. Sie können Arbeitsaufgabenfelder und -steuerelemente hinzufügen, die das Eingeben und Anzeigen der Daten ermöglichen, die nachverfolgt werden sollen.

Mit dem Control-Element werden neun Werte für das Type-Attribut bereitgestellt, mit dem Sie Felder hinzufügen, oder Nur-Text oder Linktext bzw. Felder anzeigen können. Zudem können Sie spezielle Steuerelemente zum Hinzufügen von Links und Anlagen und zum Anzeigen von webbasiertem Inhalt definieren, oder ein eigenes Steuerelement erstellen, das Sie einem Arbeitsaufgabenformular hinzufügen.

Hinzufügen von Arbeitsaufgabenfeldern

Wenn Sie das Arbeitsaufgabenformular anpassen, fügen Sie in der Regel eine Teilmenge der für den Arbeitsaufgabentyp definierten Arbeitsaufgabenfelder ein, die auf dem Formular angezeigt werden sollen. Die Felddefinitionen steuern viele Aspekte davon, welche Daten angezeigt werden oder welche Daten in das Formular eingegeben werden können. Weitere Informationen finden Sie unter Definieren von Arbeitsaufgabenfeldern.

Jedes Arbeitsaufgabenfeld ist einem Datentyp zugeordnet. Sie können die Informationen der folgenden Tabelle verwenden, um zu bestimmen, welcher Feldtyp von welchem Type-Attribut des Control-Elements unterstützt wird. Mit dem Label-Attribut geben Sie den Text an, der neben dem Steuerelement angezeigt wird. Mit dem verknüpften LabelPosition-Attribut legen Sie fest, an welcher Position relativ zum Steuerelement die Bezeichnung angezeigt wird. Weitere Informationen finden Sie unter Control the display of work item fields.

Hinweis

Die Werte von Systemfeldern können nicht geändert werden. Sie werden automatisch aktualisiert.Beispielsweise werden die Felder "Erstellungsdatum" und "Erstellt von" definiert, wenn eine Arbeitsaufgabe zum ersten Mal gespeichert wird.Sie können diese Felder jedoch als Suchkriterien verwenden.Eine Beschreibung der einzelnen Systemfelder finden Sie unter Arbeitsaufgabenfeld-Verweis für Visual Studio ALM.

Feldtyp	Steuerelementtypattribut	Verwendung
DateTime	FieldControl DateTimeControl	Stellen Sie mit FieldControl ein Textfeld für die Eingabe oder Anzeige eines DateTime-Datentypfelds bereit. `<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" />` Stellen Sie mit DateTimeControl eine Kalenderauswahl zum Auswählen eines Datums für ein Feld bereit, wie in der folgenden Abbildung dargestellt. `<Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />`
Double	FieldControl	Verwenden Sie FieldControl, um ein Textfeld für die Eingabe oder Anzeige von Double-Feldern bereitzustellen. `<Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />`
History	WorkItemLogControl	Stellen Sie mit WorkItemLogControl ein Kontrollfeld für Verlaufsfelder zur Nachverfolgung von Diskussionsthemen und anderen Versionsinformationen bereit, wie in der folgenden Abbildung dargestellt. Dieses Steuerelement kann nur zur Unterstützung der Anzeige des Verlaufsfelds einer Arbeitsaufgabe, des Arbeitsaufgabenfelds "System.History", verwendet werden. Mithilfe dieses Steuerelements können Sie Details zu Verlaufsrevisionen einer Arbeitsaufgabe erweitern und reduzieren. Zudem können Sie einen Text, den Sie dem Verlaufsfeld hinzufügen, formatieren. `<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description and History" LabelPosition="Top" Dock="Fill" />`
HTML	HTMLControl	Stellen Sie mit HTMLControl ein Kontrollfeld für HTML-Felder bereit, um die RTF-Formatierung (Rich Text Format) zu erfassen, wie in der folgenden Abbildung dargestellt. `<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />`
Integer	FieldControl	Verwenden Sie FieldControl, um ein Kontrollfeld für ein Ganzzahlfeld bereitzustellen. `<Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />`
PlainText	FieldControl	Mit FieldControl können Sie ein Kontrollfeld für ein PlainText-Feld, z. B. ein Textfeld, bereitstellen, das Beschreibungen mit mehr als 255 Zeichen enthalten kann. `<Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />`
String	FieldControl	Verwenden Sie FieldControl, um ein Kontrollfeld für ein Zeichenfolgenfeld bereitzustellen. Zeichenfolgenfelder sind auf 255 Zeichen beschränkt. `<Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />`
TreePath	WorkItemClassificationControl	Verwenden Sie WorkItemClassificationControl, um ein Kontrollfeld für ein TreePath-Feld bereitzustellen. `<Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />`

Optionale Steuerelementfeldattribute für alle Steuerelementtypen

Die folgenden optionalen Attribute können nur für die aufgeführten Steuerelementtypen angegeben werden.

Attribut	Beschreibung
Field	Gibt das Steuerelement an, das dem Arbeitsaufgabenfeld zugeordnet ist.
Label	Gibt den sichtbaren Text auf dem Formular an, mit dem das Steuerelement identifiziert wird. Geben Sie eine Zeichenfolge mit höchstens 80 Zeichen an. Hinweis Sie können einen Link an die Bezeichnung eines Felds anfügen, das mit FieldControl zu dem Arbeitsaufgabenformular hinzugefügt wird.Dieses Steuerelement ist nützlich für das Bereitstellen eines Links, um auf Informationen über die Verwendung des Felds zuzugreifen.Weitere Informationen finden Sie unter Provide help text, hyperlinks, or web content on a work item form.
LabelPosition	Gibt die Position der Bezeichnung relativ zu den Steuerelementdaten an. Geben Sie eine Zeichenfolge mit einem der folgenden Werte an: Top, Bottom, Left und Right.
Dock	Gibt die Ausrichtung der Bezeichnung nach der angegebenen Seite des Containers an oder streckt das Feld, damit es den Container ausfüllt. Geben Sie eine Zeichenfolge mit einem der folgenden Werte an: Fill, Top, Bottom, Left und Right.
Padding	Gibt den Platz um den inneren Rahmen des Steuerelements in Pixeln an. Vier Werte werden bereitgestellt, die oben, unten, links und rechts entsprechen. Zum Beispiel: (2,0,2,0).
Margin	Gibt den Platz um den äußeren Rahmen des Steuerelements in Pixeln an. Vier Werte werden bereitgestellt, die oben, unten, links und rechts entsprechen. Zum Beispiel: (2,0,2,0).
ReadOnly	Gibt an, dass das Feld schreibgeschützt ist. Geben Sie True oder False an.
MinimumSize	Gibt die minimale Größe in Pixel an, die das Steuerelement im Formular einnehmen sollte. Zwei Werte werden angegeben, die der Breite und der Höhe entsprechen. Zum Beispiel: (100,100).
Name	Identifiziert ein Steuerelement auf eindeutige Weise. Das Name-Attribut ist erforderlich, wenn einem Arbeitsaufgabenfeld mehr als ein Steuerelement eines Formulars zugeordnet ist. Hinweis Verwenden Sie das Name-Attribut, um dasselbe Feld in mehreren Formularbereichen anzuzeigen.Geben Sie für beide Steuerelementeinträge einen eindeutigen Wert für das Name-Attribut an, damit das System jedes Steuerelement eindeutig identifiziert.Es ist nützlich, dasselbe Steuerelement basierend auf dem Kontext der Registerkarten an verschiedenen Positionen anzuzeigen.

Optionale Steuerelementfeldattribute für spezifische Steuerelementtypen

Die folgenden optionalen Attribute können nur für die aufgeführten Steuerelementtypen angegeben werden.

Attribut	Steuerelementtypen	Beschreibung
NumberFormat	FieldControl	Gibt die Zeichen an, die Sie im Feldsteuerelement eingeben können. Die folgenden Werte sind gültig: WholeNumbers, SignedWholeNumbers, DecimalNumbers und SignedDecimalNumbers.
MaxLength	FieldControl	Gibt die maximale Länge von Zeichen an, die Sie für ein Feldsteuerelement verwenden können.
Format	DateTimeControl	Gibt das Format für das Datums-/Uhrzeitfeld an, das einem Wert der DateTimePickerFormat-Enumeration entspricht. Folgende Werte sind gültig: Custom, Long, Short, Time.
CustomFormat	DateTimeControl	Gibt das benutzerdefinierte Format für das Datums-/Uhrzeitfeld an, das der für die DateTimePicker.CustomFormat-Eigenschaft definierten Syntax entspricht.

Hinzufügen von speziellen Steuerelementen

In der folgenden Tabelle werden die Control-Attribute des Type-Elements beschrieben, die das Verwalten von Dateianlagen, das Erstellen von Links, das Anzeigen von webbasiertem Inhalt und das Anzeigen weiterer Daten, die keinem Arbeitsaufgabenfeld zugeordnet sind, unterstützen.

Steuerelementtypattribut	Verwendung
AttachmentsControl	Verwenden Sie dieses Attribut, um Dateien an ein Arbeitsaufgabenformular anzufügen. Dieses Steuerelement ist normalerweise in einer eigenen Gruppe von Registerkarten enthalten, wie in der folgenden Abbildung gezeigt. Anlagen-Steuerelement Weitere Informationen finden Sie unter Hinzufügen des Anlagen-Steuerelements.
LabelControl	Verwenden Sie das Attribut, um Nur-Text oder Linktext anzuzeigen, der keinem Feld zugeordnet ist, wie in der folgenden Abbildung dargestellt. Verwenden Sie die untergeordneten Elemente und Containerelemente LabelText und Link, um Text, Link und Position eines Felds oder einer Bezeichnung anzugeben, dessen bzw. deren Text teilweise einem Link zugeordnet ist. Weitere Informationen finden Sie unter Provide help text, hyperlinks, or web content on a work item form, XML-Elementreferenz für LabelText und Text und XML-Elementreferenz für Link und Param.
LinksControl	Erstellen und verwalten Sie mit dem Attribut Links zwischen Arbeitsaufgaben. Dieses Steuerelement ist normalerweise in einer eigenen Gruppe von Registerkarten enthalten, wie in der folgenden Abbildung gezeigt. Verwenden Sie den Typ LinksControlOptions, um die Linkfilter und das Layout von Spaltenfeldern zu definieren, die verwendet werden, um die Liste der Links anzuzeigen. Weitere Informationen finden Sie unter Definieren von Linksteuerelementen zum Einschränken der Linkbeziehungen und LinksControlOptions-Elemente.
StoryboardsControl	Wird zum Öffnen von PowerPoint-Storyboarding aus einer Arbeitsaufgabe und über einen Link zu Storyboard-Dateien auf einer Netzwerkfreigabe verwendet. Dieses Steuerelement ist normalerweise in einer eigenen Gruppe von Registerkarten enthalten, wie in der folgenden Abbildung gezeigt. Sie können StoryboardsControl mit dem folgenden Codeausschnitt zum Abschnitt FORM hinzufügen: <Tab Label="Storyboards"> <Control Name="StoryboardsControl" Type="LinksControl"> <LinksControlOptions> <WorkItemLinkFilters FilterType="excludeAll" /> <ExternalLinkFilters FilterType="include"> <Filter LinkType="Storyboard" /> </ExternalLinkFilters> <LinkColumns> <LinkColumn RefName="System.Title" /> <LinkColumn LinkAttribute="System.Links.Comment" /> </LinkColumns> </LinksControlOptions> </Control> </Tab>
WebpageControl	Verwenden Sie das Attribut, um Webinhalt in einem Arbeitsaufgabenformular anzuzeigen. Dieses Steuerelement ist normalerweise in einer eigenen Registerkartengruppe enthalten. Mithilfe der untergeordneten Elemente WebpageControlOptions und Link geben Sie die Steuerelemente an, die erforderlich sind, um das Webseitenziel in das Arbeitsaufgabenformular zu laden. Weitere Informationen finden Sie unter Bearbeiten einer WIT-Definition zum Hinzufügen von Webinhalt zu einem Arbeitsaufgabenformular, XML-Elementreferenz für WebpageControlOptions und XML-Elementreferenz für Link und Param.

Hinzufügen von benutzerdefinierten Steuerelementen

Zusätzlich zu den integrierten Steuerelementen können Sie ein eigenes benutzerdefiniertes Steuerelement zu einem Arbeitsaufgabenformular hinzufügen.

Sie können z. B. ein benutzerdefiniertes Steuerelement hinzufügen, um eine Bildschirmabbildung von der Zwischenablage aufzuzeichnen. Sie können auch ein Steuerelement für die Aufzeichnung mehrerer Werte bereitstellen, indem ein Kontrollkästchen für die in einer Liste oder einem Menü aufgeführten Werte hinzugefügt wird.

Um ein benutzerdefiniertes Steuerelement zu implementieren, müssen Sie den Namen des Steuerelements für das Type-Attribut angeben.

Siehe auch

Aufgaben

Ändern des Formularlayouts von Arbeitsaufgaben

Bearbeiten einer WIT-Definition zum Hinzufügen von Webinhalt zu einem Arbeitsaufgabenformular

Referenz

Steuern des XML-Elementverweises

Share via