Durchführen eines Upgrades für eine benutzerdefinierte Websitedefinition
Letzte Änderung: Dienstag, 6. April 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Aktualisieren von ASPX-Seiten
Bearbeiten von "Onet.xml"
Abschließende Überlegungen
In vorherigen Versionen von SharePoint Foundation war für zahlreiche Arten von Anpassungen das Anpassen von Websitedefinitionen erforderlich, das in der Regel das Kopieren der STS-Websitedefinition und das Ändern von Listenschemas, Seiten und anderen strukturellen Elementen in der kopierten Definition umfasste. Große Teile der benutzerdefinierten Websitedefinition wurden nicht angepasst, d. h. dass sie viele grundlegenden Merkmale der STS-Websitedefinition beibehielten.
Das Verfahren für ein aktuelles Äquivalent zu einer benutzerdefinierten Websitedefinition einer vorherigen Version variiert abhängig von der Websitedefinition und der Art der gewünschten Anpassung. Wenn Sie die Websitedefinition im Vergleich zur Websitedefinition, die als Basis verwendet wurde, nicht übermäßig angepasst haben, kann die beste Möglichkeit darin bestehen, ein aktuelles Äquivalent für diese Websitedefinition zu erstellen und die neue Definition zurück zu konvertieren, sodass die vorherigen Anpassungen eingeschlossen sind. Wenn Sie beispielsweise die Websitedefinition einer vorherigen Version nur dahingehend angepasst haben, dass Sie ein Feature zum Hinzufügen einer benutzerdefinierten Liste verwendet haben oder dass Sie die Seite Default.aspx für ein benutzerdefiniertes Aussehen und Verhalten angepasst haben, dann sollten Sie die Websitedefinition der aktuellen Version als Basis für eine neue benutzerdefinierte Websitedefinition verwenden und ein Upgrade für das Feature durchführen (siehe Aktualisieren von Features). Wenn die Anpassungen jedoch umfangreicher waren, wäre es sehr wahrscheinlich besser, die vorherige Websitedefinition in ein Äquivalent für die aktuelle Websitedefinition zu konvertieren. In den verbleibenden Abschnitten dieses Themas erhalten Sie Anleitungen zum Konvertieren einer angepassten Websitedefinition der vorherigen Version in eine korrekte Websitedefinition der aktuellen Version.
Aktualisieren von ASPX-Seiten
Wenn eine Website auf der Grundlage einer Websitedefinition der vorherigen Version gehostet wird, führt SharePoint Foundation Seiten in einem Kompatibilitätsmodus aus, um sicherzustellen, dass sie innerhalb der Bereitstellung verwendet werden können. Wenn Seiten jedoch aus einer Websitedefinition der aktuellen Version ausgeführt werden, werden aus Leistungsgründen keine Seiten von SharePoint Foundation im Kompatibilitätsmodus ausgeführt. Aus diesem Grund müssen Sie, wenn Sie die SharePoint Foundation-Websitedefinition erstellen, Ihre Microsoft ASP.NET-Seiten in einem gewissen Maße ändern.
Wenn Sie die ASPX-Seiten in der Websitedefinition der vorherigen Version nicht angepasst haben, sollten Sie die Seite Default.aspx der Websitedefinition der aktuellen Version kopieren. Wenn die Website z. B. auf einer benutzerdefinierten Websitedefinition basiert, die ursprünglich auf der STS-Websitedefinition basierte, befindet sich diese Seite im Ordner %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\SiteTemplates\sts\xml.
Alle Webpartseiten müssen einen ASP.NET-Webpart-Manager enthalten, um ordnungsmäßig zu funktionieren. Wenn Sie also ASPX-Seiten angepasst haben, müssen Sie diesen ASPX-Seiten einen Webpart-Manager hinzufügen. Fügen Sie hierzu <WebPartPages:SPWebPartManager id="m" runat="Server" /> in die Seiten ein.
.gif "Hinweis") Hinweis |
|---|
Da alle SharePoint-Gestaltungsvorlagen einen Webpart-Manager enthalten, sollten Sie einen zusätzlichen Schritt ausführen und die ASP.NET-Seiten auf einer Gestaltungsvorlage basieren lassen. Eine auf Gestaltungsvorlagen basierende Infrastruktur bietet mehr Flexibilität, und mithilfe von Gestaltungsvorlagen kann sichergestellt werden, dass allgemeine Teile der SharePoint Foundation-Funktionalität in der Seite enthalten sind. Weitere Informationen finden Sie unter Gestaltungsvorlagen. |
Bearbeiten von "Onet.xml"
Die Struktur der Datei Onet.xml wurde stark verändert. Wenn Sie die Datei Onet.xml in der benutzerdefinierten Websitedefinition der vorherigen Version nicht angepasst haben, sollten Sie die Datei Onet.xml der aktuellen Version aus dem Ordner %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\SiteTemplates\sts\xml in die Websitedefinition kopieren.
In SharePoint Foundation verwenden alle XML-Dateien im Installationsverzeichnis Ressourcenausdrücke ($Resources), damit sie für jede Sprache verwendet werden können, deren Sprachpakete installiert wurden. Wenn Sie die Websitedefinition einer vorherigen Version für mehrere Sprachen verwenden möchten und diese erweiterte Verwendung von Ressourcen nutzen möchten, müssen Sie zahlreiche Änderungen an den XML-Dateien der vorherigen Version vornehmen. In diesem Fall können Sie die Websitedefinition der aktuellen Version kopieren und dann anpassen.
Wenn Sie die Datei Onet.xml in der Websitedefinition einer vorherigen Version angepasst haben, müssen Sie die Datei ändern, damit sie in der aktuellen Version verwendet werden kann. Mithilfe der folgenden grundlegenden Schritte können Sie die Konsistenz einer vorherigen Datei Onet.xml mit der aktuellen Websitedefinition verbessern.
Wenn Sie sicherstellen möchten, dass die über die Definition erstellten Websites konsistent die aktuellen SharePoint Foundation-Basislistentypen verwenden, müssen Sie möglicherweise den Abschnitt <BaseTypes> aus der Datei Onet.xml entfernen. Basislistentypen sind standardmäßig in SharePoint Foundation-Websites vorhanden und müssen in der Datei nicht definiert werden.
Entfernen Sie, falls vorhanden, Standardlisten aus der Datei Onet.xml der vorherigen Version. Viele für die SharePoint-Funktionalität erforderliche Listen sind nun standardmäßig in SharePoint Foundation enthalten und müssen nicht in der Datei Onet.xml definiert werden. Weitere Informationen finden Sie unter Upgrade von Standardlistendefinitionen.
Entfernen Sie, falls vorhanden, das <ListTemplate>-Tag für Listen, für die das Name-Attribut gleich webtemp, listtemp, wplib oder datasrcs ist. Entfernen Sie auch, falls vorhanden, die zugrunde liegenden Listendefinitionen für diese Listen, indem Sie die Ordner LISTS\WEBTEMP, LISTS\LISTTEMP, LISTS\wplib und LISTS\DATASRCs entfernen. Entfernen Sie jedes <List>-Tag aus dem Abschnitt <Configurations>, wenn das Type-Attribut gleich 113 (Webvorlagenkatalog), 114 (Listenvorlagenkatalog) oder 111 (Webpartkatalog) ist.
Erwägen Sie das Zuordnen des Abschnitts <DocumentTemplates> zu aktuellen Dokumentvorlagen. Das System des Ausdrucks von Dokumentvorlagen in einer Websitedefinition hat sich zwischen den Versionen nicht stark verändert, und Dokumentvorlagen werden immer noch in einem Verzeichnis pro Gebietsschema gespeichert.
Sie müssen für Ihre spezifische Websitedefinition sicherstellen, dass die entsprechende Gruppe von Dokumentvorlagendateien im Verzeichnis %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\<Gebietsschema-ID>\<Websitedefinitionsname> vorhanden ist. Wenn Ihre Dokumentvorlagendateien jedoch nicht angepasst wurden, können Sie einfach angeben, dass die Websitedefinition Dokumentvorlagen wiederverwendet. Fügen Sie hierzu jedem <DocumentTemplate>-Knoten in der Datei Onet.xml einen Kommentar hinzu, um Path="STS" anzugeben.
Abschließende Überlegungen
Nachdem Sie Ihre Websitedefinition angepasst haben, testen Sie diese in SharePoint Foundation 2010, um sicherzustellen, dass die neuen über die Definitionsfunktion erstellten Websites wie gewünscht ausgeführt werden. Wenn Sie die richtige SharePoint Foundation-Websitedefinition erstellt haben, erstellen Sie im nächsten Schritt eine Upgradedefinition, um die Websitedefinition aus der vorherigen Version der aktuellen Version zuzuordnen.
Siehe auch
Konzepte
Upgrade von Standardlistendefinitionen