Lightning Experience の saveLog() | Open CTI 開発者ガイド

使用方法

オブジェクトを Salesforce で保存または更新します。このメソッドは API バージョン 38.0 以降で使用できます。

このメソッドを使用して更新するには、Id を含めます。
このメソッドを使用して作成するには、entityApiName を含めます。
オブジェクトで recordType を使用する場合、saveLog コールに recordTypeId を渡します。recordType を渡さない場合、プロファイルのデフォルトの recordType を使用してレコードが作成されます。プロファイルのデフォルトが法人取引先になっている場合に個人取引先を作成するには、個人取引先の recordType を渡すことができます。
このメソッドを使用した更新または作成の後、更新するには、callback メソッド内で refreshView メソッドを呼び出します。

メモ

構文

1sforce.opencti.saveLog({
2    value:{
3        entityApiName:string, //Optional
4        Id:string, //Optional
5        param:value //Optional
6        }, 
7    callback:function //Optional
8})

引数

名前	型	説明
value	object	保存または更新対象のオブジェクトの項目を指定します。オブジェクトの ID が指定されると、レコードが更新されます。次に例を示します。 `1{Id:"00QR0000000yN5iMAE", LastName:"New lastname" }` オブジェクトの ID が指定されない場合、新しいレコードが作成されます。次に例を示します。 `1{entityApiName:"Contact", LastName:"LastName" },callback:callback}` レコードを作成するには、すべての必須項目が指定されていることを確認します。メモ
callback	function	API メソッドコールが完了するときに実行された JavaScript メソッド。

サンプルコード – HTML および JavaScript

1<html>
2<head>
3   <script type="text/javascript" src="http://domain:port/support/api/42.0/lightning/opencti_min.js"></script>
4   <script type="text/javascript">
5      var callback = function (response) {
6         if (response.result) {
7            console.log('API method call executed successfully! returnValue:', response.returnValue);
8         } else { 
9            console.error('Something went wrong! Errors:', response.errors);
10         }
11      } 
12      function saveLog() {
13         //Update an existing object with the ID specified               
14         sforce.opencti.saveLog({value:{Id:"00QR0000000yN5iMAE", LastName:"New lastname" }, callback:callback});
15         //Create a contact
16         sforce.opencti.saveLog({value:{entityApiName:"Contact", LastName:"LastName" },callback:callback});
17         //Update a lead
18         sforce.opencti.saveLog({value:{Id:"00QR0000000yN5iMAE", LastName:"New lastname" },callback:callback});
19      } 
20   </script>
21</head>
22<body>
23   <button onclick="saveLog();">saveLog</button>
24</body>
25</html>

応答

このメソッドは非同期です。応答は、コールバックメソッドに渡されたオブジェクトで返されます。応答オブジェクトには次の項目が含まれます。

名前	型	説明
success	boolean	API メソッドコールが正常に呼び出された場合は `true`、それ以外の場合は `false` が返されます。
returnValue	object	オブジェクトが正常に作成または更新された場合はオブジェクトの ID、オブジェクトが正常に作成または更新されなかった場合は `null`。
errors	array	API コールが正常に行われた場合、この変数は `null` になります。API コールが失敗した場合、この変数はエラーメッセージの配列を返します。