Gerenciar campos de item de trabalho

Artigo
03/22/2013

Você pode gerenciar os campos de tipo de item de trabalho que são definidos para uma coleção de projeto de equipe usando os seguintes comandos de witadmin :

changefield: Modifique um ou mais atributos de um campo.Quando você altera um dos seguintes atributos, você alterá-lo para todos os tipos de itens de trabalho e projetos de equipe no projeto de equipe a coleção:

Tipo de dados para PlainText ou campos de HTML .

Importante
Quando você atualiza Team Foundation Server de uma versão anterior para a versão atual, a atribuição de tipo para o campo de Descrição () System.Description ele é convertido automaticamente de PlainText a HTML.Com o comando de changefield , você pode restaurar o conteúdo desse campo para exibir texto sem formatação.

Nome amigável que exibe a consulta de item de trabalho.Este nome pode ser diferente do exibido no formulário de item de trabalho.
Atributos de relatório que inclui o nome do campo como aparece em um relatório, o nome do relatório de referência, e no tipo de relatório.
Sincronização com o Active Directory - você pode ativar/desativar de sincronização de campos de nome da pessoa.

deletefield: Exclui o campo especificado.
indexfield: Indexar da transforma para ativar/desativar o campo especificado.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.
listfields: Lista os atributos para todos os campos ou um campo especificado.

Para executar a ferramenta de linha de comando witadmin , abra uma janela de prompt de comando onde Visual Studio ou Team Explorer sejam instalados e insira:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Em uma edição de 64 bits do Windows, substitua %programfiles% com %programfiles(x86)%.

Para obter uma visão geral dos campos definidos nos modelos de processo padrão fornecidos com Team Foundation Server, consulte Referência de campos de item de trabalho para o Visual Studio ALM.

Observação
Você pode criar e modificar campos de item de trabalho usando o editor do processo, uma ferramenta elétrica para Visual Studio.Essa ferramenta não é suportada.Para obter mais informações, consulte a seguinte página no site da Microsoft: Ferramentas poderosas do Team Foundation Server.

Requisitos

Para listar campos, você deve ter sua permissão de Visualizar informações em nível de projeto para o projeto de equipe no conjunto da coleção Permitir.
Para renomear ou excluir campos ou modificar um atributo de um campo, você deve ser um membro do grupo de segurança Administradores do Team Foundation ou grupo de segurança de Administradores da Coleção de Projetos .

Para obter mais informações, consulte Team Foundation Permissões do servidor e Team Foundation Funções, permissões e grupos do servidor padrão.

Observação
Mesmo se você fizer logon com permissões administrativas, você deve abrir uma janela de prompt de comando alto para executar esta função em um servidor que esteja executando Windows Server 2008.Para abrir uma janela de prompt de comando, escolha Iniciar, abra o menu de atalho de Prompt de comando , e então escolha Executar como administrador.Para obter mais informações, consulte o site da Microsoft: Controle de acesso de usuário.

Mesmo se você fizer logon com permissões administrativas, você deve abrir uma janela de prompt de comando alto para executar esta função em um servidor que esteja executando Windows Server 2008.Para abrir uma janela de prompt de comando, escolha Iniciar, abra o menu de atalho de Prompt de comando , e então escolha Executar como administrador.Para obter mais informações, consulte o site da Microsoft: Controle de acesso de usuário.

witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/type:PlainText | HTML] [/noprompt]

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

Parâmetros

Parâmetro	Descrição
/collection:CollectionURL	Especifica a URL a coleção de projeto de equipe.O formato para o URI é o seguinte: http://ServerName:Port/VirtualDirectoryName/CollectionName Se nenhum diretório virtual é usado, o formato para o URI é o seguinte: http://ServerName:Port/CollectionName
/n:RefName /n:Name	O nome da referência de um campo de tipo de item de trabalho.
/index	Especifica para ativar ou desativar a indexação para o campo especificado.Especificar on para ativar a indexação e o off para desativar a indexação.
/name:NewName	Especifica o novo nome para o campo.
/syncnamechanges	Especifica para usar o campo de item de trabalho para armazenar nomes e atualizá-los para como as alterações são feitas no Active Directory ou em um grupo de trabalho.Essa opção é válido somente quando um campo com o tipo de dados de cadeia de caracteres é especificado para typename. Especificar true para habilitar a sincronização para o campo de dados, especifique false para desativar a sincronização para o campo de dados.
/reportingname:ReportingName	Especifica o nome do campo da data warehouse ser usada para relatórios.
/reportingrefname:ReportingRefName	Especifica o nome da referência do campo da data warehouse ser usada para relatórios.
/reportingtype:Type	Especifica como o campo é usado no depósito de relatório.Os seguintes valores são válidas: dimension: usado para os campos inteiro, da cadeia de caracteres, ou DateTime. detail: usado para os campos inteiro, do tipo double, da cadeia de caracteres, ou DateTime. measure: usado para os campos inteiro e de double.O tipo padrão de agregação é a soma.Você pode especificar um outro tipo de agregação usando o parâmetro de formula . disable: usado para desativar o reportability no campo. Para obter mais informações, consulte Trabalhando com campos de Item de trabalho.
/reportingformula:Formula	Especifica a fórmula de agregação a ser usada quando o campo é relatado como measure.A única fórmula é suportado sum.
/type:HTML \| PlainText	Especifica para converter os conteúdos do campo de PlainText a HTML ou de HTML a PlainText.Você pode especificar esta opção somente para os campos cujos a atribuição de tipo é PlainText ou HTML.Consulte Elemento FIELD (definição).
/unused	Lista todos os campos que não são usados por qualquer projeto de equipe definido na coleção de projeto de equipe.
/noprompt	As desativa verificação solicitam para a confirmação.
/?or help	Exibe ajuda sobre o comando na janela do prompt de comando.

Comentários

Campos indexados

Um índice de consulta é criado com base nos campos que têm a indexação ativada.Isso melhora o índice tempo de resposta para executar consultas que incluem campos indexados.

Por padrão, os campos são indexados seguintes: Atribuído a, DAta de Criação, Modificada por, Estado, Motivo, ID de área, identificação de iteração, e tipo de item de trabalho.Se houver outros campos que sua equipe usa frequentemente nas consultas, você pode adicioná-los ao índice da consulta.

Sincronizando nomes da pessoa com o Active Directory

Você deve manualmente habilitar a sincronização de todos os campos de item personalizados de trabalho que são usados para atribuir os nomes da pessoa que referenciam o Active Directory.Você deve habilitar a sincronização para cada campo para cada coleção de projeto de equipe que contém os campos personalizados.

Todos os campos de referência do sistema que mostram pessoa- nomes têm o atributo syncnamechanges definido como true. Esses incluem campos System.AuthorizedAs, System.AssignedTo, System.ChangedBy e System.CreatedBy. Sincronização em habilitado para cada campo de nome da pessoa que é definido em um dos modelos padrão do processo.Para obter mais informações, consulte Atribuições e referência de campos de fluxo de trabalho.

Depois que a sincronização é ativada, o campo não mostra uma cadeia de caracteres estático.Em vez disso, o campo mostra o nome associado com uma conta de usuário.Quando você altera o nome de usuário no Active Directory ou no grupo de trabalho, um campo com syncnamechanges definido como true mostra automaticamente o novo nome.

Quando você atribui o atributo de syncnamechanges a um campo de cadeia de caracteres, o campo aceita sempre nomes de usuário válidos.No entanto, o campo não permite nomes de grupo que são armazenados em Team Foundation Server ou no Active Directory se qualquer uma das seguintes condições for true:

A regra de VALIDUSER é especificada por todos os tipos de itens de trabalho
A regra de VALIDUSER é especificada para um tipo de item de trabalho
A regra de ALLOWEDVALUES é especificada para um tipo de item de trabalho, e essa regra tem critérios de um filtro que exclui grupos

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

Atributos que você pode alterar para cada tipo de item de trabalho

Você altera os seguintes atributos ou valores definidos para um campo alterando a definição de tipo de item de trabalho que o campo aparece:

Nome que exibe no formulário de item de trabalho.Consulte Referência de elemento do controle XML.
Texto de ajuda.Consulte Definir o texto da Ajuda para um campo de item de trabalho.
Valores permitidos ou itens em uma lista de opções ou menu suspenso.Consulte Definir listas de usuários, listas de opções e listas globais.

Exemplos

Salvo indicação caso contrário, os seguintes valores se aplicam em cada exemplo:

URI para a coleção de projeto de equipe: http://AdventureWorksServer:8080/tfs/DefaultCollection
Nome de campo de item de trabalho: AdventureWorks.Field
Codificação padrão: UTF-8

Campos de lista

Use witadmin listfields para ver o conjunto de campos em uso, selecione um para adicionar a um tipo de item de trabalho.Além disso, você pode listar as atribuições de atributo definidas para um campo específico e determinar quais campos são usados por que a equipe se projetos.

Exibir os atributos de um campo de item de trabalho

Digite o seguinte comando listar os atributos definidos para um campo especificado, como Microsoft.VSTS.Common.Issue.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
```
Informações do campo e de atributo aparece para o campo denominado, como mostrado neste exemplo.
```
Field: Microsoft.VSTS.Common.Issue
Name: Issue
Type: String
Reportable As: dimension
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)
Indexed: False
```
Uso do parâmetro indica o nome de cada projeto e de tipo de item de trabalho onde o campo é usado.Para obter mais informações sobre os atributos de campo, consulte Referência de campos de item de trabalho para o Visual Studio ALM.

Listar todos os campos em uma coleção de projeto de equipe

Digite o seguinte comando listar todos os campos definidos para uma coleção de projeto de equipe.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
```
Informações de campo para todos os campos para a coleção de projeto chamado aparece.Consulte Referência de campos de item de trabalho para o Visual Studio ALM.

Campos de lista que não estão sendo usados

Digite o seguinte comando listar os campos que não estão sendo usados na coleção de projeto de equipe por qualquer tipo de item de trabalho.

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused

Informações do campo e de atributo aparece para cada campo que não está sendo usado, como mostrado neste exemplo.

Field: Microsoft.VSTS.CMMI.TaskType
Name: Task Type
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Flag
Name: Flag
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Progress
Name: Progress
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Renomear um campo

Você pode alterar o nome amigável de um campo de item de trabalho para atender às convenções de nomenclatura que sua equipe usa.Observe que o novo nome é aplicado a todos os tipos de itens de trabalho que referenciam o campo alterado em todos os projetos de equipe na coleção de projeto.O nome amigável quando você definir critérios de filtragem em uma consulta de item de trabalho.O nome que aparece em um formulário de item de trabalho pode ser diferente do nome amigável definido para o campo.

Para renomear um campo de item de trabalho

Digite o seguinte comando renomear o nome amigável atribuído a Microsoft.VSTS.Common.Rank à classificação importante.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

No y tipo de mensagem de confirmação e pressione ENTER.Espere até que você recebeu a seguinte mensagem:

Field renamed.

Para verificar as alterações importados para um único projeto

Em Team Explorer, escolha Atualizar.

As atualizações de segurança mais recentes são baixados do servidor, que incluem as alterações que você fez apenas para o nome do campo.Aguarde alguns segundos pela atualização para concluir.
Escolha Nova Consulta para criar uma consulta.
No editor de consulta, escolha o link de Clique aqui para adicionar uma cláusula para adicionar uma linha, selecione a célula em branco de Campo , e na célula, dependendo do tipo.A seguinte mensagem que aparece acima da lista de resultados.Esta mensagem indica que a classificação não pode ser encontrada.

Executar a consulta para ver os resultados da consulta. TF51005: A consulta referencia um campo que não existe.O erro é causado por <<Rank>>.
Exclua a classificação do valor da célula de Campo , e digite a classificação importante na célula.
<> Selecione a célula de Operador , e o tipo - 1 para a célula de Valor .
Na barra de ferramentas de Consulta , escolha Executar.
Abra o menu de atalho para qualquer linha nos resultados e selecione Opções de Coluna.Role para baixo na lista de Disponívelcolunas .Observe que o campo de Classificar não estiver mais atual mas o campo de Classificação importante estar presente.
Classificação importante selecione na caixa de Colunas disponíveis , e clique no botão de > (adicionar colunas selecionadas).Escolha OK.

Observe que o nome amigável para Microsoft.VSTS.Common.Rank esteve renomeado de classificação à classificação importante em todo o construtor de consultas e listam os resultados.
Feche a consulta.Escolha Não quando você for solicitado a salvar a consulta.
Crie um novo item de trabalho de tarefas.Escolha o link de Itens de trabalho , e então escolha Tarefa.

Este item de trabalho é criado de tipo de item de trabalho que você modificou e importou.
Observe, na caixa de Status , que o rótulo para o campo renomeado, Classificar, não é alterado.Isso ocorre porque os rótulos no campo em formulários de item de trabalho são do escopo para o projeto de equipe pai e são independentes do nome do campo especificado apenas amplo.

Observação

Para obter mais informações sobre como alterar rótulos de campo em formulários de item de trabalho, consulte Alterar o rótulo de um campo.
Feche a nova tarefa e escolha Não quando você for solicitado a salvar o item de trabalho.

Observação
Para obter mais informações sobre como alterar rótulos de campo em formulários de item de trabalho, consulte Alterar o rótulo de um campo.

Altere o relatório como o valor de um campo

O comando a seguir especifica a capacidade para relatar o tipo de campo AdventureWorks.CreatedOn DateTime para dimensionar.Os dados deste campo incorporam os bancos de dados de serviços de depósito e análise de modo que eles possam ser usados para filtrar relatórios.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

O comando a seguir especifica a capacidade para relatar o tipo de campo vezes AdventureWorks.Field para abranger.Todas as medidas são agregadas pela soma.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Habilitar a sincronização de um campo de nome pessoa- personalizado

O comando a seguir permite que a sincronização para o campo AW.CustomerName de item de trabalho definida para Collection1 no AdventureWorksServer.

Verifique o tipo de dados do campo que você deseja converter

Verifique o tipo de dados atribuído ao campo, como MyCompany.CustomerName, que você deseja sincronizar inscrevendo o seguinte comando:
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
```

Ativar sincronização

Para habilitar a sincronização para um campo pessoa- chamado, digite o seguinte comando, substituindo os dados para os argumentos que são mostradas aqui:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
```
O seguinte aviso de confirmação aparecer:

This will change properties for field {0} on the Team Foundation Server.Do you want to continue?
Digite 0 para confirmar que você deseja alterar o campo, ou 1 para cancelar a solicitação.

Se a solicitação de alteração for bem sucedida, a seguinte mensagem de confirmação aparecer:

The field was updated.

Se a solicitação de alteração falhar, uma mensagem de erro aparece.Os erros mais comuns que podem ser feitos estão tentando alterar um campo de referência do sistema, ou estão tentando alterar um campo de um tipo de dados diferente da cadeia de caracteres.Essas operações não são suportadas.

Excluir um campo

Antes de excluir um campo, verifique se o campo não está em uso.Se o campo está em uso, primeiro você deve remover o campo dos tipos de itens de trabalho que usam o antes de excluir a coleção de projeto de equipe.O comando a seguir exclui o campo AdventureWorks.Field de Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Verifique se um campo não está em uso

Digite o seguinte comando, especificando o nome da referência para o campo de item de trabalho, como MyCompany.MyProcess.MyField.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField
```
Nas informações exibidas para o campo, verifique se o valor para Use é “Not In Use” maneira como neste exemplo.
```
Field: MyCompany.MyProcess.MyField
Name: MyField
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False
```
Se o campo de Use indica que o campo está em uso, então você deve excluí-lo de cada tipo de item de trabalho para cada projeto de equipe que está listado.Por exemplo, o campo de Microsoft.VSTS.TCM.SystemInfo indica que está sendo usado pelos tipos de itens de trabalho de defeito de erro e de código para quatro projetos: Arroyo, deserto, palma, e molas.
```
Field: Microsoft.VSTS.TCM.SystemInfo
Name: System Info
Type: Html
Reportable As: None
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)
Indexed: False
```
Antes que você possa excluir este campo, você deve remova-o de cada um dos tipos de itens de trabalho listados para cada projeto de equipe que é definido.Para remover o campo, você altera a definição para o tipo de item de trabalho excluir elementos de FIELD e de Control que contém o nome da referência do campo.Consulte Personalizar e gerenciar tipos de item de trabalho [witadmin], Elemento FIELD (definição), e Referência de elemento do controle XML.

Excluir um campo de uma coleção de projeto de equipe

Digite o seguinte comando para excluir o campo de MyCompany.MyProcess.MyField, e escolha ENTER.
```
witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
```
Entre em y no aviso de confirmação para concluir esta etapa.

Consulte também

Conceitos

Resolver conflitos de esquema que estão ocorrendo no data warehouse

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

Referência de campos de item de trabalho para o Visual Studio ALM

Referência a campos Reportable para ALM de Visual Studio

Outros recursos

witAdmin: personalizar e gerenciar objetos para monitorar itens de trabalho

Compartilhar via