Microsoft Dynamics 365 Web サービスの使用

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

Web サービスでは、Microsoft Dynamics 365 (オンラインおよび設置型) のプログラムを記述する際に使用する API が提供されます。 このトピックでは、使用可能な Web サービスを紹介し、それらを理解し、比較するための基本的な情報を提供します。

このトピックの内容

Web API

組織のサービス

組織のデータ サービス

Web サービスの検索

展開 Web サービス

Web API

Web API は、Microsoft Dynamics 365 (オンラインおよび設置型) の新機能であり、Organization サービスのパリティを提供します。

Organization サービスと比較して、Web API はさまざまな言語、プラットフォーム、およびデバイスを通して、より優れた互換性を提供しています。Web API は、OData (オープン データ プロトコル) v4 を実装しています。OData は、RESTful API の多様なデータ ソースを構築して使用するための OASIS 標準規格です。 詳細については、[OData プロトコル] および [OASIS 標準規格] Web サイトを参照してください。

[Web API] がオープン スタンダードに組み込まれるため、[Microsoft Dynamics 365] に特定のクライアント ライブラリを使用する必要はありません。 特定の操作に対する HTTP 要求の作成を選択できるか、またはサードパーティのライブラリを使用して使用する任意の言語またはプラットフォームに対応するクラスを生成することができます。 [使用できるライブラリの一覧] をご覧ください。

最終的には、Web API が Organizationサービス、および Organization Data サービスに置き換えられますが、これら両方の既存の Web サービスは、１ つの Web API へ段階的に移行することが可能になります。Web API は、Microsoft Dynamics 365、および Microsoft Dynamics 365 (オンライン) 将来のバージョンをサポートする新しい開発の最初の選択です。 [Microsoft Dynamics 365] アプリケーション クライアントで実行される Web リソースとフォーム スクリプトから、[XmlHttpRequests] を含むサーバー上で実行されない [Microsoft Dynamics 365] データやコードにアクセスするすべてのプロジェクトには、[Web API] を使用します。 この時点で、プラグインまたはワークフロー アセンブリなどのサーバーで実行される [Web API] コードを容易に使用することはできません。

詳細:Microsoft Dynamics 365 Web API の使用

組織のサービス

Organization サービス、またはSOAP エンドポイントとしても知られるサービスは、Microsoft Dynamics CRM 2011 以降使用されてきました。 これは Microsoft Dynamics 365 を使用している多くの開発者にとって、使い慣れている Web サービスです。Organization サービスは、.NET 用に最適化されています。Microsoft Dynamics 365 SDK はアセンブリとツールのセットを提供し、厳密に型指定されたクラスや、開発プロセスを合理化するプロキシを生成することができ、Microsoft Visual Studio を使用したより優れた開発経験を提供します。 .NET 開発者で、他のプラットフォームをサポートする必要がない場合、Web API に今すぐ移行する必要はありません。Microsoft Dynamics 365 より以前にリリースされたMicrosoft Dynamics 365 バージョンを使用して、組織に展開したいすべての機能をサポートするための Organization サービスを使用する必要があります。

サーバー上のプラグインまたはワークフロー アセンブリで実行するビジネス ロジックは、Organization サービスを使用することになります。 入力および出力パラメーターは、Organization サービスをサポートするアセンブリで定義される特定のクラスを使用します。

詳細:Microsoft Dynamics 365 組織サービスの使用

組織のデータ サービス

Organization Data サービスは、OData や REST エンドポイントとしても知られ、Microsoft Dynamics CRM 2011 以降で利用できます。 このサービスは、OData v2 標準規格を実行します。 このサービスは、Microsoft Dynamics 365 を廃止する予定の年までは引き続き利用可能となります。Organization Data サービスでは、作成、読み取り、更新、削除操作の実行を限定しており、Organization サービスでは、特殊なメッセージを呼び出す機能はサポートされていません。そのため、組織サービスの機能を持つパリティに到達することはできません。 OData 標準の v2 と v4 の間で実装された変更は、組織サービスとパリティを持つサービスの要件に適合するためのサービスのアップグレードに対応しません。 受け取った多くの組織データ サービスに関するフィードバックを適用することにより、より優れた Web API の適用が可能になりました。

この Microsoft Dynamics 365 SDK リリースには、組織データ サービスに関する情報は含まれていません。 [Web リソースで OData エンドポイントを使用する] で [Microsoft Dynamics CRM 2015] リリースのドキュメントにある組織データ サービスに関する情報を参照してください。

Web サービスの検索

Microsoft Dynamics 365 は、マルチテナント型のアプリケーションです。 これは、単一の展開が Dynamics 365 の複数インスタンス、および異なった URL 経由で利用できる独自のデータのインスタンスでホストできることを意味します。 さらに、Microsoft Dynamics 365 サーバーがデータ センターでホストされている場合は特に、特定サーバーはリソースの移動や負荷分散を変更することができます。 検索 Web サービスは、独自のユーザー アカウントに接続できるようサーバーと組織を通して検出する方法をクライアントに提供します。 [Web API Discovery] サービス、または [IDiscoveryService] Web サービスの使用を選択することができます。 [Web API Discovery] サービスは、[Web API] と同様のメリットを提供し、言語や、プラットフォーム、およびデバイスのプログラミングを広範囲に使用することが容易となります。

詳細:Web API を使用して組織の URL を検出します または 組織サービスを使用して組織の URL を検出する

展開 Web サービス

Dynamics 365 (設置型) では、展開 Web サービスを使用して展開をプログラムで管理するための操作を実行できます。 これらは、サーバーにインストールされている展開マネージャー ツール クライアントを使用してサーバーで実行できる操作と、基本的に同じです。 作成、インポート、または組織の削除、およびコードに特定の設定を適用することもできます。 これは、ホスティング サービスの提供や、テスト環境作成の自動化など、特定のプロセスを自動化したい場合に役立つ可能性があります。

詳細:展開 Web サービスの概要。

関連項目

Microsoft Dynamics 365 に接続
Microsoft Dynamics 365 でユーザーを認証する
Use Microsoft Dynamics 365 web services
XRM ツールを使用して Windows のクライアント アプリケーションを作成する
モバイル アプリやモダン アプリを作成する

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権