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
      }
);