Ler em inglês

Compartilhar via

Adicionar um campo e alterar o Layout de um tipo de Item de trabalho existente

  • Artigo

Para controlar dados adicionais para um item de trabalho, você pode adicionar um campo para um tipo de item de trabalho, o exibe no formulário de item de trabalho, e o torna reportável.Você também pode alterar o layout de um formulário de item de trabalho melhor as capacidades às necessidades da equipe.Neste tópico, Julia e Peter, membros da equipe de fibra de Fabrikam, personalizam dois tipos diferentes de itens de trabalho para suportar suas metas de rastreamento.

  • Para controlar onde as solicitações para recursos novos são originados, Julia adiciona um campo personalizado com um menu drop-down das opções e altera o layout do formulário de item de trabalho para o item de retorno do produto.Julia é executado cinco tarefas adicionar um campo personalizado com uma lista suspensa de opções e alterar o layout do formulário de item de trabalho para o item de retorno do produto.

  • Para melhorar a trabalhar com e melhor no seu e a capacidade de equipe estimar o trabalho, Peter adiciona um campo para o tipo de item de trabalho de tarefas.

Como mostra a ilustração a seguir, Julia e Peter realizam suas tarefas independente, mas uma sequência prescrita.

Alterar o layout de um formulário de item de trabalho

Seqüência para adicionar um campo a um tipo de item de trabalho

Adicione um campo a um formulário de item de trabalho

Adicionar um campo a um tipo de item de trabalho

Para examinar os campos de item de trabalho e os campos atribuídos como reportável nos modelos padrão do processo para Team Foundation Server, consulte Referência de campos de item de trabalho para o Visual Studio ALM e Referência a campos Reportable para ALM de Visual Studio.

Requisitos

  • Para executar este procedimento, você deve ser um membro do grupo de Administradores do Team Foundation ou um membro do grupo de Administradores do Projeto para o projeto.Para obter mais informações, consulte Team Foundation Permissões do servidor.
ObservaçãoObservação

Se você estiver executando Windows Vista você pode não ter permissões definidas para certos pastas.Se você tentar exportar o tipo de item de trabalho a um local onde você não tem permissões definidas, a tecnologia de virtualização do Registro automaticamente redireciona o arquivo exportado e o salva no armazenamento virtual.Para evitar essa redirecionamento, você pode exportar o arquivo para um local onde você tenha permissões definidas.Para obter mais informações sobre virtualização do Registro, consulte as seguintes páginas no site da Microsoft: Virtualização do Registro e Problemas de virtualização de arquivo comum e do Registro no Windows Vista.

1.Exportar uma definição de tipo de item de trabalho

Quando você baixar a definição de tipo de seu projeto de equipe, você garante que você está trabalhando com a versão mais recente.

ObservaçãoObservação

Se você tiver alterações secundárias e é confortável trabalhar com o formato XML, você pode alterar arquivos usando o Bloco De Notas ou outro editor de texto.Ou, você pode usar o editor do processo, que é uma ferramenta elétrica que é instalado como um suplemento ao Visual Studio.Usando essa ferramenta, não precisará importar ou exportar as definições de tipo.Em vez disso, você pode abri-los usando o editor do processo e modificá-los através da interface do editor.

Você pode baixar a ferramenta elétrica a seguinte página no site da Microsoft: Ferramentas poderosas do Team Foundation Server.

Para obter informações sobre como baixar os arquivos de esquema para os modelos de processo, consulte Índice para definições de elemento XML de modelo de processo Plug-ins.

Para exportar um arquivo de definição de tipo de item de trabalho de um projeto de equipe existente

  1. 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)%.

  2. Digite o seguinte comando, substituindo os dados para os argumentos que são mostradas aqui, onde CollectionURL especifica a URL de uma coleção de projeto de equipe, ProjectName especificam o nome de um projeto de equipe definido dentro da coleção, WorkItemTypeName especifica o nome do item de trabalho para exportar, e Nome de arquivo especifica o nome e local para o arquivo exportado exporte.Escolha a chave de Enter .

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName

    Exemplo: Exportar a definição para o item de fallback de produto

    Por exemplo, o comando a seguir usa Julia exportar o definição de tipo para seu projeto de equipe FabrikamFiber para o item de retorno do produto a FF_ProductBItem.xml.

    witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:"Product Backlog Item" /f:FF_ProductBItem.xml

    Exemplo: Exportar a definição da tarefa

    Peter e usa o seguinte comando exportar o definição de tipo para a tarefa e salvá-la no arquivo rotulado FF_Task.xml.

    witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:Task /f:FF_Task.xml

    Após a conclusão com êxito, a seguinte mensagem aparece:

    Operação completo.

2.Adicione um campo em uma definição de tipo

Para adicionar um campo em uma definição de tipo, você deve adicionar um elemento de FIELD dentro da seção de FIELDS e um elemento de Control dentro da seção de FORM .Além disso, recomendamos que você está de acordo com as convenções de nomenclatura estabelecidas para campos.

Para adicionar um campo para um tipo de item de trabalho

  1. Localize a seção do arquivo XML que definem os campos para o tipo e que começa com FIELDS.

  2. Adicione o elemento de FIELD que especifica o nome do campo personalizado para adicionar.Você deve especificar os seguintes atributos necessários: nameamigável, refname (nome de referência), e type.Para obter mais informações, consulte Elemento FIELD (definição).

    ObservaçãoObservação

    O nome de referência, ou refname, é o nome programática para o campo.Todas as regras restantes devem fazer referência a esse refname.Para obter mais informações, consulte As convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

    Exemplo: Adicione um campo personalizado com uma lista de menus

    Por exemplo, Julia inserir o texto a seguir para adicionar o campo personalizado, solicitante, com um nome de referência de FabrikamFiber.MyTeam.Requestor, a definição de tipo para o item de retorno do produto.Também especifica a lista de opções de valores permitidos para este campo bem como o valor padrão do cliente para a lista.

    <FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
   <ALLOWEDVALUES>
      <LISTITEM value="Customer" />
      <LISTITEM value="Executive Management" />
      <LISTITEM value="Other" />
      <LISTITEM value="Support" />
      <LISTITEM value="Team" />
      <LISTITEM value="Technicians" />
      <DEFAULTVALUE value="Customer" />
    </ALLOWEDVALUES>
</FIELD>

    Para obter mais informações sobre as listas de opções, consulte Definir listas de opções.

    Exemplo: Adicione um campo predefinido

    Para a definição de tipo para a tarefa, Peter adiciona o campo predefinido, trabalho concluído, com um nome de referência de Microsoft.VSTS.Scheduling.CompletedWork.

    <FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum" />

    Para obter uma lista de todos os campos predefinidos, consulte Referência de campos de item de trabalho para o Visual Studio ALM.

  3. Adicione o elemento de CONTROL dentro da seção de FORM de modo que o campo personalizado aparece no formulário de item de trabalho dentro do grupo de elementos onde você deseja que apareça.Você deve especificar o atributo de type do controle.Para obter mais informações, consulte Referência de elemento do controle XML.

    Exemplo: Adicione o campo personalizado ao formulário para o item de fallback de produto

    Exemplo: Adicione o elemento de controle para um campo

    Por exemplo, Julia adicione o elemento de Control para o campo de usuário aparece abaixo do campo da razão no formulário de item de trabalho, conforme mostrado na exemplo de código.

    <Column PercentWidth="50">
   <Group Label="Status">
      <Column PercentWidth="100">
         <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
         <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
         <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
         <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
      </Column>
   </Group>
</Column>
    DicaDica

    A definição de esquema para o acompanhamento de item de trabalho define todos os elementos filho do elemento de FORM como exemplos de camelo e todos os outros elementos como tudo colocar a primeira letra da palavra em maiúscula.Se você encontrar erros ao validar seus arquivos de definição de tipo, verifica a estrutura dos casos de seus elementos.Além disso, a estrutura dos casos as marcas de abertura e fechamento devem corresponder de acordo com as regras para a sintaxe XML.

    A ilustração a seguir mostra o formulário de item de trabalho para o item de retorno do produto agora contém o novo campo.

    Adicionado ao formulário e definição de tipo de campo personalizado

    Exemplo: Adicione o campo predefinido ao formulário para a tarefa

    Para o item de trabalho de tarefas, Peter adiciona o campo de Control para aparecer acima do campo restante de trabalho como mostrado na exemplo de código a seguir:

    <Column PercentWidth="50">
   <Group Label="Details">
      <Column PercentWidth="100">
         <Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed Work:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Type="FieldControl" Label="Remaining Work:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Common.BacklogPriority" Type="FieldControl" Label="Backlog Priority:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Common.Activity" Type="FieldControl" Label="Activity:" LabelPosition="Left" />
         <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area:" LabelPosition="Left" />
      </Column>
   </Group>
</Column>

    A ilustração a seguir mostra o formulário de item de trabalho para a tarefa agora contém o campo de trabalho concluído.

    Adicionar o trabalho concluído para o formulário e o tipo de tarefa

  4. Salve as alterações no arquivo XML.

Para saber mais sobre como adicionar campos de item de trabalho para as definições de tipo

3.Alterar o layout do formulário para grupos da guia de duas colunas a uma única coluna

Julia deseja alterar o layout do formulário para o item de fallback de produto para que o campo de descrição abrange a largura do formulário.Como mostra a ilustração a seguir, o layout padrão exibe dois conjuntos de grupos de tabulação.Para alterar o layout para um único conjunto de grupos de guia, Jill precisa modificar o elemento da primeira coluna à largura de 100 por cento, e remove Column os elementos e desconhecidos de TabGroup da seção de FORM .

Layout de grupo do guia de coluna dois

Para alterar o layout do formulário de grupos da guia de duas colunas a uma única coluna de grupos da guia

  1. Localize a seção de TabGroup do arquivo XML.Observe que os elementos de Tab para itens como Descrição, Tarefas, Critérios de aceitação, e Histórico em que cada elemento de Tab contém um elemento de Control que renderiza o controle respectivo.

    <Group>
   <Column PercentWidth="50">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
   <Column PercentWidth="50">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>

  2. Consolide todos os elementos de <Tab> . . . </Tab> em um TabGroup.Remova Group, Column, e os elementos de TabGroup estranhos.O exemplo a seguir mostra a nova estrutura de sintaxe XML.

    <Group>
   <Column PercentWidth="100">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>
    ObservaçãoObservação

    Para obter melhores resultados, cada controle ou grupo devem exibir em uma coluna se a coluna mede a largura total do formulário.Por sua vez, cada coluna deve exibir em um grupo mesmo se o grupo não tem nenhum rótulo ou limite visível.Para obter mais informações, consulte Criar e personalizar um formulário de item de trabalho.

    A ilustração a seguir mostra os grupos da guia da coluna única.

    Grupo de guias de coluna única

  3. Salve as alterações no arquivo XML.

4.Importar uma definição de tipo de item de trabalho

Depois que você personalizou a definição de tipo, você deve importar-la ao seu projeto de equipe verifique suas alterações e torná-los disponíveis para uso.O arquivo XML que você importar substituirá o conteúdo de definição de tipo atual.O processo de importação valida a sintaxe XML antes de carregamento.

Para importar um tipo de item de trabalho a um projeto de equipe existente

  • A janela do prompt de comando e do diretório especificados na etapa 1, 1. Exportar uma definição de tipo de item de trabalho , descrito anteriormente neste tópico, insere o seguinte comando, e então escolha a chave de Enter .

    witadmin importwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName

    Exemplo: Importar a definição para o item de fallback de produto

    Por exemplo, Jill usa o comando a seguir importa a definição de tipo para o item de retorno do produto exportou a FF_ProductBItem.xml ao projeto de equipe FabrikamFiber.

    witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_ProductBItem.xml

    Exemplo: Importar a definição da tarefa

    Peter e usa o comando a seguir importa a definição de tipo para a tarefa que ele salvar a FF_Task.xml.

    witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_Task.xml

    Após a conclusão com êxito, a seguinte mensagem aparece:

    A importação de tipo de item de trabalho foi concluída.

5.Atualize o projeto de equipe e verificar as alterações feitas em uma definição de tipo

Após importado uma definição de tipo, você deve atualizar o cache o team Explorer para que as alterações sejam disponível.Você deve atualizar o cache somente se você tivesse Visual Studio aberto e conectou a Team Foundation Server quando você importou as definições de tipo.

Atualizando o team Explorer e crie um item de fallback de produto

Atualizar o projeto de equipe e verificar as alterações

Para atualizar o cache

  1. Em Team Explorer, escolha Atualizar o botão de Atualizar .

    As atualizações de segurança mais recentes são baixados de servidor, incluindo as alterações que você importaram apenas.

    Aguarde alguns segundos até que a atualização seja concluído.

  2. Escolha Itens de Trabalho.

  3. Escolha Novo Item de Trabalho, e então escolha o tipo de item de trabalho que você modificou, como Item de fallback de produto ou Tarefa.

  4. Verifique se as alterações feitas para aparecer no formulário de item de trabalho.

  5. Escolha o botão de Fechar para fechar o item de trabalho.Escolha o botão de Não quando você for solicitado a salvar o item de trabalho.