Modifier une définition WIT pour ajouter du contenu Web à un formulaire d'élément de travail

Article
09/12/2015

Vous pouvez ajouter du contenu Web ou du contenu HTML à un formulaire d'élément de travail en exportant le fichier XML de définition de type et en ajoutant un WebpageControl dans la section FORM. Après avoir modifié et importé le fichier XML, vous pouvez vérifier l'affichage du contenu Web dans le type d'élément de travail mis à jour.

Le contenu Web que vous affichez peut être spécifié de l'une des façons suivantes :

URL d'une page Web
Les chemins d'accès d'URL sont déterminés dynamiquement au moment de l'exécution en fonction d'une ou de plusieurs valeurs de champ définies pour l'élément de travail.
Contenu HTML

Pour plus d'informations sur la structure de la syntaxe des éléments utilisés pour ajouter du contenu web à un type d'élément de travail (WIT), consultez Référence des éléments XML WebpageControlOptions et Référence des éléments XML Link et Param.

Spécifications

Vous devez être membre du groupe Project Administrators pour le projet d'équipe. Consultez Ajouter des utilisateurs aux projets d'équipe.

Exporter et ouvrir le fichier de définition du WIT

Exécutez l'une des procédures suivantes en fonction de la portée de la personnalisation que vous souhaitez effectuer :

Si vous modifiez un type d'élément de travail pour un seul projet :
1. Exécutez witadmin exportwitd pour exporter le fichier XML du type d'élément de travail que vous souhaitez modifier. Pour plus d'informations, consultez Importer, exporter et gérer des types d'éléments de travail [witadmin].
2. Dans Visual Studio, choisissez Fichier, Ouvrir, Fichier.
3. Sous Regarder dans, accédez à l'emplacement où vous avez exporté le fichier.
Si vous modifiez un type d'élément de travail pour personnaliser un modèle de processus :
1. Recherchez l'emplacement où vous avez téléchargé le modèle de processus.
2. Sélectionnez le fichier XML du type d'élément de travail que vous souhaitez mettre à jour, puis choisissez Ouvrir. Lorsque vous êtes invité à modifier les fins de ligne, cliquez sur Non.

Ajouter du contenu Web à la section FORM du fichier de définition

Recherchez la section <TabGroup> du fichier XML. Notez que des éléments <Tab>, tels que les liens et les pièces jointes, sont associés à des éléments <Tab> qui contiennent chacun un élément <Control> qui restitue le contrôle respectif.
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```

Ajoutez un nouvel élément <Tab> qui contiendra le contenu Web ou le contenu HTML que vous souhaitez afficher dans le formulaire d'élément de travail. Copiez le code suivant dans la section <TabGroup> du fichier selon la façon dont vous définissez le contenu Web.

Pour spécifier l'URL d'une page Web :

<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>

Remplacez Tab Label et URL of Web Page par les informations que vous souhaitez voir apparaître sur le formulaire d'élément de travail.

Pour spécifier une URL dynamique à déterminer au moment de l'exécution :

<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>

Remplacez Tab Label, URL of Web Page, URL path with parameters et Param Value 1, 2, and 3 par les informations que vous souhaitez voir apparaître sur le formulaire d'élément de travail.

Pour spécifier le contenu HTML :
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl">
            <Content>
               <![CDATA[HTML Content]]>
            </Content>
         </Control>
      </Column>
   </Group>
</Tab>
```
Remplacez Tab Label et HTML Content par les informations que vous souhaitez voir apparaître sur le formulaire d'élément de travail.

Notes

Pour de meilleurs résultats, chaque contrôle ou groupe doit s'afficher dans une colonne, même si celle-ci s'étend sur la largeur totale du formulaire.Chaque colonne doit ensuite s'afficher dans un groupe, même si celui-ci ne comporte aucune étiquette ou limite visible.

Enregistrez les modifications apportées au fichier XML.
Utilisez witadmin importwitd pour importer le nouveau type d'élément de travail dans un seul projet. Pour ajouter le type d'élément de travail à votre modèle de processus, consultez Ajouter les définitions de type pour les éléments de travail à un modèle de processus.

Vérifier que la page Web ou le contenu HTML apparaît dans le formulaire

Dans Team Explorer, ouvrez les éléments de travail du projet d'équipe qui contient la définition du WIT que vous avez modifiée, puis choisissez Actualiser.

Les mises à jour les plus récentes sont téléchargées à partir du serveur, notamment les modifications que vous venez d'importer. Attendez quelques secondes jusqu'à ce que le nœud Éléments de travail soit actualisé. Les nœuds encore en cours de chargement affichent le mot en cours.
Créez un élément de travail à l'aide du WIT que vous avez modifié.

Vérifiez que la page Web ou le contenu HTML apparaît dans le formulaire, comme prévu.
Choisissez Fermer pour fermer le nouvel élément de travail.