既存のサイトを Bootstrap バージョン 5 に移行する (プレビュー)
このトピックはプレリリース ドキュメントであり、変更される場合があります。
Bootstrap バージョン 5 は、 Power Pages サイトの応答性を高め、カスタマイズを容易にする新機能とアップデートを提供します。
重要
- これはプレビュー機能です。
- プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。
- Bootstrap バージョン3サイトは、サイトの作成に使用されたテンプレートに関係なく、バージョン 5 に移行できます。
- 既存の Bootstrap バージョン 3 サイトをバージョン 5 に移行する場合、標準データ モデルまたは 拡張データ モデル のいずれかを使用できます。
- 開発者サイト で移行をテストすることを検討してください。
- Bootstrap の現在のバージョンを確認するには、Web サイトの bootstrap.min.cssWeb ファイル を参照してください。
Bootstrap バージョン 3 サイトを移行するには、次の手順に従います。
移行手順では Microsoft Power Platform CLI を使用する必要があるため、Power Pages で CLI を使用する方法を必ず理解してください。
- Power Pages の Microsoft Power Platform CLI サポート
- チュートリアル: Power Pages で Microsoft Power Platform CLI を使用する
pac powerpages
前提条件
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 powerpages
に変更されています。
paportal
引き続き機能しますが、今後は powerpages
を使用することをお勧めします。 これは、次の手順で使用する形式です。 Microsoft Power Platform CLI バージョン 1.26.6 を使用している場合は、pac paportal
ではなく pac powerpages
を使用してください。
コマンド プロンプトを開きます。
次のコマンドを入力して、Power Platform 環境 の Dataverse 組織に対して認証します:
pac auth create -u [Dataverse URL]
例:
pac auth create -u https://contoso-org.crm.dynamics.com
詳細:
pac auth create
現在の組織が含む Web サイトのリストを生成する際は、次のコマンドを入力します:
pac powerpages list
移行する予定のサイトの WebSiteId をメモします。
次のコマンドを入力して、Web サイトの次のフォルダーをダウンロードします:
pac powerpages download --path [PATH] -id [WebSiteId-GUID]
例:
pac powerpages download --path "c:\pac-powerpages\downloads" -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141
ID パラメーターには、前のステップでメモした WebSiteId を使用します。
フォルダーで移行ツールを実行する
次の pac powerpages bootstrap-migrate -p "WebsiteFolderPath"
コマンドを使用して、ダウンロードした Web サイトのフォルダーでツールを実行します
例: pac powerpages bootstrap-migrate -p "c:\pac-powerpages\downloads\bootstrap-dev-site"
このコマンドは移行後に、フォルダー名に "V5" が付加された新しいフォルダーを作成します。
Bootstrap バージョン 5 からバージョン 3 に戻すには、アップロード コマンド を使用して、バージョン 5 フォルダを Bootstrap バージョン 3 フォルダに置き換えます。
詳細: pac powerpages bootstrap-migrate
変更の確認
移行前にサイトのコピーを作成した場合は、バージョン 5 のサイトと比較してください。
前の手順で作成した V5 フォルダーを開きます。
HTML または CSS ファイルを開きます。
Visual Studio Code で、Ctrl+Shift+P を押してコマンド プロンプトを開きます。
bootstrap diff
を入力します。バージョン 3 ファイルとバージョン 5 ファイルが開きます。 強調表示された各変更の上にマウスを移動して確認します。
移行した Web サイトのレコードをアップロードする
次のコマンドを入力して、移行した Web サイトのレコードを組織にアップロードします: pac powerpages upload --path [Folder-location]
例: pac powerpages upload --path C:\pac-portals\downloads\custom-portal\
レコードをアップロードすると、その移行されたサイトは Bootstrap バージョン 5 の Web サイトになります。 サイトをバージョン 3 サイトともう一度比較し、必要に応じて Bootstrap バージョン 5 サイトを変更することをお勧めします。
サーバー側キャッシュのクリア
メタデータ/構成およびデータ テーブルのサーバー側キャッシュをクリアします。