Trabalhando com campos de Item de trabalho

Você usar campos de item de trabalho para acompanhar dados para um tipo de item de trabalho e definir os critérios de filtragem para consultas bem como para gerar relatórios.Qualquer elemento de dados, exceto os campos de dados do sistema principal em Team Foundation Server (TFS), que você deseja controlar, usar para definir o fluxo de trabalho, ou para aparecer no formulário para um tipo de item de trabalho deve ser definido como um campo de item de trabalho.Você pode definir campos de item de trabalho dentro da definição de um tipo de item de trabalho ou fluxo de trabalho global.

Os campos de item de trabalho são mantidos para uma coleção de projeto de equipe.Você adiciona campos quando você executa uma das seguintes tarefas:

• Crie um projeto de equipe.Todos os campos que são definidos nas definições para tipos de item de trabalho ou o fluxo de trabalho global e que são definidos para o modelo selecionado de processo são criados.Os campos do sistema principal são definidas automaticamente para cada tipo de item de trabalho que é definido para um projeto de equipe.Para obter uma lista desses campos, consulte Referência de campos de item de trabalho para o Visual Studio ALM.

• Importar uma definição para um tipo de item de trabalho.Todos os novos campos que são definidos dentro da definição para um tipo de item de trabalho são adicionados à coleção.Para obter mais informações, consulte Todas as referências de elementos XML WITD.

• Importar uma definição global de fluxo de trabalho.Todos os novos campos que são definidos no fluxo de trabalho global são adicionados à coleção.Você define um fluxo de trabalho global quando você deseja manter um conjunto de campos de item de trabalho que vários tipos de itens de trabalho compartilharem.Para obter mais informações, consulte Personalizar o fluxo de trabalho global.

• Mapear uma coleção de projeto a uma instância do aplicativo (PWA) Web de Projeto.Depois de instalar as extensões de Team Foundation Server para Project Server, configurar a integração mapeando vários componentes de Team Foundation.Quando você mapeia uma coleção, uma definição global de fluxo de trabalho que suporta vários campos em campos Project Server é importado.Para obter mais informações, consulte Campos de adicionados Project Server à sincronização de dados de suporte.

Todos os campos que são definidos em todos os tipos de itens de trabalho e todos os fluxos de trabalho globais para todos os projetos de equipe compõem o conjunto completo de campos que são definidos para a coleção.Você pode alterar o atributo, renomear, e excluir campos existentes.Entretanto, você provoca determinados custo quando você faz esses tipos de alterações.Para obter mais informações, consulte Personalizar dados de acompanhamento de projeto, formulários, fluxo de trabalho e outros objetos.

Para adicionar ou personalizar um campo para uma coleção, modifique o conteúdo XML para a definição de um tipo de item de trabalho ou de fluxo de trabalho global.Defina cada campo através de um elemento de FIELD dentro da seção de FIELDS de definição para um tipo de item de trabalho ou o fluxo de trabalho global.Para obter informações sobre a estrutura e o local desses arquivos, consulte Todas as referências de elementos XML WITD e Personalizar o fluxo de trabalho global.

Neste tópico

• COLOQUE a estrutura de sintaxe (de definição)

• Coloque tipos de dados

• Atributos reportáveis atribuídos aos campos

• Campos indexados

• Elementos filho de CAMPO (definição)

• Campos do sistema e campos predefinidos

COLOQUE a estrutura de sintaxe (de definição)

Cada elemento de FIELD (definição) tem um nome amigável, que é opcional, e um nome de referência, que é necessário.O nome da referência deve ser exclusivo dentro da coleção.Para obter mais informações, consulte As convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

Importante
Você pode alterar o nome amigável para um campo usando a ferramenta de linha de comando witadmin changefield .No entanto, se você renomear um campo, afeta todos os tipos de itens de trabalho em todos os projetos de equipe dentro da coleção.

Defina um campo pela sintaxe XML no arquivo de definição para o tipo de item de trabalho.

<FIELD name="fieldDisplayName"
   refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID"
   syncnamechanges="true | false"
   reportingname="reportingDisplayName"
   reportingrefname="reportingReferenceName"
   reportable="Dimension | Detail | Measure" 
   formula="sum" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

Para obter mais informações, consulte Elemento FIELD (definição).

De volta ao topo

Coloque tipos de dados

O tipo de um campo define o tipo e o tamanho dos dados que você pode armazenar no campo.Um campo pode ter apenas um tipo definido dentro de uma coleção de projeto de equipe.Essa limitação incentiva organizações usar campos comuns através dos projetos e os tipos de item de trabalho.

A lista a seguir mostra os tipos de campo suportados:

Tipo de dados	Descrição
DateTime	Especifica uma data de acordo com o ponto de (UTC) do Tempo Universal Coordenado (UTC) no tempo. Adicione um campo de DateTime a um formulário de item de trabalho usando os atributos de FieldControl ou de DateTimeControltype .
Double	Especifica um valor de ponto flutuante.Os campos duplas são usados em listas de filtros e os resultados da consulta. Adicione um campo de Double a um formulário de item de trabalho usando o atributo FieldControltype .
GUID	Especifica um campo que contém um identificador exclusivo. Você não pode adicionar um campo de GUID a um formulário de item de trabalho.
History	Suporte que exibem segmentos de notícias e acompanhar de outras informações históricas. Observação O campo de System.History é o único campo que usa esse tipo de dados.Você não pode definir um campo personalizado usando esse tipo de dados. Adicione o campo de System.History a um formulário de item de trabalho usando o atributo WorkItemLogControltype que suporta controles de rich text.
HTML	Oferece suporte à capacidade para capturar dados de rico- texto e usar uma mais descrições longas de texto como uma descrição de item de trabalho.Um campo HTML difere de um campo de texto não criptografado que um campo HTML é altamente tipado em HTML para uma exibe mais ricas de informações. Adicione um campo de HTML a um formulário de item de trabalho usando o atributo HTMLControltype , que suporta controles de rich text.
Integer	Especifica um valor de número inteiro de 32 bits com sinal.Os campos inteiro são frequentemente usados em listas de filtros e os resultados da consulta. Adicione um campo de Integer a um formulário de item de trabalho usando o atributo FieldControltype .
PlainText	Oferece suporte a entrada de uma cadeia de caracteres de texto que pode conter mais de 255 caracteres Unicode. Adicione um campo de PlainText a um formulário de item de trabalho usando o atributo type de FieldControl e limitado ao texto sem formatação, ou o atributo de HTMLControltype que suporta controles de rich text.
String	Oferece suporte a entrada de uma cadeia de caracteres de texto que pode conter até 255 caracteres Unicode.Use uma propriedade de cadeia de caracteres para um rótulo ou outra cadeia de caracteres de texto até que uma linha de tempo.Os campos de cadeia de caracteres são frequentemente usados em listas de filtros e os resultados da consulta. Adicione um campo de String a um formulário de item de trabalho usando o atributo FieldControltype .
TreePath	Especifica um campo que exibe entradas em um hierárquica ou em um estrutura de árvore, como os requisitos da área e caminhos de iteração de exibição para um produto. Observação Os campos de System.AreaPath e de System.IterationPath são os únicos campos que usam esse tipo de dados.Você não pode definir um campo personalizado usando esse tipo de dados. Adicione os campos de System.AreaPath e de System.IterationPath a um formulário de item de trabalho usando o atributo WorkItemClassificationControl type .

De volta ao topo

Atributos reportáveis que são atribuídos aos campos

Alguns valores de campos são especialmente úteis para relatar.Usando o idioma da definição de tipo de item de trabalho, você pode especificar os seguintes atributos opcionais:

• reportable.Defina o atributo reportável a None, a Detail, a Dimension, ou a Measure, dependendo se e como você deseja que o campo a ser incluído nos relatórios.Os dados dos campos que têm um valor diferente None para este atributo são exportados a data warehouse e podem ser incluídos nos relatórios.

  Quando você adiciona um campo existente a um tipo de item de trabalho, o valor atual para o atributo de reportable é usado.Quando você adiciona um campo para um tipo de item de trabalho, relatório é desabilitado a menos que você o especificar explicitamente usando o atributo reportable .

• reportingname.Atribuir um rótulo diferente a um campo que é usado quando os dados aparecem nos relatórios.Se você não especificar um valor, o nome amigável que é atribuído para o atributo de name é usado.

• reportingrefname.Atribuir um nome diferente de referência a um campo que é usado quando os dados são exportados a data warehouse relacional.Se você não especificar um valor, o valor que é atribuído ao atributo de refname é usado.

  Use este atributo a mesclagem ou diverge os campos que são incluídos nos relatórios.Para mesclar dois campos que têm nomes distintos de referência e que são definidos em coleções diferentes do projeto, você atribui mesmo reportingrefname a ambos os campos.Para divergir dois campos que têm o mesmo nome de referência e que são definidos em coleções diferentes do projeto, você atribui reportingrefname diferente para cada campo.

Após você definir um campo, você pode usar o comando de witadmin changefield em um prompt de comando alterar o valor de todos os atributos exceto para o atributo de refname .

Para obter informações sobre as práticas recomendadas em rotular coloca relatando propósitos, consulte Adicionar e modificar campos de item de trabalho para dar suporte a relatórios.

De volta ao topo

Valores de atributo reportáveis

Como a tabela a seguir descreve, você pode atribuir um dos seguintes valores para o atributo de reportable : nenhum, dimensão, detalhes, e medida.

Observação
Você pode fazer um campo reportável depois que foi usado para um item de trabalho.Após você definir o valor reportável, novas revisões de item de trabalho que são copiadas para o depósito conterá o valor do campo.No entanto, as revisões que já estão no depósito não serão aterradas com os valores existentes.

De volta ao topo

Exemplos que mostram como especificar o relatório

Exemplo de detalhes

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Exemplo de dimensão

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Exemplo de medição

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

Campos indexados

Você pode ativar ou desativar a indexação para um campo de item de trabalho usando o comando de witadmin indexfield .Quando você habilita a indexação para um campo, você pode aumentar o desempenho de localizar itens de trabalho cujas ambas as consultas especificam o campo.Se você adicionar um campo personalizado que você usar em muitas das suas consultas de item de trabalho, você pode querer permitir a indexação para o campo.Para obter mais informações, consulte Gerenciar campos de item de trabalho [witadmin].

De volta ao topo

Elementos filho de CAMPO (definição)

Há um número de elementos filhos opcionais que você pode especificar para um campo de item de trabalho, por exemplo:

• Texto de ajuda.Define informações de dica ou da ajuda de ferramenta que exibe para um campo no item de trabalho forms (HELPTEXT).

• Limitações do campo.Especifica um campo necessário, como somente leitura, vazia, congelado, ou correspondente um padrão específico (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

• Preenchimento automático do valor do campo.Especifica um valor para o campo (DEFAULT, COPY, SERVERDEFAULT).

• Listas de campo.Specifies permitiu, sugeridos, ou proibiu valores.(ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• Condições de campo.Aplica uma ou mais regras a um campo quando outro campo é modificado ou não modificado, ou outro campo tem ou não tem um valor específico, ou outro condição (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE,NOTSAMEAS).

Para obter mais informações, consulte Todas as referências de elementos do campo XML.

De volta ao topo

Sistema e campos predefinidos

Todos os campos definidos sistema têm nomes de referência que começam com o sistema, por exemplo, System.AreaPath, System.AssignedTo, e continuam naquele padrão.

Os campos predefinidos definidos pelos modelos padrão do processo que TFS fornece começa com o Microsoft.VSTS e então diferem mais baseado em seu uso.Exemplos de campos predefinidos que são usados em comum, agendando fins e integração com Microsoft Project, para a integração com Team Foundation Build, e a integração com Team Foundation são:

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

Para obter uma visão geral de todo o sistema e campos predefinidos que são definidos para os modelos padrão do processo que TFS fornece, consulte Referência de campos de item de trabalho para o Visual Studio ALM.Para obter mais informações sobre como especificar nomes de campo, consulte As convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

De volta ao topo

Atributos ocultos e não variáveis e o campo Explorer de item de trabalho

Além dos atributos que você pode alterar para um campo de item de trabalho, há um número de atributos não variáveis e praticamente ocultos para cada campo.Você pode pesquisar as atribuições desses campos usando a ferramenta do gerenciador de campo de item de trabalho.Acessar a ferramenta do gerenciador de campo de item de trabalho de ferramenta avançada do editor do processo.

Trabalhar o campo de item Explorer

Observação

A ferramenta avançada do editor do processo fornece uma interface gráfica do usuário para personalizar modelos de processo do Team Foundation Server.Você pode usar essa ferramenta para exportar e importar tipos de item de trabalho, para modificar o conteúdo do modelo de processo, e explorar o conjunto de campos definidos para uma coleção de projeto de equipe.Para obter mais informações, consulte a seguinte página no site da Microsoft: Ferramentas poderosas do Team Foundation Server.

Consulte também

Referência

Gerenciar campos de item de trabalho [witadmin]

Conceitos

Personalizar o Acompanhamento de Item de Trabalho e seu projeto de equipe

Adicionar e modificar campos de item de trabalho para dar suporte a relatórios

Todas as referências de elementos do campo XML

Outros recursos

Definir campos de item de trabalho