Partager via


Référence des éléments XML WebpageControlOptions

Vous pouvez afficher le contenu défini pour une page Web ou dans une balise CDATA sur un formulaire d'élément de travail à l'aide de l'élément WebpageControlOptions. Vous pouvez inclure les éléments enfants Link ou Content pour spécifier une URL ou HTML pour le contenu à afficher dans le formulaire.

L'élément WebpageControlOptions est un élément enfant de l'élément CONTROL.

Hiérarchie de schéma

WITD

   WORKITEMTYPE

       FORM

           Disposition

               Groupe

               Colonne

               TabGroup

                  Onglet

                     Contrôle

<xs:element name="WebpageControlOptions" type="WebpageControlOptionsType" minOccurs="0" maxOccurs="1" />
<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link UrlRoot="UrlRoot" UrlPath ="UrlPathWithParameters">
      <Param index="IndexValue " value="Param Value " type ="Original | Current"/>
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Éléments enfants et attributs

Élément

Attribut

Description

WebpageControlOptions

 

Élément Control facultatif lorsque type="WebpageControl".

Élément conteneur pour la définition d'une URL dont le contenu sera restitué dans le formulaire d'élément de travail.

Élément LINK facultatif. Requis si UrlPath est spécifié.

Spécifie une valeur à utiliser pour déterminer l'URL du lien hypertexte lorsque UrlPath est spécifié.

L'élément est de type complexe : WebpageControlOptionsType.

 

AllowScript

Attribut WebpageControlOptions facultatif.

Spécifie si le code JavaScript de la page Web est autorisé à s'exécuter (true) ou non (false). Le type de l'attribut est xs:boolean.

Tous les autres paramètres tels qu'ActiveX sont basés sur les paramètres Internet Explorer définis pour le client.

 

ReloadOnParamChange

Attribut WebpageControlOptions facultatif.

Spécifie si le contenu de la page Web doit être rechargé (true) lorsqu'un paramètre du formulaire d'élément de travail est modifié (true) ou non (false). Le type de l'attribut est xs:boolean.

La valeur par défaut est true.

Link

 

Élément WebpageControlOptions facultatif. Cet élément et l'élément Content s'excluent mutuellement.

Spécifie l'URL de la page Web à restituer dans le formulaire d'élément de travail.

Pour plus d'informations, consultez Référence des éléments XML Link et Param.

Content

 

Élément WebpageControlOptions facultatif.

Cet élément et l'élément Link s'excluent mutuellement.

Spécifie le contenu HTML devant être restitué par le contrôle de page Web. Le contenu est spécifié dans une balise CDATA. Par exemple :

<![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]>

Le type d'élément est xs:string.

RemarqueRemarque
Le contenu HTML n'est pas validé avant sa restitution dans le formulaire d'élément de travail.

Éléments parents

Élément

Description

Contrôle

Élément parent requis. Définit un élément de champ, de texte, de lien hypertexte ou d'autre contrôle à afficher sur le formulaire d'élément de travail.

Texte

Élément LabelText facultatif.

Élément conteneur pour les informations ou l'étiquette à afficher sur le formulaire d'élément de travail.

Pour plus d'informations, consultez Référence des éléments XML LabelText et Text.

Notes

Les éléments Link et Content s'excluent mutuellement.

Les attributs AllowScript et ReloadOnParamChange ne sont pas autorisés lorsque vous utilisez l'élément Content.

Lorsque le contrôle de page Web est configuré pour afficher le HTML brut, tout le script est désactivé. Tous les liens hypertexte dans le contenu cliqués sont ouverts dans le navigateur Web Visual Studio si le formulaire d'élément de travail est affiché dans Visual Studio ou dans Internet Explorer.

Plusieurs boutons de barre d'outils sont ajoutés au formulaire d'élément de travail d'un onglet qui contient WebpageControl. Ces options incluent les fonctions suivantes :

  • Navigation vers l'arrière et l'avant

  • Arrêt du chargement du contenu et actualisation du contenu

  • Retourner à la page d'accueil du contenu

  • Ouverture du contenu dans une nouvelle fenêtre ou dans un navigateur externe

De plus, si la page Web à charger contient le contenu non fiable, l'icône est bloquée et l'icône bloquée apparaît.

L'élément WebpageControlOptions est reconnu uniquement par les clients qui exécutent la version la plus récente de Team Explorer. Pour les versions antérieures, une zone rouge est affichée et un message apparaît indiquant que le contrôle n'a pas pu être trouvé. Pour plus d'informations, consultez Ajout de texte d'aide, guide de processus, contenu Web et liens vers les pages Web sur un formulaire d'élément de travail.

Exemple

L'exemple suivant montre comment charger un formulaire d'élément de travail avec du code HTML défini dans une balise CDATA.

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
         <![CDATA[Click here for detailed <b><a href="https://www.microsoft.com">Process Guidance</a></b>]]>
      </Content>
   </WebpageControlOptions>
</Control>

Définitions de schéma

WebpageControlOptionsType

<xs:complexType name="WebpageControlOptionsType">
   <xs:choice minOccurs="1" maxOccurs="1">
      <xs:element name="Link" type="HyperLinkType"/>
      <xs:element name="Content" type="xs:string"/>
   </xs:choice>
      <xs:attribute name="AllowScript" type="xs:boolean" use="optional" />
      <xs:attribute name="ReloadOnParamChange" type="xs:boolean" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

Informations sur les éléments

Espace de noms

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

Nom du schéma

Définition du type d'élément de travail

Fichier de validation

WorkItemTypeDefinition.xsd

Type d'élément

WebpageControlOptionsType

Peut être vide

Non applicable

Voir aussi

Concepts

Spécification des contrôles de formulaire d'élément de travail

Conception et personnalisation d'un formulaire d'élément de travail

Autres ressources

Ajout de texte d'aide, guide de processus, contenu Web et liens vers les pages Web sur un formulaire d'élément de travail

Historique des modifications

Date

Historique

Motif

Mai 2011

A corrigé le cas de plusieurs éléments et attributs de la syntaxe XML. La définition du schéma pour le suivi des éléments de travail définit tous les éléments enfants de l'élément FORM en casse mixte et met en majuscules toutes les lettre dans les noms des autres éléments.

Résolution des bogues de contenu.

Janvier 2011

Liens retirés vers les rubriques qui ont été supprimées.

Améliorations apportées aux informations.