使用された Web パーツ マッピングの概要
重要
SharePoint PnP モダン化は、PnP フレームワークの一部であり、継続的に進化しています。リリース ノートで常に最新の変更内容を確認してください。 問題が発生した場合は、「PnP フレームワークに関する GitHub の問題リスト」で問題を提出してください。
クラシック ページからモダン ページにページが変換されると、一般的に使用されるほとんどの Web パーツも変換されます。 クラシック Web パーツ (XSLTListView など) が、対応するモダン パーツが使用できるという想定で対応する OOB モダン パーツ (リスト Web パーツなど) によって置き換えられます。 次の章では、変換されるクラシック Web パーツとその変換方法の概要について取り上げます。
Web パーツ変換のリスト
ページ変換では、クラシック ページからモダン ページへの変換時に既定の Web パーツ マッピングが使用されます。 ここでは、この既定のモダンで使用されるマッピングについて説明していますが、独自のカスタムのサード パーティ製 Web パーツを変換ターゲットとして追加するなど、この既定のマッピングを更新することができます。 Web パーツのマッピング モデルを拡張する方法については、「ページ変換モデル」の記事で説明されています。
| クラシック Web パーツ | モダン Web パーツ | Comments | クロス サイトのサポート |
|---|---|---|---|
| Microsoft.SharePoint.WebPartPages.XsltListViewWebPart (リスト データの表示) | リスト、ライブラリ、またはイベント の各 Web パーツ | 詳細については、次の章を参照してください | 同じ名前のリストが存在する場合、有 |
| Microsoft.SharePoint.WebPartPages.ListViewWebPart (リスト データの従来の表示) | リスト、ライブラリ、またはイベント の各 Web パーツ | 詳細については、次の章を参照してください | 同じ名前のリストが存在する場合、有 |
| Microsoft.SharePoint.Portal.WebControls.SiteFeedWebPart (チーム サイトのサイト フィード) | ニュース Web パーツ | 通常、この Web パーツはホーム ページでニュースを表示するために使用されるため、OOB ニュース Web パーツに置き換えられます | 有 |
| Microsoft.SharePoint.WebPartPages.ContentEditorWebPart (埋め込みコンテンツ) | 埋め込み Web パーツ、テキスト Web パーツ、コミュニティ オープン ソース スクリプト エディターをオプションのターゲット Web パーツとする | 詳細については、次の章を参照してください | 有 |
| Microsoft.SharePoint.WebPartPages.ScriptEditorWebPart (埋め込みスクリプト) | 変換されていない OOB、コミュニティ オープン ソース スクリプト エディターをオプションのターゲット Web パーツとして構成できる | 詳細については、次の章を参照してください | 有 |
| Microsoft.SharePoint.WebPartPages.ImageWebPart | 画像 Web パーツ | 有 | |
| Microsoft.SharePoint.WebPartPages.ClientSideWebPart (= クラシック ページ上の SPFX ベースのモダン Web パーツ) | 同じモダン Web パーツとその構造が保持されます | ターゲット サイトで同一の SPFX Web パーツが利用できる場合、有 | |
| Microsoft.SharePoint.WebPartPages.ClientWebPart (= クラシック ページ上の SharePoint アドイン Web パーツ) | 同じアドインがモダン ページ上でも動作し、その構成が引き継がれます | ターゲット サイトで同一のアドイン Web パーツが利用できる場合、有 | |
| Microsoft.SharePoint.Publishing.WebControls.MediaWebPart (埋め込み動画) | ファイル ビューアー Web パーツ | 有 | |
| Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart (データのクエリとその表示) | 強調表示されたコンテンツの Web パーツ | 無 | |
| Microsoft.SharePoint.Publishing.WebControls.ContentBySearchWebPart (データの検索とその表示) | 強調表示されたコンテンツ Web パーツ | 無 | |
| Microsoft.SharePoint.Publishing.WebControls.ResultScriptWebPart (データの検索とその表示) | 強調表示されたコンテンツ Web パーツ | 無 | |
| Microsoft.Office.Excel.WebUI.ExcelWebRenderer (Excel ファイルからの埋め込み) | ファイル ビューアー Web パーツ | 無 | |
| Microsoft.Office.Visio.Server.WebControls.VisioWebAccess (Visio ファイルからの埋め込み) | ファイル ビューアー Web パーツ | 無 | |
| Microsoft.SharePoint.WebPartPages.PageViewerWebPart (他のページからの埋め込み) | 埋め込み Web パーツ | 有 | |
| Microsoft.SharePoint.WebPartPages.PictureLibrarySlideshowWebPart (画像スライド ショー) | 画像ギャラリー Web パーツ | 画像ライブラリでは CDN のサポートはしていませんので、画像ライブラリのコンテンツを標準のドキュメント ライブラリにコピーしてから、それを画像ギャラリー Web パーツで構成するようお勧めします。 | 同じ名前の画像ライブラリが存在する場合、有 |
| Microsoft.SharePoint.WebPartPages.SimpleFormWebPart (HTML フォーム埋め込み) | 変換されていない OOB、オプションでコミュニティ オープン ソース スクリプト エディターを構成できる | 詳細については、次の章を参照してください | 有 |
| Microsoft.SharePoint.Publishing.WebControls.SummaryLinkWebPart | QuickLinks Web パーツまたはテキスト Web パーツ | 既定では概要リンク HTML は QuickLinks に変換されますが、必要に応じて、テキスト Web パーツを使用して表示される HTML を生成することができます。 詳細については、次の章を参照してください | 有 |
| Microsoft.SharePoint.Portal.WebControls.ContactFieldControl (連絡先カード) | 連絡先 Web パーツ | はい | |
| Microsoft.SharePoint.WebPartPages.UserDocsWebPart (ユーザー ドキュメント) | 強調表示されたコンテンツ Web パーツ | はい | |
| Microsoft.SharePoint.WebPartPages.XmlWebPart (HTML を生成するために xml と xsl を使用) | 削除 (理由を説明するために追加されたテキスト Web パーツ) | 有 | |
| Microsoft.SharePoint.WebPartPages.DataFormWebPart (リスト フォームの従来の表示) | 削除 (理由を説明するために追加されたテキスト Web パーツ) | 有 | |
| Microsoft.SharePoint.WebPartPages.WikiContentWebpart | 削除 (理由を説明するために追加されたテキスト Web パーツ) | SPO と関係なし | 有 |
| Microsoft.SharePoint.WebPartPages.SilverlightWebPart (Silverlight アプリの実行) | 削除 (理由を説明するために追加されたテキスト Web パーツ) | モダンへの置換なし。Microsoft Edge および Chrome などのモダン ブラウザーで Silverlight が動作しなくなりました | 有 |
| Microsoft.SharePoint.Publishing.WebControls.MembersWebPart | 削除 (理由を説明するために追加されたテキスト Web パーツ) | サイト メンバーの管理は、OOB サイトのアクセス許可機能を使用して行われるようになりました | 有 |
| Microsoft.Office.InfoPath.Server.Controls.WebUI.BrowserFormWebPart (InfoPath Web パーツ) | 削除 | 有 | |
| Microsoft.SharePoint.WebPartPages.GettingStartedWebPart (タイルの概要) | 削除 | クラシック チーム サイト エクスペリエンスに関する入門情報が不要になりました | 有 |
| Microsoft.SharePoint.WebPartPages.SPUserCodeWebPart (サンドボックス Web パーツ) | 削除 | サンドボックス Web パーツは SPO で使用できなくなりました | はい |
| Microsoft.SharePoint.Publishing.WebControls.TableOfContentsWebPart | 削除 | このデータは、関連性がある場合にはサイト ナビゲーションに統合する必要があります | 有 |
注:
前述の表に記載されていない他のすべての Web パーツは、「Web パーツ xxx は変換されていません」と記されてテキスト Web パーツになる「既定」のマッピングが設定されます。 クラシック Web パーツとモダン パーツの機能レベルにおける関連性を理解するには、クラシックとモダンの Web パーツに関する記事をご覧ください。
マッピング プロパティ
マッピング プロパティを使用すると、OOB マッピング ファイルを使用するときの動作を定義できます。 典型的なサンプルは、コミュニティ スクリプト エディターの使用を有効にすることです。 以下の表は、使用可能なマッピング プロパティを定義しています。
| マッピング プロパティ | 既定 | 説明 |
|---|---|---|
| UseCommunityScriptEditor | false | 該当するマッピングでコミュニティ スクリプト エディターの使用を構成します。 |
| SummaryLinksToQuickLinks | true | QuickLinks への SummaryLinks Web パーツのマッピングを構成する |
Web パーツ変換の詳細
変換中に使用されるコミュニティ スクリプト エディター Web パーツの使用を有効にします。
埋め込みスクリプトとしての OOB モダン スクリプト エディター Web パーツは、固有のセキュリティ リスクがあるため使用が推奨されません。 ただしクラシック スクリプト エディター Web パーツを変換することが必要なら、オープン ソース コミュニティのモダン スクリプト エディターを使用して行うことができます。
コミュニティ スクリプト エディターのインストール
指示に従って、オープン ソース スクリプト エディター Web パーツ (https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-script-editor) をテナントにインストールします。
UseCommunityScriptEditor マッピング フラグを設定する
コミュニティ スクリプト エディターがインストールされていることと、変換中にそれを使用することを、ページ変換エンジンに指定する必要があります。
ConvertTo-PnPPage
PnP PowerShell コマンドレットを使用する場合は、-UseCommunityScriptEditor フラグを指定できます。 .Net を使用する場合は、次のサンプルに示すようにフラグを設定できます。
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["UseCommunityScriptEditor"] = "true";
pageTransformator.Transform(pti);
XsltListViewWebPart Wep パーツと ListViewWebPart Web パーツ
これらの Web パーツはクラシックで非常に柔軟性が高いため、特定のモダン Web パーツに置き換えられます。 置き換えは次のようになります。
- ドキュメント ライブラリ: ライブラリ Web パーツ
- リスト: リスト Web パーツ
- カレンダー: イベント Web パーツ
- 案件リスト: リスト Web パーツ
- タスク リスト: マップできなかったことを記述するテキスト Web パーツ
- ディスカッション掲示板: マップできなかったことを記述するテキスト Web パーツ
- アンケート リスト: マップできなかったことを記述するテキスト Web パーツ
リスト Wep パーツまたはライブラリ Web パーツへの変換中、変換エンジンは Web パーツを構成するためのビューを検出し、同じビューを表示するモダン ライブラリ Web パーツまたはリスト Web パーツを構成しようとします。
ContentEditorWebPart Web パーツ
コンテンツ エディター Web パーツは SharePoint でいずれかのファイルを指定して使用するか、組み込みコンテンツを設定できます。 使用されるモードに応じて、以下のロジックが適用されます。
- ファイル リンク:
- ASPX ファイルの場合、埋め込み Web パーツを介して表示できます
- コンテンツが別の種類のファイルの場合、ファイル コンテンツが読み込まれ、次のように分析されます。
- 埋め込まれたコンテンツ:
ScriptEditorWebPart Web パーツ
既定では、テキスト Web パーツが表示され、コンテンツが変換されないことが示されます。または、構成されていれば、コミュニティ パーティ スクリプト エディター Web パーツが使用されます (上記のとおり)。
SummaryLinks Web パーツ
既定では概要リンク HTML は QuickLinks に変換されますが、必要に応じて、テキスト Web パーツを使用して表示される HTML を生成することができます。 HTML を使用するには、必要なマッピング プロパティを設定する必要があります。 ConvertTo-PnPPagePnP PowerShell コマンドレットを使用する場合は、 -SummaryLinksToHtml フラグを指定できます。 .Net を使用する場合は、次のサンプルに示すようにフラグを設定できます。
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["SummaryLinksToQuickLinks"] = "false";
pageTransformator.Transform(pti);