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 le Link ou les éléments enfants Content pour spécifier une URL, ou HTML pour le contenu à afficher dans le formulaire.
Pour ajouter des éléments à un formulaire, vous modifiez un type d'élément de travail. Consultez Modifier ou ajouter un type d'élément de travail personnalisé (WIT).
L'élément WebpageControlOptions est un élément enfant de l'élément CONTROL.
Hiérarchie de schéma
<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) quand 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 que le contrôle de page web doit restituer. 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. Notes Le contenu HTML n'est pas validé avant sa restitution dans le formulaire d'élément de travail. |
Éléments parents
Élément |
Description |
|---|---|
É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. |
|
É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 sur lesquels l'utilisateur clique 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 contenant WebpageControl. Ces options incluent les fonctions suivantes :
Navigation vers l'arrière et l'avant
Arrêt du chargement et actualisation du contenu
Retour à 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 s'affiche.
L'élément WebpageControlOptions est reconnu uniquement par les clients qui exécutent la dernière version de Team Explorer. Pour les versions antérieures, une zone rouge affiche un message indiquant que le contrôle est introuvable. Pour plus d'informations, consultez Fournir du texte d'aide, des liens hypertexte ou du contenu 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écifier des contrôles de formulaire d'élément de travail
Concevoir le formulaire d'élément de travail