Compartilhar via


Adicionar relatórios ao modelo de processo

Usando o plug-in de geração de relatórios, você pode especificar a estrutura de pastas e os relatórios que aparecem no nó Relatório Relatórios para uma nova equipe de projetos.

Importante

O plug-in de geração de relatórios requer que a coleção de projetos na qual você vai criar o projeto de equipe esteja configurada com os serviços de análise SQL Server e de geração de relatórios SQL Server.Para obter mais informações, consulte Adicionar relatórios a um projeto da equipe.

Você especifica duas tarefas principais usando o plug-in de geração de relatórios. Primeiro, você cria o local para geração de relatório usando o elemento site. Depois, você deve especificar a estrutura da pasta e quais relatórios serão enviados para o site por meio dos elementos folder e report. Os relatórios enviados devem ter a extensão .rdl e serão usados no Reporting Services. Para consultar uma visão geral dos relatórios fornecidos pelos modelos de processo do TFS, veja Relatórios (SQL Server Reporting Services).

Depois de criar a equipe do projeto com base no modelo de processo, você pode adicionar, remover, renomear e alterar a estrutura das pastas para os relatórios. Para obter mais informações, consulte Exibir, carregar e organizar relatórios (Reporting Services Reports).

Nome e local do plug-in de geração de relatórios

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

Nome do arquivo:

ReportsTasks.xml

Nome da pasta:

Relatórios

Nome do plug-in:

Microsoft.ProjectCreationWizard.Reporting

Dica

Você pode alterar os nomes do arquivo XML e da pasta, mas não do plug-in.O Visual Studio Team Foundation Server 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.

No arquivo XML, você especifica uma ou mais tarefas e suas dependências. Como exemplo de tarefa que especifica um conjunto de relatórios, consulte o arquivo ReportsTasks.xml bi MSF param ver o modelo de processo de desenvolvimento de software Agile.

Estrutura da sintaxe do plug-in de geração de relatórios

O plug-in file de geração de relatórios deve adequar-se à definição de esquema para o Reporting Services, que é definida no arquivo Rosetta.xsd, além de ser especificado em seu próprio arquivo.

A sintaxe a seguir mostra a estrutura do plug-in de geração de relatórios. Para ver a descrição de cada elemento, confira Elementos filhos do Reporting Services mais adiante, neste tópico.

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="Site" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project Reporting site created.">
    <dependencies />
    <taskXml>
      <ReportingServices>
        <site> </site>
      </ReportingServices>
    </taskXml>
  </task>
  <task id="Populate Reports" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project reports uploaded.">
    <dependencies>
      <dependency taskId="Site" />
    </dependencies>
    <taskXml>
      <ReportingServices>
        <folders> . . . </folders>
        <reports> . . . </reports>
      </ReportingServices>
    </taskXml>
  </task>
</tasks>

Como criar o site de relatórios

Para que a execução dos relatórios não apresente problemas, você tem que criar um site de relatórios. O site de relatórios contém um link Relatório Relatórios que leva à página inicial do portal do projeto. Para criar esse site, use o elemento site, como mostra o exemplo a seguir:

<taskXml>
   <ReportingServices>
        <site></site>
   </ReportingServices>
</taskXml>

Como definir pastas

Você pode criar as pastas no site de geração de relatório usando o elemento folder. Use o atributo de caminho para especificar o nome de caminho relativo da nova pasta. A pasta aparece no site do projeto e na pasta Relatórios, em Team Explorer.

O exemplo a seguir cria quatro pastas de nível superior e duas subpastas no site de geração de relatórios. As pastas de nível superior recebem os nomes de Bugs, Builds, Project Management e Tests. As duas subpastas ficam dentro da pasta Project Management e recebem os nomes de Visual Studio e Visual Studio ALM.

<taskXml>
   <ReportingServices>
      <folders>
         <folder path="Bugs" />
          <folder path="Builds" />
          <folder path="Project Management" />
          <folder path="Project Management/Visual Studio" />
          <folder path="Project Management/Visual Studio ALM" />
          <folder path="Tests" />
      </folders>
   </ReportingServices>
</taskXml>

Especifique os relatórios a serem enviados

Os relatórios são definidos por arquivos .rdl. Para adicionar relatórios a um site, copie os arquivos .rdl para uma pasta dentro da pasta Relatórios do modelo de processos. Em seguida, use o elemento do relatório para descrever as propriedades e fontes de dados necessárias.

O exemplo a seguir especifica que o arquivo Remaining Work.rdl seja enviado para a pasta Project Management. Você tem que especificar o parâmetro ExplicitProject e as fontes de dados de cada relatório. As fontes de dados do exemplo a seguir correspondem aos nomes que são atribuídos automaticamente ao cubo Analysis Services e ao banco de dados relacional do data warehouse.

Dica

Os nomes das fontes de dados dos serviços de geração de relatórios são Tfs2010ReportsDS e Tfs2010OlapReportsDS.Mesmo que você tenha instalado ou atualizado para o TFS 2012 ou TFS 2013, esses nomes, que foram atribuídos às fontes de dados na instalação do TFS 2010, continuam a ser usados.

<taskXml>
   <ReportingServices>
     <reports>
        <report name="Remaining Work" filename="Reports\Remaining Work.rdl" folder="Project Management" cacheExpiration="30">
       <parameters>
          <parameter name="ExplicitProject" value="" />
       </parameters>
       <datasources>
          <reference name="/Tfs2010OlapReportDS" dsname="TfsOlapReportDS" />
          <reference name="/Tfs2010ReportDS" dsname="TfsReportDS" />
       </datasources>
    </report>
 . . . 
     </reports>
   </ReportingServices>
</taskXml>

Referência do elemento ReportingServices

A sintaxe a seguir mostra a estrutura do elemento ReportingServices e seus elementos filho. Você especifica esses elementos no elemento de contêiner taskXml e somente para o plug-in de geração de relatórios.

<ReportingServices>
   <folders>
      <folder />
 . . . 
   </folders>
   <reports>
      <report>
         <parameters>
            <parameter />
         </parameters>
         <datasources>
            <reference />
         </datasources>
      </report>
 . . . 
   </reports>
</ReportingServices>

A tabela a seguir descreve os elementos que você usa para especificar um relatório a ser enviado para um projeto de equipe e que pode ser acessado pelo SQL Server Reporting Services.

Elemento

Sintaxe

Descrição

datasources

<datasources>
   <reference />
</datasources>

Elemento filho de report obrigatório.

Contém uma coleção de elementos reference que especificam fontes de dados usadas pelos relatórios.

folder

<folder path="FolderName" />

Elemento filho de folders obrigatório.

Define o nome de uma pasta a ser criada no nó Relatórios para um projeto de equipe.

folders

<folders>
   <folder path="FolderName" />
</folders>

Elemento filho opcional de ReportingServices.

Contém uma coleção de elementos folder que especificam os nomes das pastas a serem criadas.

parameter

<parameter name="ParameterName" value="ParameterValue" />

Em que cada atributo tem a seguinte definição:

  • name: o nome do parâmetro que você quer especificar.

  • value: o valor a ser atribuído ao parâmetro.

Você deve, no mínimo, definir os parâmetros a seguir para que o relatório use automaticamente o projeto que contém o relatório:

<parameter name="ExplicitProject" value="" />

Elemento filho de parameters obrigatório.

Especifica o nome de um parâmetro do relatório e o valor a ser atribuído a ele.

parameters

<parameters>
   <parameter />
</parameters>

Elemento filho de report obrigatório.

Define uma coleção de elementos parameter para um relatório.

properties

< properties >
   < property />
</ properties >

Elemento filho opcional de report.

property

<property name="PropertyName" value="PropertyValue" />

Em que cada atributo tem a seguinte definição:

Elemento filho de properties obrigatório.

reference

<reference name="RelationalDBName" dsname="OLAPDBName" />

Em que cada atributo tem a seguinte definição:

  • name: o nome da fonte de dados em Team Foundation Server. Para o Team Foundation Server 2010, esse valor é Tfs2010OlapReportDS para o cubo Analysis Services ou Tfs2010ReportsDS para o data warehouse relacional.

  • dsname: o nome do recurso do banco de dados. Especifique TfsOlapReportDS para o cubo Analysis Services e TfsReportsDS para o data warehouse relacional.

Para saber mais sobre os nomes das fontes de dados da geração de relatórios, confira Localize relatórios após a atualização para o Team Foundation Server 2010.

Elemento filho de datasources obrigatório.

Especifica os nomes atribuídos no Team Foundation Server para o banco de dados relacional do data warehouse e para o cubo Analysis Services.

report

<report name="ReportName" filename="ReportFilePathName" 
folder="FolderName" cacheExpiration="CacheDuration">   <folders>
   <parameters>. . .</parameters>
   <datasources>. . .</datasources>
   <properties>. . .</properties >
</report>

Em que cada atributo tem a seguinte definição:

  • name: o nome do relatório a ser exibido no site de geração de relatórios e no Team Explorer.

  • filename: um caminho relativo na pasta Relatórios local ondem o arquivo de relatório .rdl pode ser obtido.

  • folder: um nome de caminho relativo do local para adicionar o relatório ao site de geração de relatórios.

  • cacheExpiration: o tempo padrão, em minutos, do armazenamento do relatório em cache.

Elemento filho de reports obrigatório.

Especifica o nome do relatório, o arquivo que contém a definição .rdl e a pasta à qual o relatório é enviado. Team Foundation Server

reports

<reports>
   <report />
   . . .
</reports>

Elemento filho de ReportingServices obrigatório.

Contém uma coleção de elementos report que especificam os nomes dos arquivos de relatórios a serem criados.

ReportingServices

<ReportingServices>
   <folders>. . .</folders>
   <reports>. . .</reports>
</ReportingServices>

Elemento filho necessário do elemento taskXml para o plug-in de geração de relatórios.

Descreve as tarefas necessárias para definir os relatórios e as pastas para o SQL Server Reporting Services.

site

<site> </site>

Elemento necessário para o plug-in de geração de relatórios.

Especifica que um site de geração de relatórios será criado para o projeto de equipe.

Consulte também

Conceitos

Personalizar um modelo de processo

Visão geral de arquivos de modelo de processo