Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ab der Version v9.0 von Dynamics 365 unterstützt die Web-API versionsspezifische Unterschiede in derselben Umgebung.
Diese Unterstützung unterscheidet sich vom Verhalten in v8.x-Releases. In den vorherigen Versionen waren neue Funktionen für jede Version des Diensts verfügbar, abhängig von dem Update, das auf die Umgebung angewendet wurde. Nach einem Upgrade auf v8.2 waren die v8.0- und v8.1-Dienste identisch. Dies war möglich, weil alle Änderungen additiv waren. Nichts wurde entfernt oder führte wichtige Änderungen ein. Daher war die spezifische Version, auf die in der Dienst-URL für v8.x verwiesen wird, eigentlich nicht wichtig.
In Zukunft können sich die Möglichkeiten des Diensts ändern, einschließlich potenziell disruptiver Änderungen wie das Entfernen spezifischer Vorgänge. Diese Änderung ermöglicht die Anwendung von Verbesserungen auf laufender Basis. In diesem Thema werden alle versionsspezifischen Unterschiede und Einschränkungen erfasst, bei denen die Web-API noch keine Parität mit dem SDK für .NET erreicht hat.
Hinweis
Während die Versionen v9.x bestimmte Unterschiede unterstützen können, enthalten die Versionen v9.0, v9.1 und v9.2 keine wichtigen Änderungen. Jede dieser Versionen weist identische Web-API-Verhaltensweisen auf.
Unterschiede im API-Verhalten werden durch die im System installierten Lösungen und nicht durch die Version des Produkts gesteuert. Wenn Microsoft jedoch eine grundlegende Änderung vornehmen muss, die nicht abwärtskompatibel ist, enthält sie die Änderung in einer neuen Versionsnummer.
Leitfaden: Verwenden Sie die Versionsnummer, die aktuell war, als Sie Ihren Code geschrieben haben. Verwenden Sie keine neuere Version automatisch, ohne nach dokumentierten Unterschieden und Tests zu suchen. Gehen Sie nicht davon aus, dass eine neuere Version vollständig abwärtskompatibel ist.
Spezifische Unterschiede bei der Web-API-Version
Die folgenden Unterschiede beziehen sich auf Änderungen in den Versionen v8.2 und v9.0 der Web-API.
Codierung für Sonderzeichen in fetchXML-Abfrageantwort
Für v8.x-Versionen enthält die Antwort auf FetchXML-Abfragen, die Linkentitäten und ihre Attribute umfassen, Unicode-Sonderzeichen, sodass "." zu "x002e" wird und "@" zu "x0040" wird. Diese Codierung für Sonderzeichen ist in der Antwort auf FetchXML-Abfragen für die Version v9.x nicht vorhanden.
Gleicher Name für Tabelle und Spalte
Wenn der Name einer Tabelle (Entität) und einer ihrer Spalten (Attribute) identisch ist, fügt das System "1" an den Attributnamen in v8.x-Instanzen an. Wenn beispielsweise eine Entität new_zipcode über ein Attribut mit dem Namen new_zipcode verfügt, ändert sich der Attributname in new_zipcode1.
Für v9.x-Instanzen fügt das System nichts an den Attributnamen an.
Neue Vorgänge hinzugefügt
Die folgenden Vorgänge werden der Web-API für die Version v9.x hinzugefügt.
Web-API-Einschränkungen
Die Dataverse-Web-API bietet eine vollständige Parität mit den Funktionen des SDK für .NET. Für Dataverse beschreibt dieses Thema die aus dem Dataverse-Release v8.x übertragenen Einschränkungen. Frühere Versionen finden Sie unter Dynamics CRM 2016 Web API-Einschränkungen.
Hinweis
Wenn Sie eine benutzerdefinierte Aktion definieren, die sowohl einen komplexen Rückgabewert als auch einen einfachen Rückgabewert enthält, stellt die Web-API keine entsprechende Aktion bereit. Der Organisationsdienst stellt diese Aktion jedoch bereit. Ein komplexer Rückgabewert ist ein EntityReference, Entityoder EntityCollection. Sie können eine beliebige Kombination aus einfachen Rückgabewerten oder einem einzelnen komplexen Rückgabewert haben. Weitere Informationen finden Sie unter Erstellen eigener Nachrichten.
Siehe auch
Verwenden der Dataverse-Web-API
Authentifizieren bei Dataverse mit der Web-API
Web-API-Typen und -Vorgänge
Ausführen von Vorgängen mithilfe der Web-API