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

Artikel
09/11/2015

Sie können Webinhalt oder HTML-Inhalt einem Arbeitsaufgabenformular hinzufügen, indem Sie die XML-Typdefinitionsdatei exportieren und ein WebpageControl-Element im FORM-Abschnitt hinzufügen. Nachdem Sie die XML-Datei geändert und importiert haben, können Sie die Anzeige des Webinhalts im aktualisierten Arbeitsaufgabentyp überprüfen.

Der Webinhalt, den Sie anzeigen, kann auf eine der folgenden Arten angegeben werden:

URL einer Webseite
Ein URL-Pfad, der zur Laufzeit anhand eines oder mehrerer Feldwerte, die für die Arbeitsaufgabe definiert wurden, dynamisch ermittelt wird
HTML-Inhalt

Informationen über die Syntaxstruktur der Elemente, die zum Hinzufügen von Webinhalt zu einem Arbeitselementtyp (Work Item Type, WIT) verwendet werden, finden Sie unter XML-Elementreferenz für WebpageControlOptions und XML-Elementreferenz für Link und Param.

Anforderungen

Sie müssen Mitglied der Gruppe Projektadministratoren für das Teamprojekt sein. Siehe Add users to team projects.

Exportieren und Öffnen der WIT-Definitionsdatei

Führen Sie basierend auf dem Umfang der durchzuführenden Anpassung einen der folgenden Schritte aus:

Wenn Sie für ein einzelnes Projekt einen Arbeitsaufgabentyp ändern:
1. Führen Sie witadmin exportwitd aus, um die XML-Datei für den zu bearbeitenden Arbeitsaufgabentyp zu exportieren. Weitere Informationen finden Sie unter Import, export, and manage work item types [witadmin].
2. Klicken Sie in Visual Studio auf Datei, Öffnen und Datei.
3. Wechseln Sie unter Suchen in in das Verzeichnis, in das Sie die Datei exportiert haben.
Wenn Sie einen Arbeitsaufgabentyp ändern, um eine Prozessvorlage anzupassen:
1. Navigieren Sie zu dem Verzeichnis, in das Sie die Prozessvorlage heruntergeladen haben.
2. Wählen Sie die Arbeitsaufgabentyp-XML-Datei aus, die Sie aktualisieren möchten, und klicken Sie dann auf Öffnen. Klicken Sie in der Eingabeaufforderung für Zeilenenden auf Nein.

Hinzufügen von Webinhalt zum FORM-Abschnitt der Definitionsdatei

Greifen Sie auf den <TabGroup>-Abschnitt der XML-Datei zu. Beachten Sie die <Tab>-Elemente wie Verknüpfungen und Dateianhänge, in denen jedes <Tab>-Element jeweils ein <Control>-Element enthält, das das jeweilige Steuerelement rendert.
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```

Fügen Sie ein neues <Tab>-Element hinzu, in dem der Webinhalt oder der HTML-Inhalt enthalten ist, den Sie im Arbeitsaufgabenformular anzeigen möchten. Kopieren Sie den folgenden Code je nach Definition des Webinhalts in den <TabGroup>-Abschnitt der Datei.

So geben Sie die URL einer Webseite an:

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" />
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

Ersetzen Sie Registerkartenbezeichnung und URL der Webseite mit den Informationen, die auf dem Arbeitsaufgabenformular angezeigt werden sollen.

So geben Sie eine dynamische URL an, die zur Laufzeit bestimmt werden soll:

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" URLPath="URL path with parameters >
      <Param Index="0" Value="Param Value 0"/>
      <Param Index="1" Value="Param Value 1"/>
      <Param Index="2" Value="Param Value 2"/>
               </Link>
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

Ersetzen Sie die Registerkartenbezeichnung, die URL der Webseite, den URL-Pfad mit Parametern und Param-Wert 1, 2 und 3 mit den Informationen, die auf dem Arbeitsaufgabenformular angezeigt werden sollen.

So geben Sie HTML-Inhalt an:
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl">
            <Content>
               <![CDATA[HTML Content]]>
            </Content>
         </Control>
      </Column>
   </Group>
</Tab>
```
Ersetzen Sie Registerkartenbezeichnung und HTML-Inhalt durch die Informationen, die auf dem Arbeitsaufgabenformular angezeigt werden sollen.

Hinweis

Um die besten Ergebnisse zu erzielen, sollte jedes Steuerelement bzw. jede Gruppe in einer Spalte angezeigt werden. Dies gilt auch, wenn sich die Spalte über die gesamte Breite des Formulars erstreckt.Ebenso sollten alle Spalten in einer Gruppe angezeigt werden, auch wenn die Gruppe keine sichtbare Bezeichnung oder Begrenzung aufweist.

Speichern Sie Ihre Änderungen in der XML-Datei.
Verwenden Sie witadmin importwitd zum Importieren des neuen Arbeitsaufgabentyps in ein einzelnes Projekt. Informationen zum Hinzufügen des Arbeitsaufgabentyps zur Prozessvorlage finden Sie unter Add type definitions for work items to a process template.

Überprüfen des Vorhandenseins der Webseite oder des HTML-Inhalts im Formular

Öffnen Sie in Team Explorer die Arbeitsaufgaben für das Teamprojekt, das die geänderte WIT-Definition enthält, und klicken Sie auf Aktualisieren.

Die aktuellen Updates werden vom Server heruntergeladen, einschließlich der Änderungen, die Sie gerade importiert haben. Warten Sie einige Sekunden, bis der Knoten Arbeitsaufgaben aktualisiert wurde. Für Knoten, für die noch ein Ladevorgang ausgeführt wird, wird In Arbeit angezeigt.
Erstellen Sie eine Arbeitsaufgabe mit dem WIT, den Sie geändert haben.

Überprüfen Sie, ob die Webseite oder der HTML-Inhalt wie erwartet auf dem Formular angezeigt wird.
Klicken Sie auf Schließen, um die neue Arbeitsaufgabe zu schließen.