Carregamento de relatórios usando os plug-in de relatórios

Artigo
08/01/2011

Usando os plug-in de relatórios, pode adicionar ou remover relatórios que serão carregados para o site de relatório para um novo projeto de equipe. Os relatórios que você carregar têm a extensão. RDL e são projetados para uso com o SQL Server Reporting Services. Com este plug-in, você especifica as tarefas que criar um site de relatório para o projeto de equipe, criar a hierarquia de pasta para relatórios e carreguem relatórios no site.

Para uma visão geral dos relatórios que são fornecidas pelos modelos de processo para o Microsoft Solutions Framework (MSF), consulte Relatório (Agile) ou Relatório (CMMI).

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

Nome do arquivo:	Arquivo ReportsTasks. XML
Nome da pasta:	Relatórios
Nome do plug-in:	Microsoft.ProjectCreationWizard.Reporting

Observação
Você pode alterar os nomes de arquivo XML e a pasta, mas não o plug-in. Visual Studio Team Foundation Servernão inclui um mecanismo de implantação do lado do cliente plug-ins, políticas ou outras modificações. Se você desejar implantar esse tipo de funcionalidade, você deve usar seu próprio programa de instalação e distribuição.

No arquivo XML, você pode especificar uma ou mais tarefas e suas dependências. Para obter um exemplo de uma tarefa que especifica um conjunto de relatórios, consulte o arquivo de arquivo ReportsTasks. XML no MSF para o modelo de processo de desenvolvimento de Software ágil.

Neste tópico

Site de relatórios
Folders
Relatórios
Permissões

Site de relatórios

Para os relatórios para serem executados corretamente, você deve criar um site de relatório. O site de relatório terá um link para ele na home page do portal do projeto e o link a ser rotulado relatórios. Para criar o site de relatório, use o site elemento, que é mostrado no exemplo a seguir.

<task  id="Site" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project Reporting site created.">
    <dependencies />
    <taskXml>
      <ReportingServices>
        <site></site>
      </ReportingServices>
    </taskXml>
  </task>

Folders

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

<folder path=""/>

O exemplo a seguir cria quatro pastas no site do relatório. As pastas são rotuladas de Bugs, compilações, gerenciamento de projetos e testes.

  <task id="Populate Reports" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project reports uploaded.">
    <dependencies>
      <dependency taskId="Site" />
    </dependencies>
    <taskXml>
      <ReportingServices>
        <folders>
          <folder path="Bugs" />
          <folder path="Builds" />
          <folder path="Project Management" />
          <folder path="Tests" />
          <folder path="Dashboards" />
        </folders>
   . . .
  </task>

Relatórios

Relatórios são definidos pelos arquivos. RDL. Para adicionar relatórios para o site de relatório, copie os arquivos de relatório. RDL em uma pasta sob a pasta de relatórios no modelo de processo. Em seguida, use o elemento de relatório para descrever as fontes de dados e propriedades necessárias para o relatório.

<report name=""
        filename=""
        folder=""
        cacheExpiration ="30">

A tabela a seguir descreve os atributos do elemento de relatório.

Atributo	Descrição
name	O nome do relatório para exibir no site de relatórios e em Team Explorer.
nome do arquivo	Um caminho relativo sob a pasta local de relatórios a partir de onde obter o arquivo de relatório. RDL.
pasta	Um nome de caminho relativo de onde adicionar o relatório no site do relatório.
cacheExpiration	Define o número padrão de minutos que o relatório é armazenado em cache.

Você pode especificar valores para parâmetros em um relatório. Isso geralmente é usado para mapear o parâmetro de projeto para o team project atual. A maioria dos relatórios não funcionará corretamente sem uma referência ao projeto de equipe atual. Para mapear o parâmetro de projeto para o atual projeto de equipe, especifica o valor como PROJECTNAME de $$$ $.

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

A tabela a seguir descreve os atributos do elemento de propriedade.

Atributo	Descrição
name	O nome do parâmetro no relatório para vincular.
Valor	O valor ao qual vincular o parâmetro.

Você deve mapear o nome de cada fonte de dados em cada relatório para um live Team Foundation Server dados de origem. Use o elemento de referência para especificar uma fonte de dados.

<datasources>
   <reference name="" dsname=""/> 
</datasources>

A tabela a seguir descreve os atributos para o reference elemento.

Atributo	Descrição
name	O nome da fonte de dados no relatório.
dsname	O nome da Team Foundation Server dados de origem. Normalmente, esse valor é TfsReportDS ou TfsOlapReportDS.

O exemplo a seguir mostra como adicionar um relatório de Status de erro. O relatório está acoplado às fontes de dados de dois: TfsOlapReportDS e TfsReportDS.

<report name="Bug Status" filename="Reports\Bug Status.rdl" folder="Bugs" cacheExpiration="30">
            <parameters>
              <parameter name="ExplicitProject" value="" />
            </parameters>
            <datasources>
              <reference name="/Tfs2010OlapReportDS" dsname="TfsOlapReportDS" />
              <reference name="/Tfs2010ReportDS" dsname="TfsReportDS" />
            </datasources>
          </report>

Consulte também

Compartilhar via

Carregamento de relatórios usando os plug-in de relatórios

Site de relatórios

Folders

Relatórios

Consulte também

Tarefas

Conceitos

Outros recursos

Recursos adicionais