ebs.insertEbs (Deprecated)

IMPORTANT!
This function has been deprecated starting with v24.1. To re-enable it, use the the sys-do-not-allow-client-side-direct-data-updates system parameter.

Adds a new record to an entity.

Syntax

Copy

ebs.insertEbs(modifyRequest: IModifyRequest, callback: any, errorCallback: any): void

Where ImodifyRequest has the following syntax:

Copy

{
        EntityName: "<<i>parent_entity</i>>",
        Values: [
                    {
                        Attribute: "<<i>attribute_name</i>>",
                        Value: "<<i>attribute_value</i>>"
                    },
                    ...
                    {
                        Attribute: "<<i>attribute_name</i>>",
                        Value: "<<i>attribute_value</i>>"
                    },
                ]
},

Parameter	Description
`parent_entity`	Name of the entity where you wish to insert the record.
`attribute_name`	Attribute name of the record you wish to insert.
`attribute_value`	The value you wish to insert for the record's attribute.

Response

Key	Description
`Id`	Unique identifier of the record you inserted.
`Message`	Indicates the outcome of the request.
`IsSuccess`	Indicates if the record insert was successful.

Examples

Insert record within the sales pipeline

An insurance company uses FintechOS for sales management. The company has a website which allows users to request information about the products and services. When users complete and submit the form, the ebs.insertEbs method is automatically triggered, creating a new record within the lead pipeline of the sales team.

Copy

ebs.insertEbs(modifyRequest:{
            EntityName: "account",
            Values: [{
                    Attribute: "name",
                    Value: "Derrick"
                    },
                    Attribute: "surname",
                    Value: "Rose"
                   }]
            },
                function(e){
                    console.log(e.IsSuccess);     // boolean - true
                    console.log(e.Message);       // Record inserted
                    console.log(e.Id);            // id of the newly inserted record
                }
);