Supported and unsupported scenarios for working with custom site definitions and custom area definitions in Windows SharePoint Services and in SharePoint Portal Server 2003 (898631)


The information in this article applies to:

  • Microsoft Office SharePoint Portal Server 2003
  • Microsoft Windows SharePoint Services

INTRODUCTION

This article contains information about custom site definitions in Microsoft Windows SharePoint Services and custom area definitions in Microsoft Office SharePoint Portal Server 2003. This article lists scenarios that are supported and scenarios that are not supported when you customize site definitions and area definitions.

MORE INFORMATION

Supported scenarios

When you work with custom site definitions or custom area definitions, the following scenarios are supported:
  • To create a custom site definition or a custom area definition, you copy an existing site definition or an existing area definition, and then you rename and modify the new site definition or the new area definition. For more information about this supported method, visit the following Microsoft Web site:

    http://msdn.microsoft.com/library/en-us/spptsdk/html/tsptCustomExistingWebTemplate_SV01017467.asp?frame=true

  • You modify the .xml files and the .aspx files in a custom site definition or in a custom area definition before you create new sites or new portal areas by using the custom site definition or the custom area definition.
  • You deploy the custom site definition or the custom area definition. That is, you create new sites or new portal areas by using the custom site definition or the custom area definition. To modify the new sites or the new portal areas that you created, you use one or more of the following three supported methods:
    • You modify the site or the portal area by using the user interface in SharePoint Portal Server 2003 or in Windows SharePoint Services.
    • You programmatically modify the site or the portal area by using the SharePoint Portal Server object model or the Windows SharePoint Services object model.
    • You modify the site or the portal area by using Microsoft Office FrontPage 2003.
    Note These three methods are also supported methods to use if you want to modify the Default.aspx page in the portal site. Microsoft does not support using other methods to modify the Default.aspx page in the portal site.

Unsupported scenarios

When you work with custom site definitions or custom area definitions, the following scenarios are not supported:
  • You modify one of the default site definitions or one of the default area definitions that are included in SharePoint Portal Server 2003 or in Windows SharePoint Services.

    Microsoft does not support modifying the default set of site definitions or area definitions that are installed when you installed Windows SharePoint Services and SharePoint Portal Server 2003. Additionally, Microsoft does not support modifying the .xml files or the .aspx files in the default site definition or in the default area definition.
  • You modify a custom site definition or a custom area definition after you deploy the custom site definition or the custom area definition.

    Microsoft does not support modifying a custom site definition or a custom area definition after you create a new site or a new portal area by using that site definition or area definition. Additionally, Microsoft does not support modifying the .xml files or the .aspx files in the custom site definition or in the custom area definition after you deploy the custom site definition or the custom area definition.
  • You modify the Webtemp.xml file or the Webtempsps.xml file that is located in the following folder:

    Drive:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\Template\LCID\XML

    With one exception, Microsoft does not support modifying the Webtemp.xml file or the Webtempsps.xml file. The exception is the Webtemp.xml file. Microsoft supports modifying the Webtemp.xml file only if you want to hide a specific template. To hide a specific template, you modify the Hidden parameter of that template in the Webtemp.xml file.

REFERENCES

For more information about the best practices for ensuring application reusability and upgrade in Windows SharePoint Services and SharePoint Portal Server 2003, visit the following Microsoft Web site:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/odc_SP2003_ta/html/WSSSharePointCodeReuse.asp

For more information about templates and site definitions, visit the following Microsoft Web sites: For more information about schema files in site definitions, visit the following Microsoft Web site:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/spptsdk/html/SPPTWSSSchemaFiles_SV01087964.asp

For more information about custom templates, click the following article number to view the article in the Microsoft Knowledge Base:

825217 Overview of custom templates in SharePoint Portal Server 2003 and Windows SharePoint Services

For more information about the SharePoint Portal Server object model and the Windows SharePoint Services object model, see the Microsoft SharePoint Products and Technologies 2003 Software Development Kit (SDK). To view the SharePoint Products and Technologies 2003 SDK, visit the following Microsoft Web site:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/spptsdk/html/SPSDKWelcome_SV01017094.asp?frame=true

Modification Type:MajorLast Reviewed:5/24/2005
Keywords:kbXML kbASP kbtshoot kbinfo KB898631 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.