创建实体记录。
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
}
);