Referencia de elementos XML WebpageControlOptions

Artículo
11/18/2015

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

<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, vea 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, vea Referencia de los elementos LabelText y Text de XML.

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