Compartir a través de


WebpageControlOptions (Referencia de elementos de XML)

Use el elemento WebpageControlOptions para mostrar contenido definido para una página web o dentro de una etiqueta CDATA en un formulario de elemento de trabajo. Puede incluir los elementos secundarios Link o Content para especificar una dirección URL o HTML como contenido que aparecerá en el formulario.

Para agregar elementos a un formulario, hay que modificar un tipo de elemento de trabajo. Consulta Modificar o agregar un tipo de elemento de trabajo (WIT) personalizado.

El elemento WebpageControlOptions es un elemento secundario del elemento CONTROL.

Jerarquía del esquema

WITD

   WORKITEMTYPE

       FORM

           Diseño

               Group

               Columna

               TabGroup

                  Tab

                     Control

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos y elementos secundarios

Elemento

Atributo

Descripción 

WebpageControlOptions

 

Elemento Control opcional cuando type="WebpageControl".

Elemento contenedor para definir una dirección URL cuyo contenido se representará en el formulario de elemento de trabajo.

Elemento Link opcional. Obligatorio cuando se especifica UrlPath.

Especifica un valor que se usará para determinar la dirección URL del hipervínculo cuando se especifique UrlPath.

El tipo de elemento es el tipo complejo: WebpageControlOptionsType.

 

AllowScript

Atributo WebpageControlOptions opcional.

Especifica si se puede ejecutar JavaScript en la página web (true) o no (false). El tipo de atributo es xs:boolean.

Todos los demás valores como ActiveX se basan en la configuración de Internet Explorer definida para el cliente.

 

ReloadOnParamChange

Atributo WebpageControlOptions opcional.

Especifica si se va a recargar (true) el contenido de la página web cuando se cambie un parámetro del formulario de elemento de trabajo (true) o no (false). El tipo de atributo es xs:boolean.

El valor predeterminado es true.

Link

 

Elemento WebpageControlOptions opcional. Este elemento y el elemento Content se excluyen mutuamente.

Especifica la dirección URL de la página web que se representará en el formulario de elemento de trabajo.

Para obtener más información, consulta Referencia de los elementos Link y Param de XML.

Content

 

Elemento WebpageControlOptions opcional.

Este elemento y el elemento Link se excluyen mutuamente.

Especifica el contenido HTML que va a representar el control de la página web. El contenido se especifica dentro de una etiqueta CDATA. Por ejemplo:

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

El tipo de elemento es xs:string.

Nota

El contenido HTML no se valida antes de representarlo en el formulario de elemento de trabajo.

Elementos primarios

Elemento

Descripción 

Control

Elemento principal necesario. Define un campo, texto, hipervínculo u otro elemento de control que aparecerá en el formulario de elemento de trabajo.

Texto

Elemento LabelText opcional.

Elemento contenedor para la información o etiqueta que aparecerá en el formulario de elemento de trabajo.

Para obtener más información, consulta Referencia de los elementos LabelText y Text de XML.

Comentarios

Los elementos Link y Content se excluyen mutuamente.

Los atributos AllowScript y ReloadOnParamChange no están permitidos cuando se usa el elemento Content.

Cuando el control de la página web está configurado para mostrar HTML sin formato, se deshabilita todo el script. Los hipervínculos del contenido en los que se haga clic se abren en el explorador web de Visual Studio si el formulario de elemento de trabajo se muestra en Visual Studio o en Internet Explorer.

Varios botones de barra de herramientas se agregan al formulario de elemento de trabajo de una pestaña que contiene WebpageControl. Estas opciones incluyen las siguientes funciones:

  • Navegación hacia delante y atrás

  • Detener la carga de contenido y actualizar el contenido

  • Volver a la página principal de contenido

  • Abrir el contenido en una nueva ventana o en un explorador externo

Además, si la página web que se va a cargar incluye contenido que no es de confianza, se bloquea el icono y aparece el icono bloqueado.

El elemento WebpageControlOptions solo es reconocido por los clientes que ejecutan la versión más reciente de Team Explorer. En versiones anteriores, se muestra un área roja y aparece un mensaje que indica que no se pudo encontrar el control. Para obtener más información, consulta Proporcionar texto de ayuda, hipervínculos o contenido web en un formulario de elemento de trabajo.

Ejemplo

En el ejemplo siguiente se muestra cómo cargar un formulario de elemento de trabajo con HTML definido en una etiqueta 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>

Definiciones de esquema

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>

Información de elemento

Espacio de nombres

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

Nombre de esquema

Definición del tipo de elemento de trabajo

Archivo de validación

WorkItemTypeDefinition.xsd

Tipo de elemento

WebpageControlOptionsType

Puede estar vacío

No es aplicable

Vea también

Conceptos

Especificar controles de formulario de elemento de trabajo

Diseñar el formulario de elemento de trabajo

Otros recursos

Proporcionar texto de ayuda, hipervínculos o contenido web en un formulario de elemento de trabajo