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