Sdílet prostřednictvím


updateRecord (Referenční dokumentace rozhraní JavaScript API) pro Dynamics 365 Channel Integration Framework 1.0

Aktualizuje záznam entity.

Syntaxe

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

Parametry

Název Typ Povinné Description
Logický_název entity String Ano Logický název entity záznamu, který chcete aktualizovat. Příklad: "účet".
identifikační číslo String Ano Identifikátor GUID záznamu entity, který chcete aktualizovat.
data String Ano

Řetězec obsahující key: value páry, kde key je vlastnost entity a value je hodnota vlastnosti, kterou chcete aktualizovat.

V příkladech dále v tomto tématu se dozvíte, jak můžete definovat data řetězec pro scénář aktualizace.

úspěchZpětné volání Funkce Ne

Funkce, která se má volat při aktualizaci záznamu.

errorCallback Funkce Ne Funkce, která se má volat v případě selhání operace.

Návratová hodnota

Při úspěchu vrátí příslib obsahující řetězec s aktualizovanými atributy a jejich hodnotami.

Examples

Tento ukázkový kód aktualizuje existující záznam kontaktu s ID záznamu = 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
      }
  );