標準データモデルサイトを拡張データモデルに移行する (プレビュー)

このトピックはプレリリースドキュメントであり、変更される場合があります。

この記事では、既存の標準データモデルサイトを拡張データモデルに移行する方法について説明します。

重要

この機能はプレビュー機能です。
プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。

前提条件

サイトを拡張データモデルに移行するには、バージョン 1.31.6 以降の Microsoft Power Platform CLI をインストールする必要があります。詳細情報: Power Platform CLI 最新版のインストール
Dataverse ベースポータルパッケージ 9.3.2307.x 以降。
Power Pages コアパッケージ 1.0.2309.63 以降。詳細: Power Pages ソリューションの更新
移行手順を完了するには、Power Pages で Power Platform CLI を使用する方法を理解する必要があります。 Power Pages の Power Platform CLI に詳しくない場合は、この Power Platform CLI チュートリアルを確認し、Power Pages を操作するための PAC CLI コマンドを参照してください。
管理モードで設定された環境の場合は、バックグラウンド操作を有効にします。

ステップ 1. 既存の標準サイトメタデータのカスタマイズをダウンロードして確認する

コマンドプロンプトを開きます。
次のコマンドを使用して Power Platform 環境の Dataverse 組織に対して認証を行い、移行用の Web サイトレコードをダウンロードします。

pac auth create -u [Dataverse URL]

例

pac auth create -u https://contoso-org.crm.dynamics.com

詳細: pac auth create
現在の組織が含む Web サイトのリストを生成する際は、次のコマンドを使用します。

pac pages list

詳細情報: pac ページの一覧
カスタマイズレポートをダウンロードするには、次のコマンドを使用します。

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

例

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

ダウンロードしたレポートにカスタマイズが見つかった場合は、レポートのガイダンスに従って、拡張データモデルへの移行後に修正してください。詳細: 標準から拡張データモデルにサイトを移行する際のサイトカスタマイズに関する考慮事項

ステップ 2. 標準から拡張データモデルにサイトデータ移行する

次のコマンドを使用して、サイトデータを拡張データモデルに移行します。

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

モード には 3 つの値があります:

configurationData: Web サイトのメタデータを移行します。詳細: 構成データを格納するテーブルのリスト
configurationDataReferences: Web サイトのトランザクションデータを移行します。詳細: 非構成データを格納するテーブルのリスト
全て: 両方のタイプのデータを移行します。

例

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

移行ツールはソリューションを検証します。上記のテンプレートに対応するそれぞれの拡張データモデルソリューションなしで存在する標準データモデルソリューションがある場合は、警告が表示されます: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

プログラム登録や会議のスケジュールと管理などの特定のテンプレートがあり、移行された Web サイトが適切に機能するためには、拡張データモデルパッケージとの一致が必要です。これらの拡張データモデルパッケージを入手するには、移行用の拡張データモデルと互換性のあるソリューションを提供するために、対応するテンプレートの新しいサイトを作成する必要があります (拡張データモデルに対して環境を有効にする必要があります)。

移行用にサポートされているテンプレート

次のテンプレートを持つサイトは、移行がサポートされています:

スターターレイアウト 1-5
アプリケーションを処理しています
空白ページ
プログラム登録
会議のスケジュールと管理
FAQ

重要

拡張データモデルでは、コミュニティ (Dynamics 365)、カスタマーセルフサービスポータル (Dynamics 365)、Employee Self Service Portal (Dynamics 365)、パートナーポータル (Dynamics 365) テンプレートの 新しい サイト作成がサポートされていますが、標準データモデルを使用してこれらのテンプレートで以前に作成したサイトはまだ移行できません。

ステップ 3. 移行の状態を確認する

サイトの移行状態を確認するには、次のコマンドを使用します:

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

例

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

メモ

サイトの移行に予想より時間がかかる場合は、データ量が原因である可能性があります。コマンドプロンプトが閉じた場合は、新しいコマンドプロンプトを開き、この手順のコマンドを使用してサイトの状態を確認します。

ステップ 4. データ移行が成功したらサイトデータモデルのバージョンを更新する

次のコマンドを使用して、サイトデータモデルのバージョンを更新します:

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

メモ

ポータル id は、Web サイトの URL に '/_services/about' を追加して Web サイトに移動することで見つけることができます。これらのオプションを表示するには、ユーザーにすべての Web サイトのアクセス許可が割り当てられた Web ロールが必要です。
サイトデータモデルのバージョンが更新されると、標準データモデルにリンクされた Web サイトレコードは非アクティブになります。代わりに、サイトは拡張データモデルに関連付けられた Web サイトレコードを参照するようになります。
updateDatamodelVersion または revertToStandardDataModel 引数を指定して移行コマンドを実行するには、ユーザーは次のいずれかのロールが必要です。これにより、管理アクションを実行して、サイトをデータモデルの強化、またはその逆に切り替えます。

例

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

移行したサイトを拡張から標準データモデルに戻す

移行後に標準データモデルサイトを拡張データモデルに戻すには、次のコマンドを使用します:

pac pages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

メモ

移行したサイトを拡張データモデルから標準データモデルに戻すと、拡張データモデルに関連付けられた Web サイトレコードが非アクティブになり、標準データモデルの Web サイトレコードが再びアクティブになります。

例

pac pages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

標準から拡張データモデルに運用サイトを移行する

運用サイトを移行する前に、運用サイトの完全なコピーを作成することをお勧めします。また、運用サイトの移行は営業時間外に実施することをお勧めします。

次の手順を使用して、運用サイトを拡張データモデルに移行します:

PAC CLI migrate-datamodel コマンドを使用して、コピーした環境のサイトで移行を試みます。
サイト構成データを管理ソリューションに追加し、運用環境にインポートします。
PAC CLI コマンドを使用して非構成データを移行し、運用環境のデータモデルバージョンを更新して完了します。

メモ

移行の場合、ソースと運用 Web サイト id は同じです。

標準から拡張データモデルにサイトを移行する際のサイトカスタマイズに関する考慮事項

このセクションでは、標準から拡張データモデルへのサイト移行のためのカスタマイズを修正するガイダンスを提供します。

adx メタデータテーブルには、次の 5 種類のサイトカスタマイズがあります:

adx メタデータテーブルのカスタム列
カスタムテーブルと adx テーブルのリレーションシップ
liquid コードスニペットの Adx テーブル参照
fetch xml での Adx テーブル参照
adx テーブル上のカスタムワークフローとプラグイン

メモ

カスタマイズ関連の修正はすべて、拡張データモデルへの移行後に実行されます。

adx メタデータテーブルのカスタム列

拡張データモデルでこのカスタマイズを修正するには、システムテーブルと新しいカスタムテーブル間のリレーションシップを作成し、データを新しいテーブルに移行します。

標準データモデル: テーブル adx_webpage には、contoso_pagetype としてカスタム列が含まれています。

拡張データモデル:contoso_webpage という名前の新しいテーブルを作成します。これには、contoso_pagetype という列と、contoso_webpage_id に関連付けられたルックアップ列 powerpagescomponent が含まれます。テーブルの作成にデータワークスペースを使用します。

拡張データモデルで contoso_webpage テーブルを作成してコードを修正する

カスタムテーブルと adx テーブルのリレーションシップ

拡張データモデルでこのカスタマイズを修正するには、カスタムテーブルとシステムテーブル間のリレーションシップを作成します。

標準データモデル: テーブル adx_webpage には、adx_webpage_contoso_pagelogs テーブルで contoso_pagelogs という名前のリレーションシップがあります。

拡張データモデル:powerpagecomponent_contoso_pagelogs テーブルで contoso_webpage という名前の新しいリレーションシップを作成します。テーブルの作成にデータワークスペースを使用します。

リキッドコードスニペットにおけるAdxテーブル参照

拡張データモデルでこのカスタマイズを修正するには、liquid コードで adx テーブル参照を拡張データモデル仮想テーブル mspp 参照に置き換えます。あるいは、サイトコンポーネント (論理名 powerpagecomponent) テーブルと コンポーネントタイプ (論理名 powerpagecomponenttype) 属性を使用して、対応する参照を取得することもできます。

標準データモデル:entities liquid タグは、ウェブリンクの値にアクセスするために{% assign app_weblinks= entities['adx_weblinks'] %} コードで使用されます。

拡張データモデル:entities liquid タグによる Web リンクを使用する代わりに、それぞれの liquid オブジェクトを使用します。 entities[adx_weblinks] を直接使用します。この場合、entities['adx_weblinks'] は、weblinks liquid オブジェクトに置き換えることができます。

fetch xml での Adx テーブル参照

拡張データモデルでこのカスタマイズを修正するには、fetch xml の adx テーブル参照を拡張データモデル仮想テーブルの直接参照に置き換えます。あるいは、サイトコンポーネント (論理名 powerpagecomponent) テーブルと コンポーネントタイプ (論理名 powerpagecomponenttype) 属性を使用して、対応する参照を取得することもできます。

標準データモデル: テーブル名 adx_webrole は fetch xml クエリ内で使用されます。

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

拡張データモデル:サイトコンポーネント (論理名 powerpagecomponent) を コンポーネントタイプ (論理名 powerpagecomponenttype) 属性と組み合わせて使用して、対応する参照を取得します。

{% fetchxml app_webroles %}
<fetch>
 <entity name='powerpagecomponent'>
  <attribute name='adx_name'/>
  <filter type='and'>
   <condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
  <entity>
</fetch>
{% endfetchxml %}

サイトコンポーネントの種類と値

コンポーネントの種類	価値
公開状態	1
Web ページ	2
Web ファイル	3
Web リンクセット	4
Web リンク	5
ページテンプレート	6
コンテンツスニペット	7
Web テンプレート	8
サイト設定	9
Web ページアクセス制御ルール	10
Web ロール	11
Web サイトのアクセス	12
サイトマーカー	13
基本フォーム	15
基本フォームメタデータ	16
リスト	17
テーブルのアクセス許可	18
詳細フォーム	19
高機能フォームステップ	20
詳細フォームメタデータ	21
投票配置	24
広告配置	26
ボット利用者	27
列パーミッションプロファイル	28
列のアクセス許可	29
リダイレクト	30
公開状態の移行ルール	31
ショートカット	32
クラウドフロー	33
UX コンポーネント	34

adx テーブル上のカスタムワークフローとプラグイン

拡張データモデルでこのカスタマイズを修正するには、ワークフローとプラグインロジックをリファクタリングし、サイトのそれぞれのテーブルに再登録する必要があります。

たとえば、ユーザーが標準データモデルでワークフロー/プラグインを 主エンティティ に Webページ (論理名 adx_webpage) テーブルとして登録した場合、ワークフロー/プラグイン内のコードは、拡張データモデルでは サイトコンポーネント (論理名 powerpagecomponent) テーブルとその属性に変更する必要があります。

ワークフロー内でサイトコンポーネントテーブルとその属性を拡張データモデルに使用する

既知の問題

移行コマンドは、標準データモデルから拡張データモデルへの 5K レコードのバッチのみを処理します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-08-05

次の方法で共有

標準データ モデル サイトを拡張データ モデルに移行する (プレビュー)

前提条件

ステップ 1. 既存の標準サイト メタデータのカスタマイズをダウンロードして確認する

ステップ 2. 標準から拡張データ モデルにサイト データ移行する

移行用にサポートされているテンプレート

ステップ 3. 移行の状態を確認する

ステップ 4. データ移行が成功したらサイト データ モデルのバージョンを更新する

移行したサイトを拡張から標準データ モデルに戻す

標準から拡張データ モデルに運用サイトを移行する

標準から拡張データ モデルにサイトを移行する際のサイト カスタマイズに関する考慮事項

adx メタデータ テーブルのカスタム列

カスタム テーブルと adx テーブルのリレーションシップ