次の方法で共有


Visual Studio を使用してプラグイン パッケージを作成および登録する

この記事では、プラグイン パッケージを作成し、それを Dataverse サーバーにアップロードして登録する方法を学習します。 プラグイン パッケージの作成、パッケージのアップロードと登録、その他のパッケージ管理タスクを実行するために Visual Studio と Power Platform Tools エクステンションを使用します。

この記事は次のことに役立ちます。

  • Visual Studio プラグイン プロジェクトの作成
  • 依存アセンブリをプロジェクトに追加してビルドする
  • Visual Studio を使用してパッケージをアップロードして登録する
  • Visual Studio を使用してパッケージを更新および削除する

詳細: プラグイン コードのビルドとパッケージ化

前提条件

  • Dataverse 環境へアクセスする
  • ターゲット環境内のシステム管理者またはシステム カスタマイザーの役割を持つシステム ユーザー アカウント
  • Visual Studio 2019 に Power Platform Tools エクステンションをインストール

Visual Studio の Power Platform Tools のインストールと使用に関連するこれらの記事を参照してください。

Power Platform Tools のプラグイン パッケージを有効にする

Visual Studio 向け Power Platform Tools は、Power Platform Tools オプション の説明に従って、いくつかの構成オプションを提供します。

  1. Visual Studio で ツール>オプション に移動し、Power Platform Tools を検索します。

  2. Dataverse にプラグインをデプロイするために、NuGet パッケージを使用するを選択します

    Dataverse にプラグインをデプロイするために、NuGet パッケージを使用するを選択します。

注意

このオプションを選択すると、すべてのプラグイン プロジェクトがプラグイン パッケージとしてデプロイされます。

依存アセンブリをプロジェクトに追加する

通常どおり、必要な参照を満たす NuGet パッケージを Visual Studio プロジェクトに追加できます。 プロジェクトをビルドすると、bin\outputPackages フォルダーにある NuGet パッケージでにプラグイン アセンブリを見つける必要があります。

NuGet パッケージ エクスプローラーを使用して、生成された NuGet パッケージを調べることができます。

NuGet 使用せずに依存アセンブリを追加する

NuGet パッケージとして配布されていないアセンブリがある場合は、通常どおりプロジェクトに追加できます。 ソリューション エクスプローラーDependencies を右クリックし、アセンブリ参照の追加... を選択します。そして追加したいアセンブリを選択します。

プラグイン パッケージをデプロイする

プラグイン パッケージをデプロイ (アップロードおよび登録) するには、ソリューション エクスプローラーでプラグイン プロジェクトを右クリックし、コンテキスト メニューからデプロイを選択します。コンテキスト メニューから

foo

初めて展開する際は、プラグイン パッケージの作成完了を通知するメッセージが出力ウィンドウに表示されます:

6/22/2022 3:03:17 PM : registration of Plugin Package sample_PowerPlatformVSSolution.ExamplePlugins, 
at E:\projects\PowerPlatformVSSolution\ExamplePlugins\bin\outputPackages\PowerPlatformVSSolution.ExamplePlugins.1.0.0.nupkg was successful. 
ID allotted was 06a20e15-77f2-ec11-bb3c-000d3a892245.

その後デプロイするたびに、プラグイン パッケージが更新されたことを通知するメッセージが出力ウィンドウに表示されます。

6/22/2022 3:20:14 PM : update of Plugin Package sample_PowerPlatformVSSolution.ExamplePlugins, at
E:\projects\PowerPlatformVSSolution\ExamplePlugins\bin\outputPackages\PowerPlatformVSSolution.ExamplePlugins.1.0.0.nupkg was successful.

重要

プラグイン アセンブリやプラグイン ステップの登録で使用するタイプを更新が削除する場合、その更新は拒否されます。 更新で削除するプラグイン アセンブリまたはプラグイン タイプを使用するステップ登録は、手動で削除する必要があります。

プラグイン パッケージやプラグイン アセンブリのバージョンは、アップグレード動作に影響しません。 こうした項目のバージョンは、必要に応じて更新できます。

プラグイン パッケージ管理

Visual Studio では、次のセクションで説明するように、プラグイン パッケージに対して追加の操作を行うことができます。

Power Platform Tools を使用してプラグイン パッケージを表示する

Power Platform エクスプローラーで、使用できるプラグイン パッケージを表示できます。

Power Platform エクスプローラーで、使用できるプラグイン パッケージを表示する

プラグイン パッケージを作成する代替方法

プラグイン パッケージのデプロイで説明されているように、通常はプラグインを作成する通常のフローでプラグイン パッケージを作成する必要はありません。 Visual Studio に プラグインを Dataverse にデプロイするには、NuGet パッケージを使用する オプションが設定されている間、プラグインを初めてデプロイしたときに自動的に作成されます。 ただし、次の手順を使用して、NuGet パッケージから新しいプラグイン パッケージを作成できます。

  1. Power Platform エクスプローラーで プラグイン パッケージ を選択し、コンテキスト メニューから 作成 を選択します。

    Power Platform エクスプローラーでプラグイン パッケージを選択し、コンテキスト メニューから作成を選択します。

  2. このコマンドにより、新しいプラグイン パッケージのインポートダイアログが開きます。

    新しいプラグイン パッケージを ** インポートするダイアログ

  3. NuGet パッケージを選択して、追加するソリューションを選択するか、新しいソリューションを作成します。

プラグイン パッケージを削除する

Power Platform エクスプローラーでプラグイン パッケージを選択し、コンテキスト メニューから削除を選択します。

プラグイン パッケージを選択し、コンテキスト メニューから [削除] を選択します

重要

パッケージの削除すると、パッケージ、パッケージが含むすべてのアセンブリ、アセンブリが含むすべてのプラグイン、プラグインのすべてのプラグイン ステップ登録が削除されます。

プラグイン パッケージを更新する代替方法

プラグイン パッケージのデプロイで説明されているように、通常はプラグインを作成する通常のフローでプラグイン パッケージを更新する必要はありません。 プラグインを Dataverse にデプロイするには、nuget パッケージを使用する オプションが Visual Studio に設定されている間、プラグインをデプロイするたびに自動的に更新されます。 なお、以下の手順で NuGet パッケージから新しいプラグイン パッケージを更新できます。

Power Platform エクスプローラー でプラグイン パッケージを選択し、コンテキスト メニューから 更新 を選択します。

プラグイン パッケージを選択し、コンテキスト メニューから [更新] を選択します

このコマンドによりダイアログが開き、NuGet パッケージを選択してプラグイン パッケージを更新できるようになります。