用于 Dynamics 365 渠道集成框架 1.0 的 createRecord(JavaScript API 参考)

创建实体记录。

Syntax

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

参数

Name 类型 必选 Description
实体逻辑名称 String 是的 要创建的实体的逻辑名称。 例如:“帐户”。
数据 String 是的 定义新实体记录的属性和值的字符串。
success回调 功能 创建记录时要调用的函数。
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
      }
);