將報表加入至流程範本

發行項
06/09/2015

您可以使用 Reporting 外掛程式來指定將出現在新 Team 專案之 [報表] 節點下方的資料夾結構和報表集。

重要

Reporting 外掛程式要求您使用 SQL Server Analysis Services 和 SQL Server Reporting Services，設定您將建立 Team 專案所在的 Team 專案集合。如需詳細資訊，請參閱將報表加入至 Team 專案。

您可以使用 Reporting 外掛程式指定兩個主要的工作。首先，您可以使用 site 項目建立報告網站。接著，您可以使用 folder 和 report 項目，指定要上傳至該網站的資料夾結構和報表。您所上傳之報表的副檔名為 .rdl，且依設計會搭配 Reporting Services 使用。如需 TFS 流程範本提供之報表的概觀，請參閱報表 (SQL Server Reporting Services)。

從流程範本建立 Team 專案之後，您可以新增、移除、重新命名以及變更報表的資料夾結構。如需詳細資訊，請參閱檢視、上傳及組織報表 (Reporting Services 報表)。

Reporting 外掛程式的名稱和位置

下表摘錄 MSF 流程範本的檔案、資料夾與外掛程式的名稱。

檔案名稱：	ReportsTasks.xml
資料夾名稱：	報告
外掛程式名稱：	Microsoft.ProjectCreationWizard.Reporting

注意事項
您可以變更 XML 檔案和資料夾的名稱，但無法變更外掛程式的名稱。Visual Studio Team Foundation Server 並未包含部署用戶端外掛程式、原則或其他修改的機制。如果您想要部署這種功能，就必須使用您自己的散發與安裝程式。

在 XML 檔中，您可以指定一項或多項工作及其相依性。如需指定報表集之工作的範例，請參閱 MSF for Agile Software Development 流程範本中的 ReportsTasks.xml 檔案。

Reporting 外掛程式語法結構

Reporting 外掛程式檔案必須符合 ReportingServices 的結構描述定義 (如 Rosetta.xsd 檔案中所定義)，而且必須在自己的檔案中指定外掛程式。

下列語法顯示 Reporting 外掛程式的結構。如需每個項目的描述，請參閱本主體稍後的 ReportingServices 子項目。

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

建立報表網站

若要讓報告正確執行，您必須建立報告網站。專案入口網站的首頁上會有標示為 [報告] 的連結，可以連結至報告網站。若要建立報告網站，請使用 site 項目，如下列範例所示：

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

定義資料夾

您可以使用 folder 項目在報告網站上建立資料夾。請使用 path 屬性來指定新資料夾的相對路徑名稱。資料夾會出現在專案網站上以及 Team Explorer的 [Reports] 資料夾下。

下列範例會在報告網站上建立四個頂層資料夾以及兩個子資料夾。頂層資料夾分別標示為 [Bug]、[Builds]、[Project Management] 與 [Tests]。兩個子資料夾位於 Project Management 之下，而且標示為 Visual Studio 和 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>

指定要上傳的報表

報告是由 .rdl 檔案所定義。若要將報告加入至報告網站，請將報告 .rdl 檔案複製到流程範本 [Reports] 資料夾下的某個資料夾中，然後使用 report 項目來描述此報告的必要屬性與資料來源。

下列範例會指定即將上傳至 Project Management 資料夾的 Remaining Work.rdl 檔案。您必須針對每個報表指定 ExplicitProject 參數與資料來源。以下範例中的資料來源會對應到自動指派給 Analysis Services Cube 以及資料倉儲關聯式資料庫的名稱。

注意事項
Reporting Services 資料來源名稱是 Tfs2010ReportsDS 與 Tfs2010OlapReportsDS。即使您已安裝或升級至 TFS 2012 或 TFS 2013，這些已指派為 TFS 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>

ReportingServices 項目參考

下列語法顯示 ReportingServices 項目及其子項目的結構。您可以在 taskXml 容器項目中指定這些項目，而且僅針對 Reporting 外掛程式指定。

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

下表描述您用來指定要上傳至 Team 專案，而且可以透過 SQL Server Reporting Services 存取的項目。

項目	語法	描述
datasources	`<datasources> <reference /> </datasources>`	report 的必要子項目。包含 reference 項目的集合，這些項目中的每一個都會指定報表所使用的資料來源。
folder	`<folder path="FolderName" />`	folders 的必要子項目。定義要在 Team 專案之 [報表] 節點下建立之資料夾的名稱。
folders	`<folders> <folder path="FolderName" /> </folders>`	ReportingServices 的選擇性子項目。包含 folder 項目的集合，其中每個項目都會指定一個要建立之資料夾的名稱。
parameter	`<parameter name="ParameterName" value="ParameterValue" />` 其中每個屬性都具有下列定義： name：您要指定之參數的名稱。 value：要指派給參數的值。您至少必須定義下列參數，讓您的報表自動使用包含您報表的專案。 `<parameter name="ExplicitProject" value="" />`	parameters 的必要子項目。指定報表參數的名稱，以及要指派給該參數的值。
parameters	`<parameters> <parameter /> </parameters>`	report 的必要子項目。定義報表之 parameter 項目的集合。
properties	`< properties > < property /> </ properties >`	report 的選擇性子項目。
property	`<property name="PropertyName" value="PropertyValue" />` 其中每個屬性都具有下列定義： name：您要指定之屬性的名稱。如需詳細資訊，請參閱使用報表管理員檢視、組織和設定報表。 value：要指派給屬性的值。	properties 的必要子項目。
reference	`<reference name="RelationalDBName" dsname="OLAPDBName" />` 其中每個屬性都具有下列定義： name：Team Foundation Server 中資料來源的名稱。若是 Team Foundation Server 2010，此值為 Tfs2010OlapReportDS (Analysis Services Cube) 或 Tfs2010ReportsDS (關聯式資料倉儲)。 dsname：資料庫資源的名稱。指定 TfsOlapReportDS (Analysis Services Cube) 與 TfsReportsDS (關聯式資料倉儲)。如需報告資料來源之名稱的詳細資訊，請參閱升級至 Team Foundation Server 2010 後尋找報表。	datasources 的必要子項目。針對資料倉儲關聯式資料庫和 Analysis Services Cube，指定 Team Foundation Server 中指派的名稱。
report	`<report name="ReportName" filename="ReportFilePathName" folder="FolderName" cacheExpiration="CacheDuration"> <folders> <parameters>. . .</parameters> <datasources>. . .</datasources> <properties>. . .</properties > </report>` 其中每個屬性都具有下列定義： name：要顯示在報告網站上以及 Team Explorer中的報告名稱。 filename：本機 [Reports] 資料夾下的相對路徑，可以從此路徑取得 .rdl 報告檔。 folder：相對路徑名稱，這是在報告網站上加入報告的位置。 cacheExpiration：快取報告的預設分鐘數。	reports 的必要子項目。指定報表的名稱、包含 .rdl 定義的檔案，以及上傳報表所在的資料夾。 Team Foundation Server
reports	`<reports> <report /> . . . </reports>`	ReportingServices 的必要子項目。包含 report 項目的集合，其中每個項目都會指定要上傳之報表檔案的名稱。
ReportingServices	`<ReportingServices> <folders>. . .</folders> <reports>. . .</reports> </ReportingServices>`	Reporting 外掛程式之 taskXml 項目的必要子項目。描述定義 SQL Server Reporting Services 之報表和資料夾所需的工作。
site	`<site> </site>`	Reporting 外掛程式檔案的必要項目。指定將建立 Team 專案的報告網站。

請參閱

概念

自訂流程範本

流程範本檔概觀