开发新的自定义网站定义并创建升级定义文件 (Office SharePoint Server)

本文内容：

• 在开发新的自定义网站定义之前

• 开发新的自定义网站定义

• 关于升级定义文件

• 创建升级定义文件

• 在工作表中记录升级定义文件信息

在开发新的自定义网站定义之前

在升级基于自定义网站定义的网站之前，必须执行以下步骤，以确保从自定义网站定义派生的每个列表和页面在升级后都能继续工作。

1. 获取或开发新的自定义网站定义和自定义元素 如果要保留基于自定义网站定义的网站的功能，则需要新的自定义网站定义，其中包括所有需要的功能以及要使用的任何新功能。如果是从解决方案提供商那里获得的自定义网站定义或自定义元素，请检查提供商是否提供了新版本。如果解决方案提供商未提供新版本，则可能需要自行开发。

2. 创建网站升级定义文件 您还需要创建一个文件，以将自定义元素从旧的自定义网站定义映射到新的自定义网站定义，以便网站中的每个元素（例如自定义页）都可以升级为相应的新元素。

3. 创建网页模板升级定义文件 对于 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)。

1. 从新环境附带的网站定义开始创建自定义网站定义。

   • 网站定义存储在以下文件夹中：

     %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\SiteTemplates\名称

     其中，名称 与网站定义名称（例如 ACTION）相匹配。为新的网站定义创建一个文件夹，并全部使用大写字母来命名该新文件夹。

   • 用于注册网站模板的 XML 文件存储在以下位置：

     %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\LCID\XML\webtemp名称.xml

     其中，名称 与网站定义名称相匹配，但为小写字母（例如 action），LCID 是模板语言的区域设置标识符（例如，1033 表示美国英语）。

2. 为 SharePoint Portal Server 2003 中的每个自定义网站定义创建 webtemp名称.xml 文件的新版本，其中 名称 是网站定义的名称。您可以从新产品（环境）附带的标准网站定义文件创建 webtemp名称.xml 文件。

3. 成功完成升级过程之后，将用于 SharePoint Portal Server 2003 的网页模板复制到已升级网站集根目录下的母版页样式库文件夹中。有关详细信息，请参阅规划网页。

   此外，使用相应的自定义登陆页面，从 SharePoint Portal Server 2003 按原样创建页面布局。请先保存您的自定义登陆页面，然后再进行升级。成功完成升级过程后，将这些布局页上载到网站集根目录下的母版页样式库文件夹中。

4. 通过创建基于网站定义的新网站，在开发环境中测试网站定义。

创建并测试新的网站定义之后，就可以创建可将以前的网站定义映射到新的网站定义的升级定义文件。

关于升级定义文件

网站升级定义文件描述如何将以前的自定义网站定义映射到新的网站定义。网站升级定义文件旨在向开发人员提供工具，以便将其以前的网站转换为对应的新网站，从而充分利用新环境所提供的所有改进。

在 Microsoft Office SharePoint Server 2007 中，存在针对特定网页模板的升级定义文件。网页模板是一个定义页面结构的 Active Server Page Extension (ASPX) 文件。网页模板的优势在于：您可以根据网页模板创建新页面，而不是在与 Office SharePoint Server 2007 兼容的网页编辑器中创建网页。网页模板存储在网站集的根目录中，并在该网站集中共享。

在 Office SharePoint Server 2007 中，网页模板用于门户网站中的大多数网页。换句话说，Office SharePoint Server 2007 的所有新网站定义均包括网页模板，并且许多在以前产品（环境）中基于标准门户网站定义的门户网页在新产品中会基于不同的页面布局。升级过程会促使以前产品的门户网页使用新产品中的页面布局。以前产品的网页模板将使用新产品附带的默认页面布局集。如果默认页面布局集不能满足您的需要，您可以创建自定义集并提供升级定义文件，以便将旧的门户网页映射到新的页面布局。

网站定义的升级定义文件具有以下部分：

• WebTemplate 从总体上指定 Web 模板的升级信息。在本部分中，每个升级定义文件都需要一个 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>

在此示例中，您会发现网站模板映射到网页模板（换言之，ID 为 20 的网站模板映射到 defaultlayout.aspx 形式的页面布局）。这意味着使用 ID 为 20 的模板的每个网站都将具有一个使用由 defaultlayout.aspx 定义的页面布局的主页（通常为 default.aspx 形式）。

请确保为将用于 Office SharePoint Server 2007 中页面布局的 SharePoint Portal Server 2003 自定义登陆页面包含网页模板升级定义文件中的项。这些项会将网站模板 ID 设置为您将用作页面布局的 SharePoint Portal Server 2003 登陆页面的名称。

创建升级定义文件

为升级定义文件提供一个以网站定义名称开头的唯一名称。例如，对于名为“STS1”的网站定义，将升级定义文件命名为“STS1_upgrade.xml”。

必须将升级定义文件安装到以下文件夹：

%COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\Config\Upgrade

有关创建升级定义文件（包括升级定义文件示例）的详细信息，请参阅 MSDN 上 Windows SharePoint Services 3.0 SDK 中的升级定义文件(https://go.microsoft.com/fwlink/?linkid=109945&clcid=0x804) 和升级定义架构(https://go.microsoft.com/fwlink/?linkid=109946&clcid=0x804) 主题。

有关部署升级定义文件和新网站定义的详细信息，请参阅部署升级定义文件和新的网站定义 (Office SharePoint Server)。有关创建升级定义文件的其他信息（如文件和架构中要包括的内容），请参阅 MSDN Library 中的将 SharePoint Portal Server 2003 自定义项升级到 SharePoint Server 2007（该链接可能指向英文页面）(https://go.microsoft.com/fwlink/?linkid=105294&clcid=0x804)（该链接可能指向英文页面）。

在工作表中记录升级定义文件信息

在自定义模板和映射文件工作表（该链接可能指向英文页面）(https://go.microsoft.com/fwlink/?linkid=73751&clcid=0x804)（该链接可能指向英文页面）中记录需要创建的每个升级定义文件的文件名和路径。

下载此书籍

本主题包含在以下可下载书籍内，以方便您阅读和打印：

• 升级到 Office SharePoint Server 2007（该链接可能指向英文页面）

有关可下载书籍的完整列表，请参阅 Office SharePoint Server 2007 的可下载书籍。