Dynamics 365 Customer Engagement (on-premises) Web サービスの使用
Web サービスでは、Dynamics 365 Customer Engagement (on-premises) のプログラムを記述する際に使用する API が提供されます。 このトピックでは、使用可能な Web サービスを紹介し、それらを理解し、比較するための基本的な情報を提供します。
Web API
Web API はバージョン 8.0 で導入され、付加的に更新されて、組織サービスにパリティを提供するようになりました。 このリリースでは、パリティが得られました。
組織サービスと比較して、Web API はさまざまな言語、プラットフォーム、およびデバイスを通して、より優れた互換性を提供しています。 Web API は OData (オープン データ プロトコル) v4 を実装します。 OData は、リッチなデータ ソースに対して RESTful API を作成して使用するための OASIS 標準規格です。 詳細については、[OData プロトコル] および [OASIS 標準規格] Web サイトを参照してください。
Web API がオープン スタンダードに組み込まれるため、Dynamics 365 Customer Engagement (on-premises) に特定のクライアント ライブラリを使用する必要はありません。 特定の操作に対する HTTP 要求の作成を選択できるか、またはサードパーティのライブラリを使用して使用する任意の言語またはプラットフォームに対応するクラスを生成することができます。 「使用できるライブラリの一覧」をご覧ください。
最終的には、Web API が組織サービス、および組織データ サービスに置き換えられますが、これら両方の既存の Web サービスは、１ つの Web API へ段階的に移行することが可能になります。 Web API は、Dynamics 365 Customer Engagement (on-premises) および将来のバージョンの Dynamics 365 Customer Engagement (on-premises) をサポートする新しい開発の最初の選択です。 Dynamics 365 Customer Engagement (on-premises) アプリケーション クライアントで実行される Web リソースとフォーム スクリプトからの要求を含む、サーバー上で実行されないコードを使用して Dynamics 365 Customer Engagement (on-premises) データにアクセスするすべてのプロジェクトに対して、Web API を使用します。 この時点で、プラグインまたはワークフロー アセンブリなどのサーバーで実行される Web API コードを容易に使用することはできません。 これらの目的に対して組織サービスの使用を続ける必要があります。
詳細 : Web API を使用した Dynamics 365 Customer Engagement の使用
組織サービス
組織サービスは、Dynamics CRM 2011 のときから使用できるようになりました。 これは Dynamics 365 Customer Engagement (on-premises) を使用している多くの開発者にとって、使い慣れている Web サービスです。 組織サービスには、.NET での使用向けに最適化されています。 .NET アセンブリとツールのセットがあり、厳密に型指定されたクラスや、開発プロセスを合理化するプロキシを生成することができ、Visual Studio を使用したより優れた開発経験を提供します。
組織サービスへのアクセスを可能にする SDK for .NET アセンブリは、現在非推奨となっている 2011 SOAP エンドポイントを使用しています。 最終的には、SDK アセンブリは 2011 SOAP エンドポイントの代わりに Web API を内部的に使用するように移行されます。 この場合、SDK アセンブリを使用して記述されたコードは、2011 年の SOAP エンドポイントから Web API の使用に自動的に移行されるため、引き続きサポートされます。 この更新は、アプリケーションのランタイム フォルダー SDK アセンブリを改訂版アセンブリに置き換えるだけで、ほぼ透過的に行うことができます。 .NET Core 開発に関する追加の詳細と新しい情報については、アプリを Dataverse ServiceClient に移行するを参照してください。
組織サービスまたは Web API を使用するかどうかに関するガイダンスについては、開発スタイルの選択 を参照してください。
.NET 開発者で、他のプラットフォームをサポートする必要がない場合、Web API に今すぐ移行する必要はありません。 組織サービスを使用して、Web API が利用可能になる前にリリースされた Dynamics 365 Customer Engagement (on-premises) の古いバージョンを使用して組織に展開する機能をサポートできます。
サーバー上のプラグインまたはワークフロー アセンブリで実行するビジネス ロジックは、組織サービスを使用することになります。 入力および出力パラメーターは、組織サービスをサポートするアセンブリで定義される特定のクラスを使用します。
詳細: Dynamics 365 Customer Engagement (on-premises) 組織サービスを使用する
組織のデータ サービス
組織データ サービスは、“OData” または “REST” エンドポイントとしても知られ、Dynamics CRM 2011 以降で利用できます。 このサービスは、OData v2 標準規格を実行します。 このサービスは今後何年もそのまま利用できますが、Dynamics 365 Customer Engagement (on-premises) では廃止されます。 組織データ サービスでは、作成、読み取り、更新、削除操作の実行を限定しており、組織サービスでは、特殊なメッセージを呼び出す機能はサポートされていません。そのため、組織サービスの機能を持つパリティに到達することはできません。 OData 標準の v2 と v4 の間で実装された変更は、組織サービスとパリティを持つサービスの要件に適合するためのサービスのアップグレードに対応しません。 受け取った多くの組織データ サービスに関するフィードバックを適用することにより、より優れた Web API の適用が可能になりました。
この Dynamics 365 Customer Engagement Web サービスリリースには、組織データ サービスに関する情報は含まれていません。 「Web リソースで OData エンドポイントを使用する」 Dynamics CRM 2015 リリースのドキュメントにある組織データ サービスに関する情報を参照してください。
Web サービスの検索
Dynamics 365 Customer Engagement (on-premises) は、マルチテナント型のアプリケーションです。 これは、単一の展開が Customer Engagement (on-premises) の複数インスタンス、および異なった URL 経由で利用できる独自のデータのインスタンスでホストできることを意味します。 さらに、Dynamics 365 Server がデータ センターでホストされている場合は特に、特定サーバーはリソースの移動や負荷分散を変更することができます。 検索 Web サービスは、独自のユーザー アカウントに接続できるようサーバーと組織を通して検出する方法をクライアントに提供します。 Discovery Web サービスへのアクセスには、OData V4 ベースの Web API または SDK アセンブリ API のいずれかを選択することができます。 どちらの API も同様の機能を提供しますが、Web API はより幅広いプログラミング言語、プラットフォーム、デバイスで利用しやすくなっています。
詳細 : Web API を使用して組織の URL を検出する、または IDiscoveryService Web サービスにより組織の URL を検出する
展開 Web サービス
Dynamics 365 Customer Engagement (on-premises) では、展開 Web サービスを使用して展開をプログラムで管理するための操作を実行できます。 これらは、サーバーにインストールされている展開マネージャー ツール クライアントを使用してサーバーで実行できる操作と、基本的に同じです。 作成、インポート、または組織の削除、およびコードに特定の設定を適用することもできます。 これは、ホスティング サービスの提供や、テスト環境作成の自動化など、特定のプロセスを自動化したい場合に役立つ可能性があります。
関連項目
Dynamics 365 Customer Engagement でのユーザーの認証
Dynamics 365 Customer Engagement (on-premises) に対してユーザーを認証する
Dynamics 365 Customer Engagement Web サービスを使用する
XRM ツールを使用して Windows のクライアント アプリケーションを作成する
モデル駆動型アプリの開発者ガイド