2007-03-12

Common errors when working with Site Templates

Below is a list of errors that I've gotten when I've been working with creating custom site and portal site templates. The errors are sometimes VERY hard to find!

It is important to remember that the sites are created on the fly so if the portal site template is provisioning multiple site you can check the tree structure to se where the provsioning failed.

"The file or folder name contains characters that are not permitted."

  • Most often this error has been casued by incomplete resource statements in the Url-field in List statement in the site configuration or,
  • when a list view is used in a modul definition, e.g. missing ';',
  • or misspelled resource names,
  • referencing the wrong resource file/library, etc.

"Cannot complete the operation".

  • Confllict between the module name in the configuration section and the named used in the module definition
  • xml errors - missing end tags,
  • when you provision a new list there is a mismatch between the list type and the feature id, and it looks like the 3 last digits in the feature id should match the list type!

2 comments:

Jill said...

Perhaps you can assist me with a problem that I am having where I get the error "The file or folder name contains characters that are not permitted." which may be related to your comments about this error may occur, but I am not seeing specifically those items to watch for.

In my onet.xml file I have the following under my configurations section:

Configuration ID="2" Name="DWS"
Lists
List FeatureId="00BFEA71-513D-4CA0-96C2-6A47775C0119" Type="150" Title="$Resources:core,ganttList;" Url="$Resources:core,lists_Folder;/$Resources:core,gantt_Folder;" /
List FeatureId="00BFEA71-5932-4F9C-AD71-1557E5751100" Type="1100" Title="$Resources:core,issuesList;" Url="$Resources:core,lists_Folder;/$Resources:core,issues_Folder;" /
List FeatureId="00BFEA71-E717-4E80-AA17-D0C71B360101" Type="101" Title="$Resources:core,shareddocuments_Title;" Url="$Resources:core,shareddocuments_Folder;" /
List FeatureId="00BFEA71-EC85-4903-972D-EBE475780106" Type="106" Title="$Resources:core,calendarList;" Url="$Resources:core,lists_Folder;/$Resources:core,calendar_Folder;" /
List FeatureId="00BFEA71-7E6D-4186-9BA8-C047AC750105" Type="105" Title="$Resources:core,contactsList;" Url="$Resources:core,lists_Folder;/$Resources:core,contacts_Folder;" /
List FeatureId="00BFEA71-D1CE-42de-9C63-A44004CE0104" Type="104" Title="$Resources:core,announceList;" Url="$Resources:core,lists_Folder;/$Resources:core,announce_Folder;"
*** the usual code here ***
/List
List FeatureId="00BFEA71-2062-426C-90BF-714C59600103" Type="103" Title="$Resources:core,linksList;" Url="$Resources:core,lists_Folder;/$Resources:core,links_Folder;" /
List FeatureId="00BFEA71-6A49-43FA-B535-D15C05500108" Type="108" Title="$Resources:core,discussions_Title;" Url="$Resources:core,lists_Folder;/$Resources:core,discussions_Folder;" /
/Lists ......... and more

In my module section I have the following:

Module Name="DWS" Url=""
File Url="default.aspx" NavBarHome="True"
View List="$Resources:core,lists_Folder;/$Resources:core,gantt_Folder;" BaseViewID="1" WebPartZoneID="Left" WebPartOrder="1" /
View List="$Resources:core,lists_Folder;/$Resources:core,issues_Folder;" BaseViewID="1" WebPartZoneID="Left" WebPartOrder="2" /
View List="$Resources:core,shareddocuments_Folder;" BaseViewID="6" WebPartZoneID="Left" WebPartOrder="3" /
View List="$Resources:core,lists_Folder;/$Resources:core,calendar_Folder;" BaseViewID="1" WebPartZoneID="Left" WebPartOrder="4" /
View List="$Resources:core,lists_Folder;/$Resources:core,contacts_Folder;" BaseViewID="1" WebPartZoneID="Left" WebPartOrder="5" /
AllUsersWebPart WebPartZoneID="Right"
WebPartOrder="1"

... the usual code in here

/AllUsersWebPart

View List="$Resources:core,lists_Folder;/$Resources:core,links_Folder;" BaseViewID="3" WebPartZoneID="Right" WebPartOrder="2" /
View List="$Resources:core,lists_Folder;/$Resources:core,announce_Folder;" BaseViewID="3" WebPartZoneID="Right" WebPartOrder="3" /
NavBarPage Name="$Resources:core,nav_Home;" ID="1002" Position="Start" /
NavBarPage Name="$Resources:core,nav_Home;" ID="0" Position="Start" /
/File
/Module

I am not really sure what the issue is as this seem fairly basic code to me. I was thinking maybe it is the BaseViewID that I am using as I was just throwing a number in there for testing purposes.

Any insight you can give me would be much appreciated.

Thanks!

P.S. sorry, I had to take out all the brackets ... I hope it still makes sense.

Jill said...

Just one more thing on my last post about "The file or folder name contains characters that are not permitted."

I did notice under configuration section that the gantt list type does not match the last 3 digits of the FeatureId, but did pull these number references from the xml files for the GanttTasksList feature.

Thanks again.

FeatureId="00BFEA71-513D-4CA0-96C2-6A47775C0119" Type="150" Title="$Resources:core,ganttList;"