Initiates a DataSource save, which involves getting all unsaved changes - created, updated and deleted items, and saving them using the configured remote.modify settings.

Triggers a change event on the DataSource object, which can be supressed by passing false as the first parameter of the save method.

var dataSource = new shield.DataSource({
    read: "/get_all.php",
    modify: {
        create: "/handle_updates.php",
        update: "/handle_updates.php",
        remove: "/handle_updates.php"
    schema: {
        fields: {
            Id: { path: "id", type: Number },
            Name: { path: "name", type: String }

// insert a new item at the end
    Id: ++max_id,
    Name: "New Item Name"

// save the changes;