Gerenciando os campos de Item de trabalho

Artigo
08/01/2011

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

deletefield: Exclui o campo especificado.
listfields: Lista os atributos de todos os campos ou um campo especificado.
indexfield: Ativa ou desativa a indexação do campo especificado. 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.

changefield: Altera os atributos de um ou mais de um campo, como, por exemplo, os atributos para emissão de relatórios de depósito de dados ou a capacidade de sincronizar um campo que contém os nomes de pessoa, um nome amigável do campo. Quando a sincronização estiver ativada, o campo é atualizado conforme as atualizações são feitas ao Active Directory ou um grupo de trabalho. Para obter informações sobre como usar campos para a emissão de relatórios, consulte Trabalhando com campos de Item de trabalho.

Importante
Quando você atualiza uma versão anterior para a versão atual, todos os campos internos do syncnamechanges atributo está definido como true para todos os campos de seqüência de caracteres que contêm nomes de pessoa. No entanto, você deve atribuir manualmente o atributo para quaisquer campos personalizados que você pode usar para armazenar nomes de pessoa e que você deseja ter sincronizado. For more information, see Atualizando os campos de nome de pessoa personalizados para sincronizar com o Active Directory ou grupos de trabalho.

Quando você atualiza uma versão anterior para a versão atual, todos os campos internos do syncnamechanges atributo está definido como true para todos os campos de seqüência de caracteres que contêm nomes de pessoa. No entanto, você deve atribuir manualmente o atributo para quaisquer campos personalizados que você pode usar para armazenar nomes de pessoa e que você deseja ter sincronizado. For more information, see Atualizando os campos de nome de pessoa personalizados para sincronizar com o Active Directory ou grupos de trabalho.

O witadmin ferramenta de linha de comando está localizada em unidade:\Arquivos de Programas\Microsoft 10.0\Common7\IDE de Visual Studio no computador cliente que executa o Team Explorer.

Para obter mais informações sobre campos, consulte A definição de campos de Item de trabalho.

Observação
Você pode criar e modificar campos de item de trabalho usando o Editor de processo, uma ferramenta de alimentação para Visual Studio. Essa ferramenta não é suportada. Para obter mais informações, consulte a seguinte página no site da Microsoft: Team Foundation Server Power Tools em abril de 2010.

Permissões necessárias

Para a coleção de projeto de equipe onde os campos de tipo de item de trabalho são definidos, você deve ter as seguintes permissões definidas:

Lista de campos, você deve ser um membro do leitores do grupo ou ter sua Exibir itens neste aceno de trabalhoe a permissão definida como Permitir
Para excluir ou renomear campos ou alterar as características de emissão de relatórios de um campo, você deve ser um membro da Os administradores do Team Foundation o grupo de segurança ou o Administradores de projeto o grupo de segurança.

For more information, see Permissões de Team Foundation Server and Team Foundation Server de grupos, permissões e funções.

Observação
Mesmo se fizer logon com permissões administrativas, você deve abrir uma janela de Prompt de comando com privilégios elevados para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir uma janela de Prompt de comando com privilégios elevados, clique em Iniciar, com o botão direito o Prompt de comandoe em seguida, clique em Executar como administrador. Para obter mais informações, consulte o site da Microsoft: Controle de acesso do usuário.

Mesmo se fizer logon com permissões administrativas, você deve abrir uma janela de Prompt de comando com privilégios elevados para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir uma janela de Prompt de comando com privilégios elevados, clique em Iniciar, com o botão direito o Prompt de comandoe em seguida, clique em Executar como administrador. Para obter mais informações, consulte o site da Microsoft: Controle de acesso do usuário.

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

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

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

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

Parâmetros

Parameter	Description
/collection:CollectionURL	Especifica o URI da coleção de projeto de equipe. O formato para o URI é o seguinte: http: / /Nome_do_servidor: port/VirtualDirectoryName/NomeDaColeta Se nenhum diretório virtual é usado, o formato para o URI é o seguinte: http: / /Nome_do_servidor: port / NomeDaColeta
/n:RefName /n:Name	O nome de referência de um campo de tipo de item de trabalho.
/index	Especifica para ativar ou desativar a indexação do campo especificado. Especificar on para habilitar a indexação e off para desativar a indexação.
/name:NewName	Especifica o novo nome para o campo.
/syncnamechanges	Especifica a usar o campo de item de trabalho para armazenar nomes e atualizar conforme são feitas alterações no Active Directory ou um grupo de trabalho. Esta opção é válida somente quando um campo com o tipo de dados de seqüência de caracteres é especificado para o typename. Especificar true para habilitar a sincronização para o campo de dados, especifique false para desabilitar a sincronização para o campo de dados.
/reportingname:ReportingName	Especifica o nome do campo no armazém de dados a ser usado para a emissão de relatórios.
/reportingrefname:ReportingRefName	Especifica o nome do campo de referência no armazém de dados a ser usado para a emissão de relatórios.
/reportingtype:Type	Especifica como o campo é usado no warehouse para geração de relatórios. Os seguintes valores são válidos: dimension:Usado para os campos DateTime, seqüência ou inteiro. detail:Usado para os campos de número inteiro, duplo, seqüência ou DateTime. measure:Usado para os campos de duplos e um inteiro. O tipo de agregação padrão é a soma. Você pode especificar outro tipo de agregação usando o formula parâmetro. disable:Usada para desabilitar o reportability no campo. For more information, see Trabalhando com campos de Item de trabalho.
/reportingformula:Formula	Especifica a fórmula de agregação para ser usado quando o campo é indicado como um measure. A fórmula com suporte somente é sum.
/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	Desativa o solicita a confirmação.
/? or help	Exibe ajuda sobre o comando na janela do Prompt de comando.

Comentários

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

A regra VALIDUSER é especificada em todos os tipos de item de trabalho
A regra VALIDUSER é especificada para um tipo de item de trabalho
A regra ALLOWEDVALUES é especificada para um tipo de item de trabalho e essa regra tem um critério de filtro que exclui grupos

For more information, see Todas as referências de elementos do campo XML.

Para obter um resumo dos campos de sistema que estão indexados, consulte Usando os campos de sistema e definidas pelos modelos de processo do MSF.

Examples

A menos que especificado em contrário, os valores a seguir aplicam-se em cada exemplo:

URI para a coleção de projeto de equipe: http://AdventureWorksServer:8080/AWTeam/Collection1
Nome do campo de item de trabalho: AdventureWorks.Field
Padrão de codificação: UTF-8

Campos de lista

O comando a seguir exibe informações sobre cada campo definido para Collection1 no servidor AdventureWorksServer:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

O comando a seguir exibe as informações de campo para o campo especificado AdventureWorks.Field usada por Collection1:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

O comando a seguir exibe todos os campos que não está usando o Collection1:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused

Renomear um campo

O comando a seguir altera o nome amigável do campo referenciado AdventureWorks.Field para NewFieldName para Collection1:

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName

Alterar o relatório como o valor de um campo

O comando a seguir especifica que a capacidade de relatar o tipo do campo DateTime AdventureWorks.CreatedOn para a dimensão. Dados do campo insere o depósito e bancos de dados do Analysis Services para que possa ser usado para filtrar relatórios.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension

O comando a seguir especifica a capacidade de informar o tipo do campo AdventureWorks.Field para medir duplo. Todas as medidas são agregadas por soma.

witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure

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

O comando a seguir habilita a sincronização para o AW de campo do item de trabalho.CustomerName definido para Collection1 sobre o AdventureWorksServer.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true

Excluir um campo

O comando a seguir exclui o campo AdventureWorks.Field Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

Consulte também

Compartilhar via