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.
Die Web-API bietet eine RESTful-Webdienstschnittstelle, mit der Sie mit Daten in Microsoft Dataverse interagieren können, indem Sie eine Vielzahl von Programmiersprachen und Bibliotheken verwenden. Verwenden Sie die folgenden Ressourcen, um zu erfahren, wie Sie Anforderungen verfassen, Abfragedaten, Tabellenzeilen verwalten und Vorgänge im Batch ausführen – alle mit standardmäßigen HTTP-Methoden.
Tipp
Neu bei der Dataverse-Web-API? Überprüfen Sie zunächst Web-API-Typen und -Vorgänge , um die OData-Dienstdokumente zu verstehen, die entitäten, Funktionen und Aktionen definieren, die Ihnen zur Verfügung stehen.
Hinweis
Die Informationen in diesem Abschnitt gelten auch für Dynamics 365 Customer Engagement (lokale) Benutzer.
In diesem Abschnitt
| Artikel | Beschreibung |
|---|---|
| HTTP-Anforderungen erstellen und Fehlern behandeln | Erfahren Sie, wie Sie die entsprechenden HTTP-Header festlegen und Fehler bei der Interaktion mit der Web-API behandeln. |
| Abfragedaten | Erfahren Sie, wie Sie Abfragen mithilfe von OData erstellen, um Daten aus Entitätssammlungen in Dataverse abzurufen. |
| Tabellenzeile erstellen | Senden Sie eine POST Anforderung zum Erstellen von Tabellenzeilen, einschließlich verwandter Zeilen in einem einzigen Deep Insert-Vorgang. |
| Abrufen einer Tabellenzeile | Verwenden Sie eine GET Anforderung, um einen bestimmten Datensatz anhand seines eindeutigen Bezeichners abzurufen, einschließlich bestimmter Eigenschaften und verwandter Datensätze. |
| Aktualisieren und Löschen von Tabellenzeilen | Führen Sie Aktualisierungs-, Lösch- und Upsert-Operationen für Tabellenzeilen aus, einschließlich Operationen für einzelne Spalten. |
| Tabellenzeilen zuordnen und deren Zuordnung aufheben | Erstellen und Entfernen von Beziehungen zwischen Datensätzen mithilfe der navigationseigenschaften, die in den Tabellenmetadaten definiert sind. |
| Tabellenzeilen zusammenführen | Kombinieren Sie zwei doppelte Datensätze zu einem einzigen, indem Sie die Aktion Merge für Konten, Kontakte, Leads und Vorfälle verwenden. |
| Verwenden von Funktionen | Verwenden Sie wiederverwendbare Funktionen mit GET Anforderungen zum Abrufen oder Auswerten von Werten in Abfragen ohne Nebenwirkungen. |
| Aktionen verwenden | Verwenden Sie wiederverwendbare Vorgänge mit POST Anforderungen, um Aktionen auszuführen, die Nebenwirkungen haben, einschließlich benutzerdefinierter Aktionen. |
| Ausführen von Batchvorgängen | Gruppieren Sie mehrere Vorgänge in einer einzelnen HTTP-Anforderung, optional innerhalb eines Änderungssatzes, um sicherzustellen, dass sie als Einheit erfolgreich sind oder fehlschlagen. |
| Annehmen der Identität eines anderen Benutzers | Führen Sie Geschäftslogik im Auftrag eines anderen Benutzers aus, und wenden Sie die Rollen- und objektbasierte Sicherheit dieses Benutzers an. |
| Ausführen von bedingten Vorgängen | Verwenden Sie ETags, um bedingte Abrufe, optimistische Parallelitätssteuerung und eingeschränkte Upsert-Vorgänge auszuführen. |
| Doppelte Daten erkennen | Verwenden Sie den MSCRM.SuppressDuplicateDetection Header, um die Erstellung doppelter Datensätze zu erkennen und zu verhindern. |
| Problembehandlung von Dataverse Client-Fehlern | Identifizieren und Beheben häufiger Clientfehler bei Verwendung der Dataverse-Web-API. |
Nächste Schritte
- Authentifizieren bei Dataverse mit der Web-API – Richten Sie die Authentifizierung ein, bevor Sie Ihre erste Anforderung vornehmen.
- Verfassen von HTTP-Anforderungen und Behandeln von Fehlern – Beginnen Sie mit dem Erstellen von Anforderungen mit den richtigen Headern und der Fehlerbehandlung.
- Web-API-Typen, -Funktionen und -Aktionen – Erkunden Sie die OData-Dienstdokumente, die verfügbare Vorgänge definieren.