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 verfügbar machen, können Teammitglieder nützliche Daten besser verfolgen".

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.

In diesem Thema

• Bereitstellen von Hilfetext oder QuickInfo-Text

• Hinzufügen von Feldbezeichnungen für eigenständigen Text und Links

• Anzeigen von Webinhalten

• Einbetten von Prozessleitfäden

Bereitstellen von Hilfetext oder QuickInfo-Text

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>

Hinzufügen von Feldbezeichnungen für eigenständigen Text und Links

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>

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 UrlPath="http://{0}/sites/{1}/render.aspx?wit=bug&amp;topic=Iteration">
            <Param value="@Server"/>
            <Param value="System.Project"/>
         </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: Durch 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://{0}/sites/{1}/render.aspx?wit=bug&amp;state={2}">
      <Param value="@Server"/>
      <Param value="System.Project"/>
      <Param 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: Anzeigen von Inhalt, der durch einen URI bereitgestellt wird

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="false">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions >
         </Control>
      </Column>
   </Group>
</Tab>

Beispiel: Anzeigen von Inhalt, der in einem CDATA-Tag bereitgestellt wird

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>

Einbetten von Prozessleitfäden

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

Referenz

XML-Elementreferenz für Control

FIELD (Workflow)-Element

Konzepte

Angeben von Steuerelementen für Arbeitsaufgabenformulare

Entwerfen des Layouts des Arbeitsaufgabenformulars

Anpassen von Projektnachverfolgungsdaten, Formularen, Workflow und anderen Objekten

Weitere Ressourcen

Steuern der Anzeige von Arbeitsaufgabenfeldern

Änderungsprotokoll