Compartilhar via


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

Arquivos de configuração do processo determinam o layout e a funcionalidade dos seguintes recursos: velocity de equipe e a lista de pendências de produto, lista de pendências de iteração, a capacidade da equipe e gráficos de burndown, board tarefas, os comentários de stakeholder, e Minhas atividades.Você pode exportar esses arquivos de configuração, AgileConfiguration e CommonConfiguration, da sua equipe de projeto ou acessá-los a partir do modelo de processo que você baixa da Visual Studio Team Foundation Server 2012.Você personalizar o layout das páginas da lista de pendências, modificando as definições especificadas no AgileConfiguration e você personalizar áreas comuns a vários recursos, modificando as definições especificadas no CommonConfiguration.

Para uma visão geral dos recursos que podem ser personalizadas, consulte Personalizar a lista de pendências e as páginas do quadro usando a configuração do processo.

ObservaçãoObservação

Para obter informações sobre como uma equipe usa as páginas de placa de listas de pendências e tarefas, consulte Planejamento ágil e iterações.

Neste tópico

  • AgileConfiguration: estrutura de sintaxe e elementos

  • CommonConfiguration: estrutura de sintaxe e elementos

AgileConfiguration: estrutura de sintaxe e elementos

Você personalizar a página de lista de pendências modificando os elementos contidos no AgileProjectConfiguration elemento.Para personalizar a página de lista de pendências de produto, modificar os elementos dentro do ProductBacklog elemento e para personalizar as páginas de lista de pendências de iteração, modificar os elementos contidos a IterationBacklog elementos.

O exemplo XML a seguir mostra a estrutura de código que define a configuração do processo ágil contida no arquivo AgileConfiguration.xml.Este exemplo corresponde à sintaxe padrão definido para o MSF for Agile Software Development v de 6.0.

<?xml version="1.0" encoding="utf-8"?>
<AgileProjectConfiguration>
  <ProductBacklog>
    <Columns>
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.IterationPath" width="200" />
    </Columns>
    <AddPanel>
      <Fields>
        <Field refname="System.Title" />
      </Fields>
    </AddPanel>
  </ProductBacklog>
  <IterationBacklog>
    <Columns>
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="System.AssignedTo" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.RemainingWork" width="50" />
    </Columns>
  </IterationBacklog>
</AgileProjectConfiguration>

De volta ao topo

Hh500408.collapse_all(pt-br,VS.110).gifElementos XML para as páginas de registro posterior

A tabela a seguir descreve os elementos filho do AgileProjectConfiguration elemento raiz.Você pode usar esses elementos para especificar as colunas e os campos que devem aparecer na página lista de pendências.

Elemento

Descrição e sintaxe

Anotações

AddPanel

Elemento de recipiente usado para especificar a experiência de "Adicionar rápido", os campos apareçam dentro da área do painel onde os novos itens de lista de pendências são definidos.

<AddPanel>
    <Fields>
       <Field . . . />
       . . .
   </Fields>
</AddPanel>

Necessário.Uma instância somente.

Você deve especificar pelo menos um Fields elemento.

A experiência de "Adicionar rápido" só aparece na página lista de pendências de produto na Team Web Access.

Column

Especifica um campo seja exibido como uma coluna em uma página de lista de pendências.

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

Necessário.

Para cada coluna que você deseja que apareça nas páginas que exibem uma lista de pendências, você deve especificar o nome de referência para um campo que é definido para o tipo de item de trabalho associado a itens de lista de pendências.Você deve especificar um número inteiro positivo para a largura do campo.

Columns

Especifica uma coleção de Column elementos.

<Columns>
   <Column . . . />
   . . .
</Columns>

Necessário.Uma instância somente para cada IterationBacklog e ProductBacklog pai elementos.

Você deve especificar as colunas que você deseja que apareça nas páginas que exibem a lista de pendências de produto ou uma lista de pendências de iteração.

Field

Especifica um campo apareça dentro do painel para a página de lista de pendências de produto.

<Field refname=”FieldReferenceName” />

Necessário.Um ou mais elementos contidos no Fields elemento pai.

Quando você define um item de trabalho para adicionar à lista de pendências, você pode especificar um valor para os campos que você listar dentro do AddPanel seção do processo de configuração.

A configuração padrão especifica o título campo como o único campo para exibir, conforme mostrado no seguinte exemplo de código:

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

Fields

Especifica uma coleção de Field elementos.

<Fields>
<Field . . . />
   . . .
</Fields>

Necessário.Uma instância definida apenas para o AddPanel elemento pai.

Você especificar os campos que você deseja especificar rapidamente quando itens são adicionados à lista de pendências de produto.

IterationBacklog

Elemento de recipiente usado para personalizar o layout de páginas que exibem os itens de trabalho atribuídos a uma iteração específica.

<IterationBacklog workItemCountLimit="MaximumLimit"  >
   <Columns> . . . </Columns>
   . . . 
</IterationBacklog > 

Necessário.Uma instância somente.

Você especificar o número de colunas, as larguras de coluna e os campos que preenchem a cada coluna dessas páginas que exibem a lista de itens de lista de pendências atribuído a uma iteração.

Por padrão, a placa de tarefa é restrita a um total de 500 itens de trabalho.Você pode alterar esse limite especificando um valor para o workItemCountLimit atributo.

ProductBacklog

Elemento de contêiner usado para personalizar o layout da página que exibe a lista de pendências de produto e que contém um painel para adicionar itens de trabalho à lista de pendências.

<ProductBacklog>
   <Columns> . . . </Columns>
   <AddPanel> . . . </ AddPanel>
</ProductBacklog >

Necessário.Uma instância somente.

Você especificar o número de colunas, as larguras de coluna e os campos que preenchem a cada coluna dessas páginas que exibem a lista de itens de lista de pendências atribuído à lista de pendências de produto.A lista de pendências de produto exibe todos os itens ativos da lista de pendências, inclusive aquelas que tiverem sido atribuídos a uma iteração.

De volta ao topo

CommonConfiguration: estrutura de sintaxe e elementos

Você personalizar a página de placa de tarefa usando o CommonProjectConfiguration elemento, que oferece suporte a vários elementos filho.O TypeFields Especifica o campo que é usado em tipos de itens de trabalho para capturar informações específicas.Vários dos outros elementos filho, por exemplo, RequirementWorkItems, TaskWorkItems, e BugWorkItems Especifica o grupo de categorias para associar esses tipos que são referenciados por áreas de recurso de configuração do processo específico.

O exemplo XML a seguir mostra a estrutura de código que define a configuração do processo comum contida no arquivo CommonConfiguration.xml.Este exemplo corresponde à sintaxe padrão definido para o MSF for Agile Software Development v de 6.0.

<?xml version="1.0" encoding="utf-8"?>
<CommonProjectConfiguration>
  <TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.StoryPoints" 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>
  <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </RequirementWorkItems>
  <TaskWorkItems category="Microsoft.TaskCategory">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </TaskWorkItems>
  <BugWorkItems category="Microsoft.BugCategory">
   <States>
        <State value="Active" type="InProgress" />
        <State value="Resolved" type="Resolved" />
        <State value="Closed" type="Complete" />
      </States> 
  </BugWorkItems>
  <FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" plural="Feedback Requests">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackRequestWorkItems>
  <FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" plural="Feedback Responses">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackResponseWorkItems>
  <Weekends>
    <DayOfWeek>Saturday</DayOfWeek>
    <DayOfWeek>Sunday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

De volta ao topo

Hh500408.collapse_all(pt-br,VS.110).gifElementos XML para áreas comuns

A tabela a seguir descreve os elementos filho do CommonProjectConfiguration elemento.Esses elementos configurar áreas que oferecem suporte a páginas que exibem ambas em Team Web Access, Team Explorer e o formulário de solicitação de comentários.

Observação importanteImportante

Os valores atribuídos a NomeDaCategoria deve corresponder a um grupo de categorias definido para o projeto de equipe.Você pode especificar grupos de categorias no arquivo de definição de categorias.Para obter a versão mais recente do ALM de Visual Studio, cinco novas categorias foram definidas.Para obter mais informações, consulte categorias, processar a configuração e a criação de tipos específicos de itens de trabalho.

Elemento

Descrição e sintaxe

Anotações

BugWorkItems

Especifica a categoria que corresponde aos itens de trabalho de bugs e associa os estados do fluxo de trabalho de itens de lista de pendências de metastates.

<BugWorkItems category=”CategoryName”>
    <States>
       <State . . . />
       . . .
   </States>
</BugWorkItems

Necessário.O NomeDaCategoria deve corresponder a uma categoria definida para o projeto de equipe.

DayOfWeek

Especifica um dia da semana que corresponde a um dia de folga.

<DayOfWeek>NameOfADay</DayOfWeek>

Filho obrigatório da Weekends elemento.

Valid names correspond to the English days of the week: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, and Saturday.

ObservaçãoObservação
Você deve especificar o dia de uma semana em inglês, independentemente da linguagem instalada de Team Foundation Server.

FeedbackResponseWorkItems

Especifica a categoria que corresponde aos tipos de itens que são usados para capturar a resposta de comentários e associa os estados do fluxo de trabalho desses itens com metastates de trabalho.

Necessário.Não personalize.

O NomeDaCategoria deve corresponder a um grupo de categorias definido para o projeto de equipe.

FeedbackRequestWorkItems

Especifica a categoria que corresponde aos tipos de item que são usados para capturar solicitações de comentários e associa os estados do fluxo de trabalho desses itens com metastates de trabalho.

Necessário.Não personalize.

O NomeDaCategoria deve corresponder a um grupo de categorias definido para o projeto de equipe.Especifique os grupos de categorias usando o arquivo Categories.xml.

RequirementWorkItems

Especifica a categoria que corresponde à lista de pendências de itens, como, por exemplo, itens de lista de pendências de produto, requisitos e histórias de usuários e associa os estados do fluxo de trabalho de itens de lista de pendências de metastates.

<RequirementWorkItems category="CategoryName" plural="NameOfBacklogItems" >
   <States>
      <State . . . />
      . . .
   </States>
</RequirementWorkItems>

Necessário.

O NomeDaCategoria deve corresponder a um grupo de categorias definido para o projeto de equipe.Especifique os grupos de categorias usando o arquivo Categories.xml.

State

Atribui um estado de fluxo de trabalho a um metastate.Metastates representa um agrupamento de estados de fluxo de trabalho que suportam o gerenciamento dos Estados do fluxo de trabalho em que a placa de tarefa ou de outros componentes de configuração do processo.

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

Necessário.

Os valores válidos para TypeName correspondem a um valor atribuído a uma STATE no fluxo de trabalho definido para os tipos de itens de trabalho que estão presentes no grupo de categoria, respectivamente.

Os valores válidos para ValueName correspondem a um dos seguintes valores enumerados: no fluxo de trabalho definido para os tipos de itens de trabalho que estão presentes no grupo de categoria, respectivamente.

  • Ágil:

    • Proposed: Indica os itens de trabalho que são novos, ainda não foi confirmada, ou ainda não ser tratada.

    • InProgress: Indica os itens de trabalho que foram confirmadas ou estão sendo ativamente trabalhados.

    • Complete: Indica os itens de trabalho que foram implementados.

  • Bug: além de metastates o Agile, inclui o Resolved metastate que indica a bugs que foram resolvidos.

  • Feedback: Requested, Received, Reviewed, and Declined.

Para obter mais informações, consulte Estados do fluxo de trabalho, metastates e a configuração do processo de.

States

Especifica uma coleção de State elementos que associa os estados do fluxo de trabalho dos tipos de itens com metastates de trabalhar.

<States>
   <State . . . />
   . . .
</States>

Required element for the BugWorkItems, FeedbackResponseWorkItems, FeedbackRequestWorkItems, RequirementWorkItems and TaskWorkItems elements.

Stateelementos são usados para atribuir estados do fluxo de trabalho para metastates.

TaskWorkItems

Especifica a categoria que corresponde aos itens de tarefa e associa os estados do fluxo de trabalho das tarefas com metastates.

<TaskWorkItems category="CategoryName">
   <States>
      <State . . . />
      . . .
   </States>
</TaskWorkItems>

Necessário.

O NomeDaCategoria deve corresponder a um grupo de categorias definido para o projeto de equipe.Você especificar grupos de categorias usando o arquivo Categories.xml.

As páginas de registro posterior e a placa de listam os itens de trabalho que correspondem a valores de estado especificada dentro de States elemento.

TypeField

Especifica o nome de referência de um campo cujo valor é referenciado para oferecer suporte a um tipo de atividade para uma área de suporte para o recurso.Você especifica este elemento dentro do TypeFields elemento de contêiner.

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

Especificando o formato é válido somente quando type="RemainingWork".Você pode especificar qualquer seqüência de texto para o TimeUnitString que você deseja ter aparecem nas barras de capacidade na página de lista de pendências de iteração atual e na placa de tarefa.

Necessário.Você deve especificar os campos que correspondem aos campos que você use dentre os tipos de itens de trabalho para capturar informações específicas.

Para as páginas de placa de lista de pendências e tarefas:

  • Activity: Usado para oferecer suporte ao recurso de capacidade-pela atividade.Especifica um campo definido para o tipo de tarefa do item de trabalho que você use para especificar o tipo de atividade a ser executada.

  • Effort: Especifica o campo usado para calcular a velocidade da equipe.Especifica um campo definido para o tipo de lista de pendências de item de trabalho que você usa para capturar o nível de esforço ou a classificação relativa para a quantidade de trabalho que precisarão de um item de lista de pendências para implementar.

  • Order: Especifica o campo usado para definir a ordem de classificação para os itens de lista de pendências nas páginas de placa de tarefa e a lista de pendências de iteração.Especifique o campo que você pode usar para capturar a prioridade relativa atribuída a itens de lista de pendências.Itens de trabalho estão listados na página na ordem crescente conforme definido pelo campo desse tipo.

  • RemainingWork: Especifica o campo usado para calcular os gráficos de trabalho e burndown restantes.Especifique o campo que você pode usar para capturar o número de horas ou dias restantes concluir uma tarefa.

    O valor que você especificar para format é usada nas páginas de placa de listas de pendências e tarefas, sempre que o trabalho restante é relatado.Por exemplo, quando relatórios de capacidade-por-atividade ou capacidade por um membro da equipe, ou ao lado do título da coluna para a tarefa informa na placa de tarefa.

    Para TimeUnitString, especifique qualquer seqüência de caracteres de texto que você deseja usar para refletir o valor de tempo, como, por exemplo, horas ou dias.

    Por exemplo, os seguintes valores são válidos:

    format="{0} h"

    format="{0} hours"

    format="hours {0}"

    format="time {0}"

  • Team: Especifica o campo usado para associar as páginas de placa de listas de pendências e tarefas com uma equipe.Este campo deve permanecer definido para o valor padrão, System.AreaPath.

Para o formulário de solicitação de comentários:

ObservaçãoObservação
Você não deve ter que alterar as atribuições padrão feitas para o seguinte TypeField elementos.Essas atribuições correspondem aos campos usados para capturar as informações correspondentes no tipo de solicitação de comentários de item de trabalho.
  • ApplicationStartInformation: Especifica o campo usado para capturar o caminho para executar o aplicativo.

  • ApplicationLaunchInstructions: Especifica o campo usado para capturar as instruções de lançamento.

  • ApplicationType: Especifica o campo usado para capturar o tipo de aplicativo.Os tipos listados correspondem aos valores permitidos especificados na definição do tipo para a solicitação de comentários.

TypeFields

Especifica uma coleção de TypeField elementos.

<TypeFields>
   <TypeField . . . />
   . . .
</TypeFields>

Necessário.

Você deve especificar os tipos de campos que você deseja referenciado para oferecer suporte a recursos que aparecem na lista de pendências, placa de tarefa e formulário de solicitação de comentários.

TypeFieldValue

Especifica o nome de um tipo de aplicativo seja exibido no formulário de solicitação de comentários.

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

Necessário.Não personalize.

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>

TypeFieldValues

Especifica uma coleção de TypeFieldValue elementos.

<TypeFieldValues>
   <TypeFieldValue . . . />
   . . .
</TypeFieldValues>

Necessário para o TypeFieldValue quando type="ApplicationType".

Você deve especificar os valores para os tipos de campos que você deseja que apareça no formulário de solicitação de comentários.

Weekends

Elemento de recipiente usado para especificar os dias de folga.

<Weekends>
   <DayOfWeek> . . . </DayOfWeek >
   . . . 
</ Weekends >

Opcional.

Especifique os dias de folga quando desejar levar em conta para dias de folga no cálculo de capacidade e burndown gráficos.

De volta ao topo

Consulte também

Referência

Gerenciando o processo de configuração [witadmin]

Conceitos

Atualizar um projeto de equipe atualizado para acessar novos recursos

Personalizar a lista de pendências e as páginas do quadro usando a configuração do processo