Microsoft Dynamics 365-Web-API-Einschränkungen

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Die Microsoft Dynamics 365-Web API bietet komplette Parität mit den Fähigkeiten des Organisationsservices. Für Microsoft Dynamics 365 (online und lokal) beschreibt dieses Thema einige der Beschränkungen.

In diesem Thema

Einschränkungen in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal)

Einschränkungen, auf die in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal) eingegangen werden

Einschränkungen, auf die in Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 eingegangen werden

Einschränkungen, auf die in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 eingegangen werden

Einschränkungen in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal)

Dieser Abschnitt liefert Informationen über die Beschränkungen in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal).

  • Einige benutzerdefinierte Aktionen sind im Web API nicht verfügbar

  • Fehlende Funktionen und Aktionen auf einige Organisationsservicemessages

Einige benutzerdefinierte Aktionen sind im Web API nicht verfügbar

Wenn Sie eine benutzerdefinierte Aktionen definieren, die die Erstellung eines komplexen Rückgabewert und eine einfache Rückgabewert enthält, wird eine entsprechende Aktion, nicht verfügbar in der Web API ist aber mit dem Endpunkt 2011 SOAP verfügbar. Ein komplexer Rückgabewert ist ein EntityReference, Entityoder EntityCollection. Sie können eine beliebige Kombination von einfachen Rückgabewerten oder einem einzelner komplexen Rückgabewert haben.Weitere Informationen:Erstellen Ihrer eigenen Aktionen

Fehlende Funktionen und Aktionen auf einige Organisationsservicemessages

Die folgende Tabelle führt die Nachrichten auf, die keine entsprechende Funktion oder Aktion haben, nachdem Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal) angewandt wurden.

GrantAccessRequest

ModifyAccessRequest

ReactivateEntityKeyRequest

RemoveMemberListRequest

RemoveItemCampaignRequest

RemoveItemCampaignActivityRequest

Für eine Liste von Funktionen und Aktionen, die in der Anfangsversion fehlen, kombinieren Sie diese Liste mit der Liste unter Funktionen und Aktionen, die in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 hinzugefügt wurden und Funktionen und Aktionen, die in Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 hinzugefügt wurden.

Einschränkungen, auf die in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal) eingegangen werden

Dieser Abschnitt liefert Informationen über die Beschränkungen in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal).

  • Web API nicht für Microsoft Dynamics 365 für Outlook mit Offlinezugriff aktiviert, wenn Benutzer offline ist

  • Datumswerte können nicht abgefragt werden

  • Wenn Sie Aktionen mit Entitätssammlungsparametern sowie anderen Parametern aufrufen, muss ein Sammlungsparameter als der letzte Parameter im Körper übergeben werden

  • Erstellen eines Kundesuchattributs nicht möglich

  • Abrufen von nicht veröffentlichten Metadaten nicht möglich

Neuer Vorgang hinzugefügt

Die folgenden Vorgänge sind der Web API für Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal)hinzugefügt worden.

QualifyLead Action

RetrieveByResourcesService Function

RetrieveFilteredForms Function

Web API nicht für Microsoft Dynamics 365 für Outlook mit Offlinezugriff aktiviert, wenn Benutzer offline ist

Hinweis

Diese Problem wird in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal) behandelt.

JavaScript Code, der in Formularskripts, Menübandbefehlen oder HTML-Webressourcen ausgeführt wird, kann die Web API nicht verwenden. Es ist auf dem lokalen Server aktiviert, der verwendet wird, wenn der Benutzer offline geht.

Datumswerte können nicht abgefragt werden

Dieses Problem war keine Beschränkung, sondern nur ein Syntaxproblem. Verwenden Sie keine einfachen Anführungszeichen, wenn Sie ein Datum als Wert für den Filter definieren.

Wenn Sie eine Datumseigenschaft, wie der Geburtstag eines Kontakts abfragen, funktioniert die folgende Abfragesyntax:

/contacts?$select=fullname,birthdate&$filter=birthdate eq 1990-01-01

Folgende Syntax wird nicht ausgeführt:

/contacts?$select=fullname,birthdate&$filter=birthdate eq '1990-01-01'

Wenn Sie Aktionen mit Entitätssammlungsparametern sowie anderen Parametern aufrufen, muss ein Sammlungsparameter als der letzte Parameter im Körper übergeben werden

Hinweis

Diese Problem wird in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal) behandelt.

Die folgenden Aktionen enthalten einen Entitätssammlungsparameter zusätzlich zu anderen Parametern.

AddListMembersList Action

AddPrivilegesRole Action

CompoundUpdateDuplicateDetectionRule Action

DeliverIncomingEmail Action

DeliverPromoteEmail Action

InstantiateTemplate Action

QualifyMemberList Action

ReplacePrivilegesRole Action

SendTemplate Action

SetLocLabels Action

Vor Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal), wenn Sie diese Aktionen verwenden, muss der Parameter, der die Entitätssammlung umfasst, als der letzte Parameter in JSON übergeben werden, oder das System gibt einen Fehler zurück. Zum Beispiel erhalten Sie einen Fehler, wenn Sie QualifyMemberList Action verwenden und die Parameterinhalte in der folgenden Art übergeben.

{
"ListMember": [
  {
   "@odata.type": "Microsoft.Dynamics.CRM.account",
   "accountid": "483F8080-6976-E511-9172-0024E8436263"
  },
  {
   "@odata.type": "Microsoft.Dynamics.CRM.account",
   "accountid": "4D3F8080-6976-E511-9172-0024E8436263"
  }
 ],
"OverrideorRemove": true
}

Folgendes sollte aber erfolgreich sein.

{
 "OverrideorRemove": true,
 "ListMember": [
  {
   "@odata.type": "Microsoft.Dynamics.CRM.account",
   "accountid": "483F8080-6976-E511-9172-0024E8436263"
  },
  {
   "@odata.type": "Microsoft.Dynamics.CRM.account",
   "accountid": "4D3F8080-6976-E511-9172-0024E8436263"
  }
 ]
}

Erstellen eines Kundesuchattributs nicht möglich

Hinweis

Diese Problem wird in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal) behandelt.

Das Erstellen von solchen Kundensuchattributen mithilfe der Web API wird in Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 nicht unterstützt.

Wenn Sie ein Kundensuchattribut mit Web API mithilfe von Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal) erstellen, finden Sie unter Erstellen eines Kundesuchattributs weitere Informationen.

Abrufen von nicht veröffentlichten Metadaten nicht möglich

Hinweis

Diese Problem wird in Dezember 2016 Update für Microsoft Dynamics 365 (online) und Dezember 2016 Service-Paket für Microsoft Dynamics 365 (lokal) behandelt.

Die Organisationsservicemeldungen, die Metadaten abrufen, umfassen einen RetrieveAsIfPublished-Parameter, der die Option zum Zurückgeben von Metadatendefinitionen, die noch nicht durch Veröffentlichung festgelegt worden sind, zur Verfügung stellt. Diese Fähigkeit ist nützlich, wenn Sie eine Anwendung aufbauen, die Sie verwenden würden, um Metadaten zu bearbeiten, und nicht festgelegte Änderungen gespeichert werden müssen. Im Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 rufen alle Operationen auf Metadaten nur die veröffentlichten Metadaten zurück.Weitere Informationen:Verwenden der Web-API mit Dynamics 365-Metadaten und Veröffentlichen von Anpassungen.

Einschränkungen, auf die in Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 eingegangen werden

Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 haben zusätzliche Funktionen und Aktionen und behandeln folgende Probleme in der Web API:

  • Funktionen und Aktionen, die in Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 hinzugefügt wurden

  • Kann keine Abfragen filtern, die auf dem Wert einer Einzelwertnavigationseigenschaft basieren

Funktionen und Aktionen, die in Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 hinzugefügt wurden

Die folgende Tabelle listet die Funktionen und die Aktionen auf, die für Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 hinzugefügt wurden.

Book Action

Reschedule Action

CalculateRollupField Function

Kann keine Abfragen filtern, die auf dem Wert einer Einzelwertnavigationseigenschaft basieren

Hinweis

Diese Problem wird teilweise in Microsoft Dynamics CRM Online 2016-Update 1 und Microsoft Dynamics CRM 2016 Service Pack 1 behandelt. Sie können jetzt Abfragen auf der Einzelwertnavigationseigenschaft filtern, wenn die Navigationseigenschaft den Primärattributswert der verwiesenen Entität verweist.Weitere Informationen:Filterung von Datensätzen auf Grundlage einer einzelbewerteten Navigationseigenschaft

Wenn Sie die Eigenschaft einer einzelwertigen Navigationseigenschaft als Filter in einer Abfrage benutzen, sehen Sie einen 501-Fehler. Zum Beispiel versucht die folgende Abfrage alle Konten zurückzugeben, in denen der zugewiesene firstname-Eigenschaftswert des Primärkontakts "Renee" ist.

  • Anforderung

    GET 
[Organization URI]/api/data/v8.0/accounts?$select=name&$filter=primarycontactid/firstname eq 'Renee' HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

  • Antwort

    HTTP/1.1 501 Not Implemented
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{  
 "error": {    
  "code": "",
   "message": "The query node (0) is not supported",
   "innererror": {      
   "message": "The query node (0) is not supported",
   "type": "Microsoft.Crm.CrmHttpException",
   "stacktrace": 
                        <stacktrace value removed for brevity>
  }  
 }
}

Einschränkungen, auf die in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 eingegangen werden

Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM Online 2016-Update 0.1 hat zusätzliche Funktionen und Aktionen addiert und ist auf die folgenden Probleme mit dem Web API eingegangen.

  • Funktionen und Aktionen, die in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 hinzugefügt wurden

  • Fehler beim Abfragen selbstreferenzieller viele-zu-viele-Beziehungen

  • $select bei einigen $expand-Ausdrücken wird möglicherweise ignoriert

  • Einzelwertige Navigationseigenschaften werden möglicherweise nicht von einer $expand-Abfrage zurückgegeben, wenn sie einen ungültigen Wert haben

  • FetchXML-Abfragen, die mit activitypointer verbunden sind,umfassen ggf. keine verbundenen Felder

  • Nullwertige Eigenschaften werden in erweiterten Navigationseigenschaftsergebnissen ggf. nicht zurückgegeben.

Funktionen und Aktionen, die in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 hinzugefügt wurden

Die folgende Tabelle listet die Funktionen und die Aktionen auf, die für Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 hinzugefügt wurden.

CheckIncomingEmail Function

FindParentResourceGroup Function

GetQuantityDecimal Function

IncrementKnowledgeArticleViewCount Function

InitializeFrom Function

IsValidStateTransition Function

QueryMultipleSchedules Function

RetrieveAllEntities Function

RetrieveDuplicates Function

RetrieveLocLabels Function

RetrievePrincipalAccess Function

RetrieveRecordWall Function

RetrieveUnpublishedMultiple Function

SearchByBodyKbArticle Function

SearchByKeywordsKbArticle Function

SearchByTitleKbArticle Function

ValidateRecurrenceRule Function

Fehler beim Abfragen selbstreferenzieller viele-zu-viele-Beziehungen

Hinweis

Diese Problem wird in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 behandelt.

Es gibt zwei Systementitäten mit selbstreferenziellen viele-zu-viele-Beziehungen: connectionrole EntityType hat connectionroleassociation_association und campaign EntityType hat campaigncampaign_association. Wenn Sie eine Abfrage versuchen, die die sammlungsbewerteten Navigationseigenschaften verwendet, wird folgender HTTP Status 400-Fehler erwartet: Reflexive relationship must specify direction using ReflexiveManyToManyRelationship.

Wenn Sie Daten unter Verwendung dieser viele-zu-viele-Beziehungen abfragen müssen, können Sie stattdessen die überschneidenden Entitäten benutzen. Für das die campaigncampaign_association sammlungswertige Navigationseigenschaft ist campaignitem EntityType die Entität die spezielle überschneidende Entität, die die Beziehungen definiert. Für connectionroleassociation_association ist connectionroleassociation die übliche überschneiden Entität, die die Daten enthält, die diese viele-zu-viele-Beziehungen definieren. Übliche überschneidende Entitäten sind nicht in der Referenzdokumentation enthalten aber in der Web API verfügbar. Sie können auf die connectionroleassociation-Entität unter Verwendung dieser URIs zugreifen: /api/data/v8.0/connectionroleassociations.Weitere Informationen:Gemeinsam bewertete Navigationseigenschaften

$select bei einigen $expand-Ausdrücken wird möglicherweise ignoriert

Hinweis

Diese Problem wird in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 behandelt.

Wenn Sie zwei Navigationseigenschaften abrufen, wenn die letzte Navigationseigenschaft die $select-Abfrageauswahl hat, werden alle Eigenschaften der ersten Navigationseigenschaft zurückgegeben. Angenommen, Sie konstruieren folgende Abfrage:

GET 
[Organization URI]/api/data/v8.0/accounts(0495779B-F67F-E511-80C2-00155DB09B03)$select=name&$expand=contact_customer_accounts($select=lastname),opportunity_customer_accounts

Sie erwarten die name-Eigenschaft des Kontos, lastnameder Kontakte, die mit contact_customer_accounts zugewiesen wurden, und alle Eigenschaften für die Verkaufschancen, die unter Verwendung von opportunity_customer_accounts zugewiesen wurden.

Jedoch erhalten Sie alle Eigenschaften für die Kontakte sowie alle Eigenschaften der in Verbindung stehenden Verkaufschancen. Es ist eine bewährte Methode, immer $select zu verwenden, um die Eigenschaften in allen Abrufoperationen zu begrenzen. Die bewährte Methode zu befolgen garantiert also, dass Sie die beste Leistung erhalten und nicht mehr Daten abrufen, als Sie brauchen.

Einzelwertige Navigationseigenschaften werden möglicherweise nicht von einer $expand-Abfrage zurückgegeben, wenn sie einen ungültigen Wert haben

Hinweis

Diese Problem wird in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 behandelt.

Entsprechend der OData-Spezifikation sollte die Eigenschaft, wenn Sie eine einzelne Navigationseigenschaft erweitern und sie keinen Wert enthält, mit Nullsatz enthalten sein. Das gegenwärtige Verhalten ist, dass die Eigenschaft nicht in der JSON-Antwort enthalten ist. Im folgenden Beispiel wird die einzelwertige primarycontactid-Kontonavigationseigenschaft angefordert, aber, weil es keinen Kontakt gibt, der mit dieser Navigationseigenschaft verbunden ist, ist der Wert ungültig.

  • Anforderung

    GET 
[Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)?$select=name&$expand=primarycontactid($select=fullname) HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

  • Erwartete Reaktion

    HTTP/1.1 200 OK
OData-Version: 4.0

{
 "@odata.context": "
[Organization URI]/api/data/v8.0/$metadata#accounts(name,primarycontactid,primarycontactid(fullname))/$entity",
 "@odata.etag": "W/\"504724\"",
 "name": "A. Datum Corporation (sample)",
 "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4",
 "primarycontactid": null
}

  • Tatsächliche Antwort

    HTTP/1.1 200 OK
OData-Version: 4.0

{
 "@odata.context": "
[Organization URI]/api/data/v8.0/$metadata#accounts(name,primarycontactid,primarycontactid(fullname))/$entity",
 "@odata.etag": "W/\"504724\"",
 "name": "A. Datum Corporation (sample)",
 "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4"
}

FetchXML-Abfragen, die mit activitypointer verbunden sind,umfassen ggf. keine verbundenen Felder

Hinweis

Diese Problem wird in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 behandelt.

Wenn Sie eine Abfrage unter Verwendung von FetchXML erstellen, die activitypointer als verbundene Entität einschließt, sind die Eigenschaftswerte ungültig. Angenommen, sie verwenden folgendes FetchXML:

<fetch version="1.0"
       output-format="xml-platform"
       mapping="logical"
       distinct="true">
  <entity name="account">
    <attribute name="name" />
    <link-entity name="activitypointer"
                 from="regardingobjectid"
                 to="accountid"
                 link-type="inner">
      <attribute name="subject" />
    </link-entity>
  </entity>
</fetch>

Sie fordern das in Verbindung stehende activitypointer an.subject Wert, der zurück gegeben wird. Er wird mit einem ungültigen Wert zurückgegeben, wenn ein tatsächlicher Wert existiert.

  • Anforderung

    GET 
[Organization URI]/api/data/v8.0/accounts?fetchXml=%3Cfetch%20version=%221.0%22%20output-format=%22xml-platform%22%20mapping=%22logical%22%20distinct=%22true%22%3E%3Centity%20name=%22account%22%3E%3Cattribute%20name=%22name%22%20/%3E%3Clink-entity%20name=%22activitypointer%22%20from=%22regardingobjectid%22%20to=%22accountid%22%20link-type=%22inner%22%3E%3Cattribute%20name=%22subject%22%20/%3E%3C/link-entity%3E%3C/entity%3E%3C/fetch%3E HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

  • Erwartete Reaktion

    HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
 "@odata.context": "
[Organization URI]/api/data/v8.0/$metadata#accounts(name)",
 "value": [
  {
   "name": "A. Datum Corporation (sample)",
   "activitypointer1.subject": "Task Subject Value"
  }
 ]
}

  • Tatsächliche Antwort

    HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
 "@odata.context": "
[Organization URI]/api/data/v8.0/$metadata#accounts(name)",
 "value": [
  {
   "name": "A. Datum Corporation (sample)",
   "activitypointer1.subject": null
  }
 ]
}

Weitere Informationen:Benutzerdefiniertes FetchXML verwenden

Nullwertige Eigenschaften werden in erweiterten Navigationseigenschaftsergebnissen ggf. nicht zurückgegeben.

Hinweis

Diese Problem wird in Microsoft Dynamics CRM Online 2016-Update 0.1 und Microsoft Dynamics CRM 2016-Update 0.1 behandelt.

Wenn eine der erweiterten Eigenschaften in einer sammlungswertigen Navigationseigenschaft null ist, ist die erweiterte Eigenschaft nicht in den Ergebnissen eingeschlossen. Das erste Beispiel zeigt die Daten, wenn einer der Kontakte, die auf ein Konto bezogen werden, einen null-Wert für die erweiterte emailaddress1-Eigenschaft hat. Die emailaddress1-Eigenschaft wird sogar nicht für den Kontakt zurückgegeben, wo sie einen Wert hat.

  • Anforderung

    GET 
[Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)?$select=name&$expand=contact_customer_accounts($select=emailaddress1,lastname,firstname) HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

  • Erwartete Reaktion

    HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
 "@odata.context": "
[Organization URI]/api/data/v8.0/$metadata#accounts(name,contact_customer_accounts,contact_customer_accounts(emailaddress1,lastname,firstname))/$entity",
 "@odata.etag": "W/\"504724\"",
 "name": "A. Datum Corporation (sample)",
 "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4",
 "contact_customer_accounts": [
  {
   "@odata.etag": "W/\"504749\"",
   "emailaddress1": null,
   "lastname": "Valdes (sample)",
   "firstname": "Rene",
   "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4"
  },
  {
   "@odata.etag": "W/\"503647\"",
   "emailaddress1": someone_l@example.com,
   "lastname": "Burk (sample)",
   "firstname": "Susan",
   "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4"
  }
 ]
}

  • Tatsächliche Antwort

    HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
 "@odata.context": "
[Organization URI]/api/data/v8.0/$metadata#accounts(name,contact_customer_accounts,contact_customer_accounts(emailaddress1,lastname,firstname))/$entity",
 "@odata.etag": "W/\"504724\"",
 "name": "A. Datum Corporation (sample)",
 "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4",
 "contact_customer_accounts": [
  {
   "@odata.etag": "W/\"504749\"",
   "lastname": "Valdes (sample)",
   "firstname": "Rene",
   "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4"
  },
  {
   "@odata.etag": "W/\"503647\"",
   "lastname": "Burk (sample)",
   "firstname": "Susan",
   "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4"
  }
 ]
}

Die folgende Abfrage, die direkt die sammlungswertige contact_customer_accounts-Navigationseigenschaft ohne Erweiterung verwendet, gibt die erwarteten Daten zurück.

  • Anforderung

    GET 
[Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)/contact_customer_accounts?$select=emailaddress1,lastname,firstname HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

  • Antwort

    HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
 "@odata.context": "
[Organization URI]/api/data/v8.0/$metadata#contacts(emailaddress1,lastname,firstname)",
 "value": [
  {
   "@odata.etag": "W/\"504749\"",
   "emailaddress1": null,
   "lastname": "Valdes (sample)",
   "firstname": "Rene",
   "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4"
  },
  {
   "@odata.etag": "W/\"503647\"",
   "emailaddress1": "someone_l@example.com",
   "lastname": "Burk (sample)",
   "firstname": "Susan",
   "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4"
  }
 ]
}

Siehe auch

Verwenden der Microsoft Dynamics 365-Web-API
Authentifizieren von Microsoft Dynamics 365 mit der Web-API
Internet API-Typen und -Vorgänge
Vorgänge mithilfe der Web-API ausführen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright