將報表加入至流程範本

發行項
08/12/2011

更新：2011 年 4 月

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

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

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

本主題內容

Reporting 外掛程式的名稱和位置
Reporting 外掛程式語法結構
建立報表網站
定義資料夾
指定要上傳的報表
ReportingServices 項目參考

從流程範本建立 Team 專案之後，您可以新增、移除、重新命名以及變更報表的資料夾結構。如需詳細資訊，請參閱管理報表。

Reporting 外掛程式的名稱和位置

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

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

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

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

回到頁首

Reporting 外掛程式語法結構

Reporting 外掛程式檔案必須符合 ReportingServices 的結構描述定義 (如 Rosetta.xsd 檔案中所定義)，而且必須在自己的檔案中指定外掛程式。您可以從 Microsoft 網站的下列頁面下載流程範本的結構描述檔案：Visual Studio Team Foundation 的流程範本和工作項目 (英文)。

下列語法顯示 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 總管的 [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 以及 Team Foundation Server 2010 之資料倉儲關聯式資料庫的名稱。如需詳細資訊，請參閱升級為 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>

回到頁首

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：您要指定之屬性的名稱。如需詳細資訊，請參閱使用報表管理員檢視、組織和設定 Visual Studio ALM 的報表。 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 總管中的報告名稱。 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 專案的報告網站。

回到頁首

請參閱

變更記錄

日期	記錄	原因
2011 年 4 月	已加入 Reporting 外掛程式支援之 ReportingServices 項目的語法結構。	資訊加強。

2011 年 4 月

已加入 Reporting 外掛程式支援之 ReportingServices 項目的語法結構。

資訊加強。

共用方式為

將報表加入至流程範本

Reporting 外掛程式的名稱和位置

Reporting 外掛程式語法結構

建立報表網站

定義資料夾

指定要上傳的報表

ReportingServices 項目參考

請參閱

工作

概念

其他資源

變更記錄

其他資源