Compartilhar via


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

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, as listas de pendências de sprint, o quadro e o 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 o acompanhamento de trabalho, Adicionar equipes e configurar suas ferramentas Scrum e Kanban.

Áreas que você pode personalizar por meio de ProcessConfiguration:

Observação

  1. Os itens anotados com um asterisco definem um padrão para o projeto. Esses itens podem ser alterados para cada equipe por meio das configurações da equipe.
  2. Com suporte para XML hospedado e para XML local para TFS 2015.2 ou versão posterior.
  3. Com suporte 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

Observação

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.

Para atualizar a configuração do processo de 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

Dica

Com o witadmin, você pode importar e exportar arquivos de definição. Outras ferramentas que você pode usar incluem o Editor de Processos (exige 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 do produto, 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 chamadas de metaestado). Esses mapeamentos suportam a exibição de todas as ferramentas de planejamento Agile, incluindo o quadro e os quadros de tarefas.

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

    Para alterar os tipos de itens de trabalho que são considerados itens de lista de pendências ou tarefas, 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 nas 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>

Observação

Dependendo do processo associado ao 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 do cliente a ser entregue e o trabalho a ser executado.

Sintaxe para elementos PortfolioBacklogs

Element

Descrição

PortfólioBacklogs

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

Carteira de Portfólio

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 dentro da 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 número inteiro. O padrão é 1000. As listas de pendências e os quadros limitarão a contagem de itens exibidos com base nesse limite.

RequisitoBacklog

Obrigatória. 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 >

Lista de pendências de tarefas

Obrigatória. Apenas uma instância.

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

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

Notas de implementaçã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 de lista de pendências em níveis inferiores e exibir o progresso em várias equipes. Projetos novos e atualizados contêm dois níveis de lista de pendências de portfólio: Recursos e Épicos. Você pode adicionar até três níveis adicionais. Somente a lista de pendências de portfólio de nível superior não especifica uma categoria pai.
  • Seu backlog de produto corresponde ao seu plano de projeto, o roteiro para o que sua equipe planeja entregar. Ele lista 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 que você vinculou 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 de 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, Confirmado a 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 de fluxo de trabalho são associados ao value atributo.

As categorias de estado, por outro lado, determinam como as ferramentas de planejamento ágil 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 Proposta, Em Andamento e Concluída. As categorias de estado estão associadas ao type atributo. Para obter mais informações, consulte Estados de fluxo de trabalho e categorias de estado.

Ao associar cada estado de 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>

Há 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 de estados (categoria WIT)

Element

Descrição

Estado

Obrigatórios. 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 que são novos, ainda não confirmados ou ainda não estão sendo trabalhados.
  • InProgress: indica itens de trabalho que foram confirmados ou estão sendo trabalhados ativamente.
  • Concluído: indica itens de trabalho que foram implementados. Para que a placa seja válida, exatamente um estado de fluxo de trabalho deve ser mapeado para a categoria de estado Completo . Se estados de fluxo de trabalho adicionais precisarem ser representados, eles poderão ser mapeados para a categoria de estado Resolvido .
    Depois que um estado de fluxo de trabalho fizer a transição para um estado associado ao metaestado Complete , o item de trabalho associado cairá da lista de pendências do produto. No entanto, ele continuará listado na última coluna do quadro.

    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.
  • Bug: use somente para tipos de item de trabalho agrupados na categoria de bug. Além das categorias de estado Agile, inclui a categoria de estado Resolvido , que indica bugs que foram resolvidos.

Observação

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

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

Estados

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

Elemento obrigatório para os seguintes elementos pai:

  • BugWorkItems
  • Carteira de Portfólio
  • RequisitoBacklog
  • Lista de pendências de tarefas
  • TestPlanWorkItems
  • TestSuiteWorkItems
  • Itens de trabalho de solicitação de feedback
  • 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 e sequência padrão 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

Element

Descrição

Colunas

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

Coluna

Especifica um campo para aparecer como uma coluna em uma lista de pendências.

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

Títulos de coluna do quadro de tarefas

Os títulos de coluna que aparecem no painel de tarefas correspondem aos estados de 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 do WIT atribuído à Categoria de Tarefa. Os estados de 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 de Negócios adicionado

O painel exibe apenas os campos incluídos na seção FIELDS da definição de WIT para o WIT selecionado. Por exemplo, se você selecionar o bug WIT, somente Título será exibido, pois 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 do Visual Studio Scrum e do MSF for Agile.

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

Sintaxe para elementos AddPanel

Element

Descrição

AddPanel

Elemento de contêiner usado para especificar a experiência de "adição rápida", os campos a serem exibidos na área do painel em que novos itens de lista de pendências são definidos.

Fields

Especifica uma coleção de elementos Field .

Campo

Especifica um campo de item de trabalho a ser exibido no painel da 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 da lista de pendências.

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

Por motivos de desempenho, o painel 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 adicionais do WIT. Para o modelo de processo Scrum, isso inclui mapeamentos para as categorias de solicitação e resposta de feedback. 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

Element

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 obter mais informações, consulte Obter seu código revisado (TFVC).

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

Itens de trabalho de solicitação de feedback

Obrigatória. 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 comentários.

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

FeedbackResponseWorkItems

Obrigatória. 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 comentários.

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

TestPlanWorkItems

Necessário apenas quando você personaliza o estado do fluxo de trabalho para o Plano de Teste e dá suporte a conexões com o projeto 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 dá suporte a conexões com o projeto 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 conjunto de testes. 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>

Observação

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. Posteriormente, é possível customizar o estado do fluxo de trabalho de planos de teste e conjuntos de testes. Para obter mais informações, consulte Test Plan e Test Suite features.

Atribuir campos de ferramentas ágeis

Você pode alterar os campos de item de trabalho 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 de WIT atribuída à Categoria de Tarefa que captura as 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>

Sintaxe para elementos TypeFields

Element

Descrição

CamposDeTipo

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

CampoTipo

Obrigatória. 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 nos 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 o TimeUnitString que deseja que apareça nas barras de capacidade na lista de pendências de sprint atual e no painel de tarefas.

Para ferramentas ágeis:

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

Observação

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 da coleção de projetos. Portanto, para restringir os valores que aparecem para a 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 ser implementado.

  • 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 esse tipo.

Observação

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 gráficos de trabalho e burndown restantes. 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 painel de tarefas.
    Para TimeUnitString, especifique qualquer cadeia de caracteres 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 desacoplar 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 dar suporte a equipes.
    Para o formulário de solicitação de feedback:

Observação

Você não deve ter que alterar as atribuições padrão feitas para os elementos TypeField a seguir. Essas atribuições correspondem aos campos usados para capturar as informações correspondentes no WIT atribuído à Categoria de Solicitação de Comentários.

  • 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 de WIT para a solicitação de comentários.

TipoCamposValores

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

ValorDoCampoDeTipo

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

<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 comentários.

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

Notas de implementação

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

  • Você pode pesquisar o nome de referência de 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 de fim de semana

Element

Descrição

DayOfWeek

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, terça, quarta, quinta, sexta e sábado.

Observação

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

Semana

Opcional. Elemento de contêiner usado para especificar dias não úteis.

Especifique os dias não úteis quando você deseja contabilizar os dias não úteis no cálculo de gráficos de capacidade e burndown.

Alterar a cor de um tipo de item de trabalho

De relance, você pode diferenciar WITs ao exibir 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 a cor da inteligência, o ícone e a cor do estado

O modelo de processo Scrum define as seguintes atribuições de cores. Outros 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

Element

Descrição

Cores_doItemTrabalho

Opcional. Elemento de contêiner 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 , 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 por meio de suas configurações de equipe. A terceira propriedade StateColors define as cores associadas aos estados de 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 listas de 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 de propriedades

Element

Descrição

Propriedades

Opcional. Elemento de contêiner 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 equipes podem escolher o comportamento que desejam por meio de suas configurações de equipe.

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 listas de pendências 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 o TFS 2017 ou versão posterior)
    O valor da propriedade é uma lista separada por vírgulas de nomes de estado e cores hexadecimais. Prefixe o código de cor hexadecimal de seis dígitos com FF, que denota que a cor deve ser totalmente visível.
    <Property name="StateColors" value="stateName1=color1, stateName2=color2,..." />

Observação

Disponibilidade de recursos: você pode especificar cores de estado de 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 de 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 é mostrada. Você só pode especificar um ícone da lista de ícones com suporte.

<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" />

Observação

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 de fluxo de trabalho

Observação

Disponibilidade de recursos: 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ê associa aos estados do item de trabalho aparecerá em todo o produto. Isso 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 e nos quadros de tarefas (para configurações, consulte Personalizar cartões)
  • Todas as listas de pendências (adicionar estado por meio de opções de coluna)
  • Resultados da consulta (adicionar opções de estado por meio de coluna)

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

Cabeçalho do formulário do item de trabalho de bug, cor do estado mostrada

Observação

Nenhuma cor é exibida nos formulários de item de trabalho do cliente ou no controle de links antigo 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 fazer com que "Ativo" seja uma cor para a História do Usuário e uma cor diferente para o Bug
  • As cores não mapeadas são padronizadas no tempo de execução com base em seu mapeamento de metaestado
  • Estados sem cor definida e sem mapeamento de meta-estado mostrarão um círculo vazio.

Especificar ícones WIT

Observação

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 de ícones com suporte 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_review icon_palette, icon_crown, icon_database_storage, icon_diamond, icon_flame, icon_gavel, icon_gear, icon_gift, icon_government, icon_headphone icon_insect, icon_key, icon_list, icon_megaphone, icon_paint_brush, icon_parachute, icon_response, icon_review, icon_ribbon, icon_sticky_note icon_star, icon_test_beaker, icon_test_parameter, icon_test_plan, icon_test_step, icon_test_suite, icon_traffic_cone, icon_trophy

Observação

Os ícones marcados com um asterisco têm suporte em Azure DevOps Services e 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 os itens de trabalho são exibidos. Isso inclui em Trabalho relacionado em PRs, 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 no 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 da Web e como personalizá-lo nestes 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 fazer com que eles apareçam em ambos os lugares. Saiba como lendo Adicionar tipos de item de trabalho a listas de pendências e quadros.