$.udb.rollback()

note

This article is about the rollback() function of the udb object.

$.udb.rollback()

Rolls back manipulated data.

Returns a Promise object or the 'this' object. From USoft 10.0.1I, returns a udbPromise instead of a Promise object.

Syntax

.rollback( *options* )

*options*          ::=  {
    keepSelections: *keep-selections*,
    quiet: *quiet*,
    promise:  *promise*,
    success: *success-function*,
    error: *error-function*
}

*keep-selections*  ::=  { true | false }
*quiet*            ::=  { true | false }
*promise*          ::=  { true | false }

Options is a struct that can have the following items, all of which are optional.

Keep-selections is a boolean that specifies whether the current record remains the same after rollback:

Value	Description
true (the default)	The current record is guaranteed to be the same record as before the rollback, in the sense of "the same data": the record with the same primary key values.
false	The current record after rollback is guaranteed to be the record that has the same position in the row set as the current record had before the rollback.

Quiet is a boolean that determines whether or not a message is displayed when the rollback is completed. The default is false, meaning that a message is displayed by default.

*Promise *determines the return value of this function. If promise has the value 'true' (the default), a Promise object is returned. If promise has the value 'false', the ‘this’ object is returned instead.

Success-function is a function called when the rollback is completed.

Error-function is a function called if the rollback fails.

Example

$.udb.rollback({
    success: function(event,state){
        if(state.msg=='')alert('Succeeded!');
    }
);