Freigeben über

deleteRecord (Client-API-Referenz)

Löscht einen Tabellendatensat.

Syntax

Xrm.WebApi.deleteRecord(entityLogicalName, id).then(successCallback, errorCallback);

Parameter

Name typ Erforderlich Beschreibung
entityLogicalName String Ja Den logischen Tabellennamen des Datensatzes, den Sie löschen wollen. Beispiel: account.
id String Ja GUID des Tabellendatensatzes, den Sie löschen möchten.
successCallback Function Nein Eine Funktion zum Aufrufen, wenn ein Datensatz gelöscht wird. Siehe Rückgabewert
errorCallback Function Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug. Es wird ein Objekt mit den folgenden Eigenschaften übergeben:
- errorCode: Zahl. Der Fehlercode als positive Dezimalzahl. Der als 0x80040333 dokumentierte Fehlercode wird zum Beispiel als 2147746611 zurückgegeben.
- message: Zeichenfolge Eine Fehlermeldung, die das Problem beschreibt.

Rückgabewert

Bei Erfolg gibt dies ein Versprechen-Objekt mit den folgenden Eigenschaften an successCallback zurück:

Name typ Beschreibung
entityType String Der logische Tabellenname des Datensatzes.
id String GUID des Datensatzes.
name String Name des Datensatzes.

Beispiele

In diesen Beispielen werden einige der gleichen Anforderungsobjekte verwendet, wie in Aktualisieren und löschen Sie Tabellen mithilfe der Web-API gezeigt, um das Datenobjekt zum Aktualisieren eines Entitätsdatensatzes zu definieren.

Löscht ein Konto mit der Datensatz-ID = 5531d753-95af-e711-a94e-000d3a11e605.

Xrm.WebApi.deleteRecord("account", "5531d753-95af-e711-a94e-000d3a11e605").then(
    function success(result) {
        console.log("Account deleted");
        // perform operations on record deletion
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Xrm.WebApi

  • Last updated on