Referência de elemento XML da configuração de processo
A configuração do processo define a configuração padrão e recursos funcionais que suas equipes podem acessar usando as ferramentas de planejamento do Agile.
As ferramentas que você visualiza com o Team Web Access (TWA) exibem um conjunto filtrado de itens de trabalho com base na configuração feita no PortfolioBacklog, RequirementBacklog e nas seções TaskBacklog do processo de configuração do arquivo de definição XML. Além disso, a configuração do processo define os mapeamentos dos fluxos de trabalho de estados para metaestados para todos os tipos de item de trabalho (WITs) que exigem mapeamento.
Para saber mais, consulte Configurar e personalizar ferramentas de planejamento do Agile para um projeto de equipe.
Áreas que você pode personalizar:
Configurar uma página de lista de pendências
Mapear metaestados para uma categoria de tipos de item de trabalho
Personalizar as colunas e a sequência de colunas padrão
Personalizar o painel de adição rápida
Alterar o número de itens de trabalho que podem aparecer no painel de tarefas
Mapear metaestados para tipos de item de trabalho específicos de ferramentas
Atribuir os campos usados em ferramentas e tabelas de planejamento do Agile
Especificar dias de final de semana
Alterar a cor de um tipo de item de trabalho
Para atualizar a configuração do processo, exporte o arquivo de definição XML, edite-o e importe o arquivo. Você usa a ferramenta de linha de comando witadmin para importar e exportar o arquivo.
Dica
Os exemplos de sintaxe exibidos neste tópico correspondem às atribuições padrão definidas no modelo de processo do Visual Studio Scrum 2013.Para acessar a versão mais recente dos modelos de processo, instale a versão mais recente do TFS e baixe os modelos usando o Gerenciador de Modelos de Processo.
Configurar uma página de lista de pendências
Existem três tipos de páginas de lista de pendências: lista de pendências de produto, iteração ou lista de pendências de sprint e lista de pendências de portfólio. É possível personalizar cada página de lista de pendências das seguintes maneiras:
Mapeamentos de metaestado: mapear estados de fluxo de trabalho para metaestados. Esses mapeamentos oferecem suporte à exibição de todas as páginas de planejamento do Agile, incluindo o bloco Kanban e o painel de tarefas.
Painel de adição rápida: especifique os WITs e os campos de item de trabalho que aparecem para a adição rápida de itens à lista de pendências.
Para alterar os tipos de itens de trabalho considerados itens ou tarefas de lista de pendências, você os adiciona à categoria correspondente. Para um exemplo, consulte Para adicionar bugs ao painel de tarefas ou à lista de pendências.
Campos de coluna: defina os campos e a sequência de colunas padrão.
Configure as páginas da lista de pendências dentro das seções XML que aparecem no exemplo a seguir:
<PortfolioBacklogs>
<PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature">
. . .
</PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName=" Backlog items" singularName=" Backlog item">
. . .
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task">
. . .
</TaskBacklog>
Elemento |
Descrição |
---|---|
PortfolioBacklogs |
Opcional. Elemento do contêiner para páginas da lista de pendências do portfólio. |
PortfolioBacklog |
Opcional. Até cinco instâncias. O elemento do contêiner que define os mapeamentos de metaestado, as colunas padrão e o painel de adição rápida para uma página da lista de pendências do portfólio.
Designar valores aos atributos conforme descrito:
|
RequirementBacklog |
Obrigatório. Somente uma instância. O elemento do contêiner que define os mapeamentos de metaestado, as colunas padrão e o painel de adição rápida para uma página de lista de pendências do produto. A lista de pendências do produto exibe todos os itens ativos na lista de pendências da equipe.
|
TaskBacklog |
Obrigatório. Somente uma instância. O elemento do contêiner usado para personalizar o layout das páginas que exibem os itens de trabalho atribuídos a uma iteração específica.
Por padrão, o painel de tarefas é restrito a um total de 500 itens de trabalho. É possível alterar esse limite especificando um valor para o atributo workItemCountLimit. |
Observações sobre a implementação
Os valores atribuídos a CategoryName devem corresponder a um grupo de categorias definido para o projeto de equipe. Você especifica grupos de categorias no arquivo de definição para Categorias. Para obter mais informações, consulte Referência a elementos XML de categorias.
Você usa listas de pendências de portfólio para exibir o rollup de itens de lista de pendências em níveis mais baixos e para exibir o andamento entre várias equipes. Projetos de equipe novos e atualizados contêm recursos rotulados de um nível. É possível adicionar até quatro níveis adicionais.
Dica
Use as páginas de portfólio pode exigir a ser concedido acesso avançado.Para obter detalhes, veja Alterar níveis de acesso.
Para obter informações sobre como usar páginas da lista de pendências do portfólio, veja Trabalhar com pendências de portfólio.
A lista de pendências do produto representa uma lista de requisitos para o produto que você está desenvolvendo. Os itens da lista de pendências correspondem a um tipo específico de item de trabalho com base no modelo de processo usado para criar seu projeto de equipe, como um item da lista de pendências, história de usuários ou requisitos. Se usar tipos diferentes de itens de trabalho ou capturar os requisitos usando dois ou mais tipos de itens de trabalho, você poderá personalizar a página de lista de pendências do produto para dar suporte ao uso.
Para obter informações sobre como usar as páginas da lista de pendências do produto, veja Criar sua lista de pendências.
As páginas da lista de pendências de sprint e de iteração exibem o conjunto de requisitos que você e sua equipe comprometeram em um ciclo específico de iteração e as tarefas que você vinculou a esses requisitos. As tarefas devem ser vinculadas a requisitos usando o tipo de link filho. Como os tipos de itens de trabalho que aparecem nessas páginas correspondem aos mesmos tipos que aparecem na página da lista de pendências do produto, grande parte do trabalho de personalização que você faz para a página da lista de pendências do produto definirá a funcionalidade das páginas da lista de pendências de tarefas.
Para obter informações sobre como usar as páginas da lista de pendências de sprint, veja Trabalhar em prazos menores.
Mapear os estados do fluxo de trabalho para metaestados
A maioria dos WITs exigem que seus estados de fluxo de trabalho sejam mapeados para um metaestado. Os estados do fluxo de trabalho definem como um item de trabalho progride da primeira ativação ou criação até o encerramento ou conclusão. Por exemplo, os estados definidos para o item da lista de pendências de produto do Scrum definem o andamento de quatro estados, de Novo, Aprovado e Confirmado a Concluído, e também incluem um quinto estado, Removido, para dar conta de um estado removido da lista de pendências sem ser implementado.
Os metaestados, por outro lado, determinam como as ferramentas de planejamento do Agile tratam cada estado do fluxo de trabalho. Os metaestados principais usados pela lista de pendências e pelo painel de tarefas são Proposed, InProgress e Complete.
Ao associar cada estado do fluxo de trabalho a um metaestado, as operações em segundo plano executadas para exibir os painéis de tarefas e listas de pendências sabem como interpretar corretamente o status de cada item de trabalho. Por exemplo, os seguintes mapeamentos são definidos para as páginas da lista de pendências do Scrum
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="New" type="Proposed" />
<State value="Approved" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
Existem três categorias de metaestados: Agile, Bug e Comentários. A tabela a seguir descreve os atributos de mapeamento e valores.
Elemento |
Descrição |
---|---|
State |
Obrigatório. Atribui um estado de fluxo de trabalho a um metaestado.
Os valores válidos para TypeName correspondem a um valor atribuído a um STATE dentro da seção WORKFLOW dos WITs atribuídos ao grupo de categorias. Os valores válidos para ValueName correspondem a um dos seguintes valores enumerados:
|
States |
Especifica uma coleção de elementos State que associam estados de fluxo de trabalho de WITs a metaestados. Elemento necessário para os seguintes elementos pai:
|
Personalizar as colunas e a sequência de colunas padrão
É possível adicionar ou remover colunas, alterar a sequência das colunas ou alterar a largura da coluna para as páginas que exibem uma página de lista de pendências. As alterações feitas na página por meio da caixa de diálogo Opções de Coluna persistem até que você as modifique novamente. A seção a seguir do código define simplesmente o conjunto e a sequência padrão da coluna.
<Columns>
<Column refname="Microsoft.VSTS.Common.Priority" width="400" />
<Column refname="System.Title" width="400" />
<Column refname="System.State" width="100" />
<Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
<Column refname="System.IterationPath" width="200" />
</Columns>
Elemento |
Descrição |
---|---|
Columns |
Especifica uma coleção de elementos Column. Elemento necessário para elementos da página da lista de pendências: PortfolioBacklog, RequirementBacklog e TaskBacklog. |
Column |
Especifica um campo para aparecer como uma coluna em uma página da lista de pendências.
|
Cabeçalhos da coluna do painel de tarefas
Os títulos de colunas que aparecem na página do painel de tarefas correspondem aos estados de fluxo de trabalho atribuídos ao WIT padrão atribuído à Categoria de Tarefas. A sequência de coluna corresponde à progressão natural das transições de fluxo de trabalho, indo da esquerda para a direita. Para alterar o layout da coluna, modifique o fluxo de trabalho do WIT atribuído à Categoria de Tarefas. Os estados de fluxo de trabalho definidos para o tipo de tarefa padrão na Categoria de Tarefas devem ser atribuídos a um metaestado válido como descrito em Mapear metaestados para uma categoria de tipos de item de trabalho.
Personalizar o painel de adição rápida
É possível adicionar campos para qualquer painel de adição rápida. Por exemplo, o exemplo a seguir adiciona o Valor Comercial para o painel da lista de pendências do produto.
O painel só exibe campos incluídos na seção FIELDS de definição do WIT para o WIT selecionado. Por exemplo, se você selecionar o bug WIT, somente o Título será exibido, porque o Valor Comercial não está definido para bugs. Para adicionar outro WIT ao painel, você o adiciona à Categoria de Requisitos como descrito aqui.
O código a seguir corresponde às atribuições padrão definidas nos modelos de processo do Visual Studio Scrum e do MSF para Agile.
<AddPanel>
<Fields>
<Field refname="System.Title" />
</Fields>
</AddPanel>
Elemento |
Descrição |
---|---|
AddPanel |
O elemento do contêiner usado para especificar a experiência “adição rápida”, os campos para aparecerem dentro da área do painel onde novos itens da lista de pendências são definidos. |
Fields |
Especifica uma coleção de elementos Field. |
Field |
Especifica um campo do item de trabalho para aparecer no painel da página de lista de pendências do produto.
O mesmo campo deve aparecer no formulário de item de trabalho de cada WIT incluído na categoria da lista de pendências. |
Alterar o número de itens de trabalho que podem aparecer no painel de tarefas
Por razões de desempenho, o painel de tarefas é restrito para exibir um máximo de 500 itens de trabalho. Ao abrir o painel de tarefas, todos os itens de trabalho são carregados em cache. Limitar o número de itens de trabalho pode render tempos de carregamento mais rápidos. É possível alterar esse limite especificando um valor para o atributo workItemCountLimit do elemento TaskBacklog.
Por exemplo, você pode aumentar o limite adicionando workItemCountLimit="800":
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>
Mapear metaestados para tipos de item de trabalho específicos de ferramentas
Os mapeamentos de metaestado são definidos para categorias adicionais WIT. Para o modelo do processo Scrum, isso inclui mapeamentos para as categorias de solicitação e resposta de comentários. Para os modelos de processo do MSF para Agile e CMMI também estão inclusos mapeamentos para a categoria de bug. (O Scrum inclui bugs na Categoria do Requisito e, portanto, define os mapeamentos de metaestado dentro da seção RequirementBacklog.)
<FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" pluralName="Feedback Requests" singularName="Feedback Request">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackRequestWorkItems>
<FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" pluralName="Feedback Responses" singularName="Feedback Response">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackResponseWorkItems>
A tabela a seguir descreve os elementos adicionais usados para definir os mapeamentos de metaestado para tipos de item de trabalho específicos da ferramenta. Consulte Mapear metaestados para uma categoria de tipos de item de trabalho para obter informações sobre a atribuição dos valores e tipos do estado real. O CategoryName deve corresponder a uma categoria definida para o projeto de equipe.
Elemento |
Descrição |
---|---|
BugWorkItems |
Opcional. O elemento do contêiner que define os mapeamentos de metaestado para os tipos de item de trabalho atribuídos à categoria do bug. Além da maneira como esses mapeamentos são usados na exibição das páginas de planejamento do Agile do TWA, elas também controlam como o recurso Meu Trabalho no Team Explorer atualiza o estado do bug à medida que os desenvolvedores migram os bugs usando Meu Trabalho. Para saber mais, consulte Escrever um novo código para uma história de usuário.
|
FeedbackRequestWorkItems |
Obrigatório. Não personalize. O elemento do contêiner que define os mapeamentos de metaestado para os tipos de item de trabalho atribuídos à categoria de solicitação de comentários.
|
FeedbackResponseWorkItems |
Obrigatório. Não personalize. O elemento de contêiner que define os mapeamentos de metaestado para os tipos de item de trabalho atribuídos à categoria de resposta de comentários.
|
TestPlanWorkItems |
Pedido apenas ao personalizar o estado do fluxo de trabalho para o plano de teste e suas conexões com suporte para o projeto de equipe de versões do Test Manager instaladas com o Visual Studio 2013.2 ou versões anteriores. O elemento do contêiner que define os mapeamentos de metaestado para os tipos de item de trabalho atribuídos à categoria de plano de teste. Por exemplo:
|
TestSuiteWorkItems |
Pedido apenas ao personalizar o estado do fluxo de trabalho para o conjunto de teste e suas conexões com suporte para o projeto de equipe de versões do Test Manager instaladas com o Visual Studio 2013.2 ou versões anteriores. O elemento do contêiner que define os mapeamentos de metaestado para os tipos de item de trabalho atribuídos à categoria de conjunto de teste. Por exemplo:
|
Para mapear metaestados para TestPlanWorkItems ou TestSuiteWorkItems, você deve realizar o upgrade do servidor no nível do aplicativo para TFS 2013.3. Posteriormente, pode personalizar o estado do fluxo de trabalho de planos de teste e conjuntos de testes.
Para saber mais, veja Importar e exportar configuração do processo.
Atribuir os campos usados em ferramentas e tabelas de planejamento do Agile
É possível alterar os campos de item de trabalho usados no cálculo de capacidade, em gráficos de burndown, previsão e velocidade. Qualquer alteração que você faz em uma das atribuições padrão deve corresponder a uma alteração feita no WIT usado para definir e capturar informações para esse valor.
Por exemplo, se você alterar o refname atribuído a type="Activity", você deverá incluir o mesmo campo na definição do WIT atribuída à Categoria de Tarefa que captura informações da atividade.
<TypeFields>
<TypeField refname="System.AreaPath" type="Team" />
<TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
<TypeField refname=" Microsoft.VSTS.Common.BacklogPriority" type="Order" />
<TypeField refname="Microsoft.VSTS.Scheduling.Effort" type="Effort" />
<TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>
</TypeField>
</TypeFields>
Elemento |
Descrição |
---|---|
TypeFields |
Obrigatório. Especifica uma coleção de elementos TypeField. |
TypeField |
Obrigatório. Especifica o nome da referência de um campo cujo valor oferece suporte a um tipo de atividade para uma área de recurso. Os campos que você especifica devem corresponder aos campos usados nos WITs que capturaram as informações do recurso.
Especifique o formato somente quando type="RemainingWork". É possível especificar qualquer cadeia de caracteres de texto para o TimeUnitString, que deseja que apareça nas barras de capacidade, na página de lista de pendências da iteração atual e no painel de tarefas. Para páginas de planejamento do Agile:
Para o comentário do formulário de solicitação: Dica Você não deve ter que alterar as atribuições padrão feitas para os seguintes elementos de TypeField.Essas atribuições correspondem aos campos usados para capturar informações correspondentes no WIT atribuídas à Categoria de Solicitação de Comentário.
|
TypeFieldValues |
Necessário para TypeFieldValue quando type="ApplicationType". Especifica uma coleção de elementos TypeFieldValue usados no formulário de solicitação de comentário. |
TypeFieldValue |
Obrigatório. Não personalize. Especifica o nome de um tipo de aplicativo que aparecerá no formulário de solicitação de comentário.
As atribuições padrão correspondem aos valores permitidos especificados na definição de tipo para o formulário de solicitação de comentário.
|
Observações sobre a implementação
Se alterar um campo na seção TypeFields, você deverá fazer a alteração correspondente na definição do WIT. Por exemplo, se você alterar os campos atribuídos para o trabalho de captura Effort, você deverá fazer a mesma mudança nas definições do WIT para o item da lista de pendências do produto e para o bug (para o Scrum).
É possível consultar o nome da referência para um campo usando este índice.
Atribuir dias não úteis
Os gráficos de planejamento de capacidade e de burndown fazem referência aos dias não úteis. Os dias não úteis a seguir são definidos em cada modelo do processo do TFS.
<Weekends>
<DayOfWeek>Saturday</DayOfWeek>
<DayOfWeek>Sunday</DayOfWeek>
</Weekends>
Elemento |
Descrição |
---|---|
DayOfWeek |
Necessário filho do elemento Weekends. Especifica um dia da semana correspondente a um dia não útil.
Os nomes válidos correspondem aos dias da semana em inglês: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday e Saturday. Dica Você deve especificar o dia da semana em inglês, independentemente do idioma do Team Foundation Server instalado. |
Weekends |
Opcional. O elemento de contêiner usado para especificar dias não úteis. Especifique dias não úteis quando quiser contabilizar dias não úteis no cálculo de gráficos de capacidade e de burndown. Qualquer observação sobre como ele aparece no gráfico de burndown; não pode ser removido. |
Alterar a cor de um tipo de item de trabalho
Em resumo, você pode diferenciar WITs ao exibir um resultado de consulta ou lista de pendências com base na cor atribuída ao WIT.
As atribuições de cor a seguir são definidas no modelo de processo do Scrum.
<WorkItemColors>
<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
<WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
<WorkItemColor primary="FFCC293D" secondary="FFFAEAE5" name="Bug" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Impediment" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Step" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Case" />
</WorkItemColors>
Elemento |
Descrição |
---|---|
WorkItemColors |
Opcional. Elemento do contêiner para especificar cores para os tipos de item de trabalho. |
WorkItemColor |
Especifica as cores usadas para exibir um WIT no TWA. A cor principal é usada em exibições de lista e a cor secundária é usada em exibições de painel ou bloco, como o painel de tarefas ou o bloco Kanban.
|
Perguntas e respostas
P: Como posso personalizar outras funções que aparecem nas ferramentas de planejamento do Agile no TWA?
R: Algumas personalizações podem ser feitas por meio da interface do usuário. Outros requerem a configuração do processo de edição ou de outros objetos de projeto de equipe. Para obter uma visão geral, veja Configurar e personalizar ferramentas de planejamento do Agile para um projeto de equipe.
P: Você quer trabalhar com duas ou mais reservas de portfólio?
R: A experiência padrão oferece suporte a um nível de retorno de portfólio. Você pode adicionar até cinco níveis como descrito em Adicionar uma lista de pendências ao Prático gerenciamento de portfólio.
P: Você deseja adicionar ou alterar os WITs que aparecem em seu painel de tarefas ou na lista de pendências do produto?
R: Se você adicionou um WIT (tipo de item de trabalho) personalizado, é possível adicioná-lo à lista de pendências ou ao painel de tarefas. Você não pode deixar que eles apareçam nos dois lugares. Saiba como lendo Adicionar bugs ao painel de tarefas ou à lista de pendências.
P: Deseja ver um exemplo trabalhado da configuração do processo de importação e exportação?
R: Um exemplo é fornecido aqui: Importar e exportar configuração do processo [witadmin].