Entwicklerressourcenseite
Auf der Seite Ressourcen für Entwickler in der Webanwendung Dynamics 365 for Customer Engagement finden Sie wichtige Ressourcen. Auf dieser Seite finden Sie die URLs der Webservice-Endpunkte, ein Zertifikat für den Zugriff auf Azure und andere Organisationsinformationen, die Sie während der Entwicklung benötigen. Um auf die Seite in der Webanwendung zuzugreifen, wählen Sie Einstellungen>Anpassungen und klicken Sie dann auf Entwicklerressourcen.
Für die Abschnitte "Organisationsservice" und "Organisationsdatendienst" in diesem Thema, enthalten die Beispiel-URLs einen OrganizationName. Dieser bezieht sich auf die Organisation, die Sie in der URL angeben, wenn Sie auf die Webanwendung zugreifen. So ist beispielsweise für contoso.crm.dynamics.com der OrganizationName Contoso.
ServerName bezieht sich auf den Namen des Servers, einschließlich der Port-Nummer, zum Beispiel myserver oder myserver:5555.
Eindeutiger Name der Organisation
Zeigt den eindeutigen Namen Ihrer Organisation, der bei der Interaktion mit dem Suchdienst erforderlich ist. Beachten Sie, dass dieser möglicherweise nicht mit dem Namen identisch ist, der in der URL angegeben ist. Dieser Name ist in folgenden Eigenschaften gespeichert:
Bereitstellungswebdienst: UniqueName
Bereitstellungswebdienst: UniqueName
Organisationswebdienst mithilfe von Klassen mit früher Bindung:
Organization.UniqueNameSie können das auch mithilfe der RetrieveOrganizationsRequest-Message vom Bereitstellungsdienst abrufen.
Microsoft Azure Servicebus-Ausstellerzertifikat
Bietet einen Download-Link zum öffentlichen Zertifikat, das für die Konfiguration von Azure für die Dynamics 365 Customer Engagement (on-premises)-Integration erforderlich ist. Bei einem lokalen oder Internet-facing deployment ist diese Information erst sichtbar, nachdem Customer Engagement für die Azure-Integration konfiguriert wurde.
Weitere Informationen finden Sie unter Azure Erweiterungen für Dynamics 365 Customer Engagement (on-premises).
Suchdienst
Der Suchdienst-Webdienst bietet Informationen zu den auf dem Dynamics 365 Server verfügbaren Organisationen. Diese Informationen enthalten die Webadressen (URL) jeder Organisation.
Für Dynamics 365 for Customer Engagement
Sie sollten generell den globalen Web-API-Suchdienst verwenden, da dieser regionale Gruppierungen ignoriert und es Ihnen ermöglicht, verfügbare Organisationen weltweit abzurufen. Informationen finden Sie unter Ermitteln Sie die URL für Ihre Organisation mithilfe der Web-API
Wenn Sie die Organisationen genau betrachten möchten, um für die einzelnen Regionen abzurufen, verwenden Sie die folgenden URLs, um auf den Suchdienst zuzugreifen (verwenden Sie die entsprechende URL für Ihren Standort).
| Ort | Suchwebdienst-URL |
|---|---|
| Nordamerika | https://disco.crm.dynamics.com/XRMServices/2011/Discovery.svc |
| Nordamerika 2 (GCC) | https://disco.crm9.dynamics.com/XRMServices/2011/Discovery.svc |
| Europa, Naher Osten und Afrika (EMEA) | https://disco.crm4.dynamics.com/XRMServices/2011/Discovery.svc |
| Asien-Pazifik (APAC) | https://disco.crm5.dynamics.com/XRMServices/2011/Discovery.svc |
| Ozeanien | https://disco.crm6.dynamics.com/XRMServices/2011/Discovery.svc |
| Japan (JPN) | https://disco.crm7.dynamics.com/XRMServices/2011/Discovery.svc |
| Südamerika | https://disco.crm2.dynamics.com/XRMServices/2011/Discovery.svc |
| Indien (IND) | https://disco.crm8.dynamics.com/XRMServices/2011/Discovery.svc |
| Kanada | https://disco.crm3.dynamics.com/XRMServices/2011/Discovery.svc |
| Vereinigtes Königreich | https://disco.crm11.dynamics.com/XRMServices/2011/Discovery.svc |
| Frankreich | https://disco.crm12.dynamics.com/XRMServices/2011/Discovery.svc |
| US Gov High (GCC High) | https://disco.crm.microsoftdynamics.us/XRMServices/2011/Discovery.svc |
Für Dynamics 365 Customer Engagement (on-premises) (lokal)
Verwenden Sie die folgende URL, um auf den Suchdienst zuzugreifen:
https://ServerName/XRMServices/2011/Discovery.svc
Für weitere Informationen, siehe Ermitteln der URL für Ihre Organisation mit dem Organisationsdienst.
Organisationsservice
Der Organisationsdienst bietet Zugriff auf Geschäfts- und Metadaten Ihrer Organisation. Weitere Informationen: Nutzen Sie den Organization Service zum Lesen und Schreiben von Daten oder Metadaten.
Für Dynamics 365 for Customer Engagement
Verwenden Sie die folgenden URLs, um auf den Organisationsdienst zuzugreifen:
| Region | URL |
|---|---|
| Nordamerika | https://OrganizationName.api.crm.dynamics.com/XrmServices/2011/Organization.svc |
| Nordamerika 2 | https://OrganizationName.api.crm9.dynamics.com/XrmServices/2011/Organization.svc |
| Südamerika | https://OrganizationName.api.crm2.dynamics.com/XrmServices/2011/Organization.svc |
| Kanada | https://OrganizationName.api.crm3.dynamics.com/XrmServices/2011/Organization.svc |
| EMEA | https://OrganizationName.api.crm4.dynamics.com/XrmServices/2011/Organization.svc |
| APAC | https://OrganizationName.api.crm5.dynamics.com/XrmServices/2011/Organization.svc |
| Ozeanien | https://OrganizationName.api.crm6.dynamics.com/XrmServices/2011/Organization.svc |
| Japan | https://OrganizationName.api.crm7.dynamics.com/XrmServices/2011/Organization.svc |
| Indien | https://OrganizationName.api.crm8.dynamics.com/XrmServices/2011/Organization.svc |
| Frankreich | https://OrganizationName.api.crm12.dynamics.com/XrmServices/2011/Organization.svc |
Für Dynamics 365 Customer Engagement (on-premises) (lokal)
Verwenden Sie die folgende URL, um auf den Organisationsdienst zuzugreifen:
http[s]://ServerName/OrganizationName/XRMServices/2011/Organization.svc
Organisationsdatendienst
Dieser Open Data (OData v2)-Webdienst bietet Zugriff auf Geschäftsdaten Ihrer Organisation, indem eine RESTAPI verfügbar gemacht wird. Über diesem Link wird das CSDL-Dokument geöffnet, worin beschrieben wird, wie Sie mithilfe dieser API auf Ihre Daten zugreifen können.
Warnung
Der Organisationsdatendienst ist veraltet und wird durch die Web-API ersetzt. Weitere Informationen über die Web-API finden Sie unter Verwenden der Dynamics 365 Customer Engagement-Web-API.
Für Dynamics 365 for Customer Engagement
Verwenden Sie die folgenden URLs, um auf den Organisationsdatendienst zuzugreifen (ODataREST-Endpunkt):
| Region | URL |
|---|---|
| Nordamerika | https://OrganizationName.api.crm.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Nordamerika 2 | https://OrganizationName.api.crm9.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Südamerika | https://OrganizationName.api.crm2.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Kanada | https://OrganizationName.api.crm3.dynamics.com/XrmServices/2011/OrganizationData.svc |
| EMEA | https://OrganizationName.api.crm4.dynamics.com/XrmServices/2011/OrganizationData.svc |
| APAC | https://OrganizationName.api.crm5.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Ozeanien | https://OrganizationName.api.crm6.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Japan | https://OrganizationName.api.crm7.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Indien | https://OrganizationName.api.crm8.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Frankreich | https://OrganizationName.api.crm12.dynamics.com/XrmServices/2011/OrganizationData.svc |
Für Dynamics 365 Customer Engagement (on-premises) (lokal)
Verwenden Sie die folgende URL, um auf den Organisationsdatendienst zuzugreifen (ODataREST-Endpunkt):
http[s]://ServerName/OrganizationName/XRMServices/2011/OrganizationData.svc
WSDL verwenden
Um einem Visual Studio-Projekt eine Servicereferenz für diese Dienste hinzufügen, müssen Sie ?WSDL zur Service-URL hinzufügen, wenn Sie die Adresse im Dialogfeld Service-Referenz hinzufügen angeben. Beispielsweise ist die Adresse des Suchdiensts (Web Services Description Language) (WSDL) http[s]://servername/xrmservices/2011/discovery.svc?wsdl.
Die Webdienste unterstützen die SDK-Versionsverwaltung. Die Angabe einer SDK-Version in der WSDL-URL gibt einen Umfang für die Datenmenge an, die in der WSDL zurückgegeben werden sollen. Die Syntax für die Webdienst-SDK-Versionsverwaltung beendet die URL in ?singleWSDL&sdkversion=X.X. Beispielsweise wäre die URL https://mydomain.crm.dynamics.com/xrmservices/2011/discovery.svc?singleWSDL&sdkversion=8.0. In diesem Beispiel würden Sie die Anwendung mithilfe der v8.0 .NET-Assemblys erstellen.
Siehe auch
Schreiben von Code für Dynamics 365 Customer Engagement-Webdienste
Verwenden des IOrganizationService-Webdiensts, um Daten oder Metadaten zu lesen und zu schreiben