Bereitstellen von Hilfetexten, Prozessleitfäden, Webinhalten und Links zu Webseiten auf einem Arbeitsaufgabenformular

Wenn Sie das Arbeitsaufgabenformular anpassen, möchten Sie möglicherweise Informationen oder Links zu Inhalten bereitstellen, die dem Team bei der Definition der Formularfelder helfen.Wenn Sie Informationen in das Formular einbetten oder diese leicht bereitstellen, können Teammitglieder besser in der Lage, nützliche Daten nachverfolgen.

Mithilfe der in diesem Thema beschriebenen Formularsteuerelemente können Sie QuickInfo-Text für einzelne Felder, eigenständigen Text oder Links zu Webseiten hinzufügen sowie HTML- oder Webinhalte in das Formular einbetten.

Sie ändern das Arbeitsaufgabenformular, indem Sie die Definition für den Arbeitsaufgabentyp ändern.Sie können das witadmin Befehlszeilentool verwenden, finden Anpassen und Verwalten von Arbeitsaufgabentypen [witadmin] oder den Prozess-Editor.

Der Prozess-Editor ist ein Powertool-Add-In für Visual Studio, das Sie herunterladen und installieren können.Eine Anwendung unter dem Menü Extras, Prozess-Editor stellt eine grafische Benutzeroberfläche zum Anpassen von Objekten bereit, die zur Nachverfolgung von Arbeitsaufgaben in Team Foundation Server verwendet werden.Sie können dieses Tool verwenden, um Arbeitsaufgabentypen importieren und exportieren und ihre Definitionen zu ändern.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Team Foundation Server-Toole.

Bereitstellen von Hilfetext oder QuickInfo-Text bereit

Sie können Hilfetext auf zwei verschiedene Methoden bereitstellen.Bei der ersten Methode fügen Sie das FIELD-Element dem HELPTEXT-Element als untergeordnetes Element im Abschnitt FIELDS der Typdefinition hinzu.Mithilfe von HELPTEXT erstellen Sie die QuickInfo für das Feld.Mit dieser Methode können Sie maximal 255 Zeichen eingeben.

<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>
</FIELD>

Bei der zweiten Methode geben Sie eigenständigen Text mithilfe der untergeordneten LabelText- und Text-Elemente an.Mit dieser Methode können Sie so viele Informationen angeben, wie Sie möchten. Der Text ist immer im Formular vorhanden.Es ist keine Benutzeraktion erforderlich.Außerdem können Sie mithilfe des Link-Elements einen optionalen Link zu weiteren Informationen hinzufügen, wie im folgenden Beispiel dargestellt.

<Control FieldName=" ACME.ACE.ImpactStatement" Type="HTMLControl" Label="Impact" LabelPosition="Left"> 
   <LabelText>
      <Text>Provide information about the impact to the ACE organization. Specifically address the following: customer segment, target strategic opportunity, resources required, and time dependencies. For more detailed information, see the Impact Statement specification at:
         <Link OpenInNewWindow="true" UrlRoot=http://ACE.ImpactStatement.aspx />
      </Text>
   </LabelText>
</Control>

Fügen Sie eigenständige Text- und Linkfeldbezeichnungen hinzu

Sie können Text zu einem Arbeitsaufgabenformular hinzufügen, das keinem Arbeitsaufgabenfeld zugeordnet ist, indem Sie das Type-Attribut der LabelControl-Option für das Control-Element verwenden.Der Text kann Nur-Text sein oder einen Link bereitstellen.Außerdem können Sie mit der FieldControl-Option einen Link an eine hinzugefügte Feldbezeichnung anfügen.

Beispiel: Nur-Textbezeichnung

Das folgende Beispiel fügt den Nur-Text "Geben Sie hier die Details des Fehlers ein.Auch Felder, die nicht erforderlich sind, sollten möglichst ausgefüllt werden." zum Arbeitsaufgabenfeld hinzu.

<Control Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />

Beispiel: Linkfeldbezeichnung

Im folgenden Beispiel wird veranschaulicht, wie einer Feldbezeichnung ein Link hinzugefügt wird.

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
            Title 2
      </Text>
   </LabelText>
</Control>

Hinweis
Für Team Foundation-Clients, die nicht auf die neueste Version aktualisiert haben, wird der Label-Attributtext angezeigt.Für Visual Studio 2012-Clients wird das Text-Tag als Link angezeigt, in dem die URL durch das Link-Tag definiert ist.

Beispiel: Feldbezeichnung mit Link für einen Teil des Texts

Im folgenden Beispiel wird veranschaulicht, wie einem Teil einer Feldbezeichnung ein Link hinzugefügt wird.In diesem Beispiel wird die URL von den Werten bestimmt, die den Param-Elementen auf Grundlage einer bestimmten Arbeitsaufgabe zugewiesen werden.

<Control Type="FieldControl" FieldName="System.IterationPath">
   <LabelText LabelPosition="Left">
      <Text>
         <Link UrlRoot="@ProcessGuidance" UrlPath="{0}.html">
            <Param Index="0" vValue"System.WorkItemType"/>         </Link>
            Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

Beispiel: Linkbeschriftung

Linkbeschriftung

Im folgenden Beispiel wird veranschaulicht, wie angezeigtem Text in einem Arbeitsaufgabenformular ein Link hinzugefügt wird.

<Group>
   <Column PercentWidth="100">
      <!-- Standalone label control 2 -->
      <Control Type="LabelControl" Label="How do I use this work item?">
         <Link UrlRoot="http://www.live.com"></Link>
      </Control>
   </Column>
</Group>

Beispiel: Kombinieren von Text und Links in einer einzelnen Bezeichnung

Kombinieren von Text und Links in einer einzelnen Bezeichnung

Im folgenden Beispiel wird veranschaulicht, wie Teilen einer Bezeichnung in einem Arbeitsaufgabenformular zwei Links hinzugefügt werden.

<Group>
   <Column PercentWidth="100">
   <!-- Standalone label control 3 -->
      <Control Type="LabelControl" Name="Microsoft.VSTS.Common.GuidanceLabel3">
         <LabelText>
            <Text>Click here for </Text>
            <Text>
               <Link UrlRoot="https://www.msn.com"></Link>
               work item guidance</Text>
            <Text> or here for </Text>
            <Text>
               <Link UrlRoot="http://www.msdn.com"></Link>
               process guidance
            </Text>
         </LabelText>
      </Control>
   </Column>
</Group>

Beispiel: Parameter-generierte Linkfeldbezeichnung

Im folgenden Beispiel wird veranschaulicht, wie einer Feldbezeichnung ein Link hinzugefügt wird. Dabei handelt es sich um eine Feldbezeichnung, die aus Parameterwerten erzeugt wird, die für die geöffnete Arbeitsaufgabe ausgewertet werden.

<Control Type="FieldControl" FieldName="System.State" Label="&amp;State:" LabelPosition="Left">
   <Link OpenInNewWindow="true" UrlRoot="http://" UrlPath="myserver.com:8080/tfs/myproject/{0}/_workItems#_a=edit&id=">      <Param Index="0" Value="System.State" Type ="Original"/>
   </Link>
</Control>

Anzeigen von Webinhalten

Mithilfe der WebpageControl-Option des Type-Attributs können Sie Webinhalte im Arbeitsaufgabenformular als Steuerelement anzeigen, statt einen Link zu einer separaten Webseite zu erstellen.Diese Anzeige kann für die Bereitstellung von Metriken nützlich sein, die Teammitglieder unterstützen, wenn sie den Inhalt eines Berichts, Dashboards oder anderen HTML-basierten Inhalt anzeigen.Sie können einen Link zum Inhalt bereitstellen oder den unformatierten HTML-Inhalt in ein CDATA-Tag einbetten.

Beispiel: Ein bereitgestellt von einem URI

Im folgenden Beispiel wird veranschaulicht, wie Inhalte einer Webseite eingebettet werden können, indem die URL zur Seite mithilfe des WebpageControlOptions- und des Link-Elements bereitgestellt wird.

<Tab Label="Web">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" Dock="Fill">
            < WebpageControlOptions AllowScript="true">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions >
         </Control>
      </Column>
   </Group>
</Tab>

Beispiel: Ein in einem CDATA-Tag bereitgestellt

Im folgenden Beispiel wird veranschaulicht, wie einem Arbeitsaufgabenformular, das in einem CDATA-Tag enthalten ist, HTML-Inhalt hinzufügt werden kann.

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
      <![CDATA[Place HTML Formatted Content Here ]]
   </Content>
   </WebpageControlOptions >
</Control>

Betten Sie Prozessleitfäden ein

Möglicherweise möchten Sie eine Registerkarte mit Informationen zum Workflow und zur Verwendung des Arbeitsaufgabentyps hinzufügen, um Prozessleitfäden im Arbeitsaufgabenformular verfügbar zu machen.Hierzu können Sie die WebpageControl-Option des Type-Attributs verwenden.Diese Option bietet Unterstützung beim Einbetten von Rich-formatiertem Text und Bildern in das Formular mithilfe der untergeordneten WebpageControlOptions- und Content-Elemente.

<FORM>
. . .
<TabGroup>
. . . 
   <Tab Label="Process Guidance">
      <Group>
         <Column PercentWidth="100">
            <Control Type="WebpageControl">
            <WebpageControlOptions >
            <Content>
               <![CDATA[Place HTML Formatted Process Guidance Content Here ]]>
            </Content>
            </WebpageControlOptions>
            </Control>
         </Column>
      </Group>
   </Tab>
. . .
</TabGroup>
. . .
</FORM>

Siehe auch

Konzepte

Entwerfen des Layouts des Arbeitsaufgabenformulars

Anpassen von Projektnachverfolgungsdaten, Formularen, Workflow und anderen Objekten