Creating Records with Remote Objects
Create a record by calling create() on a Remote
Objects model instance.
create() accepts two
arguments, both optional.
RemoteObjectModel.create({field_values}, callback_function)
The field_values block
enables you to define and create a record in one statement. Set field
values as you do when you create a model, using a JSON string. For
example, the following two calls to create() are equivalent.
var ctDetails = { FirstName: 'Marc', LastName: 'Benioff' };
// Call create() on an existing Contact model, with no arguments
var ct = new RemoteObjectModel.Contact(ctDetails);
ct.create();
// Call create() on an empty Contact model, passing in field values
var ct = new RemoteObjectModel.Contact();
ct.create(ctDetails);
create() doesn’t
return a result directly. The callback function enables you to handle
the server response asynchronously.
Your callback function
can accept up to three arguments.
See Remote
Objects Callback Functions for details about writing Remote
Objects callback functions.
function callback(Error error, Array results, Object event) { // ... }
The Id field is set on
the Remote Object as part of a successful create() call. You can access this
field in your callback function.
Note the use of the log() function; it’s the equivalent of toString() for Remote
Objects.
var ctDetails = { FirstName: 'Marc', LastName: 'Benioff' };
var ct = new RemoteObjectModel.Contact();
ct.create(ctDetails, function(err) {
if(err) {
console.log(err);
alert(err.message);
}
else {
// this is the contact
console.log(ct.log()); // Dump contact to log
console.log(ct.get('Id')); // Id is set when create completes
}
});