Upgrade Definition Schema

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The following elements and attributes are implemented within a site upgrade definition.

Config

    WebTemplate

        Lists

            List

                Source

        Files

            File

        AppliedSiteFeatures

            Feature

        AppliedWebFeatures

            Feature

Note

In Beta 1 of Windows SharePoint Services 3.0, the upgrade definition schema included Configurations/Configuration elements, which are no longer supported.

Upgrade Definition Example

The following example, taken from one of the files installed in Windows SharePoint Services, outlines the format of an upgrade definition.

<Config xmlns="urn:Microsoft.SharePoint.Upgrade">
  <WebTemplate
    ID="1"
    LocaleId="*"
    FromProductVersion="2"
    BeginFromSchemaVersion="100"
    EndFromSchemaVersion="149"
    ToSchemaVersion="150">
    <Lists>
      <List
        FromTemplateId="104"
        ToFeatureId="00BFEA71-D1CE-42de-9C63-A44004CE0104"
        v3Type="0x0104">
        <Source v2List="104" />
      </List>
      <List
        FromTemplateId="105"
        ToFeatureId="00BFEA71-7E6D-4186-9BA8-C047AC750105"
        v3Type="0x0105">
        <Source v2List="105" />
      </List>
       ...
    </Lists>
    <Files>
      <File
        FromPath="{LocaleId}\STS\default.aspx"
        ToPath=  "SiteTemplates\STS\default.aspx" />
      <File
        FromPath="{LocaleId}\STS\Lists\announce\AllItems.aspx"
        ToPath=  "Features\AnnouncementsList\announce\AllItems.aspx" />
      <File
        FromPath="{LocaleId}\STS\Lists\announce\DispForm.aspx"
        ToPath=  "Features\AnnouncementsList\announce\DispForm.aspx" />
      <File
        FromPath="{LocaleId}\STS\Lists\announce\EditForm.aspx" 
        ToPath=  "Features\AnnouncementsList\announce\EditForm.aspx"
        />
      <File
        FromPath="{LocaleId}\STS\Lists\announce\NewForm.aspx"
        ToPath=  "Features\AnnouncementsList\announce\NewForm.aspx" />
        ...
    </Files>
    <AppliedSiteFeatures>
      <Feature ID="00BFEA71-1C5E-4A24-B310-BA51C3EB7A57" />
    </AppliedSiteFeatures>
    <AppliedWebFeatures>
      <Feature ID="00BFEA71-D1CE-42de-9C63-A44004CE0104" />
      <Feature ID="00BFEA71-7E6D-4186-9BA8-C047AC750105" />
      <Feature ID="00BFEA71-DE22-43B2-A848-C05709900100" />
      ...
    </AppliedWebFeatures>
  </WebTemplate>
</Config>