更新: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>
請參閱
工作
概念
Windows SharePoint Services 流程範本外掛程式
注意事項: