Especificando os controles de formulário de Item de trabalho

Você pode usar as informações fornecidas neste tópico como uma referência rápida para o CONTROL elemento, seus elementos filho e atributos. Para cada controle de campo ou o formulário que você deseja exibir em um formulário de item de trabalho, você adicionar um CONTROL elemento. Você pode personalizar um formulário de item de trabalho para exibir informações para ajudar a sua equipe use o formulário corretamente. Você pode adicionar os campos de item de trabalho e os controles que permitem que você insira e exiba os dados que você deseja controlar. O CONTROL elemento oferece nove valores para o Type atributo que você pode usar para adicionar campos ou para exibir o texto sem formatação ou hiperlink ou campos. Além disso, você pode definir controles especiais para adicionar links e anexos, exibir o conteúdo baseado na Web, ou criar seu próprio controle e adicioná-lo a um formulário de item de trabalho.

Neste tópico

  • Adicionando campos de Item de trabalho a um formulário de Item de trabalho

  • Adicionando controles especiais para um formulário de Item de trabalho

  • Adicionando controles personalizados a um formulário de Item de trabalho

Adicionando campos de Item de trabalho a um formulário de Item de trabalho

Quando você personaliza o formulário de item de trabalho, você normalmente adiciona um subconjunto dos campos de item de trabalho que são definidos para o tipo de item de trabalho que você deseja que apareça no formulário. As definições de campo controlam vários aspectos de quais dados são exibidos ou os dados que você pode inserir no formulário. Para obter mais informações, consulte A definição de campos de Item de trabalho.

Cada campo do item de trabalho está associado um tipo de dados. Você pode usar as informações na tabela a seguir para determinar qual tipo de campo é suportado pelo qual Type atributo o Control elemento. Use o Label atributo para especificar o texto que exibe o próximo ao controle. Use o relacionados LabelPosition atributo para especificar onde o rótulo aparece em relação ao controle. Para obter mais informações, consulte Controlar a exibição de campos de Item de trabalho.

ObservaçãoObservação

Você não pode alterar os valores dos campos de sistema, que são atualizados automaticamente. Por exemplo, os campos Data de criação e criado por são definidos quando um item de trabalho é salvo pela primeira vez. No entanto, você pode usar esses campos de critérios de pesquisa. Para obter uma descrição de cada campo do sistema, consulte Usando os campos de sistema e definidas pelos modelos de processo do MSF.

Tipo de campo

Atributo de tipo de elemento de controle

Uso

DateTime

FieldControl

DateTimeControl

Use FieldControl para fornecer um campo de texto para a entrada ou a exibição de um campo de data e hora tipo dados.

<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" />

Use DateTimeControl para fornecer um selecionador de calendário para selecionar uma data para um campo, conforme mostrado na ilustração a seguir.

Calendário <>campo>
<Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />

Double

FieldControl

Use FieldControl para fornecer um campo de texto para a entrada ou a exibição dos campos Double.

<Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />

History

WorkItemLogControl

Você pode usar WorkItemLogControl para fornecer um controle de campo para campos de histórico que controlar segmentos de discussão e outras informações históricas, como mostrado na ilustração a seguir.

Guia Histórico e <>>o campo trabalho <>item><>>formulário

Você pode usar esse controle somente para oferecer suporte a exibição do campo histórico de um item de trabalho, o campo de item de trabalho do System.History. Usando esse controle, você pode expandir e recolher detalhes sobre as revisões de históricas para um item de trabalho. Você também pode formatar o texto que você adicionar ao campo histórico.

<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description
and History" LabelPosition="Top" Dock="Fill" />

HTML

HTMLControl

Use HTMLControl para fornecer um campo de controle que permitem que os campos HTML capturar a formatação rich text, conforme mostrado na ilustração a seguir.

<>>HTML<>mostrado no trabalho de campo de> <>item><>>formulário
<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />

Integer

FieldControl

Use FieldControl para fornecer um campo de controle para um campo inteiro.

<Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />

Texto sem formatação

FieldControl

Use FieldControl para fornecer um campo de controle para um campo de texto sem formatação, como uma caixa de texto que contém descrições que podem ser maiores que 255 caracteres.

<Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />

String

FieldControl

Use FieldControl para fornecer um campo de controle para um campo de seqüência de caracteres. Os campos de seqüência de caracteres são limitados a 255 caracteres.

<Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />

TreePath

WorkItemClassificationControl

Use WorkItemClassificationControl para fornecer um campo de controle para um campo de TreePath.

<Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

Atributos de campo de elemento controle opcional para todos os tipos de controle

Os seguintes atributos opcionais podem ser especificados somente para esses tipos de controle são listados.

Attribute

Descrição

Field

Especifica o controle que está associado com o campo de item de trabalho.

Label

Especifica o texto visível no formulário que identifica o controle. Especifique uma seqüência de caracteres não mais de 80.

ObservaçãoObservação
Você pode anexar um hiperlink para o rótulo de um campo que é adicionado ao formulário de item de trabalho usando FieldControl.Esse controle é útil para fornecer um link para informações sobre como o campo é usado.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.

LabelPosition

Especifica a posição do rótulo em relação a dados de controle. Especifique uma seqüência de caracteres de um dos seguintes valores: Top, Bottom, Left, and Right.

Dock

Especifica o alinhamento do rótulo com o lado especificado do recipiente ou estica o campo para preencher o recipiente. Especifique uma seqüência de caracteres de um dos seguintes valores: Fill, Top, , Bottom, Left, e Right.

Padding

Especifica a quantidade de espaço, em pixels, ao redor do interior borda do controle. Quatro valores são fornecidos que correspondem à parte superior, inferior, esquerda e direita. Por exemplo: (2,0,2,0).

Margin

Especifica a quantidade de espaço, em pixels, ao redor da borda externa do controle. Quatro valores são fornecidos que correspondem à parte superior, inferior, esquerda e direita. Por exemplo: (2,0,2,0).

ReadOnly

Especifica que o campo é somente leitura. Specify True or False.

MinimumSize

Especifica o tamanho mínimo, em pixels, que o controle deve ocupar no formulário. Dois valores forem especificados, que correspondem a largura e altura. Por exemplo: (100,100).

Name

Identifica exclusivamente um controle. O Name atributo é necessário se mais de um controle no formulário está associado com o mesmo trabalho item campo.

ObservaçãoObservação
Você pode usar o Name atributo para exibir o mesmo campo em mais de uma área no formulário.Você especificar um valor exclusivo para o Name de atributo para ambas as entradas de controle para que o sistema identifica cada controle exclusivamente.É útil mostrar o mesmo controle em vários locais, baseadas no contexto das guias.

Atributos de campo de elemento controle opcional para tipos específicos de controle

Os seguintes atributos opcionais podem ser especificados somente para esses tipos de controle são listados.

Attribute

Tipos de controle

Descrição

NumberFormat

FieldControl

Especifica os caracteres que podem ser inseridas no controle de campo. Os seguintes valores são válidos: WholeNumbers, SignedWholeNumbers, DecimalNumbers, and SignedDecimalNumbers.

MaxLength

FieldControl

Especifica o comprimento máximo de caracteres que você pode usar para um controle de campo.

Format

DateTimeControl

Especifica o formato do campo de data e hora que corresponde a um valor de enum DateTimePickerFormat. Os seguintes valores são válidos: Custom, Long, Short, Time.

CustomFormat

DateTimeControl

Especifica o formato personalizado que é usado para o campo de data e hora que corresponde à sintaxe definida para a propriedade DateTimePicker.CustomFormat.

Adicionando controles especiais para um formulário de Item de trabalho

A tabela a seguir descreve o Control elemento Type atributos que fornecem suporte para que você possa gerenciar anexos de arquivos, criar links, exibir o conteúdo baseado na Web e exibir outros dados não associado um campo de item de trabalho.

Atributo de tipo de elemento de controle

Uso

AttachmentsControl

Use esta opção para anexar arquivos a um formulário de item de trabalho. Esse controle geralmente está contido em seu próprio grupo de guias, conforme mostrado na ilustração a seguir.

Controle de anexos

Exemplo de controle de anexos

Para obter mais informações, consulte Adicionando o controle de anexos.

LabelControl

Use para exibir o texto sem formatação ou hiperlink que não está associado um campo, conforme mostrado na ilustração a seguir.

Exemplo de dois hiperlinks aplicados ao texto

Você pode usar o LabelText e Link elementos filho e o recipiente para especificar o texto, o hiperlink e a posição de um campo ou rótulo cujo texto está parcialmente associado com um hiperlink. 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, Referência de elementos XML LabelText e texto e Link e referência de elementos XML de Param.

LinksControl

Use para criar e gerenciar vínculos entre itens de trabalho. Esse controle geralmente está contido em seu próprio grupo de guias, conforme mostrado na ilustração a seguir.

Exemplo de controle de vínculos adicionado ao formulário de item de trabalho

Você pode usar o LinksControlOptions para definir os filtros de link e o layout dos campos de coluna, que são usados para exibir a lista de links. Para obter mais informações, consulte Definir controles de Link para restringir os relacionamentos de Link e Elementos de LinksControlOptions.

WebpageControl

Use para exibir o conteúdo da Web em um formulário de item de trabalho. Geralmente, este controle está contido no seu próprio grupo de guias. Você pode usar o WebpageControlOptions e Link elementos filho para especificar os controles que são necessários para carregar o destino da página da Web no formulário de item de trabalho.

Para obter mais informações, consulte Adicionando o conteúdo da Web a um formulário de Item de trabalho, Referência de elementos XML de WebpageControlOptions e Link e referência de elementos XML de Param.

Adicionando controles personalizados a um formulário de Item de trabalho

Além de controles internos, você pode adicionar seu próprio controle personalizado para um formulário de item de trabalho.

Por exemplo, você pode adicionar um controle personalizado para capturar uma captura de tela da área de transferência. Ou você poderia fornecer um controle para capturar vários valores, adicionando uma caixa de seleção para os valores que são apresentadas em uma lista ou menu.

Para implementar um controle personalizado, você deve especificar o nome do controle para o Type atributo. Para obter mais informações, consulte o site da Microsoft: Controles personalizados de rastreamento de Item de trabalho.

Consulte também

Tarefas

Adicionar e personalizar um tipo de Item de trabalho

Alterar o Layout de formulário de Item de trabalho

Alterar o rótulo para um campo

Adicionando o conteúdo da Web a um formulário de Item de trabalho

Referência

Referência de elemento do controle XML

Conceitos

Criando e personalizando um formulário de Item de trabalho

Histórico de alterações

Date

History

Motivo

Junho de 2010

Adicionado ilustrações e movidos algumas seções para novos tópicos.

Aprimoramento de informações.