Trabalhando com campos de Item de trabalho

Você pode usar campos de item de trabalho para controlar os dados para um tipo de item de trabalho e defina os critérios de filtro para consultas, bem como gerar relatórios. Qualquer elemento de dados, exceto para campos de dados do sistema de núcleo, que você deseja controlar, use para definir o fluxo de trabalho ou aparecem no formulário para um tipo de item de trabalho deve ser definido como um campo de item de trabalho. Você pode definir os campos de item de trabalho dentro da definição de um tipo de item de trabalho ou fluxo de trabalho global.

Campos de item de trabalho são mantidos para uma coleção de projeto de equipe. Você pode adicionar campos ao executar uma das seguintes tarefas:

• Você cria um projeto de equipe. Todos os campos que são definidos dentro as definições de tipos de item de trabalho ou fluxo de trabalho global e que são definidos para o modelo de processo selecionado são criados. Para obter mais informações, consulte Campos (Agile) do item de trabalho ou Campos (CMMI) do item de trabalho. Os campos de sistema de núcleo são automaticamente definidos para cada tipo de item de trabalho é definido para um projeto de equipe. Para obter uma lista desses campos, consulte Usando os campos de sistema e definidas pelos modelos de processo do MSF.

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

• Importar uma definição de fluxo de trabalho global. Todos os novos campos são definidos dentro do fluxo de trabalho global são adicionados à coleção. Você pode definir um fluxo de trabalho global quando você desejar manter um conjunto de campos de item de trabalho que compartilham de vários tipos de itens de trabalho. Para obter mais informações, consulte Personalizando o fluxo de trabalho Global.

• Você mapear uma coleção de projeto a uma instância do Project Web App (PWA). Depois de instalar o Visual Studio Team Foundation Server 2010 e a integração do Project Server feature pack, você configurar a integração, mapeando os diversos componentes do Team Foundation. Quando você mapeia uma coleção, uma definição de fluxo de trabalho global que oferece suporte a vários campos nos campos do Project Server é importada. Para obter mais informações, consulte Campos do Project Server é adicionado à sincronização de dados de suporte.

Todos os campos são definidos em todos os tipos de item de trabalho e todos os fluxos de trabalho globais para todos os projetos de equipe formam o conjunto completo de campos que são definidos para a coleção. Você pode alterar o atributo do, renomear e excluir campos existentes. No entanto, você incorrer em determinados custos ao fazer esses tipos de alterações. Para obter mais informações, consulte Personalizando o controle de dados, formulários, fluxo de trabalho e outros objetos do projeto.

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

Neste tópico

• Estrutura de sintaxe do campo (definição)

• Tipos de dados de campo

• Atribuídas a campos de atributos reportável

• Campos indexados

• Elementos filho de campo (definição)

• Os campos de sistema e de campos predefinidos

Estrutura de sintaxe do campo (definição)

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

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

Você define um campo a seguinte sintaxe XML no arquivo de definição do 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="avg" >
   <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).

Voltar ao topo

Tipos de dados de campo

O tipo de um campo define o tipo e tamanho dos dados que você pode armazenar no campo. Um campo pode ter apenas um tipo por Team Foundation Server. Essa restrição encoraja as organizações a usar os campos comuns entre projetos e os tipos de item de trabalho.

A lista a seguir mostra os tipos de campo suportadas:

Tipo de dados	Descrição
DateTime	Especifica uma data de acordo com o momento de tempo Universal Coordenado (UTC) no tempo. Você pode adicionar um DateTime campo a um formulário de item de trabalho, usando o FieldControl ou DateTimeControl type atributos.
Double	Especifica um valor de ponto flutuante. Dois campos são usados com freqüência em consulta filtra e listas de resultados. Você pode adicionar um Double campo a um formulário de item de trabalho usando o FieldControl type atributo.
GUID	Especifica um campo que irá conter um identificador exclusivo. Não é possível adicionar um GUID campo a um formulário de item de trabalho.
History	Oferece suporte à exibição de segmentos de discussão e de outras informações históricas de controle. Observação O System.History campo é o único campo que usa esse tipo de dados.Você não pode definir um campo personalizado usando o tipo de dados. Você pode adicionar o System.History campo a um formulário de item de trabalho usando o WorkItemLogControl type atributo que oferece suporte para controles de formato rich text.
HTML	Suporta a capacidade de capturar dados de rich text e usar mais descrições de textos como, por exemplo, uma descrição do item de trabalho. Um campo HTML difere de um campo de texto sem formatação, um campo HTML é digitado altamente para HTML para exibições mais ricas de informações. Você pode adicionar um HTML campo a um formulário de item de trabalho usando o HTMLControl type atributo que oferece suporte para controles de formato rich text.
Integer	Especifica um valor inteiro assinado de 32 bits. Campos inteiros são usados na consulta filtra e listas de resultados. Você pode adicionar um Integer campo a um formulário de item de trabalho usando o FieldControl type atributo.
PlainText	Oferece suporte a entrada de uma seqüência de texto que pode conter mais de 255 caracteres Unicode. Você pode adicionar um PlainText campo a um formulário de item de trabalho, usando o FieldControl atributo type e limitada para texto sem formatação, ou o HTMLControl type atributo que oferece suporte para controles de formato rich text.
String	Oferece suporte a entrada de uma seqüência de texto que pode conter até 255 caracteres Unicode. Use um campo de seqüência de caracteres para um rótulo ou outra seqüência de caracteres de texto curto até uma linha longa. Campos de seqüência de caracteres são usados na consulta filtra e listas de resultados. Você pode adicionar um String campo a um formulário de item de trabalho usando o FieldControl type atributo.
TreePath	Especifica um campo que exibe as entradas hierárquico ou estrutura de árvore, como, por exemplo, os requisitos para exibir os caminhos de área e de iteração de um produto. Observação O System.AreaPath e System.IterationPath campos são os únicos campos que usam esse tipo de dados.Você não pode definir um campo personalizado usando o tipo de dados. Você pode adicionar o System.AreaPath e System.IterationPath formulário de item de campos para um trabalho usando o WorkItemClassificationControl type atributo.

Voltar ao topo

Reportável atributos que são atribuídos a campos

Alguns valores de campo são especialmente úteis para a emissão de relatórios. Usando a linguagem de definição de tipo de item de trabalho, você pode especificar os seguintes atributos opcionais:

• reportable. Você definir o atributo reportable para None, Detail, Dimension, ou Measure, dependendo se e como você deseja que o campo a serem incluídos em relatórios. Dados dos campos que tenham um valor diferente de None para este atributo são exportados para o data warehouse e podem ser incluídos em relatórios.

  Quando você adiciona um campo existente para um item de trabalho digitar, o valor atual para o reportable atributo é usado. Quando você adiciona um campo para um tipo de item de trabalho, emissão de relatórios está desativado, a menos que você a especificar explicitamente usando a reportable atributo.

• reportingname. Você pode 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 a name atributo é usado.

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

  Você pode usar esse atributo para mesclar ou divergem de campos que são incluídos nos relatórios. Para mesclar os dois campos que têm os nomes distintos de referência e que são definidos nas coleções de outro projeto, atribuir o mesmo reportingrefname para os dois campos. Para uma diferenciação dois campos que têm o mesmo nome de referência e que são definidos nas coleções de outro projeto, atribuir uma outra reportingrefname para cada campo.

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

Para obter informações sobre práticas recomendadas para rotular campos para fins de relatórios, consulte Adicionar e modificar os campos de Item de trabalho para a emissão de relatórios de suporte.

Voltar ao topo

Valores de atributo reportável

Como a tabela a seguir descreve, você pode atribuir um dos seguintes valores para o reportable atributo: Nenhum, dimensão, detalhe e medir.

Observação
Você pode fazer um campo reportable após ele ter sido usado para um item de trabalho. Depois de definir o valor reportable, novas revisões do item de trabalho que são copiadas para o depósito conterá o valor do campo. No entanto, as revisões que já estejam no depósito não será backfilled com os valores existentes.

Valor do atributo	Descrição
Detail	Use o Detail tipo somente para campos de número inteiro, duplo, seqüência ou DateTime. Os dados neste campo são movidos para o banco de dados relacional warehouse nas tabelas de Item de trabalho atual e o Item de trabalho, mas não para o SQL Server cubo do Analysis Services. Usando esse tipo para campos de texto irrestrita, você pode usá-los em relatórios sem fazer com que o cubo significativamente maior.
Dimension	Use o Dimension tipo somente para campos de número inteiro, duplo, seqüência ou DateTime. Os dados neste campo insere o banco de dados relacional warehouse e o cubo do Analysis Services como um atributo da dimensão do Item de trabalho para que os dados podem ser usados para filtrar relatórios. Use este tipo para campos que têm listas de valores válidos. Tipo de Item de trabalho e de estado são bons exemplos de uma dimensão.
Measure	Use o Measure tipo somente para o inteiro e campos Double. As medidas são valores numéricos em seus relatórios. Durante o processamento de cubo do Analysis Services, dados são pré-calculados em campos que são definidos como Measure. Por exemplo, os grupos de medidas do Item de trabalho atual e de Item de trabalho contêm dados cumulativos para os seguintes campos: Estimativa original, restantes de horas e horas concluídas. Para obter mais informações sobre grupos de medidas, consulte Medir a grupos e avaliações fornecidas no cubo de serviços de análise para o Team System. Quando você especificar Measure, você deve especificar sum para o formula atributo, que retorna a soma de cada medida referenciado na consulta.
None	Especificar None quando não quiser incluir o campo em relatórios. Esse valor é a atribuição padrão.

Voltar ao topo

Exemplos mostrando como especificar a emissão de relatórios

Exemplo de detalhe

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

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

Campos indexados

Você pode ativar ou desativar a indexação de um campo de item de trabalho usando o witadmin indexfield comando. Quando você habilita a indexação de um campo, você pode aumentar o desempenho de encontrar itens de trabalho cujas consultas especificar esse campo. Se você adicionar um campo personalizado que você usa em muitas das suas consultas de item de trabalho, convém habilitar a indexação desse campo. Para obter mais informações, consulte Gerenciando os campos de Item de trabalho [witadmin].

Voltar ao topo

Elementos filho de campo (definição)

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

• Texto de ajuda. Define as informações de Ajuda ou a dica de ferramenta exibe um campo no trabalho formulário de item (HELPTEXT).

• Restrições de campo. Especifica um campo, conforme necessário, somente leitura, vazio, congelada ou um padrão específico de correspondência (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

• AutoPreenchimento de valor do campo. Especifica um valor para o campo (DEFAULT, COPY, SERVERDEFAULT).

• Listas de campo. Especifica os valores permitidos, sugeridos ou proibidos. (ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

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

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

Voltar ao topo

Sistema e campos predefinidos

Todos os campos de sistema definido possuem nomes de referência que começam com o sistema, por exemplo, System.AreaPath, System.AssignedTo e continuam a esse padrão.

Campos predefinidos, definidos pelo Microsoft Solutions Framework (MSF) começam com Microsoft.VSTS de modelos de processo e diferem ainda mais com base no seu uso. Exemplos de campos predefinidos que são usados em comum, para programar fins e integração com Office Project, para integração com Team Foundation Builde a integração com Team Foundation são da seguinte maneira:

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

Para uma visão geral de todos os sistema e os campos predefinidos que são definidos para o MSF para o modelo de processo do Agile Software Development v 5.0, consulte Usando os campos de sistema e definidas pelos modelos de processo do MSF. Para obter mais informações sobre como especificar os nomes de campo, consulte Convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

Voltar ao topo

Consulte também

Tarefas

Adicionar um campo para ou remover um campo de um tipo de Item de trabalho

Referência

Gerenciando os campos de Item de trabalho [witadmin]

Elemento FIELD (definição)

Conceitos

Todas as referências de elementos XML de WITD

Todas as referências de elementos do campo XML

Outros recursos

Resolvendo conflitos de esquema que estão ocorrendo no Data Warehouse

Adicionar e modificar os campos de Item de trabalho para a emissão de relatórios de suporte

A definição de campos de Item de trabalho

Histórico de alterações

Date	History	Motivo
Janeiro de 2011	Adicionadas informações sobre o fluxo de trabalho global e atualizado de várias seções com links para tópicos relacionados. Removida a seção sobre a definição de esquema.	Aprimoramento de informações.