Referência de elementos XML link e Param

Você pode adicionar um hiperlink a um campo ou um rótulo autônoma em um formulário de item de trabalho usando o elemento de Link .Você usa o elemento de Link nas instâncias:

• Adicionar um hiperlink a um rótulo de campo

• Adicionar um hiperlink a um rótulo autônomo ou partes de texto informativa

• Especificar a URL para o conteúdo é exibido em um formulário de item de trabalho

O elemento de Link é um filho do elemento de Control , ou um elemento filho dos elementos de WebpageControlTarget ou de WebpageControlOptions .Para obter mais informações sobre esses elementos, consulte Referência de elemento do controle XML e Referência de elementos XML WebpageControlOptions.

Hierarquia de esquema

WITD

   WORKITEMTYPE

       FORMULÁRIO

           Layout

               Group

               Coluna

               Tab

                     Controle

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters"> <Param Index="IndexValue " Value="ParamValue " Type ="Original | Current"/> </Link>

Atributos e elementos

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

Elementos filhos e atributos

Elemento	Atributo	Descrição
Link		Elemento opcional de Control quando type="FieldControl". Elemento de LabelText opcional. Elemento de Text opcional. Elemento de WebpageControlOptions opcional. Elemento contêiner para definir um hiperlink ou uma URL.O tipo de elemento é o tipo complexo: HyperLinkType.
	UrlRoot	Atributo necessário de Link . Especifica o protocolo e o nome do servidor da URL que contém o rótulo.Os protocolos HTTP são suportados, e MAILTO HTTPS. Você pode o nome ou inserir de servidor especificado, ou você pode usar um dos seguintes macros e opcionalmente acrescentar informações de endereço adicional a uma macro: Observação Cada macro vincula-se a URL definida e habilitado para o projeto de equipe do formulário de item de trabalho para o elemento de Link é definido.Se alguns dos recursos não são provisionados ou não estão habilitados para o projeto de equipe, “não encontrado um erro aparecerá página”. @PortalPage: O URL do site da web do SharePoint para o projeto de equipe atual (por exemplo, https://serverName/sites/collectionName/TeamProjectName). @ProcessGuidance: O URL do site da web do SharePoint para a orientação do processo para um projeto de equipe. @ReportManagerUrl: O URL do servidor que hospeda o gerenciador de relatório para o projeto de equipe atual.Isso fornece um link para o modo de pasta para relatórios (por exemplo, https://serverName/Reports/Pages/Folder.aspx?ItemPath=/collectionName/teamProjectName). @ReportServiceSiteUrl: O URL do servidor que hospeda SQL Server reporting services para o projeto de equipe atual mais o caminho base para o projeto de equipe (por exemplo, https://serverName/Reports/Pages/reportservice.asmx? ItemPath=/collectionName/teamProjectName). Para determinar o valor embutido para os dois primeiros macros, você pode abrir as configurações de portal de projeto para um projeto de equipe.Para obter mais informações, consulte Acessar um portal de projeto de equipe ou as Diretrizes de Processo. O tipo do atributo é um tipo simples: NonBlankString.
	UrlPath	Atributo opcional de Link . Especifica um caminho de URL para o hiperlink.Você usa esse atributo para especificar os parâmetros variáveis que são determinados em tempo de execução.O tipo do atributo é um tipo simples: NonBlankString.
Param		Elemento de Link opcional.Necessário UrlPath quando é especificado. Especifica um valor a ser usado para determinar o URL de hiperlink UrlPath quando é especificado. O tipo de elemento é o tipo complexo: HyperLinkParamType.
	Index	Atributo necessário de Param . Especifica o índice do parâmetro onde o valor deve ser formatado na cadeia de caracteres da URL.Não é necessário ordenação em sequência os valores de índice; no entanto, eles devem coincidir com o número de índice na cadeia de caracteres de URLPath . O tipo do atributo é PositiveInteger.O primeiro número de índice deve ser 0.
	Value	Atributo necessário de Param . Especifica o número associado com o valor para um caminho de URL para o hiperlink. Especifica um valor que deve ser formatado na cadeia de caracteres de URLPath .Os valores devem ser nomes válidos de referência dos campos usados na definição de tipo de item de trabalho. A variável de @Me é suportado.É substituído pelo nome do membro da equipe atual que está exibindo o formulário de item de trabalho.As entradas de valor não diferenciam maiúsculas de minúsculas O tipo do atributo é xs:string.
	Type	Atributo opcional de Param . Especifica que o valor original do campo deve ser usado para o parâmetro.O tipo do atributo é um tipo simples:HyperLinkParamValueKind. Os valores válidos são: Original: Especifica usar o valor do parâmetro original para determinar o caminho URL. Current: Especifica usar o valor do parâmetro atual para determinar o caminho URL. Se esse atributo não for especificado, o valor atual do campo é usado como um parâmetro

Elementos pai

Elemento	Descrição
Controle	Obrigatório.Define um campo, texto, o hiperlink, ou outro elemento de controle seja exibido no formulário de item de trabalho.
LabelText	Elemento de Control opcional. Elemento contêiner para que um rótulo aparece no formulário de item de trabalho.
Texto	Elemento de LabelText opcional. Elemento contêiner para que informações ou o rótulo aparece no formulário de item de trabalho.
WebpageControlOptions	Elemento de Control opcional. Elemento contêiner que especifica as opções para o controle da página da Web. Para obter mais informações, consulte Displaying Web Content within a Work Item Form.

Comentários

O comportamento padrão de elemento de Link é abrir o hiperlink no formulário ou página da Web de item de trabalho.Se o hiperlink é criado para abrir em uma nova janela target= _blank (””), então um navegador externo é aberto.

Você pode combinar claramente e texto hyperlinked adicionar vários elementos de Text em um elemento de LabelText .

O elemento de LabelText é reconhecido apenas pelos clientes que estão executando a versão mais recente de Team Explorer.Como consequência, você deve especificar o atributo de Label em um elemento de Control quando você especificar um elemento filho de Link .Para clientes que estão executando a versão mais recente de Team Explorer, o texto fornecido por um elemento de LabelText aparece no formulário de item de trabalho.Para clientes que são executados em versões anteriores de Team Explorer, o texto especificado pelo atributo de Label do elemento de Control aparece no formulário de item de trabalho.

Exemplo: Especificando um hyperlink com parâmetros

Descrição

O exemplo a seguir mostra como você pode definir um hiperlink que vincula à orientação do processo para o tópico de iteração:

https://serverName/sites/collectionName/projectName/render.aspx? topic=Iteration&de wit=bug

O nome do projeto é derivado do valor atribuído ao campo de System.Project.

Código

<Link UrlRoot="https://serverName" UrlPath="sites/{0}/render.aspx?wit=bug&amp;topic=Iteration">
   <Param Index="0" Value="System.Project" />
</Link>

Exemplo: Adicionando um hiperlink a um rótulo autônomo

Descrição

O exemplo a seguir mostra como você pode atribuir um hiperlink ao texto “orientação de item de trabalho” em um formulário de item de trabalho.

Código

<Control type="LabelControl">
   <LabelText> 
      <Text>
         <Link UrlRoot="https://www.msn.com" />
      work item guidance
      </Text>
   </LabelText> 
</Control>

Exemplo: Adicionando um hiperlink a um campo

Descrição

O exemplo a seguir mostra como você pode adicionar um hiperlink no rótulo para um campo em um formulário de item de trabalho.

Código

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="This text comes from the Label attribute:">
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
         This text comes from the inner Label Text
      </Text>
   </LabelText>
</Control>

Definições de esquema

• HyperLinkType

• NonBlankString

• HyperLinkParamType

• HyperLinkParamValueKind

Tipo complexo: HyperLinkType

<xs:complexType name="HyperLinkType" >
   <xs:sequence>
      <xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
   <xs:attribute name="UrlRoot"  type="NonBlankString" use="required" />
   <xs:attribute name="UrlPath"  type="NonBlankString" use="optional" />
</xs:complexType>

HyperLinkParamType

<xs:complexType name="HyperLinkParamType" >
   <xs:attribute name="Index"     type="PositiveInteger" use="required" />
   <xs:attribute name="Value"     type="xs:string" use="required" />
   <xs:attribute name="Type" type="HyperLinkParamValueKind" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

HyperLinkParamValueKind

<xs:simpleType name="HyperLinkParamValueKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="Original"/>
   <xs:enumeration value="Current"/>
   </xs:restriction>
</xs:simpleType>   

Informações de elemento

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nome de esquema	Definição de tipo de item de trabalho
Validação Arquivo	WorkItemTypeDefinition.xsd
Tipo de elemento	HyperLinkType, HyperLinkParamType
Pode ser deixado	Não aplicável.

Consulte também

Conceitos

Especificar controles de formulário de item de trabalho

Criar e personalizar um formulário de item de trabalho

Outros recursos

Elements (Work Item Type Definition Schema)