Gestaltungsvorlagen im SharePoint-Add-In-Modell
Der Ansatz, den Sie verwenden, um benutzerdefinierte master Seiten in SharePoint-Websites zu implementieren, unterscheidet sich im neuen SharePoint-Add-In-Modell von dem bei voll vertrauenswürdigem Code/Farmlösungen. In einem typischen FtC-Brandingszenario (Full Trust Code) / Farm Solution werden benutzerdefinierte master Seiten erstellt, um eine benutzerdefinierte Marke zu implementieren. Die master Seiten sind in der Regel in einem Feature verpackt, das deklarativen Code und eine FTC-/Farmlösung verwendet, um die master-Seiten bereitzustellen und bei der SharePoint-Website zu registrieren.
In einem SharePoint-Add-In-Modellbrandingszenario können auch benutzerdefinierte master Seiten verwendet werden. Sie können Ihre benutzerdefinierten master-Seiten auf SharePoint-Websites über das Remotebereitstellungsmuster bereitstellen und registrieren.
Allgemeine Richtlinien für benutzerdefinierte master Seiten
Als Faustregel möchten wir die folgenden allgemeinen Richtlinien für benutzerdefinierte master-Seiten bereitstellen.
- Sie können SharePoint-Websites mithilfe benutzerdefinierter Gestaltungsvorlagen anpassen, bedenken Sie aber, dass dies langfristig im Hinblick auf zukünftige Updates zu zusätzlichen Kosten und Schwierigkeiten führen wird.
In den meisten Fällen können Sie alle gängigen Brandingszenarien mit Designs, zusammengesetzten Designs und alternativen CSS erreichen.
Weitere Informationen zu den verschiedenen Brandingoptionen für SharePoint-Websites mit dem SharePoint-Add-In-Modell finden Sie unter Branding von SharePoint-Websites (SharePoint-Add-In-Rezept). Das Rezept hilft Ihnen, die kurz- und langfristigen Auswirkungen der Anpassung aus Betriebs- und Wartungsperspektive zu berücksichtigen. Möglicherweise stellen Sie fest, dass eine benutzerdefinierte master Seite nicht erforderlich ist, um Ihre spezifischen Brandinganforderungen zu implementieren.
Falls Sie benutzerdefinierte Gestaltungsvorlagen verwenden, müssen Sie möglicherweise Änderungen an diesen vornehmen, wenn wichtige funktionale Updates auf Office 365 angewendet werden.
- Verwenden Sie die Remotebereitstellung, um benutzerdefinierte master-Seiten mit SharePoint-Websites bereitzustellen und zu registrieren.
- Verwenden Sie keinen deklarativen Code oder Sandboxcode, um master Seiten mit SharePoint-Websites bereitzustellen und zu registrieren.
Teamwebsites im Vergleich zu Veröffentlichungswebsites
Wann ist eine benutzerdefinierte master Seite erforderlich?
Wenn Sie ein benutzerdefiniertes Branding auf SharePoint-Websites anwenden, müssen Sie sowohl Teamwebsites als auch Veröffentlichungswebsites als Branding verwenden. Im Allgemeinen verwenden Intranets, die in lokalen und Office 365-Szenarien auf SharePoint aufgebaut sind, eine Kombination aus Team- und Veröffentlichungswebsites.
Das benutzerdefinierte Branding erfordert oft bestimmte Layoutanpassungen, die nicht über Designs und JavaScript-Einbettungsmethoden erzielt werden können.
In einem solchen Szenario erfordern Teamwebsites in der Regel weniger benutzerdefiniertes Branding als Veröffentlichungswebsites, und die einsatzbereite moderne SharePoint-Ansicht für Mobilgeräte reicht in der Regel aus, um mobile Geräte im Hinblick auf Teamwebsites zu unterstützen. Da dies der Fall ist, empfiehlt es sich, nur benutzerdefinierte master Seiten für Veröffentlichungswebsites zu verwenden und AlternativeCSS- und benutzerdefinierte SharePoint-Designs (*.spcolor-Dateien), Schriftartenschemas (*.spfont-Dateien) und Hintergrundbilder zu verwenden, die als zusammengesetzte Designs für Markenteamwebsites definiert sind.
Bereitstellungsüberlegungen
- Wenn Sie benutzerdefinierte master-Seiten auf Veröffentlichungswebsites bereitstellen, müssen Sie nur die benutzerdefinierten master-Seiten auf der Stammwebsite bereitstellen.
- Die Provisioning.PublishingFeatures (O365 PnP-Beispiel) veranschaulicht, wie Sie benutzerdefinierte master Seiten auf Veröffentlichungswebsites bereitstellen.
- Das Beispiel wird unter Bereitstellen von SharePoint-Veröffentlichungsfeatures (O365-PnP-Video) erläutert.
- Wenn Sie benutzerdefinierte master-Seiten auf Nicht-Veröffentlichungswebsites bereitstellen, müssen Sie die benutzerdefinierten master Seiten auf jeder Website bereitstellen.
Benutzerdefinierte master Seiten werden in der Regel angewendet, wenn eine Website bereitgestellt wird. Der Remotebereitstellungsprozess eignet sich sehr gut für diesen Ansatz. In der Regel müssen Sie den Webbrowser nur einmalig zum manuellen Anwenden von benutzerdefiniertem SharePoint-Branding verwenden, wenn Sie Prototypen erstellen oder Änderungen an einer einzelnen SharePoint-Website vornehmen, die nicht dafür vorgesehen ist, um andere Websitesammlungen oder Unterwebsites erweitert zu werden.
- Weitere Bereitstellungsdetails und zusätzliche Beispiele finden Sie unter Module (SharePoint-Add-In-Rezept) und Websitebereitstellung (SharePoint-Add-In-Rezept).
Weitere Informationen zu benutzerdefinierten master Seiten und Seitenlayouts für SharePoint-Websites
In Szenarien, in denen eine benutzerdefinierte Gestaltungsvorlage die einzige Möglichkeit zum Implementieren Ihrer Brandinganforderungen ist, können Sie hierfür eine benutzerdefinierte Gestaltungsvorlage und Seitenlayouts erstellen. Beachten Sie die Hinweise am Anfang dieses Artikels im Hinblick auf die mit diesem Ansatz verbundenen langfristigen Vewaltungskosten.
- Die Verwendung benutzerdefinierter Gestaltungsvorlagen für SharePoint-Websites bietet das Höchstmaß an Anpassungsmöglichkeiten (unbegrenzt).
- Für die Verwendung benutzerdefinierter Gestaltungsvorlagen für SharePoint-Websites ist kurz- und langfristig der größte Zeitaufwand für Implementierung und Verwaltung erforderlich.
- In Dienstupdates enthaltene Änderungen an vorgefertigten Gestaltungsvorlagen werden nicht auf benutzerdefinierte Gestaltungsvorlagen angewendet.
- Sie können benutzerdefinierte Gestaltungsvorlagen auf Websiteebene anwenden.
- Wenn Sie eine benutzerdefinierte Gestaltungsvorlage verwenden, empfiehlt es sich, mit einer der vorgefertigten Vorlagen zu beginnen und diese an Ihre Anforderungen anzupassen.
- Versuchen Sie, den Umfang der Anpassungen zu minimieren, die Sie mit benutzerdefinierten master Seiten vornehmen. Dadurch wird es einfacher, sie zu aktualisieren, wenn Office 365 Dienständerungen an vordefinierten master Seiten auf benutzerdefinierte master Seiten repliziert werden müssen.
- Es gibt viele erforderliche Inhaltsplatzhalter auf SharePoint-Gestaltungsvorlagen, die nicht entfernt werden dürfen, da ansonsten Fehler auf der Seite auftreten. Sie werden wissen, wenn Sie einen erforderlichen Inhaltsplatzhalter entfernt haben, da in der Minute, in der Sie ihn bereitstellen und die master Seite Ihrer Website zuweisen, Fehler angezeigt werden.
Wann empfiehlt es sich, benutzerdefinierte Gestaltungsvorlagen und Seitenlayouts für eine SharePoint-Website zu erstellen?
Diese Option eignet sich gut, wenn Ihre Brandinganforderungen sehr spezifisch sind oder Sie Veröffentlichungswebsites verwenden.
Empfohlene Ansätze für die Anwendung
- Benutzerdefinierte Gestaltungsvorlagen können über einen Webbrowser manuell hochgeladen und zusammengesetzten Designs manuell zugewiesen werden.
- Benutzerdefinierte Gestaltungsvorlagen können auch über das Remotebereitstellungsmuster hochgeladen und einer SharePoint-Website zugewiesen werden.
- Weitere Bereitstellungsdetails und zusätzliche Beispiele finden Sie unter Module (SharePoint-Add-In-Rezept) und Websitebereitstellung (SharePoint-Add-In-Rezept).
Verwandte Links
- Module (SharePoint-Add-In-Rezept)
- Websitebereitstellung (SharePoint-Add-In-Rezept)
- Branding von SharePoint-Websites (SharePoint-Add-In-Rezept)
- Ignite 2015 – Detaillierte Informationen über das sichere SharePoint-Branding in Office 365 mithilfe wiederholbarer Muster und Vorgehensweisen
- Leitfadenartikel unter https://aka.ms/OfficeDevPnPGuidance
- Verweise in MSDN unter https://aka.ms/OfficeDevPnPMSDN
- Videos bei https://aka.ms/OfficeDevPnPVideos
PnP-Beispiele
- Verwalten von Designs mithilfe von CSOM (O365-PnP-Beispiel)
- AlternativeCSSUrl- und SiteLogoUrl-Eigenschaften im Webobjekt (O365-PnP-Beispiel)
- Festlegen eines Designs für eine Website (O365-PnP-Beispiel)
- Festlegen eines SharePoint-Designs in einer App für SharePoint (O365-PnP-Beispiel)
- Dynamische Out-of-the-Box-Vorlage „seattle.master“ erstellen (O365-PnP-Beispiel)
- Beispiele und Inhalte unter https://github.com/SharePoint/PnP
Gilt für
- Office 365 mit mehreren Mandanten (MT)
- Office 365 dediziert (D) teilweise
- SharePoint 2013 lokal – teilweise
Muster für dedizierte und lokale Umgebungen sind identisch mit SharePoint-Add-In-Modelltechniken, aber es gibt Unterschiede bezüglich der verwendbaren Technologien.