Auf Englisch lesen

Freigeben über

Microsoft Dataverse-Web-API-Versionen

  • Artikel

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

Dies unterscheidet sich vom Verhalten der v8.x-Versionen. In früheren Versionen waren neue Funktionen für alle Versionen des Services verfügbar. Dies hing vom Update ab, das auf die Umgebung angewendet wurde. Nach dem Upgrade auf v8.2 sind die Services v8.0 und v8.1 identisch. Dies war möglich, da alle Änderungen additiv waren. Nichts wurde entfernt oder führte wichtige Änderungen ein. Daher war die bestimmte Version, auf die in der Service-URL für V8.x verwiesen wurde, nicht wirklich wichtig.

Darüber hinaus können sich die Funktionen des Service ändern, einschließlich möglicher wichtiger Änderungen wie das Entfernen bestimmter Operationen. Dadurch wird es möglich, Verbesserungen regelmäßig anzuwenden. In diesem Thema werden alle versionsspezifischen Unterschiede und alle Einschränkungen genannt, in denen die Web-API dem SDK für .NET noch nicht gleichwertig ist.

Hinweis

Während die v9.x-Versionen bestimmte Unterschiede unterstützen können, wurden den Versionen v9.0, v9.1 oder v9.2 keine Breaking Changes hinzugefügt. Jede dieser Versionen weist identische Web-API-Verhaltensweisen auf.

Unterschiede im API-Verhalten werden eher durch die im System installierten Lösungen als durch die Produktversion verursacht. Wenn wir jedoch eine grundlegende Änderung vornehmen müssen, die nicht abwärts kompatibel ist, wird diese in eine neue Versionsnummer aufgenommen.

Orientierungshilfe: Verwenden Sie die Versionsnummer, die beim Schreiben Ihres Codes aktuell war. Verwenden Sie nicht automatisch eine neuere Version, ohne hier nach dokumentierten Unterschieden zu suchen und zu testen. Gehen Sie nicht davon aus, dass eine neuere Version vollständig abwärts kompatibel ist.

Web API - Versionsspezifische Unterschiede

Die folgenden Unterschiede beziehen sich auf Änderungen in den Versionen v8.2 und v9.0 der Web-API.

Kodierung für Sonderzeichen in der FetchXML Abfrage Antwort

Bei den Versionen v8.x enthält Antwort von FetchXML Abfragen, die Link-Entitäten und deren Attribute enthalten, Unicode-Sonderzeichen, sodass „.“ zu „x002e“ und „@“ zu „x0040“ wird. Diese Kodierung für Sonderzeichen ist in Antwort 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 eine ihrer Spalten gleich sind, wird an den Attributnamen in v8.x-Instanzen angehängt. 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 angehängt.

Neuer Vorgang hinzugefügt

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

Operations Vorgänge (fortgesetzt) Vorgänge (fortgesetzt)
GrantAccessRequest ModifyAccessRequest RetrieveSharedPrincipalsAndAccessRequest

-Web-API-Einschränkungen

Die Dataverse-Web-API bietet komplette 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. Informationen zu früheren Versionen finden Sie unter Dynamics CRM 2016 Web-API-Einschränkungen,

Hinweis

Wenn Sie eine benutzerdefinierte Aktion definiert haben, die einem komplexen und einen einfachen Rückgabewert enthielt, stand in der Web-API keine entsprechende Aktion zur Verfügung, dafür aber im Organisationsservice. 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 eigener Aktionen.

Siehe auch

Dataverse-Web-API verwenden
Dataverse mit der Web-API authentifizieren
Internet API-Typen und -Vorgänge
Vorgänge mithilfe der Web-API ausführen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).