Teilen über


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

Aktualisiert einen Entitätsdatensatz.

Syntax

microsoft-ciframework.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);

Parameter

Name des Dataflows Typ Erforderlich Beschreibung
entityLogicalName Zeichenfolge Ja Der logische Entitätsname des Datensatzes, der aktualisiert werden soll. Zum Beispiel: "Konto".
id Zeichenfolge Ja GUID des Entitätsdatensatzes, den Sie aktualisieren möchten.
data Zeichenfolge Ja

Eine Zeichenfolge mit key: value-Paaren, wobei key die Eigenschaft der Entität und value der Wert der Eigenschaft ist, die Sie aktualisieren möchten.

Siehe Beispiele weiter unten in diesem Thema, um zu sehen, wie Sie die Zeichenfolge data für das Aktualisierungsszenario definieren können.

successCallback Funktion Nein

Eine Funktion zum Aufrufen, wenn ein Datensatz aktualisiert wird.

errorCallback Funktion Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Gibt bei Erfolg ein Promise zurück, das eine Zeichenfolge mit den aktualisierten Attributen und ihren Werten enthält.

Beispiele

Dieser Beispielcode aktualisiert einen bestehenden Kontaktdatensatz mit der Datensatz-ID = a8a19cdd-88df-e311-b8e5-6c3be5a8b200

//// define the data to update a record
var entityLogicalName = "contact";
var data = {
    "firstname": "Updated Sample",
    "lastname": "Contact",
    "fullname": "Updated Sample Contact",
    "emailaddress1": "contact@contoso.com",
    "jobtitle": "Sr. Marketing Manager",
    "telephone1": "555-0109",
    "description": "Updated values for this record were set programmatically."
}
// update contact record
var id = "b44d31ac-5fd1-e811-8158-000d3af97055";
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.updateRecord(entityLogicalName,id,jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact updated with ID: " + res.id);
          //the record is updated
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
  );