Elemento FIELD (definição)

Você pode usar o FIELD o elemento (definição) para definir um campo de item de trabalho e especificar as regras e condições que se aplicam ao proprietário. Os atributos que você atribuir a um campo determinam como ele aparece em um formulário de item de trabalho e se ele está disponível para inclusão nos relatórios. Gerenciar o conjunto de atribuições de campo para uma coleção de projeto de equipe. Portanto, os atributos que você atribui aos campos que são definidos em um tipo de item de trabalho devem coincidir com todos os tipos de itens de trabalho para todos os projetos de equipe em uma coleção. Além disso, todos os campos reportável de todas as coleções são exportados para os bancos de dados do depósito de dados.

ObservaçãoObservação

Para obter informações sobre o FIELD o elemento (fluxo de trabalho), que você pode usar para especificar as regras e condições aos campos durante uma transição de fluxo de trabalho ou de alteração de estado, consulte Elemento FIELD (fluxo de trabalho).

Você pode alterar as atribuições de atributo que tornam a campos existentes para uma coleção usando o witadmin ferramenta de comando. Para obter mais informações, consulte Gerenciando os campos de Item de trabalho [witadmin].

Hierarquia de esquema

WITD

   WORKITEMTYPE

      CAMPOS

            FIELD

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" >
   <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>

Atributos e elementos

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

Atributos

Atributo

Descrição

name

Obrigatório. O nome amigável do campo que aparece nos menus drop-down de consultas de itens de trabalho. O nome amigável deve ser exclusivo em todos os campos são definidos em um projeto de equipe. Além disso, o nome amigável pode diferir do rótulo que aparece próximo ao campo do formulário de item de trabalho. Para obter mais informações, consulte Referência de elemento do controle XML.

O tipo de atributo é typelib:FieldName. Comprimento mínimo: 1; comprimento máximo: 128.

Valor padrão: ^[^\. \[\]]+$

Exemplo de valor padrão: Atribuído À

refname

Obrigatório. O rótulo exclusivo que distingue um campo de todos os outros campos são definidos na coleção de projeto de equipe.

Para outros requisitos e restrições de nomes amigáveis e nomes de referência, consulte Convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

O tipo de atributo é typelib:ReferenceFieldName. Comprimento mínimo: 1; comprimento máximo: 70.

Valor padrão: ^[a-Za-Z_][a-Za-z0-9_]* (\. [a-zA-Z0-9 _] +) +$

Exemplo de valor padrão: Company.IssueType

type

Obrigatório. Especifica o tipo de dados que o campo aceita.

ObservaçãoObservação
Campos diferentes de coleções que tiverem o mesmo projeto reportingrefname deve ser atribuído o mesmo valor para type.Se os valores forem diferentes, os conflitos de dados podem ocorrer quando o data warehouse é processado.Para obter mais informações, consulte Resolvendo conflitos de esquema que estão ocorrendo no Data Warehouse.

A tabela a seguir lista os valores válidos para este atributo:

ValorUso
DateTime Especifica uma data de acordo com o momento de tempo Universal Coordenado (UTC) no tempo.
Double Especifica um valor de ponto flutuante.
GUID Especifica um campo que irá conter um identificador exclusivo.
History
Oferece suporte a segmentos de discussão e mantém o controle de outras informações históricas.
ObservaçãoObservaçã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.
HTML Suporta captura de dados de rich text e é usado para descrições de texto mais longas, como, por exemplo, uma descrição do item de trabalho.
Integer Especifica um valor inteiro assinado de 32 bits.
PlainText Oferece suporte a entrada de uma seqüência de texto que pode conter mais de 255 caracteres Unicode.
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.
TreePath
Especifica um campo que exibe as entradas hierárquico ou estrutura de árvore, como, por exemplo, o que é necessário para exibir os caminhos de área e de iteração de um produto.
ObservaçãoObservaçã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.

syncnamechanges

Opcional. Especifica se o campo de item de trabalho é usado para armazenar os nomes que você deseja ser atualizados conforme são feitas alterações no Active Directory ou um grupo de trabalho. Esta opção é válida somente quando type="String". O tipo de atributo é xs:boolean.

Especificar true para habilitar a sincronização para o campo de dados, especifique false para desabilitar a sincronização para o campo de dados.

reportable

Opcional. Especifica se os dados do campo estão disponíveis para inclusão nos relatórios. Campos com o valor padrão de None não são exportados para o data warehouse relacional nem processados para o SQL Server cubo do Analysis Services. Para obter mais informações sobre campos reportable, consulte Adicionar e modificar os campos de Item de trabalho para a emissão de relatórios de suporte.

ObservaçãoObservação
Campos em diferentes projetos coleções que têm o mesmo valor para o reportingrefname deve ser atribuído o mesmo valor para reportable.Se os valores forem diferentes, os conflitos de dados podem ocorrer quando o data warehouse é processado.Para obter mais informações, consulte Resolvendo conflitos de esquema que estão ocorrendo no Data Warehouse.

A tabela a seguir lista os valores válidos para este atributo:

Value Uso
Detail Pode ser especificado para campos do tipo DateTime, Double, Integer ou String. Os dados neste campo são movidos no banco de dados relacional warehouse nas tabelas de Item de trabalho e o Item de trabalho atual, mas não no cubo do Analysis Services.Esse tipo é uma boa opção para os campos de texto irrestrito, porque você pode usá-las nos relatórios sem fazer com que o cubo significativamente maior.
Dimension Pode ser especificado para campos do tipo DateTime, Double, Integer ou String. 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 tipo de medida somente para campos duplos e de inteiro.As medidas são valores numéricos em seus relatórios.Quando o cubo do Analysis Services é processado, dados são pré-calculados em campos cujos reportable atributos são definidos para a medida.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.Quando você especifica a medida, você deve especificar o formula atributo.
None Especificar None quando não quiser usar o campo para inclusão nos relatórios.Esta é a atribuição padrão.

formula

Opcional. O tipo de agregação para o measure reportável tipo. O único valor válido é sum, que retorna a soma de todos os valores em conjunto.

reportingname

Opcional. Especifica o nome que aparece nos relatórios. Se você não especificar um valor, o valor é atribuído para o name atributo é usado.

ObservaçãoObservação
Campos diferentes de coleções que tiverem o mesmo projeto reportingrefname deve ser atribuído o mesmo valor para o reportingname.Se os valores forem diferentes, os conflitos de dados podem ocorrer quando o data warehouse é processado.Para obter mais informações, consulte Resolvendo conflitos de esquema que estão ocorrendo no Data Warehouse.

O tipo de atributo é typelib:FieldName. Comprimento mínimo: 1; comprimento máximo: 128.

Valor padrão: ^[^\. \[\]]+$

Exemplo de valor padrão: Atribuído À

reportingrefname

Opcional. Especifica o nome de referência é usado quando um campo reportable é processado. 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 processados para o data warehouse. 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 a ambos. Para uma diferenciação dois campos que têm o mesmo nome de referência, mas que são definidos nas coleções de outro projeto, atribuir uma outra reportingrefname para cada campo.

Você deve mesclar campos sempre que possível para minimizar o número de campos no depósito e manter sob o limite máximo de campos Reportável de 1024. Você pode gerar relatórios de entre grupos com campos mesclados.

O tipo de atributo é typelib:ReferenceFieldName. Comprimento mínimo: 1; comprimento máximo: 70.

Valor padrão: ^[a-Za-Z_][a-Za-z0-9_]* (\. [a-zA-Z0-9 _] +) +$

Exemplo de valor padrão: Company.IssueType

Elementos filho

Elemento

Descrição

ALLOWEDVALUES

Opcional. Define uma lista de valores permitidos para o campo. Os valores permitidos são valores que estão disponíveis para seleção em uma lista de campos de formulários de itens de trabalho e no query builder. Você deve selecionar um desses valores.

ALLOWEXISTINGVALUE

Opcional. Define o campo para permitir que os valores existentes. Esse elemento permite que os valores de campo que já existem para ser usado, mesmo se elas não são válidas. Todos os novos valores de campo devem ser válidos.

CANNOTLOSEVALUE

Opcional. Define o campo não pode perder valor. Este elemento mantém o valor do campo atual e não pode ser limpo ou feita vazio.

CÓPIA

Opcional. Especifica outro campo que contém um valor a ser copiada para o campo atual.

PADRÃO

Opcional. Define um valor padrão para o campo.

VAZIO

Opcional. Define o campo vazio.

CONGELADO

Opcional. Define o campo como congelado. Um campo congelado não pode ser alterado para qualquer valor vazio após as alterações são confirmadas. No entanto, limpar manualmente o campo, salvar o item de trabalho e, em seguida, especifique um valor diferente.

HELPTEXT

Opcional. Define o texto exibido na dica de ferramenta para o campo.

CORRESPONDÊNCIA

Opcional. Define um padrão para o campo que o valor do campo deve corresponder.

NOTSAMEAS

Opcional. Especifica outro campo, o valor não pode ser idêntico ao valor do campo atual.

PROHIBITEDVALUES

Opcional. Define uma lista de valores proibidos para o campo.

READONLY

Opcional. Define o campo como somente leitura.

NECESSÁRIO

Opcional. Define o campo conforme necessário.

SERVERDEFAULT

Opcional. Especifica um componente de servidor fornecerá o valor do campo.

SUGGESTEDVALUES

Opcional. Define uma lista de valores sugeridos para o campo. Os valores sugeridos são valores que estão disponíveis para seleção em uma lista de campos de formulários de itens de trabalho e no query builder. Você pode inserir outros valores Além disso, para aqueles na lista.

VALIDUSER

Opcional. Especifica que a lista de valores permitidos deve consistir apenas usuários válidos do sistema.

QUANDO

Opcional. Especifica uma ou mais regras para aplicar ao campo atual quando outro campo tem um valor específico.

WHENCHANGED

Opcional. Aplica-se uma ou mais regras para o campo atual quando valor de um campo específico é alterado.

WHENNOT

Opcional. Aplica-se uma ou mais regras para o campo atual quando outro campo não tem um valor específico.

WHENNOTCHANGED

Opcional. Aplica-se uma ou mais regras para o campo atual quando o valor de um campo específico não é alterado.

Elementos pai

Elemento

Descrição

CAMPOS

Obrigatório. Contém as definições de campo de tipo de item de trabalho.

Comentários

FIELD(Definição) é um elemento filho obrigatório FIELDS (definição).

minOccurs = "1"

Você pode definir os campos de item de trabalho não mais do que 1.024 no mesmo conjunto de projeto de equipe, e você pode definir os campos não mais do que 1.024 reportável em todas as coleções de projeto de equipe. Para obter mais informações, consulte Adicionar e modificar os campos de Item de trabalho para a emissão de relatórios de suporte.

ObservaçãoObservação

Quando você adiciona um campo existente para um tipo diferente de item de trabalho, os valores atuais para os atributos reportável são usados.

Para outros requisitos e restrições de nomes de campo amigáveis e referência, consulte Convenções de nomenclatura para objetos de rastreamento de Item de trabalho. Para obter informações sobre como os campos de rótulo para fins de relatórios, consulte Adicionar e modificar os campos de Item de trabalho para a emissão de relatórios de suporte.

Não é possível definir um campo personalizado que começa com o System. prefixo. Você pode definir um campo usando o Microsoft. de prefixo, no entanto, essa prática não é recomendável porque ele pode impedir Team Foundation Server funcionalidade.

Para uma visão geral do objeto de rastreamento de item de trabalho de campo, consulte Trabalhando com campos de Item de trabalho.

Para uma visão geral de todos os sistema e os campos predefinidos que são definidos para o Microsoft Solutions Framework (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.

Nomes de referência de campo não podem ser renomeados. Lista de campos, renomeie o nome amigável do campo e alterar os atributos de campo usando o witadmin ferramenta de linha de comando. Para obter mais informações, consulte Gerenciando os campos de Item de trabalho [witadmin].

Para obter informações sobre como os campos são usados em conjuntos de projeto de equipe, consulte Resolvendo conflitos de esquema que estão ocorrendo no Data Warehouse e Adicionar e modificar os campos de Item de trabalho para a emissão de relatórios de suporte.

Exemplo

<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
   <HELPTEXT>Type of work involved</HELPTEXT>
   <SUGGESTEDVALUES>
      <LISTITEM value="Development"/>
      <LISTITEM value="Testing"/>
      <LISTITEM value="Requirements"/>
      <LISTITEM value="Design"/>
      <LISTITEM value="Deployment"/>
      <LISTITEM value="Documentation"/>
   </SUGGESTEDVALUES>
</FIELD>

Consulte também

Referência

Gerenciando os campos de Item de trabalho [witadmin]

Conceitos

Convenções de nomenclatura para objetos de rastreamento de Item de trabalho

Usando os campos de sistema e definidas pelos modelos de processo do MSF

Personalizando o controle de dados, formulários, fluxo de trabalho e outros objetos do projeto

Trabalhando com campos de Item de trabalho

Outros recursos

Índice de definições de elemento XML para tipos de itens de trabalho

Histórico de alterações

Date

History

Motivo

Janeiro de 2011

Simplificado de conteúdo e removidos os links para tópicos que foram removidos.

Aprimoramento de informações.