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

建立實體記錄。

語法

Microsoft.CIFramework.createRecord(entityLogicalName, data).then(successCallback, errorCallback);

參數

名稱	類型	為必填項目	Description
實體邏輯名稱	繩子	Yes	您要建立之實體的邏輯名稱。 例如：「帳戶」。
資料	繩子	Yes	定義新實體記錄屬性和值的字串。
successCallback 回調	功能	否	建立記錄時要呼叫的函式。
errorCallback 回調	功能	否	作業失敗時要呼叫的函式。

傳回值

成功時，傳回包含包含屬性及其值的字串的 promise。

範例

範例程式碼示範如何建立範例連絡人記錄。

var entityLogicalName = "contact";
var data = {
    "firstname": "Sample",
    "lastname": "Contact",
    "fullname": "Sample Contact",
    "emailaddress1": "contact@contoso.com",
    "jobtitle": "Sr. Marketing Manager",
    "telephone1": "555-0109",
    "description": "Default values for this record were set programmatically."
}
// create contact record
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.createRecord(entityLogicalName,jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact created with ID: " + res.id);
          //perform operations on record creation
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
  ); 

下列範例顯示如何在變數 data中傳遞查閱值，而不是純文字。

var data =
    {
        "name": "Sample Account",
        "primarycontactid@odata.bind": "/contacts(3518ddae-2f46-e911-8190-000d3a6ce16d)"
    }
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.createRecord("account",jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact created with ID: " + res.id);
          //perform operations on record creation
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
);