プラグインとユーザー定義ワークフロー活動は、Dynamics 365 Customer Engagement (on-premises) の既存の機能を拡張するために開発するユーザー定義コードです。 プラグインまたはユーザー定義のワークフロー活動を使用するには、その前にサーバーに登録する必要があります。 プラグインおよびユーザー定義のワークフロー活動登録ツールをダウンロードできます。
プラグインとユーザー定義ワークフロー アセンブリの登録に関する一般的な情報は、Dataverse のトピック プラグインの登録 と アセンブリの登録 にあります。 以下の情報は、オンプレミス プラグイン開発に固有のものです。
このトピックでは主にプラグインに焦点を当てていますが、ほとんどの情報はユーザー定義のワークフロー活動にも適用できます。 この 2 つの違いの 1 つは、ユーザー定義のワークフロー活動アセンブリでは、アセンブリのみを登録することです。 プラグインの場合は、プラグイン アセンブリと、プラグインごとに 1 つ以上のステップを登録します。 ユーザー定義ワークフロー アクティビティの詳細については、「 ユーザー定義ワークフロー アクティビティ (ワークフロー アセンブリ)」を参照してください。
Von Bedeutung
プラグインまたはユーザー定義ワークフロー活動は、信頼できるソースから取得されたものでない限り、登録しないでください。
プラグインストレージ
設置型展開の場合、サンドボックスに登録されていないプラグインは、Dynamics 365 Server のデータベースまたは ディスク上の ファイル システムに保存できます。 運用可能なプラグインは、ディスク上ではなく Dynamics 365 Customer Engagement (on-premises) データベースに保存することを強くお勧めします。 データベースに格納されたプラグインは、データ センター クラスター内の複数の Dynamics 365 Server に自動的に分散されます。 プラグインのディスク上のストレージは、Visual Studio を使用してプラグインをデバッグする場合に便利です。 ただし、データベースに格納されているプラグインをデバッグすることはできます。 詳細については、「 プラグインのデバッグ」を参照してください。
サンドボックスに登録されたプラグインは、Dynamics 365 Customer Engagement (on-premises) の展開 (on-premises、IFD、または Online) に関係なく、データベースに格納する必要があります。
デプロイメント
設置型またはインターネットに接続 (IFD) の Dynamics 365 Customer Engagement (設置型) インストールの場合、別のコンピューターから Dynamics 365 Server ディスクにプラグインを展開するとき (ディスク上の展開)、プラグイン アセンブリは登録前に手動でサーバーにコピーする必要があります。 アセンブリは、プラグインを実行する各サーバーの <installdir>\Program Files\Microsoft CRM\server\bin\assembly フォルダに配置する必要があります。
プラグインの登録は、アセンブリがサーバー上の ...\bin\assembly フォルダーにコピーされた後に行う必要があり、システム ユーザーが Dynamics 365 Customer Engagement (on-premises) でイベントを発生させるが、登録済みのプラグイン アセンブリがまだサーバー上に存在しない状況を防ぐ必要があります。 サーバー データベースのデプロイの場合、プラグイン アセンブリはプラグインの登録時に自動的にコピーされるため、以前の状況では問題になりません。
プラグインの設計によっては、プラグインの実行に他の参照アセンブリが必要な場合があります。 プラグインをデータベースに配置するかディスクに配置するかに関係なく、プラグインで他のアセンブリを実行する必要がある場合は、プラグインを実行する各サーバーのグローバル アセンブリ キャッシュにこれらのアセンブリのコピーを配置する必要があります。
プラグインを開発環境からステージング・サーバーまたは運用サーバーに移動するには
- 開発用コンピューターで、プラグイン コードをビルドします。 デバッグ情報は含めないでください。 プラグインのパフォーマンスを最適化します。
- プラグインを Dynamics 365 Server データベースに登録します。
- Dynamics 365 Customer Engagement (on-premises) Web アプリケーションを使用して、ソリューションを作成するか、既存のソリューションを使用して、そのソリューションにプラグインを追加します。
- ソリューションに他の必要なコンポーネントを追加した後、ソリューションをエクスポートします。
- ソリューションをステージング サーバーまたは運用サーバーにインポートします。
セキュリティ制限
特権を持つユーザーのみがプラグインを登録できるセキュリティ制限があります。サンドボックスに登録されていないプラグイン (独立性) の場合、プラグインの登録に使用するシステム・ユーザー・アカウントが、Deployment Manager の デプロイメント管理者 グループに存在する必要があります。 Deployment Manager を実行できるのは、システム管理者ユーザー アカウント、または 展開管理者 グループに含まれる任意のユーザー アカウントのみです。
Von Bedeutung
分離されていないプラグインの場合、登録しているユーザー アカウントを Deployment Administrators グループに追加しないと、プラグインの登録中に例外がスローされます。 例外の説明には、「SDK エンティティの作成操作を完了するための十分な特権がありません」と記載されています。
サンドボックス (独立モード) に登録されたプラグインの場合、プラグインの登録に使用するシステム・ユーザー・アカウントには、システム管理者ロールが必要です。 Deployment Administrators グループのメンバーシップは必要ありません。
こちらも参照ください
プラグイン開発
プラグインのデバッグ
Dynamics 365 Customer Engagement (on-premises) ソリューションを使用した拡張機能のパッケージ化と配布