Referencia de elementos XML WebpageControlOptions

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Importante

Este artículo se aplica a la personalización de proyectos para los modelos de proceso XML locales. Para obtener información general sobre los modelos de proceso, consulte Personalización de la experiencia de seguimiento de trabajo.

Puede mostrar el contenido definido para una página web o dentro de una etiqueta CDATA en un formulario de elemento de trabajo mediante el WebpageControlOptions elemento . Puede incluir los elementos secundarios Vínculo o Contenido para especificar una dirección URL o HTML para que el contenido aparezca 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 personalizado.

El WebpageControlOptions elemento es un elemento secundario del elemento WebpageControlOptions

Sintaxis

<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 UrlPath se especifica .
Especifica un valor que se va a utilizar para determinar la dirección URL del hipervínculo cuando UrlPath se especifica .
AllowScript Atributo WebpageControlOptions opcional.
Especifica si JavaScript dentro de la página web puede ejecutar ( 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 debe volver a cargar ( ) el contenido de la página web cuando se cambia un parámetro en el formulario de elemento de trabajo true ( ) o no ( truefalse ). El tipo de atributo es xs:boolean .
El valor predeterminado es true.
Link Elemento WebpageControlOptions opcional. Este elemento es mutuamente excluyente con el Content elemento .
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 Vincular y param.
Content Elemento WebpageControlOptions opcional.

Este elemento es mutuamente excluyente con el Link elemento .
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="https://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 LabelText y Text.

Comentarios

Los Link elementos y son Content mutuamente excluyentes.

Los AllowScript atributos y no se permiten cuando se usa el elemento ReloadOnParamChangeContent .

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 el que se hace 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.
Se agregan varios botones de barra de herramientas al formulario de elemento de trabajo para 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 WebpageControlOptions elemento solo lo reconocen 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.

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>