探索サービスを使用して、ユーザーがメンバーである組織と、それらの各組織の組織サービスにアクセスするためのエンドポイント アドレス URL を特定します。 この検出サービスが必要なのは、Dynamics 365 for Customer Engagement がマルチテナント環境であり、1 つの Dynamics 365 for Customer Engagement サーバーで複数のビジネス組織をホストできるためです。 検出サービスを使用すると、アプリケーションは、対象組織のビジネス データにアクセスするためのエンドポイント アドレス URL を決定できます。
Dynamics 365 for Customer Engagement のインストールでは、データセンターの管理と負荷分散の一環として、サーバーと組織の割り当てが変更される場合があります。 したがって、探索サービスでは、特定の時間に組織にサービスを提供している Dynamics 365 for Customer Engagement サーバーを検出する方法が提供されます。
インターネットに接続するデプロイメント (IFD) インストールの場合、Web サービス URL の形式は次のとおりです。
https://dev.<hostname[:port]>/XRMServices/2011/Discovery.svc
オンプレミス インストールの場合、Web サービス URL の形式は次のとおりです。
http[s]://<hostname[:port]>/XRMServices/2011/Discovery.svc
インストールの正しい URL については、Dynamics 365 for Customer Engagement Web アプリケーションの 開発者向けリソース ページを参照してください。
探索サービスを使用するには、Microsoft.Xrm.Sdk.dll
アセンブリへの参照を Visual Studio プロジェクトに追加し、Microsoft.Xrm.Sdk.Discovery 名前空間にアクセスするための using
ステートメントまたは imports
ステートメントを追加します。
IDiscoveryService インターフェイスはExecuteDiscoveryRequest クラスのインスタンスを渡すために使用するメソッドを提供します。
または、前に説明した URL のサービス参照をプロジェクトに追加することもできます。
関連セクション
Discovery Service と SDK アセンブリの併用
アプリケーションとサーバー拡張機能の記述
開発者リソースページを使用したエンドポイントのダウンロード
Dynamics 365 Customer Engagement の Web サービスへのアクセス
クイックスタート:簡単なプログラム