Übersicht über die verwendete Zuordnung von Webparts
Wichtig
SharePoint PnP Modernization ist ein Bestandteil des PnP-Framework und wird ständig weiterentwickelt. Sehen Sie sich die Versionshinweise an, um bezüglich der aktuellsten Änderungen auf dem neuesten Stand zu bleiben. Wenn Sie Probleme feststellen, öffnen Sie bitte ein Ticket in der GitHub-Problemliste im PnP-Framework.
Wenn eine Seite von einer klassischen Seite in eine moderne Seite umgewandelt wird, werden auch die am häufigsten verwendeten Webparts umgewandelt. Klassische Webparts (z. B. XSLTListView) werden durch ihre modernen OOB-Entsprechungen (z. B. Listenwebpart) ersetzt, vorausgesetzt es gibt eine moderne Entsprechung. Das nächste Kapitel enthält eine Übersicht darüber, welche klassischen Webparts transformiert werden und wie dies funktioniert.
Webpart-Transformationsliste
Die Seitentransformation verwendet eine standardmäßige Webpartzuordnung, wenn klassische Seite in moderne Seiten transformiert werden. Die hierbei verwendete Zuordnung wird nachfolgend beschrieben, beachten Sie aber, dass Sie die Zuordnung so aktualisieren können, dass Sie zum Beispiel Ihre eigenen benutzerdefinierten Drittanbieter-Webparts als Transformationsziel hinzufügen können. Wie das Webpart-Zuordnungsmodell erweitert wird, wird im Artikel Seitentransformationsmodell beschrieben.
| Klassisches Webpart | Modernes Webpart | Kommentare | Standortübergreifende Unterstützung |
|---|---|---|---|
| Microsoft.SharePoint.WebPartPages.XsltListViewWebPart (Listendaten anzeigen) | Listen-, Bibliotheks- oder Ereignisse-Webpart | Im nächsten Kapitel finden Sie weitere Informationen. | Ja, wenn eine Liste mit demselben Namen vorhanden ist |
| Microsoft.SharePoint.WebPartPages.ListViewWebPart (veraltetes Anzeigen von Listendaten) | Listen-, Bibliotheks- oder Ereignisse-Webpart | Im nächsten Kapitel finden Sie weitere Informationen. | Ja, wenn eine Liste mit demselben Namen vorhanden ist |
| Microsoft.SharePoint.Portal.WebControls.SiteFeedWebPart (Website-Feed auf Teamwebsites) | Neuigkeiten-Webpart | Dieses Webpart wird in der Regel verwendet, um Neuigkeiten auf einer Startseite anzuzeigen, es wird daher mit dem News-Webpart von OOB ersetzt. | Ja |
| Microsoft.SharePoint.WebPartPages.ContentEditorWebPart (Einbetten von Inhalten) | Embed-Webpart, Text-Webpart und/oder ein Open Source-Community-Skript-Editor als optionales Zielwebpart | Im nächsten Kapitel finden Sie weitere Informationen. | Ja |
| Microsoft.SharePoint.WebPartPages.ScriptEditorWebPart (Einbetten des Skripts) | Nicht transformiertes OOB, ein Open Source-Community-Skript-Editor kann als optionales Zielwebpart konfiguriert werden | Im nächsten Kapitel finden Sie weitere Informationen. | Ja |
| Microsoft.SharePoint.WebPartPages.ImageWebPart | Bild-Webpart | Ja | |
| Microsoft.SharePoint.WebPartPages.ClientSideWebPart (= modernes SPFX-basiertes Webpart auf klassischer Seite) | Dasselbe moderne Webpart mit seiner Konfiguration wird beibehalten. | Ja, wenn das gleiche SPFX-Webpart auf der Zielwebsite verfügbar ist | |
| Microsoft.SharePoint.WebPartPages.ClientWebPart (= SharePoint-Add-In-Webpart auf klassischer Seite) | Das gleiche Add-In kann auf modernen Seiten verwendet werden und wird einschließlich seiner Konfiguration übernommen. | Ja, wenn das gleiche Add-In-Webpart auf der Zielwebsite verfügbar ist | |
| Microsoft.SharePoint.Publishing.WebControls.MediaWebPart (Einbetten von Videos) | Dateianzeige-Webpart | Ja | |
| Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart (Abfragen von Daten und Darstellen der Daten) | Webpart für Hervorgehobene Inhalte | Nein | |
| Microsoft.SharePoint.Publishing.WebControls.ContentBySear (Suche von Daten und Darstellen der Daten) | Webpart für Hervorgehobene Inhalte | Nein | |
| Microsoft.SharePoint.Publishing.WebControls.ResultScriptWebPart (Suche von Daten und Darstellen der Daten) | Webpart für Hervorgehobene Inhalte | Nein | |
| Microsoft.Office.Excel.WebUI.ExcelWebRenderer (Einbetten aus Excel-Dateien) | Dateianzeige-Webpart | Nein | |
| Microsoft.Office.Visio.Server.WebControls.VisioWebAccess (Einbetten aus Visio-Dateien) | Datei-Viewer-Webpart | Nein | |
| Microsoft.SharePoint.WebPartPages.PageViewerWebPart (Einbetten aus anderen Seiten) | Einbetten-Webpart | Ja | |
| Microsoft.SharePoint.WebPartPages.PictureLibrarySlideshowWebPart (Bildschirmpräsentation) | Bildergalerie-Webpart | Bildbibliotheken unterstützen keine CDNs. Es wird empfohlen, die Bildbibliotheksinhalte in eine reguläre Dokumentbibliothek zu kopieren und diese dann im Bildergalerie-Webpart zu konfigurieren. | Ja, wenn eine gleichnamige Bildbibliothek existiert |
| Microsoft.SharePoint.WebPartPages.SimpleFormWebPart (Einbetten eines HTML-Formulars) | Nicht transformiertes OOB, optional kann ein Open Source-Community-Skript-Editor konfiguriert werden | Im nächsten Kapitel finden Sie weitere Informationen. | Ja |
| Microsoft.SharePoint.Publishing.WebControls.SummaryLinkWebPart | QuickLinks-Webpart oder Text-Webpart | Hyperlinkübersichts-HTML-Code wird standardmäßig in QuickLinks transformiert, aber optional können Sie HTML-Code generieren, der dann mithilfe des Text-Webparts angezeigt wird. Im nächsten Kapitel finden Sie weitere Informationen. | Ja |
| Microsoft.SharePoint.Portal.WebControls.ContactFieldControl (Visitenkarte) | Personen-Webpart | Ja | |
| Microsoft.SharePoint.WebPartPages.UserDocsWebPart (Benutzerdokumente) | Webpart für Hervorgehobene Inhalte | Ja | |
| Microsoft.SharePoint.WebPartPages.XmlWebPart (Verwendung von XML und XSL zur Erstellung von HTML) | Entfernt (Text-Webpart zur Erläuterung hinzugefügt) | Ja | |
| Microsoft.SharePoint.WebPartPages.DataFormWebPart (veraltetes Anzeigen von Listenformularen) | Entfernt (Text-Webpart zur Erläuterung hinzugefügt) | Ja | |
| Microsoft.SharePoint.WebPartPages.WikiContentWebpart | Entfernt (Text-Webpart zur Erläuterung hinzugefügt) | In SharePoint Online nicht mehr relevant. | Ja |
| Microsoft.SharePoint.WebPartPages.SilverlightWebPart (Ausführen von Silverlight-Aapps) | Entfernt (Text-Webpart zur Erläuterung hinzugefügt) | Es gibt keinen Ersatz für moderne Seiten; Silverlight funktioniert nicht mehr in modernen Browsern wie Edge und Chrome. | Ja |
| Microsoft.SharePoint.Publishing.WebControls.MembersWebPart | Entfernt (Text-Webpart zur Erläuterung hinzugefügt) | Das Verwalten von Websitemitgliedern erfolgt jetzt mithilfe der Funktionalität OOB-Websiteberechtigungen | Ja |
| Microsoft.Office.InfoPath.Server.Controls.WebUI.BrowserFormWebPart (InfoPath-Webpart) | Entfernt | Ja | |
| Microsoft.SharePoint.WebPartPages.GettingStartedWebPart (Kacheln für erste Schritte) | Entfernt | Es ist nicht sinnvoll, erste Schritte für die klassische Teamwebsite beizubehalten. | Ja |
| Microsoft.SharePoint.WebPartPages.SPUserCodeWebPart (Sandkasten-Webpart) | Entfernt | Sandkasten-Webparts sind in SharePoint Online nicht mehr möglich | Ja |
| Microsoft.SharePoint.Publishing.WebControls.TableOfContentsWebPart | Entfernt | Diese Daten sollten in die Websitenavigation integriert werden, wenn sie noch relevant sind. | Ja |
Hinweis
Alle anderen Webparts, die nicht in der obigen Tabelle aufgeführt sind, erhalten eine „Standardzuordnung“; das heißt, das Text-Webpart gibt an, dass „das Webpart xxx nicht transformiert wurde“. Lesen Sie den Artikel zu klassischen und modernen Webpartoberflächen, um zu verstehen, wie klassische Webparts auf einer funktionalen Ebene mit modernen Webparts im Zusammenhang stehen.
Zuordnungseigenschaften
Zuordnungseigenschaften ermöglichen es Ihnen, das Verhalten bei der Verwendung der OOB-Zuordnungsdatei zu definieren. Ein typisches Beispiel ist die Aktivierung der Verwendung des Community-Skript-Editors. Die folgende Tabelle definiert die verfügbaren Zuordnungseigenschaften.
| Zuordnungseigenschaft | Standard | Beschreibung |
|---|---|---|
| UseCommunityScriptEditor | false | Konfigurieren der Verwendung des Community-Skript-Editors in entsprechenden Zuordnungen |
| SummaryLinksToQuickLinks | true | Konfigurieren der Zuordnung des SummaryLinks-Webparts zu QuickLinks |
Webpart-Transformationsdetails
Ermöglicht die Verwendung des Webparts des Community-Skript-Editors während der Transformation
Es gibt keinen modernen OOB-Skript-Editor-Webpart, da vom Einbetten von Skripts aufgrund der damit verbundenen Sicherheitsrisiken abgeraten wird. Wenn Sie jedoch klassische Skript-Editor-Webparts transformieren möchten, können Sie dies trotzdem mit einem modernen Skript-Editor der Open Source-Community tun.
Installieren des Community-Skript-Editors
Befolgen Sie die Anweisungen, um das Open-Source-Skript-Editor-Webpart (https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-script-editor) in Ihrem Mandanten zu installieren.
Legen Sie das UseCommunityScriptEditor-Zuordnungsflag fest
Sie müssen dem Seitentransformationsmodul mitteilen, dass Sie den Community-Skript-Editor installiert haben und ihn während der Transformation verwenden möchten. Wenn Sie das ConvertTo-PnPPagePnP PowerShell-Cmdlet verwenden, können Sie das -UseCommunityScriptEditor Flag angeben. Bei Verwendung von .Net können Sie dann das Flag wie im folgenden Beispiel gezeigt festlegen
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["UseCommunityScriptEditor"] = "true";
pageTransformator.Transform(pti);
XsltListViewWebPart- und ListViewWebPart-Webparts
Diese Webparts sind in klassischen Oberflächen sehr flexibel und werden daher durch spezifischere Webparts ersetzt. Die Ersetzung funktioniert wie folgt:
- Dokumentbibliothek: Bibliotheks-Webpart
- Liste: Listen-Webpart
- Kalender: Ereignisse-Webpart
- Problemliste: Listen-Webpart
- Aufgabenliste: Text-Webpart zur Erläuterung, dass eine Zuordnung nicht möglich war
- Diskussionsforum: Text-Webpart zur Erläuterung, dass eine Zuordnung nicht möglich war
- Umfrageliste: Text-Webpart zur Erläuterung, dass eine Zuordnung nicht möglich war
Bei der Transformation in ein Listen- oder Bibliotheks-Webpart versucht das Transformationsmodul, die zur Konfiguration des Webparts verwendete Ansicht zu ermitteln und das moderne Bibliotheks- oder Listen-Webpart so zu konfigurieren, dass dieselbe Ansicht angezeigt wird.
ContentEditorWebPart-Webpart
Das Inhalts-Editor-Webpart kann entweder verwendet werden, indem eine Datei auf eine andere Stelle in SharePoint zeigt, oder es kann alternativ eingebettete Inhalte aufweisen. Je nach dem verwendeten Modus wird die folgende Logik angewendet:
- Dateilink:
- Wenn die Datei eine ASPX-Datei ist, so kann dies über das Einbetten-Webpart angezeigt werden.
- Handelt es sich beim Inhalt um einen anderen Dateityp, wird der Dateiinhalt gelesen und analysiert:
- Wenn der Dateiinhalt kein JavaScript enthält, wird er in ein Drittanbieter-Skript-Editor-Webpart transformiert (sofern konfiguriert), oder ein Text-Webpart mit dem "cleaned file contents"-HTML-Code wird angezeigt.
- Wenn der Dateiinhalt Skript enthält, wird er entweder in ein Drittanbieter-Skript-Editor-Webpart transformiert (sofern konfiguriert) oder durch ein Text-Webpart ersetzt, das angibt, dass dieser Inhalt nicht zugeordnet werden konnte.
- Eingebetteter Inhalt:
- Wenn der eingebettete Inhalt kein JavaScript enthält, wird er in ein Drittanbieter-Skript-Editor-Webpart transformiert (sofern konfiguriert), oder ein Text-Webpart mit dem HTML-Code "cleaned embedded" wird angezeigt.
- Wenn der eingebettete Inhalt Skript enthält, wird er entweder in ein Drittanbieter-Skript-Editor-Webpart transformiert (sofern konfiguriert) oder durch ein Text-Webpart ersetzt, das angibt, dass dieser Inhalt nicht zugeordnet werden konnte.
ScriptEditorWebPart-Webpart
Standardmäßig wird ein Text-Webpart angezeigt, um zu erläutern, dass der Inhalt nicht transformiert wird. Alternativ wird ein Community-Skript-Editor-Webpart verwendet, sofern konfiguriert (wie oben gezeigt).
SummaryLinks-Webpart
Hyperlinkübersichts-HTML-Code wird standardmäßig in QuickLinks transformiert, aber optional können Sie HTML-Code generieren, der dann mithilfe des Text-Webparts angezeigt wird. Um HTML zu verwenden, müssen Sie die erforderliche Zuordnungseigenschaft festlegen: Wenn Sie das ConvertTo-PnPPagePnP PowerShell-Cmdlet verwenden, können Sie das -SummaryLinksToHtml Flag angeben. Bei Verwendung von .Net können Sie dann das Flag wie im folgenden Beispiel gezeigt festlegen
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["SummaryLinksToQuickLinks"] = "false";
pageTransformator.Transform(pti);