saveLog() for Lightning Experience

Usage

Saves or updates an object in Salesforce. This method is available in API version 38.0 or later.

To update using this method, include Id.
To create using this method, include entityApiName.
If an object uses recordType, pass the recordTypeId in the saveLog call. If you don’t pass the recordType, the record is created using the default recordType for the profile. To create a person account, you can pass the person account recordType if the profile’s default is to a business account.
To refresh after you update or create using this method, call the refreshView method in the callback method.

Note

Syntax

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

Arguments

Name	Type	Description
`value`	object	Specifies the fields to save or update on the object. If the object’s ID is specified, a record is updated. If the object’s ID isn’t specified, a new record is created. Ensure all required fields are specified when creating a record.
`callback`	function	JavaScript method executed when the API method call is completed.

To update a record, include the object’s ID in value:

1{Id:"00QR0000000yN5iMAE", LastName:"New lastname" }

To create a record, include entityApiName instead:

1{entityApiName:"Contact", LastName:"LastName" },callback:callback}

Sample Code–HTML and JavaScript

1<html>
2<head>
3   <script type="text/javascript" src="http://domain:port/support/api//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>

Response

This method is asynchronous. The response is returned in an object passed to a callback method. The response object contains the following fields.

Name	Type	Description
`success`	boolean	Returns `true` if the API method call was invoked successfully, `false` otherwise.
`returnValue`	object	ID of object if creating or updating the object was successful; `null` if creating or updating the object wasn’t successful.
`errors`	array	If the API call was successful, this variable is `null`. If the API call failed, this variable returns an array of error messages.