Share via

Definir o plug-in do portal do projeto para um modelo de processo

  • Artigo

Usando o plug-in do portal, você pode definir as bibliotecas de documentos, a estrutura de biblioteca e os documentos iniciais de um portal do projeto de equipe. Você também pode incluir as tarefas que criam painéis e relatórios do Excel que são projetados para ser usados com os modelos de processo do Team Foundation Server (TFS).

As tarefas que você especificar no plug-in para Produtos do SharePoint serão executadas somente quando você criar um site do SharePoint e criar um projeto de equipe. Para saber mais sobre os requisitos e administração do site, consulte Requisitos de Produtos do SharePoint para o Team Foundation Server.

Nome e localização do plug-in do portal

A tabela a seguir resume os nomes do arquivo de plug-in do portal, da pasta e do plug-in para os modelos de processo do TFS.

Nome do arquivo:

WssTasks.xml

Nome da pasta:

Windows SharePoint Services

Nome do plug-in:

Microsoft.ProjectCreationWizard.Portal

Dica

Você pode alterar os nomes do arquivo XML e da pasta, mas não do plug-in.O TFS não inclui um mecanismo para a implantação de plug-ins do lado do cliente, políticas ou outras modificações.Para implantar esse tipo de funcionalidade você tem que usar seu próprio programa de instalação e distribuição.

Tarefas e dependências de criação do portal

No arquivo de plug-in do portal, especifique uma ou mais tarefas e suas dependências. Você pode especificar as seguintes principais tarefas:

  • Criar o site usando um modelo de site especificado

  • Criar bibliotecas de documentos

  • Criar pastas e carregar arquivos em bibliotecas de documentos

  • Ativar recursos de painéis

Para ver um exemplo de uma tarefa que especifica um portal de projeto simples, consulte o arquivo WssTasks.xml em um dos modelos de processo do TFS. Você pode baixar os últimos modelos de processo do TFS.

Criar o site e especificar o modelo do site

Você deve especificar um modelo de site no qual o portal do projeto está baseado. O modelo de site também deve estar disponível no portal Team Foundation Server do SharePoint. Os modelos de site não estão incluídos no modelo de processo.

Especifique o modelo de site usando o elemento site.

<site template="" language=""/>

A tabela a seguir descreve os atributos do elemento site.

Atributo

Descrição

modelo

Especifica qual modelo usar. Você deve especificar um modelo que esteja definido no servidor que hospeda o Produtos do SharePoint para os projetos de equipe que serão criados.

Para usar os recursos que estão disponíveis com a versão atual dos modelos de processo para MSF, especifique a seguinte cadeia de caracteres: Team Foundation Server Project Portal.

linguagem

Especifica uma ID de localidade para indicar qual a versão de idioma do modelo de site usar. A versão em inglês é 1033.

O exemplo a seguir mostra como fazer referência à versão em inglês da versão atual do modelo de processo do MSF Agile, que suporta painéis.

<tasks>
  <task id="SharePointPortal" name="Create Sharepoint Portal" plugin="Microsoft.ProjectCreationWizard.Portal" completionMessage="Project portal site created.">
    <dependencies />
    <taskXml>
        <Portal>
           <site template="Team Foundation Server Project Portal" language="1033" />  
       . . . 
        </Portal>

Dica

Todas as outras tarefas definidas dentro do plug-in do portal dependem da tarefa de criação do site, pois o portal do projeto deve ser criado antes de você criar bibliotecas de documentos adicionais ou copiar arquivos.

Desempenho do modelo de processo

Os arquivos que você especifica no WssTasks.xml são incluídos como parte do modelo de processo quando ele é carregado. O tamanho do modelo de processo interfere no tempo de criação de um novo projeto de equipe. Os modelos de processo maiores levam mais tempo para criar novos projetos de equipe. Portanto, considere estratégias alternativas para fornecer arquivos quando o desempenho do modelo de processo diminuir.

Use o modelo de site

Você pode incluir arquivos como parte do modelo de site do SharePoint. Isso move arquivos do modelo de processo, transfere para o modelo de site e melhora o desempenho durante a criação de novos projetos de equipe.

No entanto, há uma vantagem em listar arquivos no WssTasks.xml. Você pode vincular arquivos Microsoft Project e Microsoft Excel a uma consulta usando o atributo queryid descrito anteriormente. Isso ajuda os membros da equipe quando eles abrem os arquivos, porque eles já estarão conectados aos Team Foundation Server e consulta corretos.

Use um site alternativo

Se você tem uma grande coleção de arquivos que são compartilhados entre vários projetos de equipe, você pode usar um site alternativo para hospedar os arquivos e vincular aos arquivos do portal do projeto ou páginas da Web. Essa estratégia também aumenta o desempenho durante a criação de projetos de equipe, pois os arquivos não precisam ser copiados para o portal do projeto. Para obter mais informações, consulte Configurar ou adicionar um portal de projeto.

Criar bibliotecas de documentos

Depois de criar o portal do projeto, você pode especificar que bibliotecas de documentos adicionais sejam criadas. Use o elemento documentLibrary para especificar uma biblioteca de documentos.

<documentLibraries>
   <documentLibrary name="" description="" isProcessGuidance="true | false" />
</documentLibraries>

Dica

O controle de versão de uma biblioteca de documentos não pode ser habilitado ou desabilitado no modelo de processo.Você pode habilitar ou desabilitar o controle de versão por meio do modelo de site do Windows SharePoint Services ou depois da criação do projeto.

A tabela a seguir descreve os atributos do elemento documentLibrary.

Atributo

Descrição

name

Especifica o nome da biblioteca de documentos que aparece no portal do projeto.

descrição

Fornece uma descrição da biblioteca de documentos que aparece no portal do projeto.

isProcessGuidance

Especifica se a biblioteca de documentos é usada para oferecer suporte ao conteúdo das diretrizes de processo.

O exemplo a seguir mostra como criar uma biblioteca de documentos chamada de Desenvolvimento, que a equipe de desenvolvimento pode usar para armazenar documentos.

<documentLibraries>
. . .
   <documentLibrary name="Process Guidance" description="How to make best use of the Team Foundation Server tools and process" isProcessGuidance="true" />
. . .
</documentLibraries>

Criar a estrutura de pastas de uma biblioteca de documentos

Depois de criar o portal do projeto, você pode especificar pastas adicionais a serem criadas. Você também pode especificar arquivos a serem copiados, como arquivos de modelo.

Use o elemento folder para criar uma nova pasta.

<folders>
   <folder documentLibrary="" name=""/>
</folders>

A tabela a seguir descreve os atributos do elemento pasta.

Atributo

Descrição

documentLibrary

Identifica em qual biblioteca de documentos criar a pasta.

name

Especifica o nome da pasta.

O exemplo a seguir mostra como criar uma pasta chamada Relatórios de Viagem na biblioteca de documentos Desenvolvimento, na qual os desenvolvedores podem armazenar relatórios de viagem de conferências ou visitas a clientes.

<folders>
   <folder documentLibrary="Development"
           name="Trip Reports"/>
</folders>

Especificar arquivos para carregar nas bibliotecas de documentos

Você também deve copiar arquivos para as bibliotecas de documentos e pastas. Os arquivos de origem estão localizados na pasta Windows SharePoint Services. Especifique um destino no portal do projeto.

<files>
   <file source="" documentLibrary="" target="" queryId="" /> 
</files>

A tabela a seguir descreve os atributos do elemento arquivo.

Atributo

Descrição

source

Um caminho relativo para a cópia local do arquivo. Geralmente, o nome do caminho de origem sempre começa com Windows SharePoint Services, que é o nome da pasta onde o plug-in do portal está definido.

documentLibrary

O nome da biblioteca de documentos na qual o arquivo será copiado.

target

Um caminho relativo para o destino no portal do projeto onde o arquivo é copiado.

queryId

Especifica o nome de uma consulta de item de trabalho que está vinculada ao arquivo. Quando o arquivo é aberto pela primeira vez, ele é preenchido com os resultados da execução da consulta. Esse atributo é opcional, e a consulta especificada deve existir no arquivo workitems.xml.

Dica

O atributo queryId aplica-se somente a arquivos .xls.

O exemplo a seguir mostra como copiar um arquivo de modelo chamado Project Checklist para a pasta Project Management. Este exemplo também especifica que quando o arquivo é aberto pela primeira vez, ele deve ser preenchido com os resultados da consulta de item de trabalho do Project Checklist.

<files>
   <file source="Windows SharePoint Services\Templates\Project Checklist.xls" 
      documentLibrary="Project Management" 
      target="Project Checklist.xls" 
      queryId="Project Checklist" />
</files>

Dica

Você pode incluir pastas e arquivos como parte do modelo de site, para não ter que listá-los no XML.

Dica

Se você especificar arquivos .exe e o site do SharePoint não suportar arquivos .exe, você não conseguirá criar um projeto de equipe com êxito usando o modelo de processo.

Conteúdo das diretrizes de processo e arquivos de suporte

As diretrizes de processo é o conteúdo que documenta os processos a serem seguidos pelos membros da equipe que trabalham em um projeto de software. Os itens de trabalho, relatórios e consultas podem mudar durante o ciclo de vida de um projeto de equipe e ser diferentes entre os projetos de equipe. O conteúdo das diretrizes de processo fornece detalhes sobre um projeto de equipe, como informações sobre como preencher campos de item de trabalho, exemplos de relatórios íntegros e não íntegros e descrições das consultas. As diretrizes de processo também fornecem detalhes sobre o processo a seguir em um projeto de equipe, como funções a serem assumidas e atividades a serem concluídas.

Na biblioteca MSDN, você pode acessar o conteúdo das diretrizes de processo da maioria dos artefatos definidos por cada um dos modelos de processo padrão do TFS. Pesquise o conteúdo disponível no MSDN em um dos seguintes tópicos: Visual Studio Scrum, MSF para Agile e MSF para CMMI.

Para oferecer suporte ao acesso às diretrizes de processo a partir dos formulários de item de trabalho no Team Explorer, um conjunto de arquivos .htm é enviado para a pasta Diretrizes de Processo dentro da biblioteca de documentos do SharePoint. Esses arquivos especificam URLs para o conteúdo do MSDN que é aberto quando um membro da equipe clica no ícone das diretrizes de processo Abrir diretrizes de processo de item de trabalho em um formulário de item de trabalho. Esses arquivos são carregados com base nas tarefas file definidas dentro do plug-in do portal. Por exemplo, o modelo de processo do Agile define as seguintes tarefas file:

<!-- Process Guidance -->
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.html" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.htm" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.aspx" />

Você pode personalizar esses arquivos para apontar para outros recursos de diretrizes de processo. Você também pode adicionar arquivos para oferecer suporte ao acesso a outras diretrizes de processo que você criou para sua equipe. Para obter mais informações, consulte Configurar ou adicionar um portal de projeto.

Ativando recursos de painéis

Os painéis exibem dados do projeto, oferecem suporte à investigação e ajudam as equipes a executar tarefas comuns rapidamente. Os painéis exibem vários relatórios do Excel e Web Parts do Team Web Access.

Use o elemento activateFeatures para criar painéis e relatórios do Excel. Inclua o seguinte código no arquivo de plug-in do portal, dentro do elemento Portal, para ativar a criação de painéis e relatórios do Excel para um projeto de equipe.

Para ativar recursos do painel de controle que são criados para uso com o modelo de processo do Visual Studio Scrum:

      <Portal>
    . . . 
<activateFeatures>
         <!-- TfsDashboardScrumWss -->
          <feature featureId="71EC0D67-21AB-4560-A825-9D976DA09D04" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

Para ativar recursos do painel de controle que são criados para uso com o modelo de processo de desenvolvimento de software do MSF Agile:

      <Portal>
    . . . 
        <activateFeatures>
          <!-- TfsDashboardAgileMoss -->
          <feature featureId="0D953EE4-B77D-485b-A43C-F5FBB9367207" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

Para ativar recursos do painel de controle que são criados para uso com o modelo de processo de melhoria de processos do MSF CMMI:

      <Portal>
    . . . 
<activateFeatures>
          <!-- TfsDashboardCmmiMoss -->
          <feature featureId="3D0BA288-BF8E-47F0-9680-7556EDEF6318" />
          <!-- TfsDashboardCmmiProcessDocLibraries -->
          <feature featureId="8610B95B-063F-4FB5-837C-BCF2FE9423C6" />
        </activateFeatures>
    . . . 
      </Portal>

Consulte também

Conceitos

Personalizar um modelo de processo

Visão geral de arquivos de modelo de processo