Beispiel grundlegender Web-API-Operationen
Diese Sammlung von Beispielcodeausschnitten zeigt, wie Sie grundlegende CRUD-Vorgänge (Create, Retrieve, Update und Delete) und assoziative Vorgänge mit der Microsoft Dataverse-Web-API durchführen.
Dieses Thema beschreibt einen gemeinsamen Satz von Vorgängen, die von jedem Beispielausschnitt in dieser Gruppe implementiert werden. Dieses Thema beschreibt die HTTP-Anforderungen und -Antworten sowie die Textausgabe, die jedes Beispiel ohne sprachspezifische Details ausführt. Weitere Informationen zum Ausführen dieser Vorgänge, finden Sie in den sprachspezifischen Beschreibungen und den individuellen Beispielen.
Demonstriert
Dieses Beispiel wird in die folgenden Abschnitte unterteilt und enthält Dataverse-Web-API-Vorgänge, die in den entsprechenden Themenabschnitten detailliert behandelt werden.
Hinweis
Der Kürze halber sind entsprechende HTTP-Kopfzeilen weggelassen worden. Die URLs der Datensätze variieren mit der Basisorganisationsadresse und der ID der Zeile, die von Ihrem Dataverse-Server zugewiesen wurde.
Abschnitt 1: Grundlegendes Erstellen und Aktualisieren von Vorgängen
Dieser Abschnitt erstellt einen einzelnen Kontakt und führt dann eine Reihe von Updates nach dieser Instanz aus. Beachten Sie, dass die Antwortkopfzeile OData-EntityId die URL dieser neu erstellten Zeile enthält, die in Klammern die eindeutige ID dieses Datensatzes enthält.
Erstellen Sie einen neuen Kontakt namens Rafel Shillo.
Anforderung:
POST [Organization Uri]/api/data/v9.2/contacts HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "firstname": "Rafel", "lastname": "Shillo" }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0 OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)Konsolenausgabe:
Contact URI: [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada) Contact relative Uri: contacts(0928bcb4-bb27-ed11-9db1-002248274ada)Die Eigenschaften, die für jeden Attributtyp verfügbar sind, werden im Metadatendokuments definiert und sind auch für den Abschnitt Web API Entity Type Reference dokumentiert. Allgemeinere Informationen finden Sie unter Web-API-Typen und -Operationen.
Aktualisieren Sie den Kontakt mit Werten für das Jahreseinkommen (80.000 Dollar) und Job-Position (Junior Developer).
Anforderung:
PATCH [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada) HTTP/1.1 If-Match: * OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "annualincome": 80000, "jobtitle": "Junior Developer" }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0 OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)Konsolenausgabe:
Contact 'Rafel Shillo' updated with jobtitle and annual incomeRufen Sie den Kontakt mit den Datensatz explizit mit den initialisierten Eigenschaften ab. Die
fullnameist eine schreibgeschützte Eigenschaft, die von denfirstnameundlastname-Eigenschaften berechnet wird, die explizit initialisiert wurden, als die Instanz erstellt wurde. Demgegenüber wurde diedescription-Eigenschaft nicht explizit initialisiert, damit diese ein Standardwert, einenullZeichenfolge fest.Beachten Sie, dass die Antwort, zusätzlich zu den angeforderten Werten und den typischen Überschriften, ebenfalls automatisch die folgenden Typen an zusätzlichen Informationen zurückgegebe:
- Die primäre ID für den aktuellen Tabellentyp, hier
contactid. - Ein eTagwert, steht im
@odata.etagSchlüssel, auf dem die bestimmte Version der angeforderten Ressource definiert wird. Weitere Informationen finden Sie unter Ausführen bedingter Operationen mit der Web-API. - Der Metadatenkontext, der vom
@odata.context-Schlüssel definiert wird, bietet eine Möglichkeit, Abfrageergebnisse zu bestimmen, ob Sie von derselben Abfrage kamen. - Ein
_transactioncurrencyid_value, der die Landeswährung für Finanztransaktionen angibt.
Anforderung:
GET [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)?$select=fullname,annualincome,jobtitle,description HTTP/1.1 Prefer: odata.include-annotations="*" OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 200 OK ETag: W/"72935648" OData-Version: 4.0 Preference-Applied: odata.include-annotations="*" { "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#contacts(fullname,annualincome,jobtitle,description)/$entity", "@odata.etag": "W/\"72935648\"", "fullname": "Rafel Shillo", "annualincome@OData.Community.Display.V1.FormattedValue": "$80,000.00", "annualincome": 80000.0, "jobtitle": "Junior Developer", "description": null, "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar", "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid", "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency", "_transactioncurrencyid_value": "228f42f8-e646-e111-8eb7-78e7d162ced1", "contactid": "0928bcb4-bb27-ed11-9db1-002248274ada" }Konsolenausgabe:
Contact 'Rafel Shillo' retrieved: Annual income: $80,000.00 Job title: Junior Developer Description:Wichtig
Sie sollten immer Auswahl und Filtern bei Abrufvorgängen verwenden, um die Leistung optimieren. Weitere Informationen finden Sie unter Abfragen von Daten mit Web-API.
- Die primäre ID für den aktuellen Tabellentyp, hier
Aktualisieren Sie die Kontaktinstanz, indem Sie dieselben Eigenschaften mit neuen Werten versehen.
Anforderung:
PATCH [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada) HTTP/1.1 If-Match: * OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "jobtitle": "Senior Developer", "annualincome": 95000, "description": "Assignment to-be-determined" }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0 OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)Konsolenausgabe:
Contact 'Rafel Shillo' updated: Job title: Senior Developer Annual income: 95000 Description: Assignment to-be-determinedWichtig
Senden Sie nur geänderte Eigenschaften an Updateanforderungen. Weitere Informationen finden Sie unter Grundlegendes Update.
Legen Sie explizit eine einzelne Eigenschaft fest, die einzelne primäre Telefonnummer. Hinweis: Dies ist eine
PUTAnforderung und dass der JSON-Schlüssel, dervalueheißt, verwendet wird, wenn der Vorgang oder einzelne Eigenschaften ausgeführt werden.Anforderung:
PUT [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)/telephone1 HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "value": "555-0105" }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0Konsolenausgabe:
Contact 'Rafel Shillo' phone number updated.Rufen Sie die dieselbe Eigenschaft ab, die einzelne primäre Telefonnummer. Beachten Sie erneut die Verwendung der Schlüssel, der
valueheißt.Anforderung:
GET [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)/telephone1 HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 200 OK OData-Version: 4.0 { "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#contacts(0928bcb4-bb27-ed11-9db1-002248274ada)/telephone1", "value": "555-0105" }Konsolenausgabe:
Contact's telephone # is: 555-0105.
Abschnitt 2: Erstellen Sie mit Zuordnung
Dieser Abschnitt erstellt einen neuen Firmendatensatz namens Contoso, Ltd. und verknüpft diesen mit dem vorhandenen Kontakt Rafel Shillo, der in Abschnitt 1 erstellt wurde. Die Erstellung und Zuordnung wird in einem einzelnen Vorgang ausgeführt.
Legen Sie die Firma Contoso, Ltd an, und setzen Sie das primäre Kontaktattribut auf den vorhandenen Kontakt Rafel Shillo. Der
@odata.bindZusatz gibt an, dass eine Zuordnung erstellt wurde und dieprimarycontactideinzelbewertete Navigationseigenschaft dem bestehenden Kontakt Rafel Shillo hinzugefügt wurde.Anforderung:
POST [Organization Uri]/api/data/v9.2/accounts HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "name": "Contoso Ltd", "telephone1": "555-5555", "primarycontactid@odata.bind": "contacts(0928bcb4-bb27-ed11-9db1-002248274ada)" }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0 OData-EntityId: [Organization Uri]/api/data/v9.2/accounts(2728bcb4-bb27-ed11-9db1-002248274ada)Konsolenausgabe:
Account 'Contoso Ltd' created. Account URI: accounts(2728bcb4-bb27-ed11-9db1-002248274ada)Rufen Sie den primären Kontakt für die Firma Contoso, Ltd. mithilfe von
$expandmit derprimarycontactideinzel-bewerteten Navigationseigenschaft auf, um auf den zugeordneten Datensatz contact EntityType zuzugreifen.Anforderung:
GET [Organization Uri]/api/data/v9.2/accounts(2728bcb4-bb27-ed11-9db1-002248274ada)?$select=name,&$expand=primarycontactid($select=fullname,jobtitle,annualincome) HTTP/1.1 Prefer: odata.include-annotations="*" OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 200 OK ETag: W/"72935670" OData-Version: 4.0 Preference-Applied: odata.include-annotations="*" { "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#accounts(name,primarycontactid(fullname,jobtitle,annualincome))/$entity", "@odata.etag": "W/\"72935670\"", "name": "Contoso Ltd", "accountid": "2728bcb4-bb27-ed11-9db1-002248274ada", "primarycontactid": { "@odata.etag": "W/\"72935663\"", "fullname": "Rafel Shillo", "jobtitle": "Senior Developer", "annualincome@OData.Community.Display.V1.FormattedValue": "$95,000.00", "annualincome": 95000.0, "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar", "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid", "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency", "_transactioncurrencyid_value": "228f42f8-e646-e111-8eb7-78e7d162ced1", "contactid": "0928bcb4-bb27-ed11-9db1-002248274ada" } }Konsolenausgabe:
Account 'Contoso Ltd' has primary contact 'Rafel Shillo': Job title: Senior Developer Annual income: $95,000.00
Abschnitt 3: Erstellen von verknüpften Tabellenzeilen (deep insert)
In diesem Abschnitt wird gezeigt, wie Sie eine Tabellenzeile und eine verwandte Zeile in einer einzigen POST-Anforderung erstellen. Bei dieser Methode werden alle Zeilen neu erstellt. Es sind keine Zeilen vorhanden, denen etwas zugeordnet werden kann. Diese Methode hat zwei Vorteile. Sie ist effizienter und ersetzt mehrere einfache Erstellungs- und Zuordnungsvorgänge mit einem gemeinsamen Vorgang. Auch ist er unteilbar, sodass entweder der gesamte Vorgang erfolgreich ist und alle verknüpften Objekte erstellt werden oder der Vorgang schlägt fehl und es wird nichts erstellt.
Dieser Abschnitt erstellt eine Firma, einen primären Kontakt und einen Reihe von Aufgaben für diesen Kontakt in einer Anforderung.
Erstellt die Firma
Fourth Coffeeund den primären KontaktSusie Curtisund die drei verknüpften Aufgaben in einen Vorgang. Beachten Sie die Verwendung der einzel-bewertetenprimarycontactidNavigationseigenschaft und der Sammlung-bewerteten NavigationseigenschaftContact_Tasks, um diese Beziehungen zu definieren. Einzel-bewertete Navigationseigenschaften nehmen einen Objektwert, während Sammlung-bewertete Navigationseigenschaften einen Array-Wert nehmen.Anforderung:
POST [Organization Uri]/api/data/v9.2/accounts HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "name": "Fourth Coffee", "primarycontactid": { "firstname": "Susie", "lastname": "Curtis", "jobtitle": "Coffee Master", "annualincome": 48000, "Contact_Tasks": [ { "subject": "Sign invoice", "description": "Invoice #12321", "scheduledstart": "2023-04-19T03:00:00+07:00", "scheduledend": "2023-04-19T04:00:00+07:00", "scheduleddurationminutes": 60 }, { "subject": "Setup new display", "description": "Theme is - Spring is in the air", "scheduledstart": "2023-04-20T03:00:00+07:00", "scheduledend": "2023-04-20T04:00:00+07:00", "scheduleddurationminutes": 60 }, { "subject": "Conduct training", "description": "Train team on making our new blended coffee", "scheduledstart": "2023-04-21T03:00:00+07:00", "scheduledend": "2023-04-21T04:00:00+07:00", "scheduleddurationminutes": 60 } ] } }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0 OData-EntityId: [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)Konsolenausgabe:
Account 'Fourth Coffee created.Rufen Sie selektiv die neu erstellte Fourth Coffee-Firma und den primären Kontakt ab. Eine Erweiterung wird auf der einzel-bewerteten Navigationseigenschaft
primarycontactidausgeführt.Anforderung:
GET [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)?$select=name&$expand=primarycontactid($select=fullname,jobtitle,annualincome) HTTP/1.1 Prefer: odata.include-annotations="*" OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 200 OK ETag: W/"72935710" OData-Version: 4.0 Preference-Applied: odata.include-annotations="*" { "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#accounts(name,primarycontactid(fullname,jobtitle,annualincome))/$entity", "@odata.etag": "W/\"72935710\"", "name": "Fourth Coffee", "accountid": "2e28bcb4-bb27-ed11-9db1-002248274ada", "primarycontactid": { "@odata.etag": "W/\"72935689\"", "fullname": "Susie Curtis", "jobtitle": "Coffee Master", "annualincome@OData.Community.Display.V1.FormattedValue": "$48,000.00", "annualincome": 48000.0, "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar", "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid", "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency", "_transactioncurrencyid_value": "228f42f8-e646-e111-8eb7-78e7d162ced1", "contactid": "2f28bcb4-bb27-ed11-9db1-002248274ada" } }Konsolenausgabe:
Account 'Fourth Coffee' has primary contact 'Susie Curtis': Job title: Coffee Master Annual income: $48,000.00Rufen Sie selektiv die dazugehörenden Aufgaben auf, die dem primären Kontakt zugeordnet werden, der im vorherigen Vorgang abgerufen wird. Eine Erweiterung wird auf der Sammlungs-bewerteten Navigationseigenschaft
Contact_Tasksausgeführt.Anforderung:
GET [Organization Uri]/api/data/v9.2/contacts(2f28bcb4-bb27-ed11-9db1-002248274ada)?$select=fullname&$expand=Contact_Tasks($select=subject,description,scheduledstart,scheduledend) HTTP/1.1 Prefer: odata.include-annotations="*" OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 200 OK ETag: W/"72935689" OData-Version: 4.0 Preference-Applied: odata.include-annotations="*" { "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#contacts(fullname,Contact_Tasks(subject,description,scheduledstart,scheduledend))/$entity", "@odata.etag": "W/\"72935689\"", "fullname": "Susie Curtis", "contactid": "2f28bcb4-bb27-ed11-9db1-002248274ada", "Contact_Tasks": [ { "@odata.etag": "W/\"72935719\"", "subject": "Sign invoice", "description": "Invoice #12321", "scheduledstart@OData.Community.Display.V1.FormattedValue": "4/18/2023 1:00 PM", "scheduledstart": "2023-04-18T20:00:00Z", "scheduledend@OData.Community.Display.V1.FormattedValue": "4/18/2023 2:00 PM", "scheduledend": "2023-04-18T21:00:00Z", "activityid": "3028bcb4-bb27-ed11-9db1-002248274ada" }, { "@odata.etag": "W/\"72935723\"", "subject": "Setup new display", "description": "Theme is - Spring is in the air", "scheduledstart@OData.Community.Display.V1.FormattedValue": "4/19/2023 1:00 PM", "scheduledstart": "2023-04-19T20:00:00Z", "scheduledend@OData.Community.Display.V1.FormattedValue": "4/19/2023 2:00 PM", "scheduledend": "2023-04-19T21:00:00Z", "activityid": "3128bcb4-bb27-ed11-9db1-002248274ada" }, { "@odata.etag": "W/\"72935727\"", "subject": "Conduct training", "description": "Train team on making our new blended coffee", "scheduledstart@OData.Community.Display.V1.FormattedValue": "4/20/2023 1:00 PM", "scheduledstart": "2023-04-20T20:00:00Z", "scheduledend@OData.Community.Display.V1.FormattedValue": "4/20/2023 2:00 PM", "scheduledend": "2023-04-20T21:00:00Z", "activityid": "3228bcb4-bb27-ed11-9db1-002248274ada" } ] }Konsolenausgabe:
Contact 'Susie Curtis' has the following assigned tasks: Subject: Sign invoice, Description: Invoice #12321 Start: 4/18/2023 1:00 PM End: 4/18/2023 2:00 PM Subject: Setup new display, Description: Theme is - Spring is in the air Start: 4/19/2023 1:00 PM End: 4/19/2023 2:00 PM Subject: Conduct training, Description: Train team on making our new blended coffee Start: 4/20/2023 1:00 PM End: 4/20/2023 2:00 PM
Abschnitt 4: Ordnen Sie bestehende Entitäten zu und heben Sie diese hervor
In diesem Abschnitt wird gezeigt, wie Sie vorhandene Tabellenzeilen zuordnen und die Zuordnung aufheben. Die Formung eine Zuordnung für die Verwendung einer Bezugs-URI- und eines-Beziehungsobjekt, die dann an eine POST-Anforderung gesendet werden. Die Aufhebung der Zuordnung erfordert, dass Sie einen Befehl "LÖSCHEN" an die Referenz-URL für diese Zuordnung senden. Zuerst wird einer 1: n-Zuordnung zwischen einem Kontakt und einer Firma gebildet. Anschließend wird eine n: n-Zuordnung zwischen einem Mitbewerber und mindestens einer Verkaufschance gebildet.
Fügen Sie Rafel Shillo als Kontakt der Firma Fourth Coffee mithilfe der
contact_customer_accountsSammlung-bewerteten Navigationseigenschaft hinzu. Beachten Sie die Verwendung des Schlüssels@odata.id, um den zugeordneten Datensatz zu definieren.Anforderung:
POST [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)/contact_customer_accounts/$ref HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "@odata.id": "[Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada)" }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0Bestätigen Sie den vorhergehenden Vorgang, indem Sie die Sammlung von Kontakten für das Konto Fourth Coffee abrufen. Die Antwort enthält das Element Array mit einem einzigen Element, das kürzlich dem Kontakt Rafel Shillo hinzugefügt wurde.
Anforderung:
GET [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)/contact_customer_accounts?$select=fullname,jobtitle HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 200 OK OData-Version: 4.0 { "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#contacts(fullname,jobtitle)", "value": [ { "@odata.etag": "W/\"72935741\"", "fullname": "Rafel Shillo", "jobtitle": "Senior Developer", "contactid": "0928bcb4-bb27-ed11-9db1-002248274ada" } ] }Konsolenausgabe:
Contact list for account 'Fourth Coffee': Name: Rafel Shillo, Job title: Senior DeveloperEntfernen der Zuordnung, die zwischen der Firma Fourth Coffee und dem Kontakte Rafel Shillo erstellt wurde.
Anforderung:
DELETE [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada)/contact_customer_accounts(0928bcb4-bb27-ed11-9db1-002248274ada)/$ref HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 204 NoContent OData-Version: 4.0Erstellen einer Sicherheitsrolle namens
Example Security Role.Anforderung:
POST [Organization Uri]/api/data/v9.2/roles HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "businessunitid@odata.bind": "businessunits(38e0dbe4-131b-e111-ba7e-78e7d1620f5e)", "name": "Example Security Role" }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0 OData-EntityId: [Organization Uri]/api/data/v9.2/roles(e359feba-bb27-ed11-9db1-002248274ada)Verknüpfen Sie das neue Sicherheitsrolle mit Ihrem Systembenutzerdatensatz.
Anforderung:
POST [Organization Uri]/api/data/v9.2/systemusers(4026be43-6b69-e111-8f65-78e7d1620f5e)/systemuserroles_association/$ref HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/json { "@odata.id": "[Organization Uri]/api/data/v9.2/roles(e359feba-bb27-ed11-9db1-002248274ada)" }Antwort:
HTTP/1.1 204 NoContent OData-Version: 4.0Konsolenausgabe:
Security Role 'Example Security Role' associated with to your user account.Rufen Sie die Beispielsicherheitsrolle mithilfe der Viele-zu-viele-Beziehung
systemuserroles_associationab:Anforderung:
GET [Organization Uri]/api/data/v9.2/systemusers(4026be43-6b69-e111-8f65-78e7d1620f5e)/systemuserroles_association?$select=name&$filter=roleid%20eq%20e359feba-bb27-ed11-9db1-002248274ada HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 200 OK OData-Version: 4.0 { "@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#roles(name)", "value": [ { "@odata.etag": "W/\"72935763\"", "name": "Example Security Role", "roleid": "e359feba-bb27-ed11-9db1-002248274ada" } ] }Konsolenausgabe:
Retrieved role: Example Security RoleTrennen Sie die Sicherheitsrolle von Ihrem Benutzerdatensatz. Beachten Sie erneut, das dieselbe allgemeine Syntax verwendet wird, die auch eine 1: n-Zuordnung entfernt..
Anforderung:
DELETE [Organization Uri]/api/data/v9.2/systemusers(4026be43-6b69-e111-8f65-78e7d1620f5e)/systemuserroles_association(e359feba-bb27-ed11-9db1-002248274ada)/$ref HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 204 NoContent OData-Version: 4.0
Abschnitt 5: Löschen von Tabellenzeilen
Jedes Element der Sammlung von Zeilen-URLs wird gelöscht. Der erste ist ein Kontaktdatensatz für Rafel Shillo.
Anforderung:
DELETE [Organization Uri]/api/data/v9.2/contacts(0928bcb4-bb27-ed11-9db1-002248274ada) HTTP/1.1 OData-MaxVersion: 4.0 OData-Version: 4.0 If-None-Match: null Accept: application/jsonAntwort:
HTTP/1.1 204 NoContent OData-Version: 4.0Nachfolgende Iterationen durch die Sammlung löschen die verbleibenden Datensätze.
Anforderung:
DELETE [Organization Uri]/api/data/v9.2/accounts(2728bcb4-bb27-ed11-9db1-002248274ada) HTTP/1.1 . . . DELETE [Organization Uri]/api/data/v9.2/accounts(2e28bcb4-bb27-ed11-9db1-002248274ada) HTTP/1.1 . . . DELETE [Organization Uri]/api/data/v9.2/contacts(2f28bcb4-bb27-ed11-9db1-002248274ada) HTTP/1.1 . . . DELETE [Organization Uri]/api/data/v9.2/roles(e359feba-bb27-ed11-9db1-002248274ada) HTTP/1.1
Siehe auch
Verwenden der Dataverse-Web-API
Erstellen einer Tabellenzeile über die Web-API
Abrufen einer Tabellenzeile über die Web-API
Aktualisieren und Löschen von Tabellenzeilen über die Web-API
Zuordnen und Aufheben der Zuordnung von Tabellenzeilen über die Web-API
Beispiel grundlegender Web-API-Operationen (C#)
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).
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für