將報表加入至流程範本

您可以使用 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 流程範本的檔案、資料夾與外掛程式的名稱。

注意事項
您可以變更 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 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 以及 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>
   <reference />
</datasources>

<folder path="FolderName" />

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

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

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

<parameters>
   <parameter />
</parameters>

< properties >
   < property />
</ properties >

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

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

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

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

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

<site> </site>

回到頁首

請參閱

概念

自訂流程範本

逐步自訂流程

使用流程範本檔案

在流程範本中自訂功能區域