Adicionar relatórios ao modelo de processo

Artigo
02/25/2013

Usando o plug-in de relatório, você pode especificar a estrutura de pastas e o conjunto de relatórios que serão exibidas sob o nó deRelatório para um novo projeto de equipe.

Importante
O plug-in de relatório requer que a coleção de projeto de equipe onde você criará um projeto de equipe foi configurado com serviços e o SQL Server de análise de SQL Server que reporting services.Para mais informações, consulte Adicionar um servidor de relatórios a uma coleção de projeto de equipe.

Você especifica duas tarefas principais usando o plug-in de relatório.Primeiro, você cria um site de relatório usando o elemento de site .Segundo, você especifica a estrutura de pasta e relatórios a ser carregados ao site usando elementos de folder e de report .Relatórios que você carrega têm uma extensão de .rdl e são projetados para uso com serviços de relatório.Para obter uma visão geral de relatórios que os modelos de processo para a estrutura (MSF) de soluções Microsoft fornece, consulte Relatórios (ágeis) ou Relatórios (CMMI).

Neste tópico

Nome e localização do plug-in de relatório
Estrutura da sintaxe de relatório
Criando um site de relatórios
Definindo pastas
Especificando os relatórios para carregar
Referência do elemento de ReportingServices

Depois que um projeto de equipe é criado a partir do modelo de processo, você pode adicionar, remover, renomear, e altere a estrutura de pasta para relatórios.Para mais informações, consulte Gerenciar relatórios.

Nome e localização do plug-in de relatório

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

Nome do arquivo:	ReportsTasks.xml
Nome da Pasta:	Relatório
Nome do plug-in:	Microsoft.ProjectCreationWizard.Reporting

Observação
Você pode alterar os nomes de arquivo XML e da pasta mas não o plug-in.Visual Studio Team Foundation Server não inclui um mecanismo para a implantação de plug-ins do lado do cliente, das diretivas, ou outras alterações.Se você deseja implantar esse tipo de funcionalidade, você deve usar seu próprio programa de distribuição e instalar.

Em o arquivo XML, você especifica uma ou mais tarefas e suas dependências.Para um exemplo de uma tarefa que especifica um conjunto de relatórios, consulte o arquivo de ReportsTasks.xml no MSF para o modelo de programação processo de desenvolvimento de software.

De volta ao topo

Estrutura da sintaxe de relatório

O arquivo plug-in de relatório deve estar de acordo com a definição de esquema para ReportingServices, que é definido no arquivo de Rosetta.xsd, e ser especificado no seu próprio arquivo.Você pode baixar os arquivos de esquema para os modelos de processo a seguinte página no site da Microsoft: Esquemas de item de modelo e de trabalho do processo para o Visual Studio team foundation.

A sintaxe a seguir mostra a estrutura de plug-ins de relatório.Para obter uma descrição de cada elemento elementos filho de ReportingServices , consulte posteriormente em este 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>

De volta ao topo

Criando um site de relatórios

Para que os relatórios para executar corretamente, você deve criar um site de relatório.O site de relatório ter-lhe-á um link na página inicial portal de projeto, e o link será denominado Relatório.Para criar o site de relatório, use o elemento de site , como mostra o exemplo a seguir:

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

De volta ao topo

Definindo pastas

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

O exemplo a seguir cria quatro pastas de nível superior e duas subpastas no site de relatório.As pastas de nível superior são rotuladas bugs, compilações, gerenciamento de projeto, e teste.As duas subpastas são posicionadas abaixo de gerenciamento de projeto e rotuladas 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>

De volta ao topo

Especificando os relatórios para carregar

Os relatórios são definidos por arquivos de .rdl.Para adicionar relatórios para o relatório site, copie os arquivos de relatório .rdl em uma pasta sob a pasta de relatórios no modelo de processo.Use o elemento de relatório para descrever as propriedades e as fontes de dados necessárias para o relatório.

O exemplo a seguir especifica que o arquivo restante de Work.rdl será carregado para a pasta de gerenciamento de projeto.Você deve especificar o parâmetro de ExplicitProject e as fontes de dados para cada relatório.Fontes de dados no exemplo correspondem aos nomes que são atribuídos automaticamente serviços cubo de análise e ao banco de dados relacional de data warehouse para Team Foundation Server 2010.

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

De volta ao topo

Referência do elemento de ReportingServices

A sintaxe a seguir mostra a estrutura do elemento de ReportingServices e seus elementos filhos.Você especifica esses elementos dentro do elemento contêiner de taskXml e somente para o plug-in de relatório.

<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 para carregar a um projeto de equipe e que podem ser acessados com SQL Server reporting services.

Elemento	Sintaxe	Descrição
datasources	`<datasources> <reference /> </datasources>`	Elemento filho de reportnecessário. Contém uma coleção de elementos de reference que cada um especifica uma fonte de dados que o relatório use.
folder	`<folder path="FolderName" />`	Elemento filho de foldersnecessário. Define o nome de uma pasta para criar sob o nó de Relatório para um projeto de equipe.
folders	`<folders> <folder path="FolderName" /> </folders>`	Elemento filho opcional de ReportingServices. Contém uma coleção de elementos de folder o que cada um especifica o nome de uma pasta para criar.
parameter	`<parameter name="ParameterName" value="ParameterValue" />` Onde cada atributo tem a seguinte definição: name: O nome de um parâmetro que você deseja especificar. value: Atribua o valor para o parâmetro. Por o menos, você deve definir o parâmetro a seguir para fazer automaticamente o relatório usar o projeto que contém o relatório: `<parameter name="ExplicitProject" value="" />`	Elemento filho de parametersnecessário. Especifica o nome do parâmetro de relatório e o valor para atribuir.
parameters	`<parameters> <parameter /> </parameters>`	Elemento filho de reportnecessário. Define uma coleção de elementos de parameter para um relatório.
properties	`< properties > < property /> </ properties >`	Elemento filho opcional de report.
property	`<property name="PropertyName" value="PropertyValue" />` Onde cada atributo tem a seguinte definição: name: O nome da propriedade que você deseja especificar.Para mais informações, consulte Exibir, organizar e configurar os relatórios usando o Gerenciador de relatórios para Visual Studio ALM. value: Atribua o valor à propriedade.	Elemento filho de propertiesnecessário.
reference	`<reference name="RelationalDBName" dsname="OLAPDBName" />` Onde cada atributo tem a seguinte definição: name: O nome da fonte de dados em Team Foundation Server.Para Team Foundation Server 2010, esse valor tanto Tfs2010OlapReportDS para o cubo do analysis ou o Tfs2010ReportsDS para a data warehouse relacional. dsname: O nome do recurso de banco de dados.Especificar TfsOlapReportDS para o cubo do analysis, e TfsReportsDS para a data warehouse relacional. Para obter mais informações sobre nomes de fontes de dados de relatório, consulte Locating Reports After the Upgrade to Team Foundation Server 2010.	Elemento filho de datasourcesnecessário. Especifica os nomes que são atribuídos em Team Foundation Server para o banco de dados relacional de data warehouse e o cubo do analysis.
report	`<report name="ReportName" filename="ReportFilePathName" folder="FolderName" cacheExpiration="CacheDuration"> <folders> <parameters>. . .</parameters> <datasources>. . .</datasources> <properties>. . .</properties > </report>` Onde cada atributo tem a seguinte definição: name: O nome de relatório a exibir no site de relatório e em Team Explorer. filename: Um caminho relativo no local relata da pasta onde obter o arquivo de relatório .rdl. folder: Um nome de caminho relativo local para adicionar relatórios no site de relatório. cacheExpiration: O número de minutos padrão para que o relatório é armazenado em cache.	Elemento filho de reportsnecessário. Especifica o nome do relatório, o arquivo que contém a definição de .rdl, e da pasta que o relatório é carregado.Team Foundation Server
reports	`<reports> <report /> . . . </reports>`	Elemento filho de ReportingServicesnecessário. Contém uma coleção de elementos de report o que cada um especifica o nome de um arquivo de relatório para carregar.
ReportingServices	`<ReportingServices> <folders>. . .</folders> <reports>. . .</reports> </ReportingServices>`	Elemento filho do elemento de taskXml necessário para o plug-in de relatório. Descreve as tarefas que são necessárias para definir os relatórios e pastas para SQL Server reporting services.
site	`<site> </site>`	Elemento necessário para o plug-in de relatório. Especifica que um site de relatório para o projeto de equipe será criada.