Referência do elemento XML de configuração do processo

  • Artigo

Azure DevOps Server 2022 - Azure DevOps Server 2019

A configuração do processo define a configuração padrão e os recursos funcionais que suas equipes podem acessar usando as ferramentas Agile do portal da Web. Essas ferramentas incluem a lista de pendências do produto, listas de pendências de sprint, quadro Kanban e quadro de tarefas e são personalizáveis para cada equipe que você adiciona ao projeto.

Os elementos de configuração especificam os tipos de item de trabalho (WITs), colunas padrão, campos usados pelas ferramentas e outros elementos. As principais configurações feitas determinam quais itens serão exibidos para as listas de pendências de portfólio, produto e sprint definindo as seções PortfolioBacklog, RequirementBacklog e TaskBacklog do arquivo de definição XML de configuração do processo. Além disso, a configuração do processo define o mapeamento do fluxo de trabalho da categoria estado-a-estado para todos os WITs que exigem mapeamento.

Elementos XML de configuração do processo

Para obter um resumo do que você pode configurar por meio da interface do usuário, consulte Personalizar acompanhamento de trabalho, Adicionar equipes e configurar suas ferramentas Scrum e Kanban.

Áreas que você pode personalizar através de ProcessConfiguration:

Registos de Tarefas Pendentes Tipos de item de trabalho (WITs) Outras ferramentas
- Configurar o painel de adição rápida
- Definir colunas padrão
- Mapear categorias de estado para uma categoria WIT
- Definir o número de itens do quadro de tarefas
- Definir dias de fim de semana (Scrum)1
- Definir padrão Mostrar bugs em listasde pendências 1
- Definir listas de pendênciasocultas padrão 1		 - Especificar a cor WIT
- Especificar a cor2 do estado do fluxo de trabalho
- Especifique o íconeWIT 3		 - Atribuir campos de ferramentas Agile
- Mapear categorias de estado específicas da ferramenta
- Especificar propriedades

Nota

  1. Os itens anotados com um asterisco definem um padrão para o projeto. Esses itens podem ser alterados para cada equipe através das configurações da equipe.
  2. Com suporte para XML hospedado e para XML local para TFS 2015.2 ou versão posterior.
  3. Suportado para XML hospedado e para XML local para TFS 2017.2 ou versão posterior.

Importante

Se você quiser personalizar seu projeto para adicionar tipos de item de trabalho personalizados para aparecer em suas listas de pendências ou quadros ou adicionar listas de pendências de portfólio personalizadas, consulte Adicionar um tipo de item de trabalho a uma lista de pendências e quadro e Adicionar listas de pendências de portfólio.

Atualizar a configuração do processo

Nota

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 Process Template Manager.

Para atualizar a configuração do processo para um projeto, exporte o arquivo de definição XML, edite-o e importe o arquivo. Você exporta esses arquivos exportando um processo ou exportando o arquivo de definição de configuração do processo.

Exportar arquivo de definição ProcessConfigEditar arquivo de definição XMLImportar arquivo de definição WITAtualizar e verificar alterações

Gorjeta

Com o witadmin, você pode importar e exportar arquivos de definição. Outras ferramentas que você pode usar incluem o Editor de processos (requer que você tenha instalado uma versão do Visual Studio). Instale o editor de modelo de processo do Visual Studio Marketplace.

Configurar uma lista de pendências

Você pode personalizar os seguintes elementos para a lista de pendências de produtos, listas de pendências de sprint e listas de pendências de portfólio:

  • Mapeamentos de categoria de estado: mapeie estados de fluxo de trabalho para categorias de estado (anteriormente referido como metaestado). Esses mapeamentos suportam a exibição de todas as ferramentas de planejamento Agile, incluindo o Kanban e quadros de tarefas.

  • Painel de adição rápida: especifique os WITs e os campos de item de trabalho que aparecem para adicionar rapidamente itens à lista de pendências.

    Para alterar os tipos de itens de trabalho que são considerados itens ou tarefas da lista de pendências, adicione-os à categoria correspondente. Para obter um exemplo, consulte Adicionar bugs ao quadro de tarefas ou à lista de pendências.

  • Campos de coluna: defina os campos padrão e a sequência de colunas.

Você configura 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>

Nota

Dependendo do processo associado ao seu arquivo ProcessConfiguration — Agile, Scrum ou CMMI — o pluralName for the RequirementCategory corresponderá a Stories (Agile), Backlog Items (Scrum) ou Requirements (CMMI). Todos os três são semelhantes: descrevem o valor para o cliente a ser entregue e o trabalho a ser executado.

Sintaxe para elementos PortfolioBacklogs

Elemento

Descrição

PortfólioListas de pendências

Opcional. Elemento de contêiner para listas de pendências de portfólio.

PortfólioBacklog

Opcional. Até cinco instâncias.

Elemento de contêiner que define os mapeamentos de categoria de estado, colunas padrão e painel de adição rápida para uma lista de pendências de portfólio.

<PortfolioBacklog category="PortfolioCategory" parent="ParentCategory"  
pluralName="PluralName" singularName="SingleName" workItemCountLimit="MaximumLimit>  
<States> . . . </States>  
<Columns> . . . </Columns>  
<AddPanel> . . . </ AddPanel>  
</PortfolioBacklog >

Atribua valores aos atributos conforme descrito:

  • category: especifique o nome de uma categoria que você definiu no arquivo de definição de categorias para o projeto que contém os WITs a serem associados a esse tipo de lista de pendências.

  • pai: especifique o nome da categoria que representa a lista de pendências do portfólio pai na hierarquia.

  • pluralName: especifique o rótulo plural a ser usado ao se referir aos WITs associados a esse tipo de lista de pendências. Por exemplo, Histórias, Metas, Iniciativas ou Épicos.

  • singularName: especifique o rótulo singular a ser usado ao se referir aos WITs associados a esse tipo de lista de pendências. Por exemplo, História, Meta, Iniciativa ou Épico.

  • workItemCountLimit: especifique um inteiro. O padrão é 1000. Listas de pendências e quadros limitarão a contagem de itens exibidos com base nesse limite.

RequisitoBacklog

Obrigatório. Apenas uma instância.

Elemento de contêiner que define os mapeamentos de categoria de estado, colunas padrão e painel de adição rápida para a 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.

<RequirementBacklog category="RequirementCategory"  
pluralName="PluralName" singularName="SingleName"   
workItemCountLimit="MaximumLimit" >  
<States> . . . </States>
<Columns> . . . </Columns>
<AddPanel> . . . </ AddPanel>
</RequirementBacklog >

TaskBacklog

Obrigatório. Apenas uma instância.

Elemento de contêiner usado para personalizar o layout de listas de pendências de sprint.

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" 
singularName="Task workItemCountLimit="MaximumLimit">
. . . 
</TaskBacklog >

Notas sobre a aplicação

  • Por padrão, cada lista de pendências é restrita a um total de 1000 itens de trabalho. Você pode alterar esse limite especificando um valor para o workItemCountLimit atributo.
  • Os valores atribuídos a CategoryName devem corresponder a um grupo de categorias definido para o projeto. Você especifica grupos de categorias no arquivo de definição para Categorias.
  • Você usa listas de pendências de portfólio para organizar sua lista de pendências, exibir o acúmulo de itens da lista de pendências em níveis mais baixos e visualizar o progresso em várias equipes. Projetos novos e atualizados contêm dois níveis de carteira de pendência: Recursos e Épicos. 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.
  • Sua lista de pendências de produtos corresponde ao seu plano de projeto, o roteiro para o que sua equipe planeja entregar. Ele lista os itens de trabalho cujos WITs pertencem à Categoria de Requisitos. Para gerenciar WITs diferentes daqueles fornecidos pelo seu projeto padrão, você pode adicionar WITs à Categoria de Requisitos e mapear os estados do fluxo de trabalho para categorias de estado.
  • Suas listas de pendências de sprint ou iteração exibem o conjunto de requisitos com os quais você e sua equipe se comprometeram em um ciclo de sprint específico e as tarefas vinculadas a esses requisitos. Você vincula 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 do produto, grande parte do trabalho de personalização que você faz para a lista de pendências do produto definirá a funcionalidade da lista de pendências do sprint.

Mapear estados de fluxo de trabalho de categoria WIT para categorias de estado

Vários WITs exigem que seus estados de fluxo de trabalho sejam mapeados para uma categoria de estado. Os estados do fluxo de trabalho definem como um item de trabalho progride da primeira ativação ou criação para fechado ou concluído. Por exemplo, os estados definidos para o item de lista de pendências do produto Scrum definem uma progressão de quatro estados, de Novo, Aprovado, Comprometido para Concluído, e também inclui um quinto estado, Removido, para contabilizar um estado removido da lista de pendências sem ser implementado. Os estados do fluxo de trabalho estão associados ao value atributo.

As categorias de estado, por outro lado, determinam como as ferramentas de planejamento Agile tratam cada estado do fluxo de trabalho. As categorias de estado primário usadas pela lista de pendências e pelo quadro de tarefas são Proposed, InProgress e Complete. As categorias de estado estão associadas ao type atributo. Para saber mais, consulte Estados e categorias de estado do fluxo de trabalho.

Ao associar cada estado do fluxo de trabalho a uma categoria de estado, as operações em segundo plano executadas para exibir a lista de pendências e os quadros de tarefas sabem como interpretar corretamente o status de cada item de trabalho. Por exemplo, os mapeamentos a seguir são definidos para a lista de pendências do produto 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 grupos de categorias de estado: Agile, Bug e Feedback. A tabela a seguir descreve os atributos e valores de mapeamento.

Sintaxe para elementos States (categoria WIT)

Elemento

Descrição

Distrito

Obrigatório. Atribui um estado de fluxo de trabalho a uma categoria de estado.

<State value="ValueName" type="TypeName" />

Os valores válidos para ValueName 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 TypeName correspondem a um dos seguintes valores enumerados:

  • Agile: Use para todos os tipos de item de trabalho.
  • Proposto: Indica itens de trabalho novos, ainda não comprometidos ou que ainda não estão sendo trabalhados.
  • InProgress: Indica itens de trabalho que foram confirmados ou estão sendo trabalhados ativamente.
  • Concluído: indica os itens de trabalho que foram implementados. Para que o quadro Kanban seja válido, exatamente um estado de fluxo de trabalho deve ser mapeado para a categoria Estado completo . Se estados de fluxo de trabalho adicionais precisarem ser representados, eles poderão ser mapeados para a categoria Estado resolvido .
    Quando um estado de fluxo de trabalho transita para um estado associado ao metaestado Completo , o item de trabalho associado cairá da lista de pendências do produto. No entanto, ele continuará listado na última coluna do quadro Kanban.

    Os itens de trabalho em um estado de fluxo de trabalho que não são mapeados para uma das categorias de estado não aparecem na lista de pendências ou no quadro.
  • Erro: Use apenas para tipos de item de trabalho agrupados dentro da categoria de bug. Além das categorias de estado Agile, inclui a categoria de estado Resolvido , que indica bugs que foram resolvidos.

Nota

Você só pode atribuir a categoria de estado Resolvido a um estado de fluxo de trabalho especificado no elemento BugWorkItems .

  • Feedback: use apenas para tipos de item de trabalho agrupados nas categorias Solicitação de feedback ou Resposta de feedback. Solicitado, recebido, revisado e recusado.

Estados

Especifica uma coleção de elementos State que associam estados de fluxo de trabalho WIT a categorias de estado.

Elemento obrigatório para os seguintes elementos pai:

  • BugWorkItems
  • PortfólioBacklog
  • RequisitoBacklog
  • TaskBacklog
  • TestPlanWorkItems
  • TestSuiteWorkItems
  • FeedbackRequestWorkItems
  • FeedbackResponseWorkItems

Definir colunas padrão

Especifique quais campos você deseja exibir em cada lista de pendências na seção Colunas . As alterações feitas por meio da caixa de diálogo Opções de Coluna persistem até que você as altere novamente.

Colunas padrão e sequência para a página de lista de pendências

Aqui está a configuração padrão definida pelo modelo de processo Scrum para a lista de pendências do 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>

Sintaxe para elementos Columns

Elemento

Descrição

Colunas

Especifica uma coleção de elementos Column . Elemento necessário para os elementos da lista de pendências: PortfolioBacklog, RequirementBacklog e TaskBacklog.

Coluna

Especifica um campo a ser exibido como uma coluna em uma lista de pendências.

<Column refname="FieldReferenceName"  width="FieldWidth" />

Cabeçalhos de coluna do quadro de tarefas

Os cabeçalhos de coluna que aparecem no quadro de tarefas correspondem aos estados do fluxo de trabalho atribuídos ao WIT padrão atribuído à Categoria de Tarefa. A sequência de colunas corresponde à progressão natural das transições do fluxo de trabalho, movendo-se da esquerda para a direita. Para modificar o layout da coluna, modifique o fluxo de trabalho para o WIT atribuído à Categoria de Tarefa. Os estados do fluxo de trabalho definidos para o tipo de tarefa padrão na Categoria de Tarefa devem ser atribuídos a uma categoria de estado válida, conforme descrito em Mapear categorias de estado para uma categoria de tipos de item de trabalho.

Personalizar o painel de adição rápida

Você pode adicionar campos para qualquer painel de adição rápida. Por exemplo, o exemplo a seguir adiciona valor comercial ao painel de lista de pendências do produto.

Painel Backlog com campo Valor Empresarial adicionado

O painel exibe apenas os campos incluídos na seção CAMPOS da definição WIT para o WIT selecionado. Por exemplo, se você selecionar o bug WIT, somente Título será exibido, porque o Valor Comercial não está definido para bugs. Para adicionar outro WIT ao painel, adicione-o à Categoria de Requisitos, conforme descrito em Adicionar um tipo de item de trabalho a uma lista de pendências e quadro.

O código a seguir corresponde às atribuições padrão definidas nos modelos de processo Visual Studio Scrum e MSF for Agile.

<AddPanel>
      <Fields>
      <Field refname="System.Title" />
      </Fields>
</AddPanel>

Sintaxe para elementos AddPanel

Elemento

Descrição

Painel Suplementar

Elemento container usado para especificar a experiência de "adição rápida", os campos a serem exibidos dentro da área do painel onde novos itens da lista de pendências são definidos.

Campos

Especifica uma coleção de elementos Field .

Campo

Especifica um campo de item de trabalho a ser exibido no painel para a lista de pendências do produto.

<Field refname="FieldReferenceName"/>

O mesmo campo deve aparecer no formulário de item de trabalho de cada WIT incluído na categoria para a lista de pendências.

Definir o número de itens de trabalho do quadro de tarefas

Por motivos de desempenho, o quadro de tarefas é restrito a exibir um máximo de 1000 itens de trabalho. Quando você abre o quadro de tarefas, todos os itens de trabalho são carregados no cache. Limitar o número de itens de trabalho pode gerar tempos de carregamento mais rápidos. Você pode alterar esse limite especificando um valor para o workItemCountLimit atributo do elemento TaskBacklog .

Por exemplo, você pode diminuir o limite especificando workItemCountLimit="800":

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>

Mapear categorias de estado para tipos de item de trabalho específicos da ferramenta

Os mapeamentos de categoria de estado são definidos para categorias WIT adicionais. Para o modelo de processo Scrum, isso inclui mapeamentos para as categorias de solicitação de feedback e resposta. Para os modelos de processo MSF Agile e CMMI, ele também inclui mapeamentos para a categoria de bug. (O Scrum inclui bugs na Categoria de Requisitos e, portanto, define os mapeamentos de categoria de estado dentro do 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 categoria de estado para tipos de item de trabalho específicos da ferramenta. Consulte Mapear categorias de estado para uma categoria de tipos de item de trabalho para obter informações sobre como atribuir os valores e tipos de estado reais. O CategoryName deve corresponder a uma categoria definida para o projeto.

Sintaxe para elementos de mapeamento de categoria de estado específicos da ferramenta

Elemento

Descrição

BugWorkItems

Opcional. Elemento de contêiner que define os mapeamentos de categoria de estado para tipos de item de trabalho atribuídos à Categoria de Bug. Além de como esses mapeamentos são usados na exibição de ferramentas Agile, eles também controlam como o recurso Meu Trabalho no Team Explorer atualiza o estado do bug à medida que os desenvolvedores movem bugs usando Meu Trabalho. Para saber mais, consulte Obter seu código revisado (TFVC).

<BugWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</BugWorkItems>

FeedbackRequestWorkItems

Obrigatório. Não personalize. Elemento de contêiner que define os mapeamentos de categoria de estado para tipos de item de trabalho atribuídos à categoria de solicitação de feedback.

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackRequestWorkItems>

FeedbackResponseWorkItems

Obrigatório. Não personalize. Elemento de contêiner que define os mapeamentos de categoria de estado para tipos de item de trabalho atribuídos à categoria de resposta de feedback.

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackResponseWorkItems>```

TestPlanWorkItems

Apenas necessário quando você personaliza o estado do fluxo de trabalho para o Plano de Teste e oferece suporte a conexões com o projeto a partir de versões do Test Manager instaladas com o Visual Studio 2013.2 ou versões anteriores.

Elemento de contêiner que define os mapeamentos de categoria de estado para tipos de item de trabalho atribuídos à Categoria de Plano de Teste. Por exemplo:

<TestPlanWorkItems category="Microsoft.TestPlanCategory"  
pluralName="Test Plans" singularName="Test Plan">
<States>
<State type="InProgress" value="Design" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Signed Off" />
</States>
</TestPlanWorkItems>

TestSuiteWorkItems

Necessário apenas quando você personaliza o estado do fluxo de trabalho para o Test Suite e oferece suporte a conexões com o projeto a partir de versões do Test Manager instaladas com o Visual Studio 2013.2 ou versões anteriores.

Elemento de contêiner que define os mapeamentos de categoria de estado para tipos de item de trabalho atribuídos à categoria Test Suite. Por exemplo:

<TestSuiteWorkItems  
category="Microsoft.TestSuiteCategory"  
pluralName="Test Suites" singularName="Test Suite">
<States>
<State type="Proposed" value="Authoring" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Completed" />
</States>
</TestSuiteWorkItems>

Nota

Disponibilidade de recursos: para mapear categorias de estado para TestPlanWorkItems ou TestSuiteWorkItems, você deve atualizar seu servidor de camada de aplicativo para o TFS 2013.3 ou versão posterior. Depois, você pode personalizar o estado do fluxo de trabalho de planos de teste e suítes de teste. Para saber mais, consulte Plano de teste e recursos do conjunto de testes.

Atribuir campos de ferramentas Agile

Você pode alterar os campos de item de trabalho que são usados no cálculo de capacidade, gráficos de burndown, previsão e velocidade. Qualquer alteração feita 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" , deverá incluir o mesmo campo na definição WIT atribuída à Categoria de Tarefa que captura as informações de 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>

Sintaxe para elementos TypeFields

Elemento

Descrição

TipoCampos

Obrigatório. Especifica uma coleção de elementos TypeField .

TypeField

Obrigatório. Especifica o nome de referência de um campo cujo valor suporta um tipo de atividade para uma área de recurso. Os campos especificados devem corresponder aos campos que você usa dentro dos WITs usados para capturar as informações do recurso.

<TypeField refname="FieldReferenceName"  
type="NameOfType" [format="{0} TimeUnitString"] / >

Especifique o formato somente quando type="RemainingWork". Você pode especificar qualquer cadeia de caracteres de texto para TimeUnitString que você deseja que apareça nas barras de capacidade na lista de pendências de sprint atual e no quadro de tarefas.

Para ferramentas ágeis:

  • Atividade: Usado para dar suporte ao recurso capacidade por atividade. Especifique o mesmo campo usado no WIT atribuído à Categoria de Tarefa.

Nota

Os valores exibidos pela ferramenta Capacidade refletem uma união de todos os valores definidos para o campo em todos os projetos dentro da instância de coleta de projetos. Portanto, para restringir os valores que aparecem para Capacidade de sprint, você deve fazer com que os valores correspondam em todos os projetos para o campo atribuído a type="Activity".

  • Esforço: Usado para calcular a velocidade da equipe. Especifique o mesmo campo usado no WIT atribuído à Categoria de Requisito que você usa para capturar o nível estimado de esforço, pontos de história ou tamanho para a quantidade de trabalho que um item de lista de pendências requer para implementar.

  • Ordem: Usada para definir a ordem de classificação dos itens nas listas de pendências e quadros. O sistema lista os itens de trabalho de acordo com sua ordem crescente, conforme definido pelo campo para este tipo.

Nota

Você pode mover itens arrastando-os para cima ou para baixo na lista em uma lista de pendências ou quadro. À medida que você move itens, um processo em segundo plano atualiza o campo atribuído ao type="Order".

  • RemainingWork: Usado para calcular o trabalho restante e gráficos de burndown. Especifique o mesmo campo usado no WIT atribuído à Categoria de Tarefa que você usa para capturar as horas, dias ou outra unidade de medida que restam para concluir uma tarefa.
    O valor especificado para o formato é usado nas listas de pendências de sprint e nos quadros de tarefas sempre que o trabalho restante é relatado. Por exemplo, ao relatar capacidade por atividade ou capacidade por membro da equipe, ou ao lado do título da coluna para os estados da tarefa no quadro de tarefas.
    Para TimeUnitString, especifique qualquer cadeia de texto que você deseja usar para refletir o valor de tempo, como horas ou dias.
    Por exemplo, os seguintes valores são todos válidos:
    format="{0} h"
    format="{0} hours"
    format="hours {0}"
    format="time {0}"
  • Equipe: Usado para associar as listas de pendências a uma equipe. O valor padrão é System.AreaPath. Para separar equipes de caminhos de área, você pode especificar um campo diferente, conforme descrito em Usar campos de equipe em vez de caminhos de área para equipes de suporte.
    Para o formulário de solicitação de feedback:

Nota

Não deve ser necessário alterar as atribuições padrão feitas para os seguintes elementos TypeField . Essas atribuições correspondem aos campos usados para capturar as informações correspondentes no WIT atribuído à Categoria de Solicitação de Feedback.

  • ApplicationStartInformation: Usado para capturar o caminho para executar o aplicativo.

  • ApplicationLaunchInstructions: Usado para capturar instruções de inicialização.

  • ApplicationType: Usado para capturar o tipo de aplicativo. Os tipos listados correspondem aos valores permitidos especificados na definição WIT para a solicitação de feedback.

TypeFieldValues

Necessário para o TypeFieldValue quando type="ApplicationType". Especifica uma coleção de elementos TypeFieldValue que são usados no formulário de solicitação de feedback.

TypeFieldValue

Obrigatório. Não personalize. Especifica o nome de um tipo de aplicativo a ser exibido no formulário de solicitação de feedback.

<TypeFieldValue value="ApplicationTypeName" type="TypeApp"/>

As atribuições padrão correspondem aos valores permitidos especificados na definição de tipo para o formulário de solicitação de feedback.

<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>

Notas sobre a aplicação

  • Se você alterar um campo dentro da seção TypeFields , deverá fazer a alteração correspondente na definição WIT. Por exemplo, se você alterar os campos atribuídos para capturar o trabalho Effort, deverá fazer a mesma alteração nas definições WIT para o item de lista de pendências do produto e bug (para Scrum).

  • Você pode procurar o nome de referência para um campo usando esse índice.

Definir dias não úteis

Os dias não úteis são removidos dos cálculos feitos pela ferramenta de planejamento de capacidade e pelos gráficos de burndown. Os processos padrão — Agile, Scrum ou CMMI — especificam sábado e domingo como dias não úteis.

<Weekends>
   <DayOfWeek>Saturday</DayOfWeek>
   <DayOfWeek>Sunday</DayOfWeek>
</Weekends>

Sintaxe para elementos Weekends

Elemento

Descrição

DiadeSemana

Filho obrigatório do elemento Fins de semana.

Especifica um dia da semana que corresponde a um dia não útil.

<DayOfWeek>NameOfADay</DayOfWeek>

Os nomes válidos correspondem aos dias da semana em inglês: domingo, segunda-feira, terça-feira, quarta-feira, quinta-feira, sexta-feira e sábado.

Nota

Você deve especificar o dia de uma semana em inglês, independentemente do idioma instalado do seu TFS local.

Fins de semana

Opcional. Elemento container usado para especificar dias não úteis.

Especifique os dias não úteis quando quiser contabilizar os dias não úteis no cálculo da capacidade e nos gráficos de burndown.

Alterar a cor de um tipo de item de trabalho

De relance, você pode diferenciar WITs ao visualizar um resultado de consulta ou lista de pendências com base na cor e no ícone atribuídos ao WIT. O sistema aplica a cor definida para o tipo de item de trabalho ao ícone especificado para o WIT.

Resultados da consulta mostrando cor, ícone e cor de estado

O modelo de processo Scrum define as seguintes atribuições de cores. Semelhantes são feitos 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>

Sintaxe para elementos WorkItemColors

Elemento

Descrição

WorkItemColors

Opcional. Elemento container para especificar cores para tipos de item de trabalho.

WorkItemColor

Especifica as cores usadas para exibir um WIT no portal da Web. A cor primária é usada em exibições de lista. A cor secundária não é mais referenciada, no entanto, você deve especificá-la para que a sintaxe seja validada.

Ao especificar a cor, sempre prefixe o código de cor hexadecimal de seis dígitos com FF , o que indica que a cor deve ser totalmente visível.

<WorkItemColor primary="HexColorCode" secondary="HexColorCode"  
name="witName" />

Especificar propriedades e comportamentos

As duas primeiras propriedades que você pode definir BugsBehavior e HiddenBacklogs definir o valor padrão para um projeto. No entanto, cada equipe pode alterar o comportamento através de suas configurações de equipe. A terceira propriedade StateColors define as cores associadas aos estados do fluxo de trabalho para todos os WITs. Os valores definidos são usados para todas as equipes em um projeto.

Exemplo de Properties configuração:

 <Properties>  
      <Property name="BugsBehavior" value="AsTasks" />  
      <Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />  
      <Property name="StateColors" value="Active=#FF00FF00,Resolved=#FFFF0000" />
      <Property name="WorkItemTypeIcons" value="Epic=Icon_Crown,Feature=Icon_Trophy,User Story=icon_book,
        Task=icon_clipboard,Bug=icon_insect,Issue=icon_traffic_cone,
        Test Plan=icon_test_plan,Test Suite=icon_test_suite,Test Case=icon_test_case,Shared Steps=icon_test_step,
        Shared Parameter=icon_test_parameter" />  
  </Properties>

A BugsBehavior propriedade determina como os bugs e outros WITs definidos na Categoria de Bug aparecem em listas de pendências e quadros. Basicamente, você pode configurar se os bugs são tratados como requisitos, como tarefas, ou não aparecem em listas de pendências e quadros. Para obter detalhes, consulte Mostrar bugs em listas de pendências e quadro.

A HiddenBacklogs propriedade determina quais pendências/listas de pendências de portfólio aparecem por padrão. O padrão é mostrar apenas a lista de pendências do produto e um nível de lista de pendências do portfólio, a lista de pendências de recursos. As equipes podem determinar se desejam ativar a lista de pendências do Epics ou fazer outras alterações. Para obter detalhes, consulte Organizar sua lista de pendências, Ativar níveis de lista de pendências para sua equipe.

Sintaxe para elementos Properties

Elemento

Descrição

Propriedades

Opcional. Elemento container para especificar propriedades e comportamentos padrão.

Propriedade

Especifica a atribuição padrão feita a novas equipes ou equipes existentes ao atualizar um projeto com novos recursos. As equipas podem escolher o comportamento que desejam através das suas definições de equipa.

Os nomes de propriedade válidos são:

  • BugsBehavior define o padrão para Mostrar bugs em listas de pendências e quadro. Os valores permitidos correspondem a:
  • AsRequirements — Bugs aparecem em backlogs e quadros semelhantes aos requisitos (padrão para o processo Scrum)
  • AsTasks — Bugs aparecem em backlogs e quadros semelhantes a tarefas (padrão para processos Agile e CMMI)
  • Desativado — Os bugs não aparecem em listas de pendências ou quadros
  • HiddenBacklogs especifica a lista de pendências que está inativa por padrão.
  • StateColors define os valores de cor para estados de fluxo de trabalho. (Requer TFS 2017 ou versão posterior)
    O valor da propriedade é uma lista separada por vírgulas de nomes de estado e cores hexadecimais. Prefira o código de cores hexadecimal de seis dígitos com FF, que indica que a cor deve ser totalmente visível.
    <Property name="StateColors" value="stateName1=color1, stateName2=color2,..." />

Nota

Disponibilidade de recursos: você pode especificar cores de estado do fluxo de trabalho se usar XML hospedado ou, para XML local, tiver atualizado para o TFS 2015.2 ou versão posterior.
Para obter detalhes adicionais, consulte a próxima seção, Especificar cores de estado do fluxo de trabalho.

  • WorkItemTypeIcons define o ícone a ser exibido para cada tipo de item de trabalho. O ícone é exibido em listas de itens de trabalho e em formulários de item de trabalho. A entrada padrão para o processo Agile é como mostrado. Você só pode especificar um ícone da lista de ícones suportados.

<Property name="WorkItemTypeIcons" 
value="Epic=Icon_Crown,Feature=Icon_Trophy,  
User Story=icon_book,Task=icon_clipboard,Bug=icon_insect,  
Issue=icon_traffic_cone,Test Plan=icon_test_plan,Test Suite=icon_test_suite,  
Test Case=icon_test_beaker,Shared Steps=icon_test_step,Shared Parameter=icon_test_parameter" />

Nota

Disponibilidade de recursos: você pode personalizar os ícones usados para tipos de item de trabalho se usar XML hospedado ou, para XML local, tiver atualizado para o TFS 2017.2 ou versão posterior.

Especificar cores de estado do fluxo de trabalho

Nota

Disponibilidade do recurso: para especificar as cores do estado do fluxo de trabalho, você deve atualizar para o TFS 2015.2 ou versão posterior.

A cor que você associar aos estados do item de trabalho aparecerá em todo o produto. Isto inclui as seguintes áreas:

  • Formulário de item de trabalho (portal da Web, consulte Nova experiência de item de trabalho)
  • Controle de links de formulário de item de trabalho (portal da Web, consulte Referência de elementos XML LinksControlOptions)
  • Cartões exibidos no quadro Kanban e nos quadros de tarefas (Para configurações, consulte Personalizar cartões)
  • Todas as listas de pendências (adicionar Estado através de opções de coluna)
  • Resultados da consulta (adicionar Estado através de opções de coluna)

Aqui mostramos como ele aparece no formulário de item de trabalho:

Bug cabeçalho do formulário de item de trabalho, cor do estado mostrado

Nota

Nenhuma cor é exibida nos formulários de item de trabalho do cliente ou no controle de links antigos dentro do formulário do cliente.

Detalhes:

  • Você deve especificar a cor como um valor hexadecimal de oito dígitos, semelhante ao usado para a cor definida para um WIT
  • Para adicionar ou editar cores, basta reimportar a configuração do processo com a propriedade updated
  • As cores de estado são definidas pelo nome em todos os tipos de item de trabalho, ou seja, não há como ter "Ativo" sendo uma cor para User Story e uma cor diferente para Bug
  • As cores não mapeadas são padronizadas no tempo de execução com base em seu mapeamento de meta-estado
  • Estados sem cor definida e sem mapeamento de meta-estado mostrarão um círculo vazio.

Especificar ícones WIT

Nota

Disponibilidade de recursos: você pode personalizar os ícones usados para tipos de item de trabalho se usar XML hospedado ou, para XML local, tiver atualizado para o TFS 2017.2 ou versão posterior.

O conjunto suportado de ícones que você pode especificar para um tipo de item de trabalho é mostrado abaixo.

icon_airplane, icon_asterisk, icon_book, icon_car, icon_chart, icon_chat_bubble, icon_check_box, icon_clipboard, icon_code_response icon_code_reviewicon_palette, icon_crown, icon_database_storage, icon_diamond, icon_flame, icon_gavel, icon_gear, icon_gift, icon_government icon_headphoneicon_insect, icon_key, icon_list, icon_megaphone, icon_paint_brush, icon_parachute, icon_response, icon_review, icon_ribbon icon_sticky_noteicon_star, icon_test_beaker, icon_test_parameter, icon_test_plan, icon_test_step, icon_test_suite, icon_traffic_cone icon_trophy

Nota

Os ícones observados com um asterisco são suportados nos Serviços de DevOps do Azure e no TFS 2017.3 e versões posteriores.

O sistema aplica a cor definida para o tipo de item de trabalho ao ícone. Cores e ícones aparecem no portal da Web onde sempre os itens de trabalho são exibidos. Isso inclui em Trabalho relacionado em RPs, lista de links, as páginas do projeto , bem como listas de pendências de trabalho , quadros, consultas e planos.

Por exemplo, aqui você vê uma exibição de lista...

Portal da Web, lista de itens de trabalho com ícones

e, aqui, o ícone é mostrado dentro do formulário de item de trabalho.

Cabeçalho do formulário de item de trabalho de bug, ícone de tipo de item de trabalho mostrado

Saiba mais sobre o formulário de item de trabalho na Web e como personalizá-lo a partir destes tópicos adicionais:

Se você adicionou um WIT personalizado e deseja adicioná-lo à lista de pendências ou ao quadro de tarefas, você pode. Você simplesmente não pode fazê-los aparecer em ambos os lugares. Saiba como lendo Adicionar tipos de item de trabalho a listas de pendências e quadros.