Обзор сопоставления использованных веб-частей
Важно!
Модернизация SharePoint PnP является частью платформы PnP и постоянно развивается. См. заметки о выпуске, чтобы быть в курсе последних изменений. Если у вас возникнут проблемы, внесите данные о них в список проблем GitHub для платформы PnP.
При преобразовании страницы из классической версии в современную страницу наиболее часто используемые веб-части тоже преобразуются. Классические веб-части (например, XSLTListView) заменяются на современные OOB аналоги приложения (например, веб-часть списка), если они доступны. В следующей главе описано, какие классические веб-части преобразуются, и как.
Список преобразований веб-частей
Преобразование страницы использует сопоставление веб-частей по умолчанию при преобразовании классических страниц в современные. В этой статье описано используемое сопоставление в современной странице по умолчанию, но вы можете обновить сопоставление, чтобы, например, добавить в качестве цели трансформации сторонние настраиваемые веб-части. Процесс расширения модели сопоставления веб-частей описан в статье Модель преобразования страницы.
| Классические веб-части: | Современные веб-части: | Примечания | Межсайтовая поддержка |
|---|---|---|---|
| Microsoft.SharePoint.WebPartPages.XsltListViewWebPart (просмотр данных списка) | Веб-части Список, Библиотека или События | Дополнительные сведения см. в следующей главе | Да, если имеется список с таким же именем |
| Microsoft.SharePoint.WebPartPages.ListViewWebPart (традиционный просмотр данных списка) | Веб-части Список, Библиотека или События | Дополнительные сведения см. в следующей главе | Да, если имеется список с таким же именем |
| Microsoft.SharePoint.Portal.WebControls.SiteFeedWebPart (веб-каналы на сайтах групп) | Веб-часть Новости | Эта веб-часть обычно используется для отображения новостей на домашней странице, поэтому она заменяется на OOB веб-части новостей | Да |
| Microsoft.SharePoint.WebPartPages.ContentEditorWebPart (внедрение содержимого) | Веб-часть Внедрение, веб-часть Текст и/или редактор скриптов с открытым кодом от сообщества как необязательные целевые веб-части | Дополнительные сведения см. в следующей главе | Да |
| Microsoft.SharePoint.WebPartPages.ContentEditorWebPart (внедрение скриптов) | Непреобразованный OOB и редактор скриптов с открытым кодом от сообщества могут быть настроены как необязательные целевые веб-части | Дополнительные сведения см. в следующей главе | Да |
| Microsoft.SharePoint.WebPartPages.ImageWebPart | Веб-часть Поддержка изображений | Да | |
| Microsoft.SharePoint.WebPartPages.ClientSideWebPart (= современные веб-части на основе SPFX на классической странице) | Те же веб-части со своей конфигурацией будут сохранены | Да, если на конечном сайте доступна та же веб-часть SPFX | |
| Microsoft.SharePoint.WebPartPages.ClientSideWebPart (= веб-части надстроек SharePoint на классической странице) | Те же надстройки могут работать на современных страницах и в том числе будут включать свою конфигурацию | Да, если на конечном сайте доступна та же веб-часть надстроек | |
| Microsoft.SharePoint.Publishing.WebControls.MediaWebPart (внедрение видео) | Веб-часть Просмотр файлов | Да | |
| Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart (запрашивание данных и их демонстрация) | Веб-часть Выделенное содержимое | Нет | |
| Microsoft.SharePoint.Publishing.WebControls.ContentBySearchWebPart (поиск данных и их демонстрация) | Веб-часть Выделенное содержимое | Нет | |
| Microsoft.SharePoint.Publishing.WebControls.ResultScriptWebPart (поиск данных и их демонстрация) | Веб-часть Выделенное содержимое | Нет | |
| Microsoft.Office.Excel.WebUI.ExcelWebRenderer (внедрение из файлов Excel) | Веб-часть Просмотр файлов | Нет | |
| Microsoft.Office.Visio.Server.WebControls.VisioWebAccess (внедрение из файлов Visio) | Веб-часть Просмотр файлов | Нет | |
| Microsoft.SharePoint.WebPartPages.PageViewerWebPart (внедрение с других страниц) | Веб-часть Внедрить | Да | |
| Microsoft.SharePoint.WebPartPages.PictureLibrarySlideshowWebPart (рисунок слайд-шоу) | Веб-часть Коллекция изображений | Библиотеки рисунков не поддерживают сеть CDN, рекомендуется скопировать содержимое библиотеки рисунков в обычную библиотеку документов, а затем настроить его в веб-части "Коллекция изображений". | Да, если есть библиотека изображений с таким же именем |
| Microsoft.SharePoint.WebPartPages.SimpleFormWebPart (внедрение формы HTML) | Непреобразованный OOB и, при желании, редактор скриптов с открытым кодом от сообщества могут быть настроены | Дополнительные сведения см. в следующей главе | Да |
| Microsoft.SharePoint.Publishing.WebControls.SummaryLinkWebPart | Веб-часть QuickLinks или веб-часть Текст | HTML-код сводных ссылок преобразуется в QuickLinks по умолчанию, но при необходимости вы можете создать HTML-код, отображаемый с помощью веб-части Текст. Дополнительные сведения см. в следующей главе | Да |
| Microsoft.SharePoint.Portal.WebControls.ContactFieldControl (карточка пользователя) | Веб-часть Люди | Да | |
| Microsoft.SharePoint.WebPartPages.UserDocsWebPart (документы пользователя) | Веб-часть Выделенное содержимое | Да | |
| Microsoft.SharePoint.WebPartPages.XmlWebPart (использование XML и XSL для получения HTML) | Удаленные элементы (веб-часть Текст добавлена для объяснения причины) | Да | |
| Microsoft.SharePoint.WebPartPages.DataFormWebPart (традиционный просмотр форм списка) | Удаленные элементы (веб-часть Текст добавлена для объяснения причины) | Да | |
| Microsoft.SharePoint.WebPartPages.WikiContentWebpart | Удаленные элементы (веб-часть Текст добавлена для объяснения причины) | Больше не относящееся в SPO | Да |
| Microsoft.SharePoint.WebPartPages.SilverlightWebPart (запуск приложений Silverlight) | Удаленные элементы (веб-часть Текст добавлена для объяснения причины) | Нет современных замен, к тому же Silverlight больше не работает в современных браузерах, например в Microsoft Edge и Chrome | Да |
| Microsoft.SharePoint.Publishing.WebControls.MembersWebPart | Удаленные элементы (веб-часть Текст добавлена для объяснения причины) | Управление участниками сайта теперь выполняется с помощью функции разрешений сайта OOB | Да |
| Microsoft.Office.InfoPath.Server.Controls.WebUI.BrowserFormWebPart (веб-часть InfoPath) | Удаленные элементы | Да | |
| Microsoft.SharePoint.WebPartPages.GettingStartedWebPart (плитки начала работы) | Удаленные элементы | Нет смысла в сохранении плитки начала работы для классического интерфейса сайта группы | Да |
| Microsoft.SharePoint.WebPartPages.SPUserCodeWebPart (веб-часть Песочница) | Удаленные элементы | Изолированные веб-части больше не поддерживаются в SPO | Да |
| Microsoft.SharePoint.Publishing.WebControls.TableOfContentsWebPart | Удаленные элементы | Эти данные следует интегрировать в навигацию по сайту, если они все еще актуальны | Да |
Примечание.
Все остальные веб-части, не упомянутые в приведенной выше таблице, получат следующее сопоставление "по умолчанию": веб-часть Текст, сообщающая, что "Веб-часть xxx не была преобразована". Чтобы понять, как классические веб-части связаны с современными на функциональном уровне, см. статью Классические и современные интерфейсы веб-частей.
Свойства сопоставления
Свойства сопоставления позволяют определить поведение при использовании файла сопоставлений OOB. Типичным примером является разрешение использования редактора скриптов сообщества. В таблице ниже определены доступные свойства сопоставления.
| Свойство сопоставления | По умолчанию | Описание |
|---|---|---|
| UseCommunityScriptEditor | false | Настройка использования редактора скриптов сообщества в применимых сопоставлениях |
| SummaryLinksToQuickLinks | true | Настройка сопоставления веб-частей summarylinks с QuickLinks |
Сведения о преобразовании веб-частей
Разрешение использования веб-части редактора скриптов сообщества во время преобразования
Не существует современной веб-части редактора скриптов OOB, так как внедрение скриптов не рекомендуется из-за присущего риска для безопасности. Но если вы хотите преобразовать классическую веб-часть редактора скриптов, это можно сделать с помощью современного редактора скриптов с открытым кодом от сообщества.
Установка редактора скриптов сообщества
Следуйте инструкциям, чтобы установить веб-часть редактора сценариев с открытым кодом (https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-script-editor) в клиенте.
Установка флага сопоставления UseCommunityScriptEditor
Нужно сообщить модулю преобразования страницы об установке редактора скриптов сообщества и о необходимости его использования во время преобразования. При использовании командлета ConvertTo-PnPPagePowerShell PnP можно указать -UseCommunityScriptEditor флаг . При использовании .NET можно установить флаг, как показано в примере ниже
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["UseCommunityScriptEditor"] = "true";
pageTransformator.Transform(pti);
Веб-части XsltListViewWebPart и ListViewWebPart
В классической версии эти веб-части довольно гибкие, поэтому заменяются на более специфические современные. Замена работает следующим образом:
- Библиотека документов: веб-часть Библиотека
- Список: веб-часть Список
- Календарь: веб-часть События
- Список проблем: веб-часть Список
- Список задач: веб-частьТекст, объясняющая, что сопоставление невозможно
- Доска обсуждений: веб-частьТекст, объясняющая, что сопоставление невозможно
- Список опросов: веб-частьТекст, объясняющая, что сопоставление невозможно
Во время преобразования веб-части "Список" или "Библиотека" обработчик преобразования попытается определить режим, используемый для конфигурации веб-части, а также настроить современную веб-часть "Библиотека" или "Список" для отображения такого же представления.
Веб-часть ContentEditorWebPart
Веб-часть редактора содержимого можно использовать, указав файл, размещенный где-либо в SharePoint, или в нем может быть внедренное содержимое. В зависимости от используемого режима применяется следующее выражение:
- Ссылка на файл.
- В ASPX-файле она может отображаться через веб-часть Внедрение
- Если контент представляет собой файл другого типа, содержимое файла считывается и анализируется:
- Если в содержимом файла отсутствует JavaScript, оно преобразуется в стороннюю веб-часть редактора скриптов (при настройке) или отображается веб-часть Текст с очищенным HTML-кодом содержимого файла
- Если в содержимом файла есть скрипт, оно преобразуется в стороннюю веб-часть редактора скриптов (при настройке) или заменяется на веб-часть Текст, сообщающую о невозможности сопоставления этого содержимого
- Внедренное содержимое.
- Если во внедренном содержимом отсутствует JavaScript, оно преобразуется в стороннюю веб-часть редактора скриптов (при настройке) или отображается веб-часть Текст с очищенным встроенным HTML-кодом
- Если во встроенном содержимом есть скрипт, оно преобразуется в стороннюю веб-часть редактора скриптов (при настройке) или заменяется на веб-часть Текст, сообщающую о невозможности сопоставления этого содержимого
Веб-часть ScriptEditorWebPart
По умолчанию веб-часть Текст отображается, чтобы объяснить, что содержимое не преобразуется или что используется веб-часть редактора скриптов сообщества, если она настроена (как показано выше)
Веб-часть SummaryLinks
HTML-код сводных ссылок преобразуется в QuickLinks по умолчанию, но при необходимости вы можете создать HTML-код, отображаемый с помощью веб-части Текст. Чтобы использовать HTML, необходимо задать необходимое свойство сопоставления: при использовании командлета ConvertTo-PnPPagePowerShell PnP можно указать -SummaryLinksToHtml флаг . При использовании .NET можно установить флаг, как показано в примере ниже
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["SummaryLinksToQuickLinks"] = "false";
pageTransformator.Transform(pti);