Dodawanie raportów do szablonu procesu

Artykuł
09/13/2015

Przy użyciu raportowanie dodatku plug-in, można określić struktura folderów oraz zestaw raportów, które będą wyświetlane w obszarze Report Raporty węzła dla nowego projektu zespołowego.

Waż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 elementy. 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 Server nie 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.

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. Witryna Raportowanie będzie zawierać łącze do niej na stronie głównej portalu projektu, a następnie łącze będzie oznaczone Report Raporty. 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 raportowania w witrynie przy użyciu 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 nowszej wersji programu TFS, 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

Następująca składnia pokazuje strukturę ReportingServices elementu i jego elementów podrzędnych. 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>`	Element podrzędny opcjonalne 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 >`	Element podrzędny opcjonalne report.
property	`<property name="PropertyName" value="PropertyValue" />` Gdzie każdy atrybut ma następującą definicję: name: Nazwa właściwości, która ma zostać określony. Aby uzyskać więcej informacji, zobacz Wyświetlanie, organizowanie i konfigurowanie raportów za pomocą usługi raportowania. value: Wartość do przypisania do właściwości.	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 zlokalizowanie raporty po uaktualnić do wersji 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 foldery 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

Dostosowanie procesu

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

Udostępnij za pośrednictwem