Teilen über


createRecord (JavaScript API-Referenz) für Dynamics 365-Kanalintegrationsframework 1.0

Erstellt einen Entitätsdatensatz.

Syntax

Microsoft.CIFramework.createRecord(entityLogicalName, data).then(successCallback, errorCallback);

Parameter

Name des Dataflows Typ Erforderlich Beschreibung
entityLogicalName Zeichenfolge Ja Der logische Name der zu erstellenden Entität Zum Beispiel: "Konto".
data Zeichenfolge Ja Zeichenfolge, die die Attribute und Werte für den neuen Entitätsdatensatz definiert.
successCallback Funktion Nein Eine Funktion zum Aufrufen, wenn ein Datensatz erstellt wird.
errorCallback Funktion Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Bei Erfolg wird ein Promise zurückgegeben, das eine Zeichenfolge mit den Attributen und ihren Werten enthält.

Beispiele

Der Beispielcode demonstriert, die Erstellung eines Beispiel-Kontaktdatensatzes.

var entityLogicalName = "contact";
var data = {
    "firstname": "Sample",
    "lastname": "Contact",
    "fullname": "Sample Contact",
    "emailaddress1": "contact@contoso.com",
    "jobtitle": "Sr. Marketing Manager",
    "telephone1": "555-0109",
    "description": "Default values for this record were set programmatically."
}
// create contact record
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.createRecord(entityLogicalName,jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact created with ID: " + res.id);
          //perform operations on record creation
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
  ); 

Das folgende Beispiel zeigt, wie Sie einen Nachschlagewert anstelle von Klartext in die Variable data übergeben können.

var data =
    {
        "name": "Sample Account",
        "primarycontactid@odata.bind": "/contacts(3518ddae-2f46-e911-8190-000d3a6ce16d)"
    }
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.createRecord("account",jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact created with ID: " + res.id);
          //perform operations on record creation
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
);