コード コンポーネントをパッケージ化する

コード コンポーネントをソリューション ファイルにパッケージ化し、実行時に使用できるようにMicrosoft Dataverseにインポートする方法について説明します。 また、環境に接続する方法、Microsoft Power Platform CLI を使用して更新プログラムをデプロイする方法、ソリューションからコンポーネントを削除する方法についても説明します。

Process

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

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

  2. pac solution init コマンドを使用して、新しいソリューション プロジェクトを作成します。 Dataverse にインポートするソリューション ZIP ファイルにコード コンポーネントをバンドルする場合は、ソリューション プロジェクトを使用します。

    pac solution init --publisher-name developer --publisher-prefix dev

    ヒント

    publisher-name と publisher-prefix の値は環境に固有である必要があります。

  3. 新しいソリューション プロジェクトを作成したら、 ソリューション フォルダーを作成したサンプル コンポーネントの場所として設定します。 pac ソリューションの add-reference コマンドを使用して参照を追加します。 このリファレンスは、ビルド中に追加するコード コンポーネントについてソリューション プロジェクトに通知します。 参照を 1 つのソリューションのプロジェクトの複数コンポーネントへ追加できます。

     pac solution add-reference --path c:\downloads\mysamplecomponent

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

    msbuild /t:restore

    msbuild

    または、.NET SDK バージョン 6 以降をインストールしている場合:

    dotnet build

    ヒント

    • msbuild 15.9.* がパスにない場合は、VS 2017 の開発者コマンド プロンプトを開き、 msbuild コマンドを実行します。
    • デバッグ 構成でソリューションをビルドして、アンマネージド ソリューション パッケージを生成します。 リリース構成でソリューションをビルドすると、マネージド ソリューション パッケージが生成されます。 これらの設定は、cdsproj ファイルで SolutionPackageType プロパティを指定することでオーバーライドできます。
    • 実稼働ビルドを発行するには、msbuild 構成を Release に設定します。 例: msbuild /p:configuration=Release
    • ソリューションで msbuild コマンドを実行するときに、あいまいなプロジェクト名というエラーが発生した場合は、ソリューション名とプロジェクト名が同じでないことを確認します。

  5. ビルドが成功したら、 \bin\debug\ フォルダー内で生成されたソリューション ファイルを見つけます。

  6. Web ポータルを使用して手動で Dataverse にソリューションをインポートするか、Microsoft Power Platform ビルド ツールを使用して自動的にソリューションをインポートします。

環境に接続する

コード コンポーネントは、Dataverse 環境に接続して、その後その更新されたコンポーネントをプッシュすることで Microsoft Power Platform CLI から直接デプロイできます。

次の一覧の手順に従って認証プロファイルを作成し、Dataverse に接続し、更新されたコンポーネントをプッシュします。

  1. pac auth create コマンドを使用して認証プロファイルを作成します。

    pac auth create --url https://xyz.crm.dynamics.com

  2. 以前に認証プロファイルを作成した場合は、 pac auth list コマンドを使用して既存のすべてのプロファイルを表示します。

     pac auth list

  3. pac auth select コマンドを使用して、以前に作成した認証プロファイルを切り替えます。

     pac auth select --index <index of the active profile>

  4. pac org who コマンドを使用して、環境に関する基本情報を取得します。 接続では、既定の認証プロファイルが使用されます。

    pac org who

  5. pac auth delete コマンドとpac auth delete --index <index of the profile>構文を使用して、特定の認証プロファイルを削除します。

  6. pac auth clear コマンドを使用して、ローカル コンピューターからすべての認証プロファイルをクリアします。 この操作は、ローカル コンピュータから完全に authprofile.json ファイルやトークン キャッシュ ファイルを削除するため不可逆です。

コード コンポーネントをデプロイする

認証プロファイルを作成したら、すべての最新の変更を含むコード コンポーネントを Dataverse インスタンスにプッシュし始めます。

push機能は、コード コンポーネントのバージョン管理要件をバイパスし、コード コンポーネントをインポートするためにソリューション (cdsproj) をビルドする必要がないため、開発者の内部サイクル開発を高速化します。

push機能を使用するには、次の手順に従います。

  1. 有効な認証プロファイルがあることを確認します。

  2. サンプル コンポーネント ファイルがあるディレクトリに移動します。

  3. pac pcf push コマンドを実行します。

    pac pcf push --publisher-prefix <your publisher prefix>

    ヒント

    push コマンドで使用するパブリッシャー プレフィックスは、コンポーネントを含めるソリューションのパブリッシャー プレフィックスと一致している必要があります。

ソリューションからのコンポーネントの削除

ソリューション ファイルからコード コンポーネントを削除したい場合:

  1. ソリューション プロジェクト ディレクトリの cdsproj ファイルを編集し、コンポーネントへの参照を削除します。 コンポーネント参照の例を次に示します。

    <ItemGroup>
    <Projectreference Include="..\pcf_component\pcf_component.pcfproj">
      <Project>0481bd83-ffb0-4b70-b526-e0b3dd63e7ef</Project>
      <Name>pcf_component</Name>
      <Targets>Build</Targets>
      <referenceOutputAssembly>false</referenceOutputAssembly>
      <OutputItemType>Content</OutputItemType>
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </Projectreference>
</ItemGroup>

  2. 次のコマンドを使用してリビルド (またはクリーン) を実行します。

    msbuild /t:rebuild

関連項目

モデル駆動型アプリの列またはテーブルにコードコンポーネントを追加する
キャンバス アプリにコンポーネントを追加する
Power Apps Component Framework API の参照
Power Apps Component Framework の概要
Microsoft Power Platform CLI コマンド グループ

  • Last updated on