開発者リソース ページ

Dynamics 365 for Customer Engagement Web アプリケーションの 開発者リソース ページでは、重要なリソースが提供されます。 このページには、Web サービス エンドポイント URL、Azure にアクセスするための証明書、および開発中に必要になる他の組織情報が含まれます。 Web アプリケーションのページにアクセスするには、設定>カスタマイズ をクリックしてから、開発者リソース をクリックします。

このトピックの組織サービスおよび組織データ サービス セクションの URL の例には、OrganizationName が含まれます。 これは、Web アプリケーションにアクセスするときに URL で指定する組織を参照しています。 たとえば、Contoso.crm.dynamics.com の場合、OrganizationName は Contoso です。 ServerName は、ポート番号を含むサーバーの名前を示しています (例: myserver または myserver:5555)。

組織独自の名前

組織の一意の名前を示します。探索サービスと対話するときに必要です。 URL で指定されている名前とは異なる場合があることに注意してください。 この名前は、次のプロパティで見つけることができます。

• 展開 Web サービス: UniqueName

• 検出 Web サービス: UniqueName

• 事前バインド クラスを使用する組織 Web サービス: Organization.UniqueName

  RetrieveOrganizationsRequest メッセージを使用して探索サービスからこれを取得することもできます。

Microsoft Azure Service Bus 発行証明書

Dynamics 365 Customer Engagement (on-premises) 統合用の Azure を構成するために必要な公開証明書へのダウンロード リンクを提供します。 設置型またはインターネットに接続する展開では、Customer Engagement が Azure 統合用に構成した後にのみ、この情報が表示されます。

詳細については、Dynamics 365 Customer Engagement (on-premises) の Azure 拡張機能 を参照してください。

探索サービス

探索サービスの Web サービスでは、 Dynamics 365 Server で入手可能な組織についての情報が提供されます。 この情報には、各組織の Web アドレス (URL) が含まれます。

Dynamics 365 for Customer Engagement の場合

Web API グローバル探索サービスは地域のグループを無視して、利用可能な組織を世界中から取得できるため、通常は Web API グローバル探索サービスを使用する必要があります。 Web API を使用して組織の URL を検出する を参照してください

個々の地域に対して取得する組織をスコープする場合、以下の URL を使用して探索サービスにアクセスします (ユーザーの場所に対して適切な URL を使用)。

設置型 Dynamics 365 Customer Engagement (on-premises) 用

次の URL を使用して探索サービスにアクセスします。

https://ServerName/XRMServices/2011/Discovery.svc

詳細については、組織サービスを使用して組織の URL を検出する を参照してください。

組織サービス

組織サービスでは、組織のビジネス データおよびメタデータへのアクセスが提供されます。 詳細: 組織サービスを使用したデータまたはメタデータの読み取りと書き込み。

Dynamics 365 for Customer Engagement の場合

次の URL を使用して組織サービス にアクセスします:

設置型 Dynamics 365 Customer Engagement (on-premises) 用

次の URL を使用して探索サービスにアクセスします:

http[s]://ServerName/OrganizationName/XRMServices/2011/Organization.svc

組織のデータ サービス

この Open Data (OData v2) Web サービスでは、RESTAPI を使用して、組織のビジネス データへのアクセスが提供されます。 このリンクを使用すると、この API を使用してデータにアクセスする方法が記述されている Conceptual Schema Definition Language (CSDL) ドキュメントが開きます。

Dynamics 365 for Customer Engagement の場合

次の URL を使用して組織データ サービス (ODataREST エンドポイント) にアクセスします。

設置型 Dynamics 365 Customer Engagement (on-premises) 用

次の URL を使用して組織データ サービス (ODataREST エンドポイント) にアクセスします。

http[s]://ServerName/OrganizationName/XRMServices/2011/OrganizationData.svc

WSDL の使用

これらのサービスのサービス参照を Visual Studio プロジェクトに追加するには、サービス参照の追加 ダイアログ ボックスでアドレスを指定する際に、サービス URL に ?WSDL を追加する必要があります。 たとえば、探索サービス Web サービス記述言語 (WSDL) のアドレスは、http[s]://servername/xrmservices/2011/discovery.svc?wsdl となります。

Web サービスでバージョン管理がサポートされます。 WSDL URL で SDK バージョンを指定すると、WSDL で返されるデータの量のスコープが示されます。 Web サービスの SDK バージョン管理の構文は、?singleWSDL&sdkversion=X.X を URL の末尾に使用します。 たとえば、URL は https://mydomain.crm.dynamics.com/xrmservices/2011/discovery.svc?singleWSDL&sdkversion=8.0 になります。 この例では、アプリケーションを v8.0 .NET アセンブリを使用して作成したことになります。

関連項目

Dynamics 365 Customer Engagement Web サービス用コードの記述
IOrganizationService Web サービスを使用したデータまたはメタデータの読み取りと書き込み