createRecord (Client-API-Referenz)

  • Artikel

Erstellt einen Tabellendatensatz.

Syntax

Xrm.WebApi.createRecord(entityLogicalName, data).then(successCallback, errorCallback);

Parameter

Name des Dataflows Type Erforderlich Beschreibung
entityLogicalName String Ja Logischer Name der Tabelle, die Sie erstellen möchten. Beispiel: account.
data Object Ja Ein JSON-Objekt, dass die Spalten und Werte für den neuen Tabellendatensatz definiert. Siehe Beispiele
successCallback Function Nein Eine Funktion zum Aufrufen, wenn ein Datensatz erstellt 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: Nummer. Der Fehlercode.
- 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 des Dataflows Type Beschreibung
entityType String Den logischen Tabellennamen des neuen Datensatzes.
id String GUID des neuen Datensatzes.

Beispiele

In diesen Beispielen werden einige der gleichen Anforderungsobjekte verwendet, wie in Erstellen einer Tabellenzeile mithilfe der Web-API gezeigt, um das Datenobjekt zum Erstellen eines Tabellendatensatzes zu definieren.

Grundlegende Erstellung

Einen Firmendatensatz erstellen.

// define the data to create new account
var data =
    {
        "name": "Sample Account",
        "creditonhold": false,
        "address1_latitude": 47.639583,
        "description": "This is the description of the sample account",
        "revenue": 5000000,
        "accountcategorycode": 1,
        "opendeals_date": new Date("2024-02-03T00:00:00Z")
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Hinweis

Das Erstellen von Datensätzen mit einem primären Bild wird im Offlinemodus nicht unterstützt. Primäre Bilder können nur mit „Erstellen“ im Onlinemodus festgelegt werden. Andere Bildspalten können mit „Erstellen“ nicht festgelegt werden. Weitere Informationen zu primären Bildern

Sie können miteinander verknüpfte Tabellen erstellen, indem Sie sie als Werte für Navigationseigenschaften definieren. Dieses Muster ist bekannt als tiefes Einfügen. In diesem Beispiel wird ein Beispielfirmendatensatz erstellt zusammen mit dem Datensatz des primären Kontakts und einem zugeordneten Verkaufschancendatensatz.

Hinweis

Das Erstellen verwandter Tabellendatensätze in einem einzelnen Erstellungsvorgang wird im Offline-Modus nicht unterstützt.

// define data to create primary and related table records
var data =
    {
        "name": "Sample Account",
        "primarycontactid":
        {
            "firstname": "John",
            "lastname": "Smith"
        },
        "opportunity_customer_accounts":
        [
            {
                "name": "Opportunity associated to Sample Account",
                "Opportunity_Tasks":
                [
                    { "subject": "Task associated to opportunity" }
                ]
            }
        ]
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Ordnen Sie Tabellen beim Erstellen neuer Datensätze zu

Um neuen Tabellendatensätzen vorhandene Tabellendatensätze zuzuordnen, legen Sie den Wert der einwertigen Navigationseigenschaften mithilfe der @odata.bind Anmerkung fest.

Hinweis

Die Namen von einwertigen Navigationseigenschaften sind nicht immer identisch mit dem LogicalName für das Suchattribut. Sie sollten sicherstellen, dass Sie den Name-Attributwert des NavigationProperty-Elements im $metadata-Servicedokument der Web-API verwenden. Weitere Informationen: Web API-Navigationseigenschaften

Im Folgenden finden Sie ein Code-Beispiel:

Im folgenden Beispiel wird ein Firmendatensatz erstellt und in einen vorhandenen Kontaktdatensatz eingeordnet, um den letzteren als primären Kontakt für den neuen Firmendatensatz festzulegen:

var data =
    {
        "name": "Sample Account",
        "primarycontactid@odata.bind": "/contacts(465b158c-541c-e511-80d3-3863bb347ba8)"
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Veraltete Methode für mobile offline Szenarien

Hinweis

Anstatt das zuvor gezeigte @odata.bind-Anmerkungsbeispiel zu verwenden, wird das veraltete Nachschlage- Objekt mit Eigenschaften, bei denen die Groß- und Kleinschreibung beachtet wird (logicalname und id), für vorhandene Anpassungen weiterhin unterstützt. Es wird jedoch empfohlen, die @odata.bind-Anmerkung für Online- und Offline-Szenarien zu verwenden, statt dieses veraltete Objekt zu verwenden.

Im folgenden Beispiel wird die veraltete Methode verwendet, um einen Firmendatensatzes zu aktualisieren, der mit einem weiteren Kontaktdatensatz als primären Kontakt für die Firma in der mobilen Clients verknüpft ist, während Sie im Offlinemodus arbeiten:

var data =
    {
        "name": "Sample Account",
        "primarycontactid":
        {
            "logicalname": "contact",
            "id": "465b158c-541c-e511-80d3-3863bb347ba8"
        } 
    }

// create account record
Xrm.WebApi.offline.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Erstellen einer Tabellenzeile über die Web-API
Xrm.WebApi

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).