共用方式為

定義流程範本的專案入口網站外掛程式

  • 發行項

使用入口網站外掛程式可讓您定義 Team 專案入口網站的初始文件庫、文件庫結構和文件。 您也可以納入工作，以建立專為搭配 Team Foundation Server (TFS) 流程範本而設計的儀表板和 Excel 報表。

您在外掛程式中針對 SharePoint 產品指定的工作只會在您建立 Team 專案期間建立 SharePoint 網站時執行。 如需有關這網站需求和管理的詳細資訊，請參閱 Team Foundation Server 的 SharePoint 產品需求。

入口網站外掛程式名稱和位置

下表摘錄 TFS 流程範本的入口網站外掛程式檔案、資料夾與外掛程式的名稱。

檔案名稱：

WssTasks.xml

資料夾名稱：

Windows SharePoint Services

外掛程式名稱：

Microsoft.ProjectCreationWizard.Portal
注意事項注意事項

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

入口網站建立工作和相依性

在入口網站外掛程式檔案中，您可以指定一個或多個工作及其相依性。 您可以指定下列主要工作：

  • 使用指定的網站範本建立網站

  • 建立文件庫

  • 建立資料夾以及將檔案上載至文件庫

  • 啟動儀表板功能

如需指定簡單專案入口網站的工作範例，請參閱任一 TFS 流程範本中的 WssTasks.xml 檔。 您可以從 TFS 下載最新的流程範本。

建立網站和指定網站範本

您必須指定專案入口網站所依據的網站範本。 此外，Team Foundation Server SharePoint 入口網站上也要提供網站範本， 因為流程範本中並沒有包含網站範本。

請使用 site 項目來指定網站範本。

<site template="" language=""/>

下表說明 site 項目的屬性。

屬性

描述

Template

指定要使用哪一個範本。 您必須為即將建立的 Team 專案，指定裝載該專案之 SharePoint 產品的伺服器上所定義的範本。

若要使用新版 MSF 流程範本提供的功能，請指定下列字串：Team Foundation Server Project Portal。

語言

指定地區設定 ID，以代表要使用網站範本的哪一個語言版本。 英文版本是 1033。

下面範例將示範如何參考最新版 MSF Agile 流程範本的英文版本，此版本支援儀表板。

<tasks>
  <task id="SharePointPortal" name="Create Sharepoint Portal" plugin="Microsoft.ProjectCreationWizard.Portal" completionMessage="Project portal site created.">
    <dependencies />
    <taskXml>
        <Portal>
           <site template="Team Foundation Server Project Portal" language="1033" />  
       . . . 
        </Portal>
注意事項注意事項

在入口網站外掛程式中定義的其他所有工作都相依於網站建立工作，因為您必須先將專案入口網站建立起來，接著才能建立其他文件庫或複製檔案。

流程範本的效能

您在 WssTasks.xml 中所指定的檔案，會在流程範本上載時納入其中當成它的一部分。 流程範本的大小會影響建立新的 Team 專案所要花費的時間， 較大的流程範本會花費較長的時間來建立新的 Team 專案。 因此，當流程範本的效能降低時，您應該考慮使用其他策略來提供檔案。

使用網站範本

您可以將檔案納入 SharePoint 網站範本中當成它的一部分。 這樣就會將檔案從流程範本移到網站範本中，進而改善建立新 Team 專案的效能。

不過，將檔案列在 WssTasks.xml 中有一項優點， 那就是您可以使用先前所述的 queryid 屬性，將 Microsoft Project 和 Microsoft Excel 檔繫結至查詢。 這對小組成員很有幫助，因為當小組成員開啟檔案時，就已經連接到正確的 Team Foundation Server 和查詢。

使用其他網站

如果有一大堆多個 Team 專案所共用的檔案，您可以使用另一個網站來裝載檔案，然後從專案入口網站或網頁連結至這些檔案。 這個策略也可以改善建立 Team 專案的效能，因為不需要將檔案複製到專案入口網站。 如需詳細資訊，請參閱設定或加入專案入口網站。

建立文件庫

建立了專案入口網站之後，您可以指定要建立其他文件庫。 請使用 documentLibrary 項目來指定文件庫。

<documentLibraries>
   <documentLibrary name="" description="" isProcessGuidance="true | false" />
</documentLibraries>
注意事項注意事項

您無法在流程範本中啟用或停用文件庫的版本控制，但可以經由 Windows SharePoint Services 網站範本或是在專案建立之後啟用或停用版本控制。

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

屬性

描述

name

指定出現在專案入口網站上的文件庫的名稱。

description

提供出現在專案入口網站上的文件庫的說明。

isProcessGuidance

指定是否使用文件庫來支援流程指引內容。

下列範例將示範如何建立開發小組可以用來存放文件的文件庫 (名稱為 Development)。

<documentLibraries>
. . .
   <documentLibrary name="Process Guidance" description="How to make best use of the Team Foundation Server tools and process" isProcessGuidance="true" />
. . .
</documentLibraries>

建立文件庫的資料夾結構

建立了專案入口網站之後，您可以指定要建立其他資料夾， 也可以指定要複製哪些檔案 (例如範本檔)。

請使用 folder 項目來建立新的資料夾。

<folders>
   <folder documentLibrary="" name=""/>
</folders>

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

屬性

描述

documentLibrary

識別要在哪一個文件庫中建立資料夾。

name

指定資料夾的名稱。

下面範例將示範如何在 Development 文件庫中建立一個稱為 Trip Reports 的資料夾，讓開發人員可以存放參加會議或拜訪客戶後所做的心得報告。

<folders>
   <folder documentLibrary="Development"
           name="Trip Reports"/>
</folders>

指定要上傳至文件庫的檔案

您還必須將檔案複製到文件庫與資料夾中。 原始程式檔是位於 Windows SharePoint Services 資料夾中， 您必須指定位於專案入口網站上的目標。

<files>
   <file source="" documentLibrary="" target="" queryId="" /> 
</files>

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

屬性

描述

來源

本機檔案複本的相對路徑。 一般而言，來源路徑名稱一律是以 Windows SharePoint Services 為開頭，這是定義入口網站外掛程式之資料夾的名稱。

documentLibrary

要將檔案複製到那裡的文件庫的名稱。

target

要將檔案複製到專案入口網站上的目標的相對路徑。

queryId

指定繫結至檔案的工作項目查詢的名稱。 當檔案初次開啟時，就會在檔案中填入執行查詢的結果。 這個屬性是選擇性的屬性，而指定的查詢則必須存在於 workitems.xml 檔中。

注意事項注意事項

queryId 只適用於 .xls 檔。

下面範例示範如何將一個稱為 Project Checklist 的範本檔複製到 Project Management 資料夾中。 這個範例還會指定當檔案初次開啟時，應該要在檔案中填入 Project Checklist 工作項目查詢的結果。

<files>
   <file source="Windows SharePoint Services\Templates\Project Checklist.xls" 
      documentLibrary="Project Management" 
      target="Project Checklist.xls" 
      queryId="Project Checklist" />
</files>
注意事項注意事項

您可以將資料夾與檔案納入網站範本中當成它的一部分，而不需在 XML 中列出。
注意事項注意事項

如果您指定了 .exe 檔，而 SharePoint 網站不支援 .exe 檔，就無法使用流程範本成功地建立 Team 專案。

流程指引內容和支援檔案

流程指引是一份內容，當中記錄了參與軟體專案之小組成員所應遵循的流程。 在 Team 專案的生命週期當中，工作項目、報告和查詢都可能會變動，而且可能會因 Team 專案而有差異。 因此，流程指引內容提供了有關 Team 專案的詳細資料，例如，如何完成工作項目欄位的相關資訊、狀況良好和狀況不良的報告範例，以及查詢的描述。 流程指引也提供了 Team 專案所要遵循的流程之詳細資料，例如，所承擔的角色以及要完成的活動。

您可以從 MSDN Library 存取流程指引內容給每個預設 TFS 流程範本所定義的大部分成品。 您可以從任何下列主題瀏覽 MSDN 現有內容：Visual Studio Scrum、MSF for Agile 和 MSF for CMMI。

為了支援存取 Team Explorer 中工作項目表單的流程指引，會將一組 .htm 檔案上傳至 SharePoint 文件庫中名稱為 [Process Guidance] 的資料夾。 這些檔案指定當小組成員選擇工作項目表單中的 開啟工作項目的流程指引 流程指引圖示時，所開啟連至 MSDN 內容的 URL。 這些檔案會根據在入口網站外掛程式中定義的 file 工作上傳。 例如，Agile 流程範本會定義下列 file 工作：

<!-- Process Guidance -->
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.html" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.htm" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.aspx" />

您可以自訂這些檔案，使其指向其他流程指引資源。 您也可以加入檔案，來支援存取其他為小組建立的流程指引。 如需詳細資訊，請參閱設定或加入專案入口網站。

啟動儀表板功能

儀表板可顯示專案資料、支援調查，並幫助小組快速地執行一般工作。 儀表板可顯示多種 Excel 報告和 Team Web Access Web 組件。

您可以使用 activateFeatures 項目來促成儀表板和 Excel 報告的建立。 您必須在入口網站外掛程式檔案的 Portal 項目中加入下列程式碼，才能為 Team 專案啟動儀表板和 Excel 報告建立功能。

若要啟動專為搭配 Visual Studio Scrum 流程範本而設計的儀表板功能：

      <Portal>
    . . . 
<activateFeatures>
         <!-- TfsDashboardScrumWss -->
          <feature featureId="71EC0D67-21AB-4560-A825-9D976DA09D04" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

若要啟動專為搭配 MSF Agile 軟體開發之流程範本而設計的儀表板功能：

      <Portal>
    . . . 
        <activateFeatures>
          <!-- TfsDashboardAgileMoss -->
          <feature featureId="0D953EE4-B77D-485b-A43C-F5FBB9367207" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

若要啟動專為搭配 MSF CMMI 流程改進的流程範本而設計的儀表板功能：

      <Portal>
    . . . 
<activateFeatures>
          <!-- TfsDashboardCmmiMoss -->
          <feature featureId="3D0BA288-BF8E-47F0-9680-7556EDEF6318" />
          <!-- TfsDashboardCmmiProcessDocLibraries -->
          <feature featureId="8610B95B-063F-4FB5-837C-BCF2FE9423C6" />
        </activateFeatures>
    . . . 
      </Portal>

請參閱

概念

自訂流程範本

流程範本檔概觀