共用方式為


報表流程範本外掛程式

更新:2007 年 11 月

「報告」外掛程式會定義 Team 專案的初始報告。此外掛程式的名稱是 Microsoft.ProjectCreationWizard.Reporting,而「報告」XML 檔的名稱則是 ReportsTasks.xml,位於流程範本資料夾階層架構的 [報告] 資料夾中。必要時,您可以變更 XML 檔案和資料夾名稱。

在 XML 檔中,指定一或多項工作及其相依性。如需指定簡單報告之工作的範例,請參閱 MSF for Agile Software Development 流程範本中的 ReportsTasks.xml 檔。

注意事項:

Team Foundation Server 並未包含部署用戶端外掛程式、原則或其他修改的機制。如果您想要將外掛程式、原則或其他修改部署至 Team 總管,就必須使用您自己的散發與安裝程式。

報告網站

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

<task 
   id="Site"
   plugin="Microsoft.ProjectCreationWizard.Reporting"
   completionMessage="Project Reporting site created.">
   <dependencies/>
   <taskXml>
      <ReportingServices>
         <site />
      </ReportingServices>
   </taskXml>
</task>

資料夾

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

<folder path=""/>

下面範例會在報告網站上建立 Public 資料夾。

   <task id="Populate Reports"
          plugin="Microsoft.ProjectCreationWizard.Reporting"
          completionMessage="Project site created.">
        <dependencies>
            <dependency taskId="Site"/>
        </dependencies>
        <taskXml>
            <ReportingServices>
         <folders>
            <folder path="Public"/>
         </folders>
      </ReportingServices>
   </taskXml>
</task>

報告

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

<report name=""
        filename=""
        folder=""
        cacheExpiration ="30">

下表將說明 report 項目的屬性。

屬性

描述

name

要顯示在報告網站上以及 Team 總管中的報告名稱。

filename

本機 [報告] 資料夾下的相對路徑,可以從此路徑取得 .rdl 報告檔。

folder

相對路徑名稱,這是在報告網站上加入報告的地方。

cacheExpiration

設定快取報告的預設分鐘數。

您可以指定報告中參數的值,這通常是用於將 Project 參數對應至目前的 Team 專案。如果缺少了對目前 Team 專案的參考,大部分報告都無法正確執行。若要將 Project 參數對應至目前的 Team 專案,請將此值指定為 $$PROJECTNAME$$。

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

下表將說明 property 項目的屬性。

屬性

描述

name

報告中要繫結之參數的名稱。

要繫結的參數值。

您必須將每一份報告中的每一個資料來源名稱對應至目前可用的 Team Foundation Server 資料來源。請使用 reference 項目來指定資料來源。

<datasources>
   <reference name="" dsname=""/> 
</datasources>

下表將說明 reference 項目的屬性。

屬性

描述

name

報告中資料來源的名稱。

dsname

Team Foundation Server 資料來源的名稱。這個值通常是 TfsReportDS 或 TfsOlapReportDS。

下面範例示範如何加入 Work Items 報告。Project 參數會繫結至目前的 Team 專案,而報告則會繫結至 TfsReportDS 資料來源。

<report name="Work Items" 
        filename="Reports\Work Items.rdl" 
        folder="" 
        cacheExpiration ="30">
   <parameters>
      <parameter name="Project" value="$$PROJECTNAME$$"/>
   </parameters>
   <datasources>
      <reference name="/TfsOlapReportDS" dsname="TfsOlapReportDS"/> 
      <reference name="/TfsReportDS" dsname="TfsReportDS"/>
   </datasources>
</report>

請參閱

工作

HOW TO:驗證報告變更

概念

Windows SharePoint Services 流程範本外掛程式

版本控制流程範本外掛程式

群組及權限流程範本外掛程式

其他資源

工作項目追蹤流程範本外掛程式