Power Apps Component Framework

  • [アーティクル]

Power Apps メーカーがアクセス可能にするには、Power Apps Component Framework のコンポーネントをソリューションにパッケージ化し、エクスポートしてから、Dataverse で Power Apps 環境にインポートします。 次のセクションでは、その方法について説明します。

コード コンポーネントで ALM 手法を使用する方法の詳細については、コード コンポーネント アプリケーション ライフ サイクル管理 (ALM) を参照してください。

コード コンポーネントのパッケージ化および展開

このセクションでは、コンポーネントが Power Apps メーカーを利用できるよう、コード コンポーネントを Microsoft Dataverse にインポートする方法を説明します。　

Power Platform CLI を使用してコード コンポーネントを実装した後、次のステップは、すべてのコード コンポーネントの要素をソリューション ファイルにパックし、ソリューション ファイルを Dataverse にインポートします。これにより、メーカーのランタイム エクスペリエンスでコード コンポーネントを確認できます。

ソリューション ファイルを作成およびインポートするには:

  1. cdsproj ファイルのあるフォルダ内に新しいフォルダーを作成し、CLI コマンド mkdir Solutions を使用して名前を ソリューション (または任意の名前) と名付けます。 コマンドcd Solutions を使用して、ディレクトリに移動します。

  2. 以下のコマンドを使用して、新しいソリューション プロジェクトを作成します。 ソリューション プロジェクトは、Dataverse へのインポートに使用されるソリューション zip (圧縮) ファイルにコード コンポーネントをバンドルするために使用されます。

    pac solution init --publisher-name \<enter your publisher name\>
--publisher-prefix \<enter your publisher prefix\>

    Note

    publisher-name と publisher-prefix の値は環境に特化したものである必要があります。 詳細: ソリューション発行者 およびソリューション発行者の接頭辞

  3. 新しいソリューション プロジェクトの作成後は、ソリューション フォルダーを参照して、作成したサンプル コンポーネントが配置されている場所に移動します。 以下に表示されているコマンドを使用して参照を追加することができます。 この参照は、コード コンポーネントがビルド中に追加すべきソリューションのプロジェクトを通知します。 参照を 1 つのソリューションのプロジェクトの複数コンポーネントへ追加できます。

    pac solution add-reference --path \<path to your Power Apps component framework project\>
```dotnetcli

  4. ソリューション プロジェクトから zip ファイルを生成するには、ソリューション プロジェクトのディレクトリに移動して、以下のコマンドを使用してプロジェクトを構築する必要があります。 このコマンドは MSBuild プログラムを使用して、復元の一部として NuGet の依存関係をプルダウンすることで、ソリューション プロジェクトを構築します。 初めてソリューション プロジェクトを構築する際には /restore のみを使用します。 その後の各ビルドに対しては、コマンド msbuild を実行できます。

    msbuild /t:build /restore

    チップ

    • MSBuild 15.9.* がパスに存在しない場合は、Visual Studio 2017 向け Developer Command Prompt を開き msbuild コマンドを実行します。
    • デバッグ 構成でソリューションをビルドして、アンマネージド ソリューション パッケージを生成します。 管理ソリューション パッケージは、リリース 構成でソリューションを構築することにより生成されます。 これらの設定は、cdsprojfile.cdsproj ファイルで SolutionPackageType プロパティを指定してオーバーライドできます。
    • msbuild の構成を リリース に設定すると、本番ビルドを発行することができます。 例: msbuild /p:configuration=Release
    • ソリューションで msbuild コマンドが実行されている際に、「あいまいなプロジェクト名」 というエラーが発生された場合、ソリューション名とプロジェクト名が同じ名前でないことを確認してください。

  5. ビルドが成功すると、生成されたソリューション ファイルが  \bin\debug\ (または \bin\release) フォルダーに配置されます。

  6. Microsoft Power Platform ビルド ツールを使用して、Dataverse 環境へのソリューションのインポートを自動化することができます。それ以外の方法としては、Web ポータルを使用して手動でDataverse にソリューションをインポートすることができます。

フレームワークとソリューションで実行できる追加のタスク

以下は、フレームワークとソリューションを操作するときに実行可能な追加の一般的なタスクへのリンクです。

関連項目

プラグイン