クロス サイト ページ変換を実行すると、デフォルトで URL マッピングが使用されます。 常に最新の（通信）サイト内に最新のページを作成するため、公開ページを最新化する場合は、クロス サイト ページ変換が必須です。 クロス サイト URL マッピングが適用されている場合は、イン プレース チームサイトの最新化を行うときにURLをマッピングする必要はありません。 URL マッピングは、"元の"ロケーションを指す URL を自動的に類似の URL に置き換えますが、その後"目的の"ロケーションを指すようになります。 既定でアクティブになっている（ただし無効にすることができる）デフォルトの URL マッピング コンポーネントと、使用できるオプションのカスタム URL マッピングコンポーネントがあります。
URLマッピングが適用される場所
URL マッピング/書き換えは次の場所に適用されます。
- 最新ページのテキスト部分として終わるすべてのコンテンツ（2019 年 5 月リリース時点）
- SummaryLinks からテキストコンテンツまたは最新の QuickLinks Web パーツへの変換（2019 年 5 月リリース時点）
- 画像のアンカー タグ (2019 年 11 月リリース時点)
デフォルトの URL マッピング ロジック
上記で説明したように、既定の URL マッピングが適用されているクロスサイト変換が行われます。 デフォルトのURLマッピング メカニズムは、現在の Web とサイトのフル URL と相対 URL をマッピングします。 これは、従来の "ページ" ライブラリ発行から最新の SitePages ライブラリへの切り替えを処理します。 以下は、既定の URL マッピングのしくみを示しています。 元のサイトを次の http://contoso.com/sites/portal/hr 、目的の通信サイトが https://contoso.sharepoint.com/sites/hr にあると仮定すると、次の URL の書き換えが適用されます。
-
http://contoso.com/sites/portal->https://contoso.sharepoint.com/sites/hr -
http://contoso.com/sites/portal/pages->https://contoso.sharepoint.com/sites/hr/sitepages - /sites/portal -> /sites/hr
- /sites/portal/pages -> /sites/hr/sitepages
-
http://contoso.com/sites/portal/hr->https://contoso.sharepoint.com/sites/hr -
http://contoso.com/sites/portal/hr/pages->https://contoso.sharepoint.com/sites/hr/sitepages - /sites/portal/hr -> /sites/hr
- /sites/portal/hr/pages -> /sites/hr/sitepages
URL マッピングを無効にする
URL マッピングを望まない場合は、-SkipUrlRewritingPnP PowerShell のフラグや .Net ページ変換構成オブジェクトの SkipUrlRewrite 属性 (PageTransformationInformation と PublishingPageTransformationInformation) を介して無効にできます。
カスタム URL マッピング
規定のマッピング論理によって処理されるのではなく、追加のマッピングを実行する場合は、カスタムの URL マッピングの定義リストを含むファイルを提供する必要があります。 これは、ソースとターゲットの URL 値がヘッダーに含まれていない単純な CSV ファイルです。 CSV ファイルの区切り記号として、コンマ (,) またはセミコロン (;) を使用することができます。
https://contoso.com/intranet,https://contoso.sharepoint.com/sites/intranet
/sites/hr,/sites/myhrportal
このカスタムの URL マッピング ファイルを使用するには、ページ変換エンジンをファイルにポイントするだけです。 PnP PowerShell を使用する場合、ConvertTo-ClientSidePage コマンドレット (-UrlMappingFile "c:\temp\urlmap.csv" など) の -UrlMappingFile パラメーターが使用でき、または .Net ページ変換構成オブジェクトの UrlMappingFile 属性(PageTransformationInformation と PublishingPageTransformationInformation) を使用します。
既定の URL マッピングとカスタムの URL マッピング
カスタム URL マッピングを使用する場合、そのしくみとともに既定の URL マッピングを理解することが重要です。
- カスタム URL マッピングは既定の URL マッピングの 前 に実行され、書き換えられた既定の URL へのカスタム マッピングを指定することで URL マッピングの既定の動作を変更することができます
- URL マッピングを無効にすると、カスタム URL マッピングも無効になります。 カスタム URL マッピングのみ使用する場合は、
ConvertTo-ClientSidePageコマンドレットの-SkipDefaultUrlRewritingパラメーターを使用するか、.Net ページ変換の構成オブジェクト (PageTransformationInformationおよびPublishingPageTransformationInformation) のSkipDefaultUrlRewrite属性を使用します。