Referência de elementos XML de WebpageControlOptions

Você pode exibir o conteúdo definido para uma página da Web ou dentro de uma tag CDATA em um formulário de item de trabalho usando o WebpageControlOptions elemento. Você pode incluir tanto o LINK ou CONTENT elementos filho para especificar um URL ou o HTML para o conteúdo apareça no formulário.

Um elemento WebpageControlOptions é um filho do elemento CONTROL.

Hierarquia de esquema

WITD

   WORKITEMTYPE

       FORMULÁRIO

           Layout

               Group

               Coluna

               Grupo de abas

                  TAB

                     CONTROLE

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos e elementos filho

Elemento

Atributo

Descrição

WebpageControlOptions

 

Opcional Control elemento ao type="WebpageControl".

Elemento de contêiner para definir uma URL, cujo conteúdo será processado no formulário de item de trabalho.

Opcional LINK elemento. Necessário ao URLPath é especificado.

Especifica um valor a ser usado para determinar a URL do hiperlink quando URLPath é especificado.

O tipo de elemento é um tipo complexo: WebpageControlOptionsType.

 

AllowScript

Opcional WebpageControlOptions atributo.

Especifica se o JavaScript na página da Web é permitido executar (true) ou não (false). O tipo de atributo é xs:boolean.

Todas as outras configurações, como, por exemplo, ActiveX baseiam-se as configurações do Internet Explorer definidas para o cliente.

 

ReloadOnParamChange

Opcional WebpageControlOptions atributo.

Especifica se recarregar (true) o conteúdo da página da Web quando um parâmetro no formulário de item de trabalho é alterado (true) ou não (false). O tipo de atributo é xs:boolean.

O valor padrão é true.

Link

 

Opcional WebpageControlOptions elemento. Este elemento é mutuamente exclusivo com o Content elemento.

Especifica a URL da página da Web a ser processado no formulário de item de trabalho.

Para obter mais informações, consulte Link e referência de elementos XML de Param.

Content

 

Opcional WebpageControlOptions elemento.

Este elemento é mutuamente exclusivo com o Link elemento.

Especifica o conteúdo HTML a ser processado pelo controle de página da Web. O conteúdo é especificado dentro de uma tag CDATA. Por exemplo:

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

O tipo de elemento é xs:string.

ObservaçãoObservação
O conteúdo HTML não é validado antes para processamento de formulário de item de trabalho.

Elementos pai

Elemento

Descrição

Controle

Elemento pai obrigatório. Define um campo, o texto, o hiperlink ou outro elemento de controle seja exibido no formulário de item de trabalho.

Texto

Opcional LabelText elemento.

Elemento de contêiner para as informações ou o rótulo apareça no formulário de item de trabalho.

Para obter mais informações, consulte Referência de elementos XML LabelText e texto.

Comentários

O Link e Content elementos são mutuamente exclusivas.

O AllowScript e ReloadOnParamChange atributos não são permitidos ao usar o Content elemento.

Quando o controle de página da Web está configurado para exibir HTML bruto, todo o script está desativado. Todos os hiperlinks no conteúdo que são clicados são abertos no navegador da Web de Visual Studio se o formulário de item de trabalho é mostrado na Visual Studio ou no Internet Explorer.

Vários botões da barra de ferramentas são adicionados ao formulário de item de trabalho para uma guia que contém WebpageControl. Essas opções incluem as seguintes funções:

  • Navegação voltar e Avançar

  • Parar o conteúdo de carregamento e atualizar conteúdo

  • Retornar à home page do conteúdo

  • Abrir o conteúdo em uma nova janela ou em um navegador externo

Além disso, se a página da Web a ser carregado contiver conteúdo não confiável, em seguida, o ícone é bloqueado e o ícone bloqueado aparece.

O WebpageControlOptions elemento só é reconhecido por clientes que estão executando a versão mais recente do Team Explorer. Para versões anteriores, uma área vermelha é exibida e aparece uma mensagem indicando que o controle não pôde ser encontrado. Para obter mais informações, consulte Fornecendo o texto de Ajuda, orientação do processo, conteúdo da Web e Links para páginas da Web em um formulário de Item de trabalho.

Exemplo

O exemplo a seguir mostra como carregar um formulário de item de trabalho com HTML, definido em uma tag 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>

Definições 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>

Informações do elemento

Namespace

https://schemas.microsoft.com/VisualStudio/2008/WorkItemTracking/TypeDef

Nome de esquema

Definição de tipo de Item de trabalho

Arquivo de validação

WorkItemTypeDefinition.xsd

Tipo de elemento

WebpageControlOptionsType

Pode ficar vazio

Não aplicável.

Consulte também

Conceitos

Especificando os controles de formulário de Item de trabalho

Criando e personalizando um formulário de Item de trabalho

Outros recursos

Fornecendo o texto de Ajuda, orientação do processo, conteúdo da Web e Links para páginas da Web em um formulário de Item de trabalho

Histórico de alterações

Date

History

Motivo

Janeiro de 2011

Removidos os links para tópicos que foram removidos.

Aprimoramento de informações.