Adicionar um nível de lista de pendências de portfólio

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Seu projeto vem equipado com duas listas de pendências de portfólio: Recursos e Epics. No entanto, se você precisar de uma ou mais listas de pendências de portfólio adicionais, poderá adicioná-las.

Importante

Este artigo se aplica à personalização de projeto para modelos de processo XML hospedados e XML local. Para o modelo de processo de herança, consulte Personalizar suas listas de pendências ou quadros para um processo.

Para obter uma visão geral dos modelos de processo, consulte Personalizar sua experiência de acompanhamento de trabalho.

As listas de pendências de portfólio são úteis para organizar sua lista de pendências em iniciativas de negócios. Ao organizar suas listas de pendências em portfólios, você pode obter uma visão hierárquica do trabalho definido em listas de pendências de nível inferior, incluindo o trabalho em andamento em várias equipes. Os gerentes de programas podem acompanhar a status desses itens de lista de pendências de interesse e fazer drill down para garantir que todo o trabalho seja representado.

Observação

Se você ainda não tiver habilitado o recurso Desativação de Portfólio para seu projeto do Azure DevOps local, faça isso primeiro.

Aqui, adicionamos uma terceira lista de pendências de portfólio, Iniciativa. Com ele, a equipe de gerenciamento pode definir prioridades e exibir o progresso do trabalho pertencente a iniciativas.

Observação

As imagens que você vê no portal da Web podem ser diferentes das imagens que você vê neste tópico. Essas diferenças resultam de atualizações feitas em seu projeto e do modelo de processo escolhido ao criar seu projeto— Agile, Scrum ou CMMI. No entanto, a funcionalidade básica disponível para você permanece a mesma, a menos que seja explicitamente mencionada.

Você pode adicionar até cinco níveis de listas de pendências de portfólio. E, cada equipe pode escolher em quais listas de pendências aparecem para trabalhar.

Visão geral do processo

O processo para adicionar outra lista de pendências de portfólio difere ligeiramente dependendo do modelo de processo que você usa.

• Para XML hospedado: primeiro você exportará seu processo, adicionará ou atualizará arquivos de definição e, em seguida, importará esse processo para atualizar projetos existentes ou usá-lo para criar um projeto.
• Para XML local: primeiro você exportará seus arquivos de definição de acompanhamento de trabalho, os atualizará e, em seguida, os importará para seu projeto.

Este artigo explica como adicionar uma lista de pendências de portfólio a um projeto com base no processo Agile nestas cinco etapas:

1. Exportar os arquivos necessários
2. Criar o tipo de item de trabalho Initiative
3. Atualizar categorias com a categoria de iniciativa
4. Atualizar ProcessConfiguration para adicionar a lista de pendências do portfólio da Iniciativa
5. Atualizar seu projeto e verificar suas alterações

Você pode aplicar as mesmas etapas se trabalhar com um projeto com base no processo Scrum ou CMMI . Quando terminar, você poderá gerenciar seu portfólio de projetos agrupando o trabalho dentro desses quatro níveis: Histórias de usuário (ou itens de lista de pendências de produto ou Requisitos), Recursos, Epics e Iniciativas.

Para obter mais informações, confira Sobre processos e modelos de processo. Para obter uma visão geral dos três modelos de processo, consulte Personalizar sua experiência de acompanhamento de trabalho.

1. Exportar os arquivos necessários

1. Se você não for membro do grupo Administradores de Coleção de Projetos , será adicionado como administrador. Você precisa dessas permissões para personalizar o projeto.

2. Obtenha os arquivos necessários:

   • Para XML Hospedado: exporte o processo que você deseja atualizar. Salve os arquivos em uma pasta que você usará para atualizar esses arquivos e pastas: Categories, ProcessConfiguration e WorkItemTypes.
   • Para XML local: exporte os arquivos de definição necessários: Epic, Categories e ProcessConfiguration.

2. Criar um tipo de item de trabalho chamado Iniciativa

A maneira mais fácil de criar um tipo de item de trabalho (WIT) é copiar um existente, renomeá-lo e editá-lo para dar suporte aos seus requisitos. Neste exemplo, copiamos o EPIC WIT e o rotulamos como Iniciativa.

- Copie a definição de WIT 'Epic' para um arquivo XML denominado 'Iniciativa'. (O arquivo Epic.xml está localizado na pasta WorkItem Tracking da pasta ProcessTemplate.)

• Edite o arquivo chamado Initiative.
  
- Renomeie o WIT. Substitua 'WORKITEMTYPE name="Epic"' por 'WORKITEMTYPE name="Initiative"' e atualize a descrição.
'<WORKITEMTYPE name="Iniciativa" >'
   '<DESCRIÇÃO>As iniciativas ajudam os gerentes de programa a gerenciar e organizar efetivamente o trabalho em várias equipes >'
   '</DESCRIÇÃO'>
`. . .`
'</WORKITEMTYPE>'

- Adicione os campos personalizados que você deseja rastrear usando este WIT.
- Renomeie a seção 'Guia' chamada 'Recursos' para 'Épicos' e substitua 'Filter WorkItemType="Feature"' por 'Filter WorkItemType="Epic"'.
'<Tab Label="Epics">'
'<Tipo de controle="LinksControl" Name="Hierarquia">'
   '<LinksControlOptions>'
   '<WorkItemLinkFilters FilterType="incluir">'
   '<Filtrar LinkType="System.LinkTypes.Hierarchy" />'
   '</WorkItemLinkFilters>'
   '<WorkItemTypeFilters FilterType="include">'
      '<Filter WorkItemType="Epic" />'
   '</WorkItemTypeFilters>'
      '<ExternalLinkFilters FilterType="excludeAll" />'
      '<Colunas de> link'
          '<LinkColumn RefName="System.ID" />'
          '<LinkColumn RefName="System.Title" />'
          '<LinkColumn RefName="System.AssignedTo" />'
          '<LinkColumn RefName="System.State" />'
          '<LinkColumn LinkAttribute="System.Links.Comment" />'
          '</LinkColumns>'
   '</LinksControlOptions>'
'</Controle>'
'</Guia>'


Com essa alteração, você faz com que o controle guia mostre ou vincule exclusivamente os épicos como itens de trabalho filho da iniciativa.

3. Atualizar Categorias com a Categoria de Iniciativa

Agora, adicione a Categoria de Iniciativa. Isso adiciona a lista de pendências da Iniciativa para processar a configuração. A experiência agile gerencia WITs de acordo com categorias.

Adicione a Categoria de Iniciativa ao arquivo Categories.xml. (O arquivo Categories.xml está localizado na pasta Acompanhamento do WorkItem.)

  <CATEGORY name="Initiative Category" refname="FabrikamFiber.InitiativeCategory">  
    <DEFAULTWORKITEMTYPE name="Initiative" />  
  </CATEGORY>  

Você pode adicionar essa categoria em qualquer lugar dentro do arquivo de definição. Como você está adicionando uma categoria personalizada, rotule a categoria usando o nome da empresa.

4. Atualizar ProcessConfiguration para adicionar a lista de pendências do portfólio da iniciativa

Nesta última etapa, você adiciona a lista de pendências do portfólio da Iniciativa ao processo e modifica a lista de pendências do portfólio de recursos para refletir a hierarquia entre Iniciativas e Recursos. A configuração do processo determina as relações pai-filho entre as listas de pendências do portfólio.

1. Edite o arquivo ProcessConfiguration para adicionar uma nova lista de pendências de portfólio na PortfolioBacklogs seção . (O arquivo ProcessConfiguration.xml está localizado na pasta WorkItem Tracking/Process da pasta ProcessTemplate.)

   Adicione a Categoria de Iniciativa adicionando a sintaxe a seguir. Substitua os nomes, os valores de estado do fluxo de trabalho e os campos de coluna padrão para corresponder aos que você usa.

   <PortfolioBacklog category="FabrikamFiber.InitiativeCategory" pluralName="Initiatives" singularName="Initiative" workItemCountLimit="1000">
     <States>
       <State value="New" type="Proposed" />
       <State value="Active" type="InProgress" />
       <State value="Resolved" type="InProgress" />
       <State value="Closed" type="Complete" />
     </States>
     <Columns>
       <Column refname="System.WorkItemType" width="100" />
       <Column refname="System.Title" width="400" />
       <Column refname="System.State" width="100" />
       <Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
       <Column refname="Microsoft.VSTS.Common.BusinessValue" width="50" />
       <Column refname="Microsoft.VSTS.Common.ValueArea" width="100" />
       <Column refname="System.Tags" width="200" />
     </Columns>
     <AddPanel>
       <Fields>
         <Field refname="System.Title" />
       </Fields>
     </AddPanel>
   </PortfolioBacklog>
   

   Se você modificou os estados de fluxo de trabalho, verifique se cada estado de fluxo de trabalho é mapeado para um dos metaestados de Proposed, InProgresse Complete. O último estado dentro do fluxo de trabalho deve ser mapeado para Complete.

2. Edite o PortfolioBacklog elemento para a Categoria Épica para Initiative apontar como a lista de pendências pai.

   <PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics"  
      singularName="Epic" parent="FabrikamFiber.InitiativeCategory"      
      workItemCountLimit="1000">   
      . . .  
   </PortfolioBacklog>
   

   As listas de pendências do portfólio intermediário exigem a especificação da categoria pai, que deve ser configurada como uma lista de pendências de portfólio.

3. Adicione a cor a ser usada para Iniciativa à WorkItemColors seção .

       <WorkItemColor primary="FFCC66FF" secondary="FFF0D1FF" name="Initiative" />
   

   Isso atribui um rosa brilhante como a cor primária a ser usada em exibições de lista e um rosa mais pálido para a cor secundária (atualmente não usada).

5. Atualizar seu projeto e verificar o acesso à nova lista de pendências do portfólio

1. Atualize seu projeto:

   • Para XML hospedado: Importe seu processo.
   • Para XML local: Importe os arquivos de definição que você atualizou nesta ordem:
     a. Initiative.xml
     b. Categories.xml
     c. ProcessConfiguration.xml

2. Abra ou atualize o portal da Web e confirme se a Iniciativa aparece como uma lista de pendências de portfólio conforme o esperado. Consulte Organizar sua lista de pendências.

3. Conceda acesso avançado aos usuários que precisarão exercitar todos os recursos disponíveis com listas de pendências de portfólio.
   Para XML hospedado: consulte Atribuir licenças aos usuários.

Importar e exportar arquivos de definição (somente TFS local)

Se você estiver atualizando um projeto que se conecta a um TFS local, usará os comandos witadmin para importar e exportar arquivos de definição. Você precisa exportar os seguintes arquivos:

• Epic.xml
• Categories.xml (localizado na pasta WorkItem Tracking)
• ProcessConfiguration.xml (localizado na pasta WorkItem Tracking/Process)

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.

1. Abra uma janela do Prompt de Comando de acordo com as instruções fornecidas em witAdmin: Personalizar e gerenciar objetos para acompanhar o trabalho. Por exemplo:

1. Insira o witadmin comando , substituindo seus dados pelos argumentos mostrados. Por exemplo, para importar um WIT:

   witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\WITDefinitionFile.xml"
   

   Para CollectionURL, especifique a URL de uma coleção de projetos e , para ProjectName, especifique o nome de um projeto definido dentro da coleção. Você deve especificar a URL no seguinte formato: http://ServerName:Port/VirtualDirectoryName/CollectionName.

   Para DirectoryPath, especifique o caminho para a WorkItem Tracking/TypeDefinitions pasta que contém o modelo de processo que você baixou. O caminho do diretório deve seguir esta estrutura: Drive:\TemplateFolder\WorkItem Tracking\TypeDefinitions.

   Por exemplo, importe o WIT do ServiceApp:

   witadmin importwitd /collection:"http://MyServer:8080/tfs/DefaultCollection"/p:MyProject /f:"DirectoryPath/ServiceApp.xml"
   

Use estes comandos para exportar e importar categorias e processar a configuração:

witadmin exportwitd /collection:CollectionURL /p:"ProjectName" /n:TypeName /f:"DirectoryPath\WITDefinitionFile.xml"

witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\WITDefinitionFile.xml"

witadmin exportcategories /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/categories.xml"

witadmin importcategories /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/categories.xml"

witadmin exportprocessconfig /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/ProcessConfiguration.xml"

witadmin importprocessconfig /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/ProcessConfiguration.xml"

Artigos relacionados

Acabamos de mostrar como adicionar outro nível de lista de pendências de portfólio. Você pode adicionar até cinco listas de pendências de portfólio. Isso inclui as listas de pendências padrão de Feature e Epic. No total, isso fornece sete níveis da lista de pendências do portfólio de nível superior para a tarefa.

Se você quiser adicionar outro WIT às suas listas de pendências ou quadros, consulte tipos de item de trabalho para listas de pendências e quadros.

Para obter mais informações sobre a sintaxe de um arquivo de definição ou ferramenta de linha de comando, consulte estes tópicos:

• Referência de todos os elementos XML WITD
• Referência de elemento XML categories
• Referência de elemento XML da configuração de processo
• Importar, exportar e gerenciar tipos de item de trabalho
• Categorias de importação e exportação
• Configuração do processo de importação e exportação

Caso contrário, consulte Personalizar sua experiência de acompanhamento de trabalho para acessar outras opções de configuração e personalização disponíveis para você.

Se você tiver outras perguntas, consulte Team Foundation Server – fórum de acompanhamento de trabalho .

Hierarquia de lista de pendências do portfólio

O que controla a hierarquia entre listas de pendências de portfólio?

A configuração do processo determina a hierarquia por meio da atribuição de categorias pai para categorias de lista de pendências de portfólio. Há suporte apenas para relações pai-filho. A categoria mais alta dentro da hierarquia não contém uma atribuição pai.

Listas de pendências de portfólio e categorias WIT

Posso ter mais de um WIT definido em uma categoria que uso para uma lista de pendências de portfólio?

Sim. Por exemplo, você pode adicionar WITs de Meta e Iniciativa a uma categoria de lista de pendências de portfólio. A restrição main é não adicionar o mesmo WIT a duas categorias diferentes atribuídas a uma das seções a seguir para a configuração do processo: , PortfolioBacklogRequirementBacklogou TaskBacklog.

Aninhamento de itens de lista de pendências

Você pode aninhar itens de lista de pendências além de usar listas de pendências de portfólio?

Embora você possa aninhar itens de lista de pendências, não recomendamos que você faça isso. Não damos suporte à vinculação de arrastar e soltar de itens de lista de pendências aninhadas. Em vez disso, damos suporte ao mapeamento de itens de lista de pendências para itens de portfólio.

Para obter exemplos de como itens hierarquicamente vinculados que pertencem à Categoria de Requisitos aparecem nas listas de pendências e quadros, consulte Como listas de pendências e quadros exibem itens hierárquicos (aninhados).