Share via

Atualizar o fluxo de trabalho para projetos de equipe do Agile

  • Artigo

Depois de configurados os recursos do seu projeto de equipe atualizado, criado com um modelo de processo com base no Microsoft Solutions Framework (MSF) para Agile Software Development v5.0, você deve atualizar manualmente a história do usuário e as atribuições de fluxo de trabalho da tarefa. Se não atualizar o fluxo de trabalho, o painel de tarefas fornecerá apenas dois estados: Ativo e Fechado, conforme mostrado na ilustração a seguir. Isso impede que você ou sua equipe façam distinção entre tarefas que estejam em andamento daquelas ainda não iniciadas.

Painel de tarefas de um projeto de equipe Agile sem as atualizações manuais recomendadas

Painel de tarefas de projeto de equipe Agile não atualizados

Atualizações feitas pelo assistente Configurar Recursos feitas para corresponder ao fluxo de trabalho existente definido para o projeto de equipe. Para a versão 5.0 do modelo de processo MSF Agile, isso significa que os estados Novo e Removido, incluídos na versão mais recente, não estão presentes. Esses estados são compatíveis com a transição de histórias do usuário de um estado Novo para outro Ativo. Sem o estado Novo definido, uma História do Usuário atribuída a uma iteração permanece na lista de pendências do produto até que seja resolvido, o que não é o comportamento desejável ou esperado.

Da mesma maneira, adicionar o estado Novo ao fluxo de trabalho da tarefa permite mover tarefas de Novo para Ativo e Fechado usando o painel de tarefas. Além disso, adicionando o estado Removido às definições de tipo História do Usuário e Tarefa, você permite que os usuários recortem histórias e tarefas usando as ferramentas de planejamento.

Para oferecer suporte aos comportamentos desejados, você deve adicionar os estados Novo e Removido aos tipos de itens de trabalho: história do usuário e tarefa, e atualizar os mapeamentos de metaestado atribuídos na configuração do processo.

Dica

Você pode executar alguns dos procedimentos descritos abaixo usando o Editor de Processo, um poderoso suplemento de uma ferramenta para Visual Studio que pode ser baixado e instalado.Localizado no menu Ferramentas, o Editor de Processo fornece uma interface gráfica do usuário para personalização de modelos de processo Team Foundation Server.É possível usar essa ferramenta para importar e exportar tipos de itens de trabalho e modificar o conteúdo do modelo de processo.Para saber mais, veja a seguinte página no site da Microsoft: Team Foundation Server Power Tools.

Requisitos

  • Para executar a ferramenta da linha de comando witadmin, você deve ser membro de um dos seguintes grupos: grupo de Administradores do Team Foundation, Administradores da Coleção de Projetos ou Administradores do Projeto do projeto de equipe. Consulte Referência de permissões para o Team Foundation Server.

Atualizar o fluxo de trabalho e metaestados de um projeto de equipe Agile

Importante

Os procedimentos deste tópico foram escritos com base no MSF do Agile Software Development 6.0.Para atualizar seu projeto de equipe para suportar o fluxo de trabalho mais recente definido para MSF para Agile Software Development 6.1, você pode adaptar esses procedimentos para copiar as seções WORKFLOW do modelo de processo Agile mais recente.Atualizações significativas foram feitas no fluxo de trabalho de vários tipos de itens de trabalho na atualização do último trimestre.Essas mudanças são compatíveis com transições anteriores, de modo que, quando arrastar indevidamente um item de trabalho no painel Kanban ou no painel de tarefas para um estado resolvido ou fechado, você poderá arrastá-lo de volta para um estado anterior do fluxo de trabalho.

Para saber mais sobre a atualização, veja Novidades de planejamento e acompanhamento.

Você precisa executar as seguintes etapas:

  • Exportar as definições para os tipos de História do Usuário e Tarefas e para a configuração do processo.

  • Inserir trechos de código na seção do fluxo de trabalho para História do Usuário e Tarefa.

  • Atualizar os mapeamentos de metaestado para a configuração do processo.

  • Importar as definições atualizadas para os tipos de itens de trabalho e configuração do processo.

  • Verificar se as mudanças aparecem no painel de tarefas.

Importante

Para que os procedimentos a seguir funcionem, o estado Ativo deverá estar especificado no fluxo de trabalho definido para os tipos História do Usuário e Tarefa dos itens de trabalho.

Para atualizar os estados do fluxo de trabalho e as transições para História do Usuário

  1. Para executar a ferramenta da linha de comandos witadmin, abra uma janela do Prompt de Comando em que Visual Studio ou Team Explorer esteja instalado e digite:

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

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

  2. Para exportar a definição de tipo para História do Usuário, insira o comando a seguir, substituindo seus dados pelos argumentos que são mostrados aqui, onde CollectionURL especifica a URL de uma coleção de projetos de equipe, ProjectName especifica o nome de um projeto de equipe definido dentro da coleção e "DirectoryPath\FileName.xml" especifica o nome e o local do arquivo a ser exportado. Em seguida, pressione Enter.

    witadmin exportwitd /collection:CollectionURL /p:"ProjectName" /n:"User Story" /f:"DirectoryPath\FileName.xml"

    Use este formato para a URL: **http://**ServerName:Port/VirtualDirectoryName/CollectionName, por exemplo: http://srvalm:8080/tfs/DefaultCollection.

  3. Em um editor de texto ou no Visual Studio, abra o arquivo exportado.

  4. Adicione esse trecho de código entre as linhas <STATES> e <STATE value="Active">:

    <STATE value="New">
   <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
         <EMPTY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ResolvedBy">
         <EMPTY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
         <EMPTY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
         <EMPTY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
         <EMPTY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
         <EMPTY />
      </FIELD>
   </FIELDS>
</STATE>
<STATE value="Removed" />

  5. Substitua a seção que começa com <TRANSITION from=" " to="Active"> e termina com <TRANSITION> por este trecho de código:

    <TRANSITION from="" to="New">
   <REASONS>
      <DEFAULTREASON value="New" />
   </REASONS>
   <FIELDS>
      <FIELD refname="System.Description">
         <DEFAULT from="value" value="As a &amp;lt;type of user&amp;gt; I want &amp;lt;some goal&amp;gt; so that &amp;lt;some reason&amp;gt;" />
      </FIELD>
   </FIELDS>
</TRANSITION>
<TRANSITION from="New" to="Active">
   <REASONS>
      <DEFAULTREASON value="Implementation started" />
   </REASONS>
   <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
         <COPY from="currentuser" />
         <VALIDUSER />
         <REQUIRED />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
         <SERVERDEFAULT from="clock" />
      </FIELD>
      <FIELD refname="System.AssignedTo">
         <DEFAULT from="currentuser" />
      </FIELD>
   </FIELDS>
</TRANSITION>
<TRANSITION from="New" to="Removed">
   <REASONS>
      <DEFAULTREASON value="Removed from the backlog" />
   </REASONS>
</TRANSITION>
<TRANSITION from="Active" to="New">
   <REASONS>
      <DEFAULTREASON value="Implementation halted" />
   </REASONS>
</TRANSITION>
<TRANSITION from="Removed" to="New">
   <REASONS>
      <DEFAULTREASON value="Reconsidering the User Story" />
   </REASONS>
</TRANSITION>

  6. Salve e feche o arquivo.

  7. Importe o arquivo, substituindo seus dados pelos argumentos mostrados.

    witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\FileName.xml"

Para atualizar os estados do fluxo de trabalho e as transições para Tarefa

  1. Exporte a definição de tipo para Tarefa, substituindo seus dados pelos argumentos mostrados.

    witadmin exportwitd /collection:CollectionURL /p:"ProjectName" /n:"Task" /f:"DirectoryPath\FileName.xml"

  2. Em um editor de texto ou no Visual Studio, abra o arquivo exportado.

  3. Adicione esse trecho de código entre as linhas <STATES> e <STATE value="Active">:

    <STATE value="New">
   <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
         <EMPTY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
         <EMPTY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
         <EMPTY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
         <EMPTY />
      </FIELD>
   </FIELDS>
</STATE>
<STATE value="Removed" />

  4. Substitua o primeiro bloco de transição, que corresponde às linhas que ficam entre <TRANSITION from="" to="Active"> e sua marca de fechamento </TRANSITION>, por este trecho de código:

    <TRANSITION from="" to="New">
   <REASONS>
      <DEFAULTREASON value="New" />
   </REASONS>
</TRANSITION>
<TRANSITION from="New" to="Active">
   <ACTIONS>
      <ACTION value="Microsoft.VSTS.Actions.StartWork" />
   </ACTIONS>
   <REASONS>
      <DEFAULTREASON value="Work started" />
   </REASONS>
   <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
         <COPY from="currentuser" />
         <VALIDUSER />
         <REQUIRED />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
         <SERVERDEFAULT from="clock" />
      </FIELD>
      <FIELD refname="System.AssignedTo">
         <DEFAULT from="currentuser" />
      </FIELD>
   </FIELDS>
</TRANSITION>
<TRANSITION from="Active" to="New">
   <ACTIONS>
      <ACTION value="Microsoft.VSTS.Actions.StopWork" />
   </ACTIONS>
   <REASONS>
      <DEFAULTREASON value="Work halted" />
   </REASONS>
</TRANSITION>
<TRANSITION from="New" to="Closed">
   <ACTIONS>
      <ACTION value="Microsoft.VSTS.Actions.Checkin" />
   </ACTIONS>
   <REASONS>
      <DEFAULTREASON value="Completed" />
      <REASON value="Cut" />
      <REASON value="Deferred" />
   <REASON value="Obsolete" />
   </REASONS>
   <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
         <READONLY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
         <READONLY />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
         <SERVERDEFAULT from="clock" />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
      <COPY from="currentuser" />
         <VALIDUSER />
         <REQUIRED />
      </FIELD>
   </FIELDS>
</TRANSITION>
<TRANSITION from="Closed" to="New">
   <REASONS>
      <DEFAULTREASON value="Reactivated" />
   </REASONS>
   <FIELDS>
      <FIELD refname="System.AssignedTo">
         <COPY from="field" field="Microsoft.VSTS.Common.ClosedBy" />
      </FIELD>
   </FIELDS>
</TRANSITION>
<TRANSITION from="New" to="Removed">
   <REASONS>
      <DEFAULTREASON value="Removed from the backlog" />
   </REASONS>
</TRANSITION>
<TRANSITION from="Active" to="Removed">
   <REASONS>
      <DEFAULTREASON value="Removed from the backlog" />
   </REASONS>
</TRANSITION>
<TRANSITION from="Removed" to="New">
   <REASONS>
      <DEFAULTREASON value="Reconsidering the Task" />
   </REASONS>
</TRANSITION>

  5. Salve e feche o arquivo.

  6. Importe o arquivo, substituindo seus dados pelos argumentos mostrados.

    witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\FileName.xml"

Para atualizar os mapeamentos de metaestado para configuração do processo

  1. Digite o comando a seguir para exportar o arquivo ProcessConfiguration, substituindo seus dados pelos argumentos mostrados.

    witadmin exportprocessconfig /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\ ProcessConfiguration.xml"

    Onde CollectionURL especifica a URL da coleção de projetos de equipe e ProjectName especifica o nome do projeto de equipe. Use este formato para a URL: **http://**ServerName:Port/VirtualDirectoryName/CollectionName, por exemplo: http://srvalm:8080/tfs/DefaultCollection.

  2. Abra o arquivo ProcessConfiguration.xml no Bloco de Notas ou em outro editor de texto.

  3. Localize a marca <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">.

  4. Substitua a linha <State type="Proposed" value="Active" /> por estas linhas:

    <State type="Proposed" value="New" /> 
<State type="InProgress" value="Active" />

  5. Localize a marca <TaskWorkItems category="Microsoft.TaskCategory"> e substitua a linha <State type="Proposed" value="Active" /> por estas linhas:

    <State type="Proposed" value="New" />
<State type="InProgress" value="Active" />

  6. Verifique se possui os seguintes mapeamentos:

    <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
   <States>
      <State type="Proposed" value="New"/>
      <State type="InProgress value="Active" />
      <State type="InProgress value="Resolved" />
      <State type="Complete" value="Closed" />
   </States>
</RequirementWorkItems>
<TaskWorkItems category="Microsoft.TaskCategory">
   <States>
      <State type="Proposed" value="New" />
      <State type="InProgress" value="Active" />
      <State type="Complete" value="Closed" />
   </States>
</TaskWorkItems>

  7. Salve e feche o arquivo.

  8. Importe o arquivo de configuração.

    witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"

Para verificar se as mudanças aparecem no painel de tarefas

  1. Abra Team Web Access e se conecte ao projeto de equipe usando uma URL com o seguinte formato:

    http://MyServer:8080/tfs/TeamProjectCollectionName/MyProject

    Se TWA já estiver aberto, atualize o navegador para atualizar o cache.

  2. Verifique se as colunas do painel de tarefas exibem agora Novo, Ativo e Fechado.

    Painel de tarefas de um projeto de equipe Agile com os estados do fluxo de trabalho atualizados

    Painel de tarefas Agile com o fluxo de trabalho atualizado

    Para saber mais sobre como usar o painel de tarefas, veja Trabalhar em prazos menores.

Consulte também

Conceitos

Acompanhar o trabalho com o Visual Studio ALM e o TFS

Configurar recursos após uma atualização do TFS