ポータルの構成を移行する

注意

2022 年 10 月 12 日より、Power Apps ポータルは Power Pages となります。 詳細: Microsoft Power Pages の一般提供が開始されました (ブログ)
Power Apps ポータルのドキュメントは、近日中に Power Pages ドキュメントに移行、統合されます。

ポータル開発には、ポータル エンド ユーザーのための望ましいエクスペリエンスを実現するための、複数の構成およびカスタマイズが含まれます。

Portal インスタンスの開発または構成が完了した後、最新のポータル構成を、開発環境からテスト環境または運用環境へ移行することを希望する場合があります。

移行には、ソースの Microsoft Dataverse 環境からの既存の構成のエクスポートし、その後対象 Dataverse 環境へのそのデータをインポートすることが含まれています。

ターゲット環境を準備する

注意

• ターゲット環境の準備は 1 回限りのプロセスです。 Dataverse にマネージド ポータル ソリューションをにインストールして、ポータル Web アプリケーションを構成するには、新しいポータルをプロビジョニングする必要があります。 このプロセスでは、既定のポータル メタデータもインストールされます。これは、ソース環境のポータル メタデータに置き換えられます。
• ターゲット環境の最大添付ファイルサイズが、ソース環境と同等以上のサイズに設定されていることを確認してください。
• ファイルの最大サイズは、環境システム設定ダイアログ ボックスのシステム設定メールタブの最大ファイルサイズの設定により決定されます。

1. ターゲット環境で新しいポータルをプロビジョニングします。 ソース環境でプロビジョニングしたものと同じポータル テンプレートを使用します。 たとえば、ソース環境のポータルでDynamics 365 カスタマー セルフサービスプロビジョニングした場合、ターゲット環境のポータルで Dynamics 365 カスタマー セルフサービスをプロビジョニングします。

2. ターゲット環境で、ポータル管理アプリを使用して、新しく作成された Web サイト レコードを削除します。 これにより、既定のポータル構成データがターゲット環境から削除されます。

   

3. ターゲット環境で、ポータル アプリを削除します。 これにより、既定のポータルをレンダリングするように現在構成されているポータル アプリが削除されます。

   注意

   ポータル管理アプリは削除しないでください!

   

4. Power Platform CLI または構成移行ツールを使って、ソース環境からポータル メタデータを 移行 します。

5. ターゲット環境で、既存のポータル Web サイト オプションを使用して新しいポータルをプロビジョニングします。 このプロセスでは、ソース環境から転送したポータル構成を使用してポータルを構成します。

   

6. ソース環境からのポータルの更新は、この新しいターゲット環境に反映される必要があります。 今後は、ポータル構成データを転送することで、ソース環境からターゲット環境に構成を転送できるようになるはずです。

ポータル メタデータを転送する

Power Platform CLI

注意

2022 年 10 月 12 日より、Power Apps ポータルは Power Pages となります。 詳細: Microsoft Power Pages の一般提供が開始されました (ブログ)
Power Apps ポータルのドキュメントは、近日中に Power Pages ドキュメントに移行、統合されます。

Power Platform CLI を使用してポータル構成を転送する

Microsoft Power Platform CLI は、特にポータル向けの機能を多く提供しています。 これらのコマンドを使用すると、ポータル構成をソース環境からダウンロードして、ターゲット環境に転送できます。 これらのコマンドは、ALM プロセスに組み込むこともできます。

1. Power Platform CLI 認証プロファイルを作成して、ソース環境とターゲット環境の両方に接続します。 ターゲット環境とソース環境を簡単に識別できるように、名前を付けることができます。

   pac auth create --name [name] --url [environment url]
   

   例

   pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
   

2. 認証プロファイルが作成されると、list コマンドを使用して決定できるインデックスが関連付けられます。

   pac auth list
   

   

3. ソース環境に接続された Power Platform CLI 認証プロファイルを選択します。

   pac auth select --index [source environment index]
   

   例

   pac auth select --index 1
   

4. ソース ポータルの Web サイト ID を決定します。

   pac paportal list
   

   

5. ポータル構成データをローカル ワークステーションにダウンロードします。 以前に同じパスにポータル構成をダウンロードした場合、true に設定した --上書きオプション セットを使用します。

   pac paportal download --path [path] --webSiteId [website id]
   

   例

   pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
   

6. ターゲット環境に接続された Power Platform CLI 認証プロファイルを選択します。

   pac auth select --index [target environment index]
   

   例

   pac auth select --index 2
   

7. ポータル構成データをターゲット環境にアップロードします。

   pac paportal upload --path [path]
   

   例

   pac paportal upload --path "C:\paportals\portaldev"
   

注意

Power Platform CLI ツールは、テーブルまたはテーブル スキーマを移行しません。 構成データが選択したスキーマと一致しない場合、テーブルやフィールドなどの要素が欠落していると、移行が失敗する可能性があります。 インポート中に、ソリューションとして個別にインポートされたテーブル、フィールド、フォーム、ビューなどの追加のカスタマイズを使用して、移行先の環境にすでにインストールされているものと同じポータル タイプが含まれていることを確認します。

構成移行ツール

注意

2022 年 10 月 12 日より、Power Apps ポータルは Power Pages となります。 詳細: Microsoft Power Pages の一般提供が開始されました (ブログ)
Power Apps ポータルのドキュメントは、近日中に Power Pages ドキュメントに移行、統合されます。

構成移行ツールを使用して、ポータル構成を転送する

注意

推奨される方法は、Power Platform CLI を使用して、ポータル メタデータを転送するやり方です。

構成データを移行するには、構成の移行ツールと、ポータル固有の構成スキーマ ファイルを使用する必要があります。 このツールの詳細については、構成データの管理を参照してください。

注意

• 最新のバージョンの Configuration Migration ツールの使用を推奨いたします。 構成移行ツールは NuGet からダウンロードすることができます。 ツールのダウンロードについては、 NuGetからツールをダウンロードを参照してください。
• 構成移行のスキーマ ファイルでサポートされているポータルの最小バージョンのソリューションは、8.4.0.275 です。 ただし、最新バージョンのソリューションを使用することをお勧めします。
• 移行が正常に機能するためには、移行元と移行先の組織のデフォルト言語が同じである必要があります。

スキーマ ファイルは次のポータルの種類に対して使用することができます。

• Dataverse を備えた環境で作成されたポータル

  • カスタム ポータル (空白のポータル)
  • カスタム ポータル (空のポータル) (バージョン 9.2.2103.x 用)
  • カスタム ポータル (空のポータル) (バージョン 9.3.2201.x 以降用)

• Customer Engagement アプリ (Dynamics 365 Sales、Dynamics 365 Customer Service など) を含む環境で作成されたポータル

  • カスタム ポータル (空白のポータル)
  • カスタム ポータル (空のポータル) (バージョン 9.2.2103.x 用)
  • カスタム ポータル (空のポータル) (バージョン 9.3.2201.x 以降用)
  • コミュニティ ポータル
  • 顧客セルフサービス ポータル
  • パートナー ポータル
  • 従業員セルフサービス ポータル

既定のスキーマ ファイルには、すべてのポータル テーブル、関連付け、および各エンティティの一意性の定義に関する情報が含まれています。 詳細については、ポータル構成データのエクスポートを参照してください。

組織データをエクスポートした後、ターゲット環境にそれをインポートする必要があります。 詳細については、ポータル構成データのインポートを参照してください。

注意

構成移行ツールは、スキーマを使用して構成データをエクスポートおよびインポートします。 このツールは、テーブルまたはテーブル スキーマを移行しません。 構成データが選択したスキーマと一致しない場合、テーブルやフィールドなどの要素がないと、移行が失敗する可能性があります。

エクスポート中に、構成移行ツールのスキーマ ファイルで指定されているポータル テーブルがソース環境に含まれていることを確認します。 スキーマ ファイルを変更して、テーブルや属性などを追加、削除、変更して、構成データのサブセットを移行することもできます。

インポート中に、ソリューションとして個別にインポートされたテーブル、フィールド、フォーム、ビューなどの追加のカスタマイズを使用して、移行先の環境にすでにインストールされているものと同じポータル タイプが含まれていることを確認します。

ポータル構成データのエクスポート

ポータル構成データは、ポータル固有の構成データ スキーマ ファイルを使用して、ソース システムからエクスポートすることができます。

1. Configuration Migration ツールをダウンロードして目的のフォルダーに解凍することができます。

2. ユーザーのポータルの種類のために用意された上記のリンクを使用して、ポータル構成スキーマ ファイルをダウンロードします。

3. DataMigrationUtility.exe ファイルを <your_folder>\Tools\ConfigurationMigration フォルダーでダブルクリックして、Configuration Migration ツールを実行し、メイン画面からデータのエクスポートを選択し、続行を選択します。

   

4. ログイン画面で、認証の詳細を提供し、データのエクスポート元の Dataverse 環境に接続します。 データのエクスポート元から Dataverse 環境上に複数の組織を持っている場合、使用可能な組織のリストを表示するチェックボックスをオンにして、ログインを選択します。

   

5. 複数の組織があり、使用可能な組織の一覧を常に表示するチェック ボックスを前のステップでオンにした場合、次の画面で接続する組織を選択することができます。 接続する Dataverse 環境を選択します。

   注意

   複数の組織がない場合、この画面は表示されません。

6. スキーマ ファイルでは、データのエクスポートに使用するポータル固有の構成スキーマ ファイルを参照して選択します。

7. データ ファイルに保存では、エクスポートするデータ ファイルの名前および場所を指定します。

   

8. データのエクスポートを選択します。 クスポートが完了すると、画面の下部に、エクスポートの進行状況とエクスポートされたファイルの場所が表示されます。

   

9. 終了を選択して、ツールを閉じます。

ポータル構成データのインポート

1. Configuration Migration ツールを実行してメイン画面でデータのインポートを選択し、 続行を選択します。

   

2. ログイン画面で、認証の詳細を提供し、データのエクスポート元の Dataverse 環境に接続します。 データのエクスポート元から Dataverse 環境上に複数の組織を持っている場合、使用可能な組織のリストを表示するチェックボックスをオンにして、ログインを選択します。

3. 複数の組織があり、使用可能な組織の一覧を常に表示するチェック ボックスを前のステップでオンにした場合、次の画面で接続する組織を選択することができます。 接続する Dataverse 環境を選択します。

   注意

   • 複数の組織がない場合、この画面は表示されません。
   • 構成をインポートする計画がある組織に、ポータル ソリューションがインストール済みであることを確認します。

4. 次の画面で、インポートするデータ ファイル (.zip) を指定するように求められます。 データ ファイルを参照して選択し、データのインポートを選択します。

   

5. 次の画面にレコードのインポートの状態が表示されます。 データのインポートは複数のパスで実行され、最初に依存データのキュー中に基盤データをインポートし、続くパスで依存データをインポートし、データ依存またはリンクを処理します。 このアクションにより、クリーンで一貫性のあるデータ インポートができます。

6. 終了を選択して、ツールを閉じます。

移行したデータを使用して新しいポータルを作成する

移行プロセスが既存のポータルを更新している場合、更新はターゲット環境に表示されます。 構成が新しいポータル向けの場合、インポートした Web サイトレコードに対して、既存の Web サイトレコードのデータを使用する オプションを使って新しいポータルを作成できるようになりました。 詳細情報: ポータルを作成する

テナントからテナントへの移行

Power Apps ポータルは、テナントからテナントへの移行をサポートしていません。 ポータルをあるテナントから別のテナントに移行するには、次の手順に従う必要があります:

1. ソース テナントのポータルを リセット します。

2. Dataverse または Customer Engagement アプリを含む 環境で新しいポータルをプロビジョニングします。

3. 前にこの記事で説明したステップを使用して、ポータルの構成とカスタマイズを移行します。

関連情報

• Power Apps ポータル構成の変更を追跡。
• Microsoft Power Platform CLI のポータル サポート。
• Power Platform 環境 のテナントからテナントへの移行。
• Sales、Customer Service、Marketing、Field Service、Project Service Automation など、Dynamics 365 の モデル駆動型アプリ のテナントからテナントへの移行。

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。