As convenções de nomenclatura para objetos de rastreamento de Item de trabalho

Todos os objetos deacompanhamento do trabalho itemestão associados um ou mais nomes. A maioria tem nomes para exibição amigável e todos, mas os tipos de item de trabalho e listas globais estão associadas a nomes de referência.Um nome amigável é um exclusivo, o usuário-visível identificador para um campo que você usa para garantir a consistência em todos os projetos de equipe e tipos de item de trabalho em umacoleçãodo projeto. O nome de referência é usado internamente pelo Team Foundation Server e não pode ser alterado depois que ela está definida.

A tabela a seguir resume os requisitos de nomeação que devem ser atendidos para cada trabalho item acompanhamento objeto.

objeto acompanhamentode itemde trabalho	Nome de referência	Nome amigável
Tipo de item de trabalho	Não aplicável.	O nome de cada tipo de item de trabalho pode ter até 255 caracteres Unicode e deve ser exclusivo dentro de um projetode equipe.
campo do itemde trabalho	Necessário.Consulte requisitos de nome de referência.	Os nomes de campo podem ser de até 128 caracteres Unicode e devem ser exclusivos dentro de um projetode equipecoleção.
Tipo de link	Necessário.Consulte requisitos de nome de referência.	Você define dois nomes amigáveis para cada tipo de link: encaminhar o nome e o nome inversa.Esses nomes podem ter até 128 Unicode caracteres e devem ser exclusivos para todos os tipos de link definidos para um projetode equipecoleção.
Category (Categoria)	Necessário.Consulte requisitos de nome de referência.	Nomes amigáveis de categoria podem ser de até 128 caracteres Unicode e devem ser exclusivos dentro de um projetode equipe.
Lista global	Não aplicável.	O nome de cada lista global pode ter até 254 caracteres do Unicode e deve ser exclusivo dentro de um projetode equipecoleção.

Conteúdo do Tópico

• Requisitos de nome amigável

• Requisitos de nome de referência

• Requisitos de portabilidade e nomes de referência de campo

• Exemplos de nomes de referência de campo

Requisitos de nome amigável

Com os requisitos resumidos na tabela listada anteriormente neste tópico, os nomes amigáveis que você define devem atender aos seguintes requisitos:

• Nomes não devem estar vazios.

• Nomes não podem ter espaço em branco à direita ou à esquerda.

• Nomes não podem conter caracteres de barra invertida (\).

• Nomes de campo não podem conter os seguintes caracteres: barra invertida (\), ponto (.) e abertura e fechamento quadrado colchetes ([]).

• Nomes não podem conter dois ou mais espaços em branco consecutivos.

Requisitos de nome de referência

Você deve definir um nome de referência sempre que você adicionar ou criar um itemde trabalho decampo, tipo de link ou categoria. Todos os nomes de referência podem ser de até 70 caracteres Unicode .

Você pode definir um nome de referência usando caracteres alfanuméricos, caracteres sublinhados e hífens.Cada nome de referência deve conter pelo menos um período (.), mas nenhum período pode aparecer no início ou final de um nome.Um nome de referência não pode começar com um número ou um sublinhado, e não pode ter vários hifens consecutivos, tais como (-).

Portabilidade e nomes de referência de campo

A linguagem de definição de tipo de item de trabalho inclui o conceito de um nome de referência do campo .Nomes de referência de campo podem ajudá-lo a definições de portar entre Team Foundationcoleções de projeto e também permitir integrações de terceiros localizar e fazer referência a campos específicos. Esses nomes são globalmente exclusivos, assim como um namespace no.NET Framework aplicativo é globalmente exclusivo.

Nomes de referência de campo não podem ser renomeados.Se, por exemplo, você alterou o nome do campo "Título" para "Cabeçalho", o nome de referência de campo desse campo permanecerá o mesmo.Integrações e representações internas dos campos devem usar o nome de referência de campo em vez de acordo com o nome do campo .

O namespace do sistema é usado somente para definir todos os principais campos de sistema que são obrigatórios para Team Foundation funções do sistema.Team Foundation Serverimpede que você crie seu próprio System.X campo porque ele pode impedir Team Foundation Server a funcionalidade.

O Microsoft namespace é usado para definir os campos que são definidos em uma definição de tipo de item de trabalho de ummodelode processode Microsoft Solutions Framework Framework (MSF). Team Foundation Servernão impede que você criar seu próprio Microsoft.X de campo.No entanto, essa prática é altamente desencorajada porque ele pode impedir Team Foundation Server funcionalidade

Clientes e parceiros podem criar seus próprios espaços para nome do campo para tipos de item de trabalho personalizados.

Para obter descrições dos campos do sistema e os campos definidos pelo MSF for Agile Software Development - v 5.0, consulte Referência de campos de item de trabalho para o Visual Studio ALM.

Exemplos de nomes de referência de campo

Os exemplos a seguir mostram válidonomes de referência decampo , em vários espaços para nome.

Exemplos de Namespace do sistema

System.ID

System.title

System.CreatedBy

System.CreationDate

System.ChangedBy

System.ChangedDate

System.State

System. Reason

Exemplos do Namespace Microsoft

Microsoft.Common.status

Microsoft.Common.Priority

Microsoft.Scheduling.Duration

Microsoft.Scheduling.PercentComplete

Microsoft.Testing.TestCaseName

Exemplos em outros espaços

Clientes e parceiros também podem definir seus próprios espaços para nome para dar suporte a seus tipos de item de trabalho personalizados.Por exemplo, a empresa fictícia, a Trey Research pode definir os seguintes tipos de item de trabalho personalizados:

TreyResearch.Common.Severity

TreyResearch.Common.Phase

TreyResearch.RiskManagement.RiskType

TreyResearch.RiskManagement.Resolution

A empresa de software fictícia a.Datum Corporation pode definir os seguintes tipos de item de trabalho:

A_Datum.Common.BusinessPriority

A_Datum.bug.FoundInPhase

A_Datum.bug.FixInPhase

Consulte também

Referência

Elemento FIELD (definição)

Conceitos

Personalizar dados de acompanhamento de projeto, formulários, fluxo de trabalho e outros objetos