$.udb.executeInContext()

$.udb.executeInContext()

Switches the default context of a function call. Use this function if there is a need to cross the boundaries of context, so that you need to explicitly identify the target context. This occurs, for example, when a VariableSet data source on a page in one frame must be accessed by controls on a page in a different frame.

Returns the result of executing the func function. This could be a result value, or a Promise object that yields a result value. From USoft 10.0.1I, instead of a Promise object, a udbPromise object is returned.

Syntax

.executeInContext( context, func )

The required context refers to the root context if it has the value "" (empty string). A subframe within the root context is referred to by the name of the frame. In context, names of frames contained in frames are separated from the name of the containing frame by a forward slash:

$.udb.executeInContext("MyFrame/SubFrame", function() { … });

The required func is the function call for which the default context is being switched.

Prior to USoft 10.0.1I, $.udb.executeInContext() was necessary if you were using .then() to take a next step if a promise was fulfilled, but in that next step, you wanted to refer back to the context of the previous step, because .then() have up that context by default:

$.udb('TOUR').executeQuery().then(function(dsc){
  var searchCols = {};  
  dsc.searchCols().each(function(index,col){
      searchCols[col.name()] = col.val();
  });
  $.udb.executeInContext( dsc.context, function(){
    $.udb.navigateTo("Tours Info 1.2 Results").then(function(){
      $.udb('TOUR').searchCols().each(function(index,col){
        col.val(searchCols[col.name()]);
      });
    });
  });
});

From USoft 10.0.1I, with the advent of udbPromise, this is no longer necessary:

$.udb('TOUR').executeQuery().then(function(dsc){
  var searchCols = {};  
  dsc.searchCols().each(function(index,col){
      searchCols[col.name()] = col.val();
  });
  $.udb.navigateTo("Tours Info 1.2 Results").then(function(){
    $.udb('TOUR').searchCols().each(function(index,col){
      col.val(searchCols[col.name()]);
    });
  });
});