Microsoft Power Platform CLI のポータル サポート

Microsoft Power Platform CLI (コマンド ライン インターフェース) はコード コンポーネントを作成するための、シンプルでワンストップな開発者向けコマンド ライン インターフェイスです。

Microsoft Power Platform CLI ツーリングは、エンタープライズ開発者と ISV が拡張機能やカスタマイズを、すばやく効率的に作成、構築、デバッグ、および公開できる、包括的なアプリケーション ライフ サイクル (ALM) ストーリーの最初のステップです。 詳細については、Microsoft Power Platform CLI とは? を参照してください

この機能により、Microsoft Power Apps ポータルは、ポータル構成の CI/CD (継続的統合/継続的配置) を有効にする Microsoft Power Platform CLI をサポートします。 ポータル構成をチェック インしてソース管理を行い、Microsoft Power Platform CLI を使用してポータル構成を任意の環境に移動できるようになりました。

ポータル開発に Microsoft Power Platform CLI を使用する理由は何ですか?

ポータルでの Microsoft Power Platform CLI のサポートにより、ポータルのコンテンツを変更することで、ポータルのカスタマイズにオフラインのような機能を使用できるようになりました。 すべてのカスタマイズまたは変更を保存したら、ポータルにアップロードします。 Microsoft Power Platform CLI を使用してポータル コンテンツをダウンロードすると、コンテンツは YAML および HTML 形式で構造化されるため、カスタマイズが容易になり、開発に適したエクスペリエンスを実現できます。

Microsoft Power Platform CLI のサポートによってポータルがメリットを受ける機能のリストを次に示します。

使いやすさ

• ローカル ファイル システムとの間のポータル データのダウンロード/アップロードのサポート

• 既存の Microsoft Power Platform CLI ツールに構築します。

アプリケーション ライフサイクル管理 (ALM)

• 組織内のポータル構成への変更を追跡する

• 組織またはテナント間で構成ファイルを移動します

プロ開発およびエンタープライズ サポート

• 「git」などのソース管理ツールとシームレスに統合できます

• CI/CD パイプラインを簡単に設定できます

Microsoft Power Platform CLI のインストール

詳細な手順については、Microsoft Power Platform CLI をインストール。

サポートするテーブル

Microsoft Power Platform CLI のポータル サポートは、以下の表に限定されます。

ポータルの Microsoft Power Platform CLI をインストールして確認

Microsoft Power Platform CLI インストールについて学習するには、インストール Microsoft Power Platform CLI に移動してください。

Microsoft Power Platform CLI をインストール後、コマンド プロンプトを開き、pac を実行して、出力に「paportal」 - Power Apps ポータルのコマンドが含まれていることを確認します。

ポータルの Microsoft Power Platform CLI コマンド

ポータルのMicrosoft Power Platform CLI コマンドは "paportal" です。

次のセクションでは、"paportal" コマンドの異なるプロパティの詳細を提供します。

Parameters

デプロイ プロファイルを使用する

deploymentProfile スイッチを使用すると、環境の変数のセットを YAML 形式で定義できます。 たとえば、プロファイルで定義されたさまざまなスキーマの詳細を持つ、異なるデプロイ プロファイル (dev、test、prod など) を持つことができます。

テスト プロファイルを作成している場合は、デプロイ プロファイルの下で、「test.deployment.yml」 (つまり、<profileTag>.deployment.yml) を使用してファイルを作成できます。 タグ (<profileTag>) でコマンドを実行し、プロファイルを使用します。

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test

このファイルでは、deploymentProfile パラメータを使用してポータル構成をアップロードする間、テーブル ID、属性リストおよびオーバーライドしたい値を使用してテーブル (エンティティ) 名を持つことができます。

さらに、OS 変数を使用して、オペレーティング システムの環境変数にアクセスできます。

一意のスキーマ詳細を持つ「test.deployment.yml」プロファイル YAML ファイルの例を次に示します。

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

マニフェスト ファイル

pac paportal download CLI コマンドを使用して Web サイトのコンテンツをダウンロードする場合、を使用すると、サイト コンテンツをダウンロードするだけでなく、2 つのマニフェスト ファイルも生成されます。

• 環境マニフェスト ファイル (org-url-manifest.yml)
• 追跡マニフェスト ファイル (manifest.yml) を削除します

環境マニフェスト ファイル (org-url-manifest.yml)

環境マニフェスト ファイルは、pac paportal download コマンドが実行されるたびに生成されます。

ダウンロードのたびに、PAC CLI ツールは既存の環境マニフェストファイルを読み込み、環境内で削除されたエントリーを更新し、環境マニフェストファイルが存在しない場合は作成します。

pac paportal upload コマンドを実行すると、ポータル Web サイトのコンテンツがアップロードされます。 環境マニフェストファイルを読み込んで、前回のダウンロード以降の変更点を特定し、更新されたコンテンツのみをアップロードします。 これは、アップロード コマンドごとにすべてのコンテンツをアップロードするのではなく、更新されたウェブサイトのコンテンツのみをアップロードすることで、アップロード処理を最適化する際に役立ちます。

環境マニフェスト ファイルは、同一環境 (環境 URL とファイル名が一致) に接続した場合、誤って変更されないように、読み取り専用になります。

追跡マニフェスト ファイル (manifest.yml) を削除します

このファイルは、環境から削除されたレコードを追跡するために使用されます。

pac paportal download コマンドを使用して Web サイトのコンテンツをダウンロードすると、削除されたレコードが環境マニフェスト ファイル (org-url-manifest.yml) から manifest.yml ファイルに追加されます。 したがって、pac paportal upload コマンドを使用して Web サイトのコンテンツをアップロードすると、環境からファイルが削除されます (別の環境であっても)。 このファイルは削除されず、接続している環境に関係なく使用されます。

Visual Studio Code 拡張機能を使用する

また、VS Code 拡張機能 Power Platform VS Code 拡張機能を使用して、IntelliSense の組み込みの Liquid 言語、コード補完支援、ヒント、および VS Code 統合ターミナルを使用した Microsoft Power Platform CLI との対話を行うこともできます。 詳細: Visual Studio Code 拡張機能を使用する (プレビュー)

さらに考慮すべきこと

• ファイル パスがパスの最大長の制限を超えると、エラーが報告されます。 詳細: Windows での最大パス長の制限
• 重複する Web ページ名などの重複するレコードの場合、Microsoft Power Platform CLI は 2 つの異なるフォルダー — を作成します。1 つは Web ページの名前、もう 1 つは同じ名前の戦闘にハッシュ コードが付いたフォルダーです。 たとえば、「マイページ」や「マイページ ハッシュコード」。

次の手順

チュートリアル: ポータルで Microsoft Power Platform CLI を使用する

関連項目

• Microsoft Power Platform CLI
• Visual Studio Code 拡張機能を使用する (プレビュー)