Moves the processing flow to a specific data set in the data source.
Each data set consist of n records, where n is determined by the dataSetSize() function of the DataSourceMetaContainer object. The number of available data sets is the total number of records divided by n.
A new data set is queried only if the data is not already available on the client, or not anymore, possibly because the lifeTime() function has caused it to expire.
When you call this function, it is executed for all data sources in the container object. To move between data sets on a single data source's Rowset, use rowSet.gotoDataSet() instead.
Returns a Promise object or the 'this' object.
The required index is a string or an integer that identifies the data set that must become the active data set, using values as follows:
The optional options is a struct that can have the following items, all of which are optional.
Key-string is a keys string that identifies a rowset. If key-string is passed, the gotoDataSet action is performed on this specific rowset.
Promise determines the return value of this function. If promise has the value of 'true' (the default), a Promise object is returned. If promise has the value of 'false', the ‘this’ object is returned instead.
Success-function is a function called after the data was processed on the client.
Error-function is a function called when an error occurs.
NOTE: The last of these Examples is equivalent to: