ページ変換中の用語マッピング

用語マッピングとは、ソース環境で管理されているメタデータの用語を、ターゲット環境で適用可能な用語に変換するメカニズムです。 用語マッピングが適用されるケースは、次のとおりです。

• オンプレミスの SharePoint から SharePoint Online への変換
• SharePoint Online でのクロス サイト変換 (例: 従来の発行ポータルから最新のイントラネットへの変換)

用語マッピングは、次の場合には使用されません。

• ソースとターゲットが同じ用語セット ID を指している
• インプレース変換を行っている場合 (ソース ページとターゲット ページが同じサイト内に存在する場合)

用語マッピングの仕組み

用語マッピングでは、ソース ページで使用されている用語に対応する用語が SharePoint Online 内で自動的に検索されます。そして、これ行うには次の 2 つの方法があります。

• 自動マッピング: 用語マッピングは、同じ用語グループ、用語セット、用語パスがターゲット用語ストアで見つかるかどうかを確認し、同等の用語を見つけようとします。
• ファイルに基づくカスタム マッピング: マッピング ファイルを使用して、指定されたソース用語に対するターゲット用語を指定することができます。

自動マッピングをオフにする

用語マッピングを望まない場合は、PnP PowerShell の -SkipTermStoreMapping フラグや .Net ページ変換構成オブジェクトの SkipTermStoreMapping 属性 (PageTransformationInformation と PublishingPageTransformationInformation) を介して無効にすることができます。

カスタム用語マッピング

自動用語マッピングを使用したくない、または使用できない場合には、用語マッピング ファイルを指定するオプションがあります。 用語マッピング ファイルは、以下のコードのような、ソース用語とターゲット用語を一覧にした、簡易 CSV ファイルです

SourceTermGroup|SourceTermSet|SourceTerm,TargetTermGroup|TargetTermSet|TargetTerm
SourceTermGroup|SourceTermSet|SourceTerm|SourceChildTerm1|SourceChildTerm2,TargetTermGroup|TargetTermSet|TargetTerm|TargetChildTerm1|TargetChildTerm2
f0b1b6aa-b00b-4198-b8dd-ef4393e3ad05,fec05391-6a39-4ad5-a2a1-a01020d94efd

いくつかの注意事項があります。

• パス (用語ラベルの | で区切られた文字列) に基づいてマッピングを選択するか、またはソースとターゲットの用語 ID に基づいてマッピングを定義することを選択することができます
• SharePoint 2010 から変換する場合には、ソース用語グループ名に DEFAULT を指定する必要があります

実際にマッピングファイルを作成するには、最初の手順として、PnP PowerShell を使用している場合、ConvertTo-PnPPage コマンドレットの TermMappingFile パラメーターでファイルを指定する必要があります。 .Net を使用している場合は、.Net ページ変換構成オブジェクト (PageTransformationInformation と ) の属性を使用してTermMappingFileファイルをPublishingPageTransformationInformation指定できます。