Udostępnij za pośrednictwem


Dodawanie raportów do szablonu procesu

By using the Reporting plug-in, you can specify the folder structure and set of reports that will appear under the RaportReports node for a new team project.

Ważna uwagaWażne

Raportowanie wtyczki wymaga skonfigurowano kolekcji projektów zespołowych, gdzie utworzy projektu zespołowego SQL Server usług Analysis Services i SQL Server usług Reporting Services.Aby uzyskać więcej informacji, zobacz Dodawanie raportów do projektu zespołowego.

Określamy dwa główne zadania przy użyciu raportowanie dodatku plug-in.Najpierw tworzymy raportowania witryny za pomocą site elementu.Drugi, określ struktura folderów i raportów do przesłania do witryny za pomocą folder i report elementów.Raporty, które można przekazać pliki z rozszerzeniem RDL i są przeznaczone do użytku z usługami Reporting Services.Przegląd raportów, że TFS przetworzyć Szablony zapewniają, zobacz Raporty (SQL Server Reporting Services ).

Po utworzeniu projektu zespołowego z szablonu procesu można dodać, usunąć, Zmień nazwę i zmienić struktura folderów dla raportów.Aby uzyskać więcej informacji, zobacz Przeglądaj, przekazuj i organizuj raporty (Raporty usługi raportowania).

Raportowanie wtyczki nazwa i lokalizacja

Poniższa tabela zawiera podsumowanie nazwy pliku, folderu i dodatku plug-in dla struktury MSF szablony procesów.

Nazwa pliku:

ReportsTasks.xml

Nazwa folderu:

Raporty

Nazwa dodatku:

Microsoft.ProjectCreationWizard.Reporting

[!UWAGA]

Można zmienić nazwy pliku XML i folderu, ale nie dodatku plug-in.Visual Studio Team Foundation Servernie ma mechanizm wdrażania dodatków po stronie klienta, zasad lub inne modyfikacje.Jeśli chcesz wdrożyć tego rodzaju funkcje, trzeba użyć dystrybucji i instalacji aplikacji użytkownika.

W pliku XML należy określić co najmniej jedno zadanie oraz ich zależności.Na przykład zadanie, które określa zestaw raportów znaleźć w pliku ReportsTasks.xml w Opracowywanie szablonu procesu Zwinne Wytwarzanie oprogramowania.

Raportowanie wtyczki składni struktury

Plik dodatku plug-in raportowanie musi być zgodna z definicji schematu dla ReportingServices, który jest zdefiniowana w pliku Rosetta.xsd i można określić w pliku.Pliki schematów dla szablony procesów można pobrać z następującej strony w witrynie sieci Web firmy Microsoft: szablon procesu i schematów elementu roboczego dla programu Visual Studio Team Foundation.

Następująca składnia pokazuje strukturę raportowanie dodatku plug-in.Opis każdy element, zobacz elementy podrzędne ReportingServices poniżej w tym temacie.

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

Tworzenie witryny raportów

Dla raportów działać prawidłowo należy utworzyć witrynę raportowania.The reporting site will have a link to it on the project portal home page, and the link will be labeled RaportReports.Aby utworzyć witrynę raportowania, należy użyć site elementu, jak pokazano w następującym przykładzie:

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

Definiowanie folderów

Można utworzyć foldery w witrynie raportowania za pomocą folder elementu.Użyj atrybutu ścieżki, aby określić nazwę ścieżki względnej nowy folder.Folder jest wyświetlany w witrynie projektu i w folderze Raporty w Team Explorer.

Poniższy przykład tworzy cztery foldery najwyższego poziomu i dwa podfoldery w witrynie raportowania.Foldery najwyższego poziomu są oznaczone usterki, kompilacji, zarządzania projektem i testów.Dwa podfoldery znajdują się w obszarze Zarządzanie projektami i są oznaczone jako Visual Studio i ALM w programie Visual Studio.

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

Określ raporty można przekazać

Raporty są definiowane przez pliki RDL.Aby dodać raporty w witrynie raportowania, skopiuj pliki RDL raportu do folderu w folderze Raporty w szablonie procesu.Następnie użyj elementu raportu do opisywania niezbędne właściwości i źródła danych dla raportu.

W poniższym przykładzie określono, że pozostałe Work.rdl plik zostanie dołączony do folderu Zarządzanie projektami.Należy określić ExplicitProject parametr i źródła danych dla każdego raportu.Źródła danych w tym przykładzie odpowiadać na nazwy, które są automatycznie przypisywane do modułu usług Analysis Services i relacyjnej bazy danych magazynu danych.

[!UWAGA]

Nazwy usług reporting services są źródeł danych Tfs2010ReportsDS i Tfs2010OlapReportsDS.Nawet jeśli użytkownik może być zainstalowany, lub uaktualnienie do TFS 2012 lub TFS 2013, te nazwy, które zostały przypisane do źródeł danych w celu przeprowadzenia instalacji TFS 2010, nadal ma być używany.

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

Odwołanie do elementu ReportingServices

Poniższa składnia pokazuje strukturę elementu ReportingServices i jego elementy podrzędne.Określ te elementy w ramach taskXml element kontenera i tylko w przypadku raportowanie dodatku plug-in.

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

W poniższej tabeli opisano elementy, które służy do określania raportu można przekazać do projektu zespołowego i że można uzyskać dostęp za pośrednictwem SQL Server usług Reporting Services.

Element

Składnia

Opis

datasources

<datasources>
   <reference />
</datasources>

Wymagany element podrzędny elementu report.

Zawiera zbiór reference źródła elementy, że każdy określają danych używany w raporcie.

folder

<folder path="FolderName" />

Wymagany element podrzędny elementu folders.

Definiuje nazwę folderu do utworzenia w obszarze raporty węzła dla projektów zespołowych.

folders

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

Opcjonalny element podrzędny elementu ReportingServices.

Zawiera zbiór folder elementy czy każdy określić nazwę folderu do utworzenia.

parameter

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

Gdzie każdy atrybut ma następującą definicję:

  • name: Nazwa parametru, który ma zostać określony.

  • value: Wartość do przypisania do parametru.

Co najmniej należy zdefiniować następujące parametru dokonanie raportu automatycznie użyj projekt zawierający raportu:

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

Wymagany element podrzędny elementu parameters.

Określa nazwę parametru raportu i wartość do przypisania do niej.

parameters

<parameters>
   <parameter />
</parameters>

Wymagany element podrzędny elementu report.

Definiuje zbiór parameter elementów raportu.

properties

< properties >
   < property />
</ properties >

Opcjonalny element podrzędny elementu report.

property

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

Gdzie każdy atrybut ma następującą definicję:

Wymagany element podrzędny elementu properties.

reference

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

Gdzie każdy atrybut ma następującą definicję:

  • name: Nazwa źródła danych w Team Foundation Server.Dla Team Foundation Server 2010, ta wartość jest Tfs2010OlapReportDS dla modułu usług Analysis Services lub Tfs2010ReportsDS dla magazynu danych relacyjnych.

  • dsname: Nazwa zasobu bazy danych.Określ TfsOlapReportDS dla modułu usług Analysis Services i TfsReportsDS dla hurtowni danych relacyjnych.

Aby uzyskać więcej informacji o nazwach źródeł danych raportowania, zobacz Lokalizowanie raportów po uaktualnieniu do programu Team Foundation Server 2010.

Wymagany element podrzędny elementu datasources.

Określa nazwę, które są przypisane w Team Foundation Server dla relacyjnej bazy danych magazynu danych i modułu usług Analysis Services.

report

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

Gdzie każdy atrybut ma następującą definicję:

  • name: Nazwa raportu, aby wyświetlić w witrynie raportowania oraz na Team Explorer.

  • filename: Ścieżką względną w folderze lokalnym raporty z do uzyskania pliku RDL raportu.

  • folder: Ścieżka względna nazwa lokalizacji, aby dodać raport w witrynie raportowania.

  • cacheExpiration: Domyślna liczba minut, dla których raport jest zapisane w pamięci podręcznej.

Wymagany element podrzędny elementu reports.

Określa nazwę raportu, pliku, który zawiera definicję RDL i folderu, do którego jest przekazane raportu.Team Foundation Server

reports

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

Wymagany element podrzędny elementu ReportingServices.

Zawiera zbiór report elementów, że każdy Podaj nazwę raportu plik do przekazania.

ReportingServices

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

Wymagany element podrzędny elementu taskXml elementu Raportowanie dodatku plug-in.

Zawiera opis zadań, które są wymagane do definiowania raportów i folderów dla SQL Server usług Reporting Services.

site

<site> </site>

Wymagany element dla raportowania dodatku plug-in.

Określa, zostanie utworzony obiekt raportowania na projektu zespołowego.

Zobacz też

Koncepcje

Dostosowywanie szablonu procesów

Stopniowy proces dostosowywania [redirected]

Przegląd plików szablonów procesów

Dostosowywanie obszarów funkcjonalnych w szablonie procesów [przekierowanie]