Compartilhar via

Link e referência de elementos XML de Param

  • Artigo

Você pode adicionar um hiperlink para um campo ou um rótulo autônomo em um formulário de item de trabalho usando o LINK elemento. Você pode usar o LINK elemento nas seguintes instâncias para:

  • Adicionar um hiperlink para um rótulo de campo

  • Adicionar um hiperlink para um rótulo autônomo ou partes do texto informativo

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

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

Hierarquia de esquema

WITD

   WORKITEMTYPE

       FORMULÁRIO

           LAYOUT

               GRUPO

               COLUNA

               TAB

                     CONTROLE

<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>

<LINK URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
</LINK>

Atributos e elementos

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

Atributos e elementos filho

Elemento

Atributo

Descrição

LINK

 

Opcional CONTROL elemento ao type="FieldControl".

Opcional TE elemento.

Opcional WebpageControl elemento.

Opcional WebpageControlOptions elemento.

Elemento de contêiner para definir um hiperlink ou URL. O tipo de elemento é um tipo complexo: HyperLinkType.

 

URLRoot

Obrigatório LINK atributo.

Especifica o protocolo e o nome do servidor do URL para que os links de rótulo. Protocolos suportados são HTTP, HTTPS e MAILTO.

Você pode tanto codificar o nome do servidor especificado ou você pode usar um dos seguintes macros e opcionalmente anexar informações adicionais a uma macro:

ObservaçãoObservação
Cada links de macro para a URL que está definida e habilitada para o projeto de equipe do formulário de item de trabalho para o qual o LINK elemento é definido.Se algum dos recursos não são provisionados ou habilitados para o projeto de equipe, uma "página não encontrada" erro será exibida.

  • @PortalPage: A URL do site do SharePoint para o projeto de equipe atual (por exemplo, https://serverName/sites/NomeDaColeta/TeamProjectName).

  • @ProcessGuidanceUrl: A URL do site do SharePoint para a orientação do processo para um projeto de equipe.

  • @ReportManagerUrl: A URL do servidor que hospeda o Report Manager para o team project atual. Isso fornece um link para o modo de exibição de pasta para os relatórios (por exemplo, https://serverName/Reports/Pages/Folder.aspx?ItemPath = /NomeDaColeta/teamProjectName).

  • @ReportServiceSiteUrl: A URL do servidor que hospeda SQL Server a equipe do Reporting Services para o atual projeto plus caminho base para o projeto de equipe (por exemplo, https://serverName/Reports/Pages/reportservice.asmx?ItemPath = /NomeDaColeta/teamProjectName).

Para determinar o valor embutido para as duas primeiras macros, você pode abrir as configurações de portal do projeto para um projeto de equipe. Para obter mais informações, consulte Acessar um Team Project Portal e as diretrizes de processo.

O tipo de atributo é simples: NonBlankString.

 

URLPath

Opcional LINK atributo.

Especifica um caminho de URL do hiperlink. Você pode usar esse atributo para especificar parâmetros de variáveis são determinados em tempo de execução. O tipo de atributo é simples: NonBlankString.

PARAM

 

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: HyperLinkParamType.

 

index

Obrigatório PARAM atributo.

Especifica o índice do parâmetro onde o valor deve ser formatado em seqüência de caracteres de URL. Não é necessário para solicitar os valores de índice de seqüência; No entanto, eles deverão coincidir com o número do índice de URLPath seqüência de caracteres.

O tipo de atributo é PositiveInteger. O primeiro número de índice deve ser 1.

 

value

Obrigatório PARAM atributo.

Especifica o número associado com o valor para um caminho de URL do hiperlink.

Especifica um valor que deve ser formatado para o URLPath seqüência de caracteres. Valores devem ser nomes de referência válido dos campos usados na definição de tipo de item de trabalho.

O @Me variável é suportado. Ele é substituído com o nome do membro da equipe atual que está exibindo o formulário de item de trabalho. Entradas de valor não diferenciam maiúsculas de minúsculas

O tipo de atributo é xs:string.

 

type

Opcional Param atributo.

Especifica que o valor original do campo deve ser usado para o parâmetro. O tipo de atributo é simples:HyperLinkParamValueKind.

Os valores válidos são:

  • Original: Especifica o valor do parâmetro original de usar para determinar o caminho de URL.

  • Current: Especifica para usar o valor do parâmetro atual para determinar o caminho de URL.

Se este 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, o texto, o hiperlink ou outro elemento de controle seja exibido no formulário de item de trabalho.

LABELTEXT

Opcional CONTROL elemento.

Elemento de contêiner para um rótulo apareça 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.

WebpageControlOptions

Opcional CONTROL elemento.

Elemento de recipiente que especifica as opções para o controle de página da Web.

Para obter mais informações, consulte Displaying Web Content within a Work Item Form: WebpageControlOptions Elements.

Comentários

O comportamento padrão do LINK elemento é abrir o hiperlink no formulário de item de trabalho ou página da Web. Se o hiperlink é criado para abrir em uma nova janela (destino = "_ blank"), e um navegador externo é aberto.

Você pode combinar o texto sem formatação e hiperlink adicionando vários TEXT elementos em um LABELTEXT elemento.

O LABELTEXT elemento só é reconhecido por clientes que estão executando a versão mais recente do Team Explorer. Portanto, você deve especificar o Label o atributo em um CONTROL elemento ao especificar um filho LINK elemento. Para clientes que estejam executando a versão mais recente do Team Explorer, o texto fornecido pela uma LABELTEXT elemento aparece no formulário de item de trabalho. Para clientes que estejam executando versões anteriores do Team Explorer, o texto especificado pelo CONTROL elemento Label atributo será exibida no formulário de item de trabalho.

Descrição

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

https://serverName/sites/NomeDaColeta/projectName/render.aspx?wit=bug & amp; tópico = iteração

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

Código

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

Descrição

O exemplo a seguir mostra como você pode atribuir um hiperlink para o texto "diretrizes 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>

Descrição

O exemplo a seguir mostra como você pode adicionar um hiperlink para o 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 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

HyperLinkType, HyperLinkParamType

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

Elementos (esquema de definição do tipo 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.