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

Article
08/10/2011

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

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

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.

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.

Partager via