Mögliche Brandingprobleme beim Upgrade auf SharePoint 2013

Artikel
03/08/2023

GILT FÜR: yes-img-13 2013 no-img-16 2016 no-img-19 2019 no-img-se Subscription Edition no-img-sop SharePoint in Microsoft 365

In SharePoint 2013 steht eine neue Benutzeroberfläche zur Verfügung, die kompakt, schnell und flüssig ist. Diese Benutzeroberfläche basiert auf neuen CSS-Formatvorlagen, Designs und Gestaltungsvorlagen. Um diese neuen Elemente nutzen zu können, müssen Sie ein Upgrade auf die neue Benutzeroberfläche durchführen. Allerdings können die erheblichen Änderungen, die zur Unterstützung der neuen Benutzeroberfläche vorgenommen wurden, das Upgrade für einige Szenarien unterbrechen, in denen Sie benutzerdefiniertes Branding verwenden.

In SharePoint 2010-Produkte standen Ihnen mehrere Möglichkeiten zum Branding Ihrer Website zur Verfügung:

Anwenden eines benutzerdefinierten Stylesheets auf die Website, das die SharePoint-Standardformatvorlagen überschreibt
Anwenden eines benutzerdefinierten Designs (THMX-Datei) auf die Website
Kopieren und Ändern einer in SharePoint 2013 enthaltenen Gestaltungsvorlage
Erstellen einer vollständig neuen benutzerdefinierten Gestaltungsvorlage auf einer Veröffentlichungswebsite, wobei die benutzerdefinierte Gestaltungsvorlage benutzerdefinierte Formatvorlagen verwendet und von benutzerdefinierten Seitenlayouts auf sie verwiesen wird

Wenn Sie Ihre Websitesammlung auf SharePoint 2013 aktualisieren, funktionieren diese Arten von Anpassungen nicht, da die standardmäßigen CSS-Formatvorlagen, Designs und Gestaltungsvorlagen geändert wurden. Sie müssen Ihr benutzerdefiniertes Branding stattdessen erneut erstellen. Hierzu müssen Sie die in SharePoint 2013 verfügbaren neuen Formatvorlagen, Designs oder Gestaltungsvorlagen verwenden und dann den neu erstellten Entwurf auf die aktualisierte Websitesammlung anwenden.

Änderungen an den standardmäßigen SharePoint-Formatvorlagen, -Designs und -Gestaltungsvorlagen waren erforderlich, um eine schnellere und flüssigere Benutzeroberfläche zu erstellen und um nachfolgende Upgrades vorhersagbarer zu machen.

Falls Ihre Websitesammlung benutzerdefiniertes Branding enthält, empfehlen wir Ihnen daher, vor einem Upgrade zunächst eine Auswertungswebsitesammlung zu erstellen, in der Sie Ihr benutzerdefiniertes Branding in einer SharePoint 2013-Umgebung testen und neu erstellen können. Weitere Informationen zu einer Auswertungswebsitesammlung finden Sie unter Upgraden einer Websitesammlung.

In den folgenden Abschnitte werden mögliche Brandingprobleme beim Upgrade auf SharePoint 2013 aufgeführt.

Benutzerdefinierte CSS

Die gängigste Methode zum Anwenden von benutzerdefiniertem Branding auf eine SharePoint 2010-Produkte-Website besteht darin, eine CSS-Datei mit Formatvorlagen zu erstellen, die die SharePoint-Standardformatvorlagen überschreiben.

Um die neue Benutzeroberfläche schneller und flüssiger zu machen, wurden in SharePoint 2013 grundlegende Änderungen in Bezug auf die CSS-Implementierung eingeführt:

Kleinere CSS-Dateien
Begrenzte Schachtelung von CSS-Selektoren
Einsatz von CSS-Vererbung, sofern möglich
Zentrale Definition von Klassen
Gruppierung zugehöriger Klassen in der CSS-Datei
Inlineformatvorlagen und die !important-Deklaration werden nicht verwendet, da sie nicht überschrieben werden können.
Konsistente Struktur und Benennungskonvention für Formatvorlagen

In SharePoint 2013 wird für Formatvorlagen eine konsistente Struktur und Benennungskonvention verwendet.

BENENNUNGSTEIL	MS-	<FEATURE:>	<NAME>
Erläuterung	Gibt an, dass dies eine Microsoft-Klasse ist.	Der Name des Features, dem dieses Element zugeordnet ist, oder „Core", wenn es als Teil der Kernbenutzeroberfläche verwendet wird.	Ein beschreibender Name des Elements, z. B. Titel, Link usw.

Aufgrund dieser Änderungen in Bezug auf die CSS-Implementierung in SharePoint 2013 werden benutzerdefinierte CSS-Formatvorlagen bei einem Upgrade nicht auf Ihre Website angewendet. Um dieses Problem zu beheben, erstellen Sie zunächst eine Auswertungswebsitesammlung, und verwenden Sie diese Website dann als Umgebung, um die neuen SharePoint 2013-Formatvorlagen zu identifizieren, die Sie überschreiben müssen. Erstellen Sie eine CSS-Datei für diese Formatvorlagen, und wenden Sie diese CSS-Datei anschließend auf die aktualisierte Website an.

Benutzerdefiniertes Design

In SharePoint 2010-Produkten können Sie ein Office-Programm wie PowerPoint 2010 verwenden, um eine THMX-Datei zu erstellen. Anschließend können Sie diese Designdatei in SharePoint 2010-Produkte hochladen und das Design auf Ihre Website anwenden.

In SharePoint 2013 wurde das Designmodul verbessert, um die Erstellung von Designs zu beschleunigen und flexibler zu machen, sodass Designs in Zukunft einfacher aktualisiert werden können. Das Designmodell verwendet kommentarartiges Markup im CSS und ersetzt dann Teile des CSS auf Grundlage von Parametern wie Schriftarten und Farbschemas, die Benutzer auswählen. Designs in SharePoint 2013 werden mit XML-Dateien definiert:

In „Spcolor.xml" wird die Farbpalette definiert, deren Felder nun semantische Namen haben, damit klarer ist, welche Benutzeroberflächenelemente betroffen sind, wenn Sie einen Farbwert ändern. Außerdem unterstützen Designs nun das Festlegen der Deckkraft.
In „Spfont.xml“ wird das Schriftartschema definiert; diese Datei unterstützt mehrere Sprachen, websichere Schriftarten und Webschriftarten.

Das Upgrade einer THMX-Datei von SharePoint 2010-Produkte auf SharePoint 2013 wird jedoch nicht unterstützt. Wenn Sie ein benutzerdefiniertes Design auf die SharePoint 2010-Produkte-Website angewendet haben, bleiben die Designdateien bei einem Upgrade auf SharePoint 2013 erhalten. Das Design wird jedoch nicht mehr auf die Website angewendet, und die Website wird auf das Standarddesign zurückgesetzt.

Um dieses Problem zu beheben, erstellen Sie zunächst eine Auswertungswebsitesammlung, und verwenden Sie dann die neuen Designfeatures in SharePoint 2013, um das Design erneut zu erstellen. Weitere Informationen zu den neuen Designs finden Sie in den folgenden MSDN-Artikeln:

Wichtig

Wenn Sie in Zukunft benutzerdefiniertes Branding verwenden möchten und dieses auch nach späteren Upgrades weiterhin funktioniert soll, wird empfohlen, Designs zum Implementieren des Entwurfs zu verwenden. Für Designs steht Upgradeunterstützung bei zukünftigen Updates zur Verfügung. Wenn Designs für Ihr Szenario nicht geeignet sind oder Sie ein umfassenderes Branding benötigen, empfehlen wir die Verwendung einer Veröffentlichungswebsite in Verbindung mit dem Entwurfs-Manager. Seien Sie sich jedoch bewusst, dass Sie bei einer Investition in benutzerdefinierte Gestaltungsvorlagen und Seitenlayouts Ihre Entwurfsdateien möglicherweise bei und nach jedem SharePoint-Upgrade überarbeiten oder aktualisieren müssen.

Kopieren und Ändern einer im Lieferumfang von SharePoint 2013 enthaltenen Gestaltungsvorlage

In SharePoint 2010-Produkten besteht eine gängige Möglichkeit, kleinere Anpassungen an der Benutzeroberfläche vorzunehmen, darin, eine Gestaltungsvorlage zu kopieren und zu ändern, die im Lieferumfang von SharePoint 2010-Produkten enthalten ist. Sie können z. B. die Gestaltungsvorlage ändern, um Funktionen für Benutzer zu entfernen oder auszublenden.

Bei einem Upgrade einer SharePoint 2010-Produkte-Website auf SharePoint 2013 wird die Gestaltungsvorlage auf die Standardgestaltungsvorlage in SharePoint 2013 zurückgesetzt. Aus diesem Grund wird Ihre Website nach dem Upgrade mit dem benutzerdefinierten Branding angezeigt. Die in SharePoint 2010-Produkte erstellte benutzerdefinierte Gestaltungsvorlage ist nach wie vor in der Website vorhanden, Sie sollten jedoch die alte Gestaltungsvorlage nicht auf die neue Website anwenden, da die neue Website nicht wie erwartet angezeigt wird.

Zur Unterstützung der neuen Benutzeroberfläche in SharePoint 2013 wurden Änderungen an den Standardgestaltungsvorlagen vorgenommen. Aus diesem Grund können Sie eine in SharePoint 2010-Produkte erstellte Gestaltungsvorlage nicht auf eine Website in SharePoint 2013 anwenden.

Um dieses Problem zu beheben, erstellen Sie zunächst eine Auswertungswebsitesammlung, und erstellen Sie anschließend die Gestaltungsvorlage auf der SharePoint 2013-Website erneut. Nachdem Sie sich vergewissert haben, dass die neue Gestaltungsvorlage wie erwartet funktioniert, verschieben Sie die Gestaltungsvorlage in die neue Websitesammlung, und wenden Sie sie auf die Website an. Wenn es sich bei den Websites um Veröffentlichungswebsites handelt, können Sie den Entwurfs-Manager verwenden, um die Gestaltungsvorlage als Teil eines Entwurfspakets zu exportieren und anschließend zu importieren. Andernfalls können Sie die Gestaltungsvorlage als Teil einer Sandkastenlösung oder durch Hochladen der Datei in den Gestaltungsvorlagenkatalog verschieben.

Wichtig

[!WICHTIGER HINWEIS] Veröffentlichungswebsites werden von SharePoint Foundation 2013 nicht unterstützt. Sie benötigen SharePoint 2013, um Veröffentlichungswebsites verwenden zu können.

Benutzerdefinierte Gestaltungsvorlage auf einer Veröffentlichungswebsite

Wenn Sie eine vollständig firmenspezifische Website wie z. B. einer Intranetwebsite zur Unternehmenskommunikation wünschen, verwenden Sie eine Veröffentlichungswebsite, die eine vollständig benutzerdefinierte Gestaltungsvorlage und benutzerdefinierte Seitenlayouts enthält, die an die benutzerdefinierte Gestaltungsvorlage angefügt sind.

Bei einem Upgrade einer SharePoint 2010-Produkte-Website auf SharePoint 2013 wird die Gestaltungsvorlage auf die Standardgestaltungsvorlage in SharePoint 2013 zurückgesetzt. Aus diesem Grund wird Ihre Website nach dem Upgrade nicht mit dem benutzerdefinierten Branding angezeigt. Die in SharePoint 2010-Produkte erstellte benutzerdefinierte Gestaltungsvorlage und die Seitenlayouts sind nach wie vor in der Website vorhanden, Sie sollten jedoch die alte Gestaltungsvorlage nicht auf die neue Website anwenden, da die neue Website nicht wie erwartet angezeigt wird.

Um dieses Problem zu beheben, erstellen Sie zunächst eine Auswertungswebsitesammlung, bei der es sich um eine Veröffentlichungswebsite handelt, und erstellen Sie anschließend die Gestaltungsvorlage auf der SharePoint 2013-Website erneut. Nachdem Sie sich vergewissert haben, dass die neue Gestaltungsvorlage wie erwartet funktioniert, führen Sie die folgenden Schritte aus:

Exportieren Sie die Gestaltungsvorlage als Teil eines Entwurfspakets.
Importieren Sie das Entwurfspaket in die neue Websitesammlung.
Wenden Sie die neue Gestaltungsvorlage auf die Website an.

Benutzerdefinierte Inhaltsplatzhalter in einer benutzerdefinierten Gestaltungsvorlage

Wichtig

[!WICHTIGER HINWEIS] Wenn Ihre benutzerdefinierte Gestaltungsvorlage einen benutzerdefinierten Inhaltsplatzhalter verwendet und die benutzerdefinierten Seitenlayouts diesen Platzhalter ebenfalls enthalten, wird das Rendern der Startpage Ihrer Website nach dem Upgrade möglicherweise aufgrund eines Fehlers verhindert. Stattdessen wird nach dem Upgrade möglicherweise die Fehlermeldung angezeigt, dass ein unerwarteter Fehler aufgetreten ist.

Um festzustellen, ob dieses Problem bei Ihnen vorliegt, können Sie eine Auswertungswebsitesammlung erstellen, bei der es sich ebenfalls um eine Veröffentlichungswebsite handelt, und dann die Gestaltungsvorlage auf die Gestaltungsvorlage festlegen, die im Lieferumfang von SharePoint 2013 enthalten ist. Wenn die Website immer noch angezeigt wird, liegt dieses Problem bei Ihnen nicht vor. Wenn die Website nicht angezeigt wird und ein „unerwarteter Fehler" mit einer Korrelations-ID ausgegeben wird, liegt dieses Problem wahrscheinlich bei Ihnen vor.

Wenn Sie dieses Problem beheben möchten, führen Sie folgende Schritte aus:

Erstellen Sie eine Auswertungswebsitesammlung, bei der es sich um eine Veröffentlichungswebsitesammlung handelt.
Erstellen Sie eine SharePoint 2013-Gestaltungsvorlage.
Fügen Sie den benutzerdefinierten Inhaltsplatzhalter der 2013-Gestaltungsvorlage hinzu.
Wenden Sie die neue Gestaltungsvorlage auf die Website an.
Erstellen Sie ein Seitenlayout ohne den benutzerdefinierten Inhaltsplatzhalter.

Das Seitenlayout wird der neuen Gestaltungsvorlage zugeordnet, die auf die Website angewendet wurde.
Ändern Sie alle Seiten mit dem alten Seitenlayout so, dass das neue Seitenlayout verwendet wird.

Sie können jede Seite einzeln manuell im Browser bearbeiten und die Option im Menüband verwenden, oder Sie können das clientseitige Objektmodell für SharePoint verwenden, um die Seiten programmgesteuert zu aktualisieren.
Löschen Sie das alte Seitenlayout mit dem benutzerdefinierten Inhaltsplatzhalter.