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ê exibir do portal da web, incluem a lista de pendências de produto, listas de pendências de sprint, quadro Kanban e painel de tarefas. Essas ferramentas se tornam disponíveis para você quando você criar uma equipe de projeto emVisual Studio Onlineou em umTeam Foundation Server (TFS) local.
Elementos de configuração especificam os tipos de item de trabalho (WITs), as colunas padrão, campos usados pelas ferramentas e outros elementos. As configurações principais feitas determinar quais itens serão exibida para o portfólio, produtos e sprints pendências definindo aPortfolioBacklogRequirementBacklogeTaskBacklogseções do arquivo de definição de processo configuração XML. Além disso, a configuração do processo define os mapeamentos de estado para metaestados do fluxo de trabalho para todos os WITs que exigem o mapeamento.
Configurar e personalizar ferramentas de planejamento do Agile para um projeto de equiperesume o que você pode configurar na interface do usuário e o que requer configuração definindo o arquivo ProcessConfiguration.
Áreas que podem ser personalizados por meio de ProcessConfiguration:
Configurar uma lista de pendências
|
|
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 mostrados neste tópico correspondem às atribuições padrão definidas no modelo de processo Scrum.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 lista de pendências
Você pode personalizar os seguintes elementos para a lista de pendências de produto, listas de pendências de sprint e listas de pendências de portfólio:
Mapeamentos de metaestado: mapear estados de fluxo de trabalho para metaestados. Esses mapeamentos oferecem suporte à exibição de todas as ferramentas, incluindo os painéis de tarefas e de Kanban de planejamento do Agile.
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.
Você pode configurar listas de pendências dentro das seções XML que aparecem no exemplo a seguir:
<PortfolioBacklogs>
<PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
. . .
</PortfolioBacklog>
<PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature" parent="Microsoft.EpicCategory" workItemCountLimit="1000">
. . .
</PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="User Story" workItemCountLimit="1000">
. . .
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="1000">
. . .
</TaskBacklog>
Elemento |
Descrição |
---|---|
PortfolioBacklogs |
Opcional. Elemento contêiner de pendências de portfólio. |
PortfolioBacklog |
Opcional. Até cinco instâncias. Elemento de contêiner que define os mapeamentos de metaestado, as colunas padrão e rápida Adicionar painel para uma lista de pendências de portfólio.
Designar valores aos atributos conforme descrito:
|
RequirementBacklog |
Obrigatório. Somente uma instância. Elemento de contêiner que define os mapeamentos de metaestado, as colunas padrão e rápida Adicionar painel para a lista de pendências de 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. Elemento contêiner usado para personalizar o layout das listas de pendências de sprint.
|
Observações sobre a implementação
Por padrão, cada lista de pendências é restrita a um total de 1.000 itens de trabalho. É possível alterar esse limite especificando um valor para o atributo workItemCountLimit.
Os valores atribuídos a CategoryName devem corresponder a um grupo de categorias definido para o projeto de equipe. Vocêespecificar grupos de categorias no arquivo de definição de categorias.
Você usalistas de pendências de portfóliopara organizar sua lista de pendências, exibir o valor acumulado de itens de lista de pendências em níveis mais baixos e para exibir o progresso em várias equipes. Projetos de equipe novos e atualizados contêm dois níveis de lista de pendências de portfólio: recursos e epopéias. Você pode adicionar até três níveis adicionais. Apenas a lista de pendências do portfólio de nível superior não especifica uma categoria pai.
Dica
Talvez seja necessário teracesso avançadopraticar alguns dos recursos da lista de pendências de portfólio.
Olista de pendências de produtocorresponde ao seu plano de projeto, o roteiro para o que sua equipe planeja oferecer. Ela lista os itens de trabalho cujos WITs pertencem à categoria de requisitos. Para gerenciar os WITs diferentes daqueles fornecidos pelo seu projeto de equipe padrão, você pode adicionar WITs ã categoria de requisitos e mapear os estados do fluxo de trabalho para metaestados.
Olistas de pendências de sprint ou iteraçãoexibem o conjunto de requisitos que você e sua equipe comprometeram em um ciclo de determinado sprint e as tarefas que você vinculou a esses requisitos. Vincular tarefas a requisitos usando o tipo de link pai-filho. Como os WITs que aparecem nessas listas de pendências correspondem aos mesmos tipos que aparecem na lista de pendências de produto, grande parte do trabalho de personalização que você faz para a lista de pendências de produto definirá a funcionalidade da lista de pendências de sprint.
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.
Metaestados, por outro lado, determinam como as ferramentas de planejamento Agile tratam cada estado de 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 a lista de pendências de produto 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
Especificar quais campos você deseja exibir em cada lista de pendências dentro doColumnsseção. As alterações feitas por meio deOpções de colunadiálogo persistem até você alterá-las novamente.
Aqui está a configuração padrão definida pelo modelo de processo Scrum para a lista de pendências de produto.
<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 os elementos da lista de pendências:PortfolioBacklogRequirementBacklogeTaskBacklog. |
Column |
Especifica um campo a ser exibido como uma coluna em uma lista de pendências.
|
Cabeçalhos da coluna do painel de tarefas
Os títulos de colunas que aparecem no painel de tarefas correspondem aos estados de fluxo de trabalho atribuídos para o WIT atribuído à categoria de tarefa padrão. 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 de item de trabalho para aparecer no painel de lista de pendências de 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 motivos de desempenho, o painel de tarefas é restrito para exibir um máximo de 1.000 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 diminuir o limite especificandoworkItemCountLimit="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. Elemento de contêiner que define os mapeamentos de metaestado para os tipos de item de trabalho atribuídos à categoria de Bug. Além de como esses mapeamentos são usados na exibição de ferramentas do Agile, elas também controlam como oMeu trabalhorecurso no Team Explorer atualiza o estado de bug, como os desenvolvedores migram os bugs usandoMeu trabalho. Para obter mais informações, consulteUm dia na vida de um desenvolvedor do ALM: escrever 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". Você pode especificar qualquer cadeia de caracteres de texto para oTimeUnitStringque você deseja que apareça nas barras de capacidade na lista de pendências de sprint atual e no painel de tarefas. Para as ferramentas 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
Dias de folga são removidos do cálculos feitos pelográficos de burndown ferramenta de planejamento de capacidade. Processos padrão Visual Studio Online e modelos de processo do TFS especificam sábado e domingo como dias de folga. Depois de criar um projeto de equipe,cada equipe pode definir seus específicos dias de folga.
<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 instalado do TFS seu local. |
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. |
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.
O modelo de processo Scrum define as atribuições de cor a seguir. Itens semelhantes são feitas para os modelos Agile e CMMI.
<WorkItemColors>
<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
<WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
<WorkItemColor primary="FFFF7B00" secondary="FFFFD7B5" name="Epic" />
<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" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Plan" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Suite" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Parameter" />
</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 portal da web. 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.
|
Especificar propriedades e comportamentos
Há apenas uma propriedade que você pode especificar no momento. OBugsBehaviorpropriedade define a configuração padrão para como bugs e outros WITs definidos na categoria de Bug, aparecerão em listas de pendências e placas. Basicamente, você pode configurar se bugs são tratados como requisitos, como tarefas, ou não aparecem nas listas de pendências e placas. Depois de criar um projeto de equipe,cada equipe pode definir o comportamento que desejam.
<Properties>
<Property name="BugsBehavior" value="AsTasks" />
<Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />
</Properties>
Elemento |
Descrição |
---|---|
Properties |
Opcional. Elemento de contêiner para especificar propriedades padrão e comportamentos. |
Property |
Especifica a atribuição padrão feita em novas equipes ou equipes existentes ao atualizar um projeto de equipe com novos recursos. As equipes podem escolher o comportamento quiserem por meio de suas configurações de equipe. BugsBehaviorDefine o padrão para oMostrar bugs em listas de pendências ou placas. HiddenBacklogsEspecifica ocategoria da lista de pendências que está inativa para a equipe. Valores permitidos paraBugsBehaviorcorrespondem a:
|
Perguntas e respostas
P: como posso personalizar outros recursos da ferramenta Agile?
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, consulteConfigurar e personalizar ferramentas de planejamento do Agile para um projeto de equipe.
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 lendoAdicionar tipos de item de trabalho a listas de pendências e quadros.