Microsoft Dataverse Web-API-Versionen

Ab der Version v9.0 von Dynamics 365 unterstützt die Web-API versionsspezifische Unterschiede in derselben Umgebung.

Dies unterscheidet sich vom Verhalten in den v8.x-Versionen. In den vorherigen Versionen waren neue Funktionen für jede Version des Diensts verfügbar, je nachdem, welche Aktualisierung 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.

Darüber hinaus können sich die Funktionen des Service ändern, einschließlich möglicher wichtiger Änderungen wie das Entfernen bestimmter Operationen. Dies 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 v9.x-Versionen bestimmte Unterschiede unterstützen können, wurden zu v9.0-, v9.1- oder v9.2-Versionen keine wichtigen Änderungen hinzugefügt. Jede dieser Versionen verfügt über identische Web-API-Verhaltensweisen.

Unterschiede im API-Verhalten werden durch die im System installierten Lösungen und nicht durch die Version des Produkts gesteuert. Wenn wir jedoch eine grundlegende Änderung vornehmen müssen, die nicht abwärtskompatibel ist, wird sie in eine neue Versionsnummer aufgenommen.

Leitfaden: Verwenden Sie die Versionsnummer, die beim Schreiben des Codes aktuell war. Verwenden Sie nicht automatisch eine neuere Version, ohne nach dokumentierten Unterschieden hier 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 Versionen v8.x enthält die Antwort von FetchXML-Abfragen, die Verknüpfungsentitäten und deren Attribute umfassen, Unicode-Sonderzeichen: "." wird zu "x002e" und "@" wird zu "x0040". Diese Codierung für Sonderzeichen ist im Ergebnis von 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, wird "1" an den Attributnamen in v8.x-Instanzen angefügt. Wenn beispielsweise eine Entität new_zipcode ein Attribut mit dem Namen new_zipcode hat, ändert sich der Attributname in new_zipcode1.

Für v9.x-Instanzen wird nichts an den Attributnamen hinzugefügt.

Neue Vorgänge hinzugefügt

Die folgenden Vorgänge wurden der Web-API für die Version v9.x hinzugefügt.

Operationen	Vorgänge (Cont'd)	Vorgänge (Cont'd)
GrantAccessRequest	ModifyAccessRequest	RetrieveSharedPrincipalsAndAccessRequest

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 definiert haben, die einen komplexen Rückgabewert und einen einfachen Rückgabewert enthielt, war eine entsprechende Aktion in der Web-API nicht verfügbar, aber mit dem Organisationsdienst verfügbar. 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: Erstellen Sie Eigene 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