Dynamics 365 チャネル統合フレームワーク 1.0 の createRecord (JavaScript API リファレンス)
エンティティ レコードを作成します。
構文
Microsoft.CIFramework.createRecord(entityLogicalName, data).then(successCallback, errorCallback);
Parameters
件名 | タイプ | Required | Description |
---|---|---|---|
entityLogicalName | String | あり | 作成するエンティティの論理名。 たとえば、「account」。 |
データ | String | 有効 | 新しいエンティティ レコードの属性および値を定義する文字列。 |
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
}
);