Dynamics 365 チャネル統合フレームワーク 1.0 の updateRecord (JavaScript API リファレンス)

  • [アーティクル]

エンティティ レコードを更新します。

構文

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

Parameters

件名 タイプ Required Description
entityLogicalName String あり 更新するレコードのエンティティの論理名。 たとえば、「account」。
ID String 可 更新するエンティティ レコードの GUID。
データ String あり

key: value ペアを含む文字列では、key はエンティティのプロパティであり、value は、更新するプロパティの値です。

更新シナリオ向けに data 文字列を定義する方法については、このトピックの以降の例を参照してください。
successCallback 機能 なし

レコードを更新した場合に呼び出す関数。
errorCallback 機能 なし 処理が失敗したときに呼び出す関数。

戻り値

成功すると、更新した属性とその値を持つ文字列を含む Promise が返されます。

例

このサンプル コードは、レコード 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
      }
  );