適用於 Dynamics 365 管道整合架構 1.0 的 updateRecord （JavaScript API 參考）

更新實體記錄。

語法

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

參數

名稱	類型	為必填項目	Description
實體邏輯名稱	繩子	Yes	您要更新之記錄的實體邏輯名稱。 例如：「帳戶」。
識別碼	繩子	Yes	您要更新之實體記錄的 GUID。
資料	繩子	Yes	包含 key: value 配對的字串，其中 key 是實體的屬性，是 value 您要更新的屬性值。 請參閱本主題稍後的範例，以瞭解如何定義 data 更新案例的字串。
success回呼	功能	否	更新記錄時要呼叫的函式。
errorCallback	功能	否	作業失敗時要呼叫的函式。

傳回值

成功時，傳回一個承諾，其中包含具有更新屬性及其值的字串。

範例

此範例程式碼會更新記錄 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
      }
  );