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

Artigo
08/01/2011

Para adicionar ou remover um campo de dados de um tipo de item de trabalho, você pode modificar o arquivo de definição de tipo de item de trabalho. Você deve adicionar ou remover FIELD elementos a partir do FIELDS seção, bem como o layout e os controles definidos no FORM seção. Depois que você tiver modificado o tipo de item de trabalho, você pode importar o arquivo XML e começar a usar o tipo de item de trabalho atualizados.

Importante
Campos do tipo de item de trabalho são gerenciados para uma coleção de projeto de equipe. Para obter mais informações, consulte Gerenciando os campos de Item de trabalho [witadmin].

Neste tópico

Exportar e abra o arquivo de definição de tipo de Item de trabalho
Adicionar um campo
Remover um campo
Importar o arquivo de definição de tipo de Item de trabalho
Verifique se as alterações aparecem no formulário de Item de trabalho

Permissões necessárias

Para executar este procedimento, você deve ser um membro da Os administradores do Team Foundation grupo ou um membro da Administradores de projeto grupo para o projeto. Para obter mais informações, consulte Permissões de Team Foundation Server.

Exportar e abra o arquivo de definição de tipo de Item de trabalho

Para exportar e abra o arquivo de definição de tipo de item de trabalho

Execute uma das etapas a seguir com base no escopo de personalização que você deseja executar:

Se você estiver modificando um tipo de item de trabalho para um único projeto:
1. Execute witadmin exportwitd para exportar o arquivo XML para o tipo de item de trabalho que você deseja modificar. Digite o seguinte comando, substituindo os seus dados com os argumentos mostrados:
```
witadmin exportwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
  Para obter mais informações, consulte Exportar e importar os tipos de Item de trabalho a partir de um projeto existente.
2. Em Visual Studio, clique em arquivo, clique em Abrire em seguida, clique em arquivo.
  
  O Abrir arquivo de caixa de diálogo aparece.
3. Em Examinar, mover para o local onde você exportar o arquivo.
Se você estiver modificando um tipo de item de trabalho para personalizar um modelo de processo:
1. Encontre o local onde você baixou o modelo de processo.
2. Selecione o arquivo XML de tipo de item de trabalho que você deseja atualizar e clique em Abrir. Quando solicitado sobre terminações de linha, clique em não.

Adicionar um campo

Para adicionar um campo para um tipo de item de trabalho

Localize a seção do arquivo XML a seguir:
```
<FIELDS>
```

Criar um campo de seqüência de caracteres, digitando o seguinte XML mostrado como realçado no exemplo a seguir:

<FIELDS>
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="Dimension">
</FIELD>

Observação
O nome de referência, ou refname, é o nome programático para o campo. Todas as outras regras devem se referir a isso refname. Para obter mais informações, consulte Convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

Localize a seção do arquivo XML que descreve o formulário de item de trabalho:
```
<FORM>
```

Localizar as seguintes linhas no <FORM> seção:

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  </Column>
</Group>

Inserir um controle para exibir o campo digitando o seguinte XML mostrado como realçado no exemplo a seguir:

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
    <Control Type="FieldControl" FieldName="MyCompany.MyProcess.IssueLevel" Label="Issue Level" LabelPosition="Left" />
  </Column>
</Group>

Sobre o arquivo menu, clique em Salvar < nome do arquivo >. XML para salvar as alterações no arquivo XML.
Para importar o novo tipo de item de trabalho para um único projeto, consulte importar o arquivo de definição de tipo de Item de trabalho. Para adicionar o tipo de item de trabalho para o seu modelo de processo, consulte Adicionar um tipo de Item de trabalho a um modelo de processo.

Remover um campo

Para remover um campo de um formulário de item de trabalho

Localize e exclua a definição do campo que deseja remover do tipo de item de trabalho. O exemplo a seguir mostra um campo chamado "Nível de problema". Para remover este campo, você pode excluir a seção de campo a seguir:

Observação
A seção de campo em seu arquivo XML não pode conter todos os elementos no código a seguir. No entanto, se você personalizou o campo de tipo de item de trabalho para incluir esses elementos, eles devem ser também excluídos.

<FIELDS>
. . .
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="dimension">
<HELPTEXT>Describes the issue level to which this special task belongs.</HELPTEXT>
  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHEN>
  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Process Management" />
      <LISTITEM value="Planning" />
      <LISTITEM value="Execution" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHENNOT>
</FIELD>
…
</FIELDS>

Encontrar o <Layout> seção onde o controle para o campo de item de trabalho é definido e excluir as seções apropriadas para remover o campo. As seções destacadas a seguir são exemplos deve buscar.

<Group Label="Classification">
  <Column PercentWidth="50">
    <Group>
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
  <Column PercentWidth="50">
    <Group>
      <Column PercentWidth="100">
        <Control Type="FieldControl" FieldName="MyCompany.MyProcess.IssueLevel" Label="IssueLevel" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
</Group>

Sobre o arquivo menu, clique em Salvar < nome do arquivo > para salvar as alterações no arquivo XML.

Importar o arquivo de definição de tipo de Item de trabalho

Para importar o arquivo de definição de tipo de item de trabalho

Execute witadmin importwitd para importar o arquivo XML para o tipo de item de trabalho que você modificou. Digite o seguinte comando, substituindo os seus dados com os argumentos mostrados:
```
witadmin importwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
Para obter mais informações, consulte Exportar e importar os tipos de Item de trabalho a partir de um projeto existente.

Verifique se as alterações aparecem no formulário de Item de trabalho

Para verificar as alterações, importadas para um único projeto.

Em Team Explorer, o botão direito do mouse no nó do projeto da equipe que contém a definição de tipo de item de trabalho modificado, e clique em Atualizar.

As atualizações mais recentes são baixadas do servidor, incluindo as alterações que você acabou de ser importado. Aguarde alguns segundos até que o Itens de trabalho nó for atualizada. Nós que ainda estão sendo carregados exibem a palavra trabalhando.
Criar um item de trabalho usando o tipo de item de trabalho que você modificou clicando com o Work Items o nó, apontando para Add Work Iteme clicando em tipo de item de trabalho.

O item de trabalho é criado a partir do tipo de item de trabalho que você tenha alterado.
Verifique se que as alterações feitas por você aparece no formulário de item de trabalho.
Clique em Fechar para fechar o novo item de trabalho. Clique em não quando for solicitado para salvar o item de trabalho.

Consulte também

Referência

Personalizando e tipos de Item de trabalho Gerenciando [witadmin]

Elemento FIELD (definição)

Referência de elemento do controle XML

Conceitos

Trabalhando com campos de Item de trabalho

Outros recursos

A definição de campos de Item de trabalho