既存のサイトを Bootstrap version 5 に移行する

Bootstrap バージョン 5 は、 Power Pages サイトの応答性を高め、カスタマイズを容易にする新機能とアップデートを提供します。

重要

• Bootstrap バージョン3サイトは、サイトの作成に使用されたテンプレートに関係なく、バージョン 5 に移行できます。
• 既存の Bootstrap バージョン 3 サイトをバージョン 5 に移行する場合、標準データ モデルまたは 拡張データ モデル のいずれかを使用できます。
• 開発者サイト で移行をテストすることを検討してください。
• Bootstrap の現在のバージョンを確認するには、Web サイトの bootstrap.min.cssWeb ファイル を参照してください。

Bootstrap バージョン 3 サイトを移行するには、次の手順に従います。

1. Web サイトのフォルダーをダウンロードする.
2. フォルダーで移行ツールを実行します。
3. 変更を確認します。
4. 移行した Web サイトのレコードをアップロードする。
5. サーバー側キャッシュのクリア。

移行手順では Microsoft Power Platform CLI を使用する必要があるため、Power Pages で CLI を使用する方法を必ず理解してください。

• Power Pages の Microsoft Power Platform CLI サポート
• チュートリアル: Power Pages で Microsoft Power Platform CLI を使用する
• pac pages

前提条件

• Microsoft Power Platform CLI バージョン 1.28.2 またはそれ以降をインストールします。

• サイトで SVG ファイルを使用している場合は、Power Platform 環境で ".svg" 拡張子を許可するように 添付ファイルのブロックされたファイル拡張子を設定する システム設定を確認してください。

• Bootstrap バージョン 3 を使用した Power Pages サイトのバージョンを 2 つ作成することを検討してください。 そのうちの 1 つは移行用に使用し、もう 1 つは 移行したサイトと比較する を参照として使用します。

Web サイトのフォルダーをダウンロードする

Microsoft Power Platform CLI バージョン 1.27 以降、pac paportal コマンドは pac pages に変更されています。 paportal は引き続き機能しますが、今後は powerpages を使用することをお勧めします。 これは、次の手順で使用する形式です。 Microsoft Power Platform CLI バージョン 1.26.6 を使用している場合は、pac paportal ではなく pac pages を使用してください。

1. コマンド プロンプトを開きます。

2. 次のコマンドを入力して、Power Platform 環境 の Dataverse 組織に対して認証します: pac auth create -u [Dataverse URL]

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

   詳細: pac auth create

3. 現在の組織が含む Web サイトのリストを生成する際は、次のコマンドを入力します: pac pages list

   移行する予定のサイトの WebSiteId をメモします。

   詳細: pac pages list

4. 次のコマンドを入力して、Web サイトの次のフォルダーをダウンロードします: pac pages download --path [PATH] -id [WebSiteId-GUID]

   例: pac pages download --path "c:\pac-powerpages\downloads" -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

   ID パラメーターには、前のステップでメモした WebSiteId を使用します。

   詳細: pac pages download

フォルダーで移行ツールを実行する

次の pac pages bootstrap-migrate -p "WebsiteFolderPath" コマンドを使用して、ダウンロードした Web サイトのフォルダーでツールを実行します

例: pac pages bootstrap-migrate -p "c:\pac-powerpages\downloads\bootstrap-dev-site"

このコマンドは移行後に、フォルダー名に "V5" が付加された新しいフォルダーを作成します。

Bootstrap バージョン 5 へのアップグレード中に問題が発生した場合、または Bootstrap バージョン 3 に戻したい場合は、Bootstrap バージョン 5 からバージョン 3 に戻す方法を参照してください。

変更の確認

移行前にサイトのコピーを作成した場合は、バージョン 5 のサイトと比較してください。

1. 前の手順で作成した V5 フォルダーを開きます。

2. HTML または CSS ファイルを開きます。

3. Visual Studio Code で、Ctrl+Shift+P を押してコマンド プロンプトを開きます。 bootstrap diff を入力します。

4. バージョン 3 ファイルとバージョン 5 ファイルが開きます。 強調表示された各変更の上にマウスを移動して確認します。

移行した Web サイトのレコードをアップロードする

次のコマンドを入力して、移行した Web サイトのレコードを組織にアップロードします: pac pages upload --path [Folder-location]

例: pac pages upload --path C:\pac-portals\downloads\custom-portal\

詳細: pac pages upload

レコードをアップロードすると、その移行されたサイトは Bootstrap バージョン 5 の Web サイトになります。 サイトをバージョン 3 サイトともう一度比較し、必要に応じて Bootstrap バージョン 5 サイトを変更することをお勧めします。

サーバー側キャッシュのクリア

メタデータ/構成およびデータ テーブルのサーバー側キャッシュをクリアします。

Bootstrap バージョン 5 からバージョン 3 に戻す方法

Bootstrap バージョン 3 に戻すには:

1. upload コマンド を実行して、バージョン 5 のフォルダーを Bootstrap バージョン 3 のフォルダーに置き換えます。 詳細については、pac pages bootstrap-migrate を参照してください
2. ポータル管理アプリ を開き、Site/BootstrapV5Enabled サイト設定を削除します。 詳細については、Web サイトのサイト構成を参照してください。
3. サーバー側キャッシュのクリア。 詳細については、Power Pages におけるサーバー側キャッシュのしくみを参照してください。

参照

• Bootstrap の概要
• Bootstrap バージョン 5 で新しいサイトを作成する
• CSS ファイルを管理する