開發新的自訂網站定義與建立升級定義檔案 (Office SharePoint Server)

發行項
06/12/2012

本文內容：

開發新的自訂網站定義之前
開發新的自訂網站定義
關於升級定義檔
建立升級定義檔
在工作表中記錄升級定義檔資訊

開發新的自訂網站定義之前

在您根據自訂網站定義升級網站之前，您必須採取下列步驟，以確保升級後會繼續使用從自訂網站定義衍生的每個清單及頁面。

注意

如果您還沒準備好要根據自訂網站定義升級網站 (例如，如果您從方案提供者取得網站定義，但尚未提供該網站定義的新版本)，您可以使用逐步升級來升級其他網站，並讓根據舊的自訂網站定義之網站維持在舊版環境中執行。稍後，當您有新的自訂網站定義時，即可建立升級定義檔，並僅升級根據新的自訂網站定義之網站。

**取得或開發新的自訂網站定義與自訂元素 **若要保留根據自訂網站定義的網站功能，您需要新的自訂網站定義以包含所需的全部功能，以及任何您想使用的新功能。如果您從方案提供者取得自訂網站定義或自訂元素，請檢查提供者是否有新版本。如果方案提供者未提供新版本，您可能需要自行開發。
**建立網站升級定義檔 **您還需要建立檔案，以將自訂元素從舊的自訂網站定義對應至新的自訂網站定義，讓網站中的每個元素 (例如自訂頁面) 可升級至適當的新元素。
**建立頁面範本升級定義檔 **對於 Microsoft Office SharePoint Portal Server 2003，您還需要建立升級定義檔，以將頁面範本 (例如首頁範本) 轉譯為新的版面配置。Microsoft Office SharePoint Server 2007 中的版面配置會取代 SharePoint Portal Server 2003 中的頁面範本，而您必須指定每個頁面類型要使用的版面配置。如需版面配置的詳細資訊，請參閱＜規劃網頁＞。

重要

若是使用 SharePoint Portal Server 2003 的預先定義網站定義之一建立網站範本，則升級程序可能會覆寫網站範本中所含的一些檔案或自訂項目。您必須重新建立利用 SharePoint Portal Server 2003 網站定義所建立的網站範本。此外還必須使用相等的 Office SharePoint Server 2007 網站定義重建範本，以便升級之後提供新的網站。

在升級前程序期間，會將新的自訂網站定義及任何升級定義檔複製到安裝目錄，以供升級網站集合時使用。

開發新的自訂網站定義

使用此程序可在開發環境中建立自訂網站定義。如需詳細資訊，請參閱 MSDN 上的 Windows SharePoint Services 軟體開發套件 (SDK)。

從新版環境提供的網站定義開始建立自訂網站定義。
- 網站定義儲存在下列資料夾：
  
  %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\SiteTemplates\NAME
  
  其中 NAME 與網站定義名稱相符 (例如 ACTION)。為新網站定義建立資料夾，並使用全大寫字母命名新資料夾。
- 用於登錄網站範本的 XML 檔案儲存在下列位置：
  
  %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\LCID\XML\webtempname.xml
  
  其中 name 與網站定義名稱相符，只有使用小寫字母的名稱除外 (例如 action)；而 LCID 是範本語言的區域設定識別碼 (例如，1033 表示美國英文)。
為 SharePoint Portal Server 2003 中的每個自訂網站定義建立新版 webtempname.xml 檔案，其中 name 是網站定義的名稱。您可以從新版產品 (環境) 提供之標準網站定義的檔案，建立 webtempname.xml 檔案。
在您成功完成升級程序之後，請將用於 SharePoint Portal Server 2003 的頁面範本，複製到已升級網站集合根目錄的主版頁面庫資料夾。如需詳細資訊，請參閱＜規劃網頁＞。

此外，還可直接使用 SharePoint Portal Server 2003 的對應自訂登陸頁面來建立版面配置。升級之前，請儲存自訂登陸頁面的複本。在您成功完成升級程序之後，請將這些版面配置頁面上載至網站集合根目錄的主版頁面庫資料夾。
建立根據網站定義的新網站，以在開發環境中測試網站定義。

在您建立及測試新網站定義之後，即可建立升級定義檔，將舊的網站定義對應至新的網站定義。

關於升級定義檔

網站升級定義檔說明如何將舊的自訂網站定義對應至新的網站定義。網站升級定義檔的目標在於，提供開發人員將舊網站轉換為新網站的工具，以利用新版環境必須提供的所有增強功能。

在 Microsoft Office SharePoint Server 2007 中，特定頁面範本會有升級定義檔。頁面範本是定義頁面結構的 Active Server Page Extension (ASPX) 檔案。頁面範本的好處在於您可以根據頁面範本建立新頁面，而不是在與 Office SharePoint Server 2007 相容的網頁編輯器中建立頁面。頁面範本儲存在網站集合的根目錄，並可跨網站集合共用。

在 Office SharePoint Server 2007 中，頁面範本會用於入口網站的大多數頁面。換言之，Office SharePoint Server 2007 的所有新網站定義會包含頁面範本，且先前根據舊版產品 (環境) 中標準入口網站定義的許多入口網站頁面，現在會根據新版產品中的不同版面配置。升級程序會將入口網站頁面從舊版產品移至使用新版產品中版面配置的頁面。舊版產品的頁面範本會移至新版產品提供的預設版面配置集合。如果預設版面配置集合不符合您的需要，您可以建立自訂的集合，並提供升級定義檔將舊版入口網站頁面對應至新的版面配置。

網站定義的升級定義檔具有下列區段：

**WebTemplate **指定整個網站範本的升級資訊。在此區段中，每個升級定義檔需要一個 WebTemplate 標籤。
**Lists **指定範本中每個清單或文件庫的升級資訊。在 [Lists] 區段中，每個清單或文件庫需要一個 List 標籤。
**Files **指定範本中個別頁面的升級資訊。在 [Files] 區段中，範本中的每個非客製化頁面需要一個 File 標籤。
**AppliedSiteFeature **指定範本中所包含之任何網站集合層級或子網站層級功能的升級資訊。在 [AppliedSiteFeature] 與 [AppliedWebFeature] 區段中，每個功能在範本中的該層級需要一個 Feature 標籤。
**AppliedWebFeature **指定範本中所包含之任何子網站層級功能的升級資訊。在 [AppliedWebFeature] 區段中，每個功能在範本中的該層級需要一個 Feature 標籤。

下列範例取自 Office SharePoint Server 2007 中安裝的其中一個檔案，概述頁面範本升級定義檔的格式。

<SPSSiteUpgraderConfig>
    <PublishingPageLayoutMappings>
        <PublishingPageLayoutMapping WebTemplateId="20" PublishingPageLayout="/_catalogs/masterpage/defaultlayout.aspx"/>
        <PublishingPageLayoutMapping WebTemplateId="22" PublishingPageLayout="/_catalogs/masterpage/welcomelayout2.aspx"/>
    </PublishingPageLayoutMappings>
</SPSSiteUpgraderConfig>

如此範例所示，網站範本會對應至頁面範本；換言之，識別碼為 20 的網站範本會對應至版面配置為 defaultlayout.aspx 的頁面範本。這表示使用範本識別碼 20 的每個網站會有使用 defaultlayout.aspx 所定義之版面配置的首頁 (通常為 default.aspx)。

請務必在頁面範本升級定義檔中，包含您將用於 Office SharePoint Server 2007 版面配置之 SharePoint Portal Server 2003 自訂登陸頁面的項目。這些項目會將網站範本識別碼設為您將用於版面配置之 SharePoint Portal Server 2003 登陸頁面的名稱。