Del via


updateRecord (JavaScript API-reference) til Dynamics 365 Channel Integration Framework 1.0

Opdaterer en objektpost.

Syntaks

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

Parametre

Navn Type Påkrævet Beskrivelse
entityLogicalName String Ja Det logiske objektnavn på den post, du vil opdatere. For eksempel: "konto".
id String Ja GUID for den objektpost, du vil opdatere.
data String Ja

Streng, der indeholder key: value par, hvor key er egenskaben for objektet og value er værdien af den egenskab, du vil opdatere.

Se eksempler senere i dette emne for at se, hvordan du kan definere strengen data for opdateringsscenariet.

succesTilbagekald Funktion Nej

En funktion, der skal kaldes, når en post opdateres.

errorCallback Funktion Nej En funktion, der skal kaldes, når handlingen mislykkes.

Afkast værdi

Når det lykkes, returneres et løfte, der indeholder en streng med de opdaterede attributter og deres værdier.

Eksempler

Denne eksempelkode opdaterer en eksisterende kontaktpost med post-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
      }
  );