Creates a new object based on supplied properties and returns it. The object is not saved to the database; it only exists in memory. Property names and values can be passed in either using named arguments or as a struct to the properties argument.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| properties | struct | No | The properties you want to set on the object (can also be passed in as named arguments). | |
| callbacks | boolean | No | true | See documentation for save. |
<!--- Create a new author in memory (not saved to the database) --->
<cfset newAuthor = model("author").new()>
<!--- Create a new author based on properties in a struct --->
<cfset newAuthor = model("author").new(params.authorStruct)>
<!--- Create a new author by passing in named arguments --->
<cfset newAuthor = model("author").new(firstName="John", lastName="Doe")>
<!--- If you have a `hasOne` or `hasMany` association setup from `customer` to `order`, you can do a scoped call. (The `newOrder` method below will call `model("order").new(customerId=aCustomer.id)` internally.) --->
<cfset aCustomer = model("customer").findByKey(params.customerId)>
<cfset anOrder = aCustomer.newOrder(shipping=params.shipping)>