EntitySave

Description

Saves or updates data of the entity and all related entities to the database. ColdFusion automatically tries to find if a new record should be inserted or an existing record be updated for the given entity. If you set forceinsert=true, then ColdFusion tries to insert the entity as a new record.

Returns

Void

Category

ORM functions

Function Syntax

EntitySave(entity, [forceinsert])

See Also

EntityLoad, EntityLoadByExample, EntityDelete

History

ColdFusion 9: Added this function.

Parameters

Parameter

Description

entity

Name of the entity that must be saved in the database.

forceinsert

If true, then ColdFusion always tries to insert the entity as a new record.

Example

To save an entity:

<cfset employee = createObject("Employee")> 
<cfset employee.setFirstName("Marcia")> 
<cfset employee.setlastName("Em")> 
<cfset EntitySave(employee)>

To update an entity:

<cfset employee = EntityLoad('employee', 100, true)> 
<cfset employee.setLastName("Em")> 
<cfset EntitySave(employee)>