LCDS DataService.commit() undocumented arguments

I was working on a LCDS project with Flex Builder when I realized that code-hinting was providing me information for arguments regarding the commit method on the DataService class.

If you take a look here you'll see that commit method isn't expecting any argument. The 2 arguments Flex Builder was listing was ItemsOrCollections and cascadeCommit.

Jeff Vroom, told me that it was something they implemented in 2.5 but they didn't documented it yet. While the commit() will send all changes in all managed objects, providing an array of objects or a collection will only commit those specific changes to the server.

This allows me to edit 2 (or more) records and only commit in fact one of them to the server.

The second parameter is important and it should be set to true, when your Value Object depends upon another uncommited changes from a related Object.