forio Toggle navigation

State API Adapter

The State API Adapter allows you to view the history of a run, and to replay or clone runs.

The State API Adapter brings existing, persisted run data from the database back into memory, using the same run id (replay) or a new run id (clone). Runs must be in memory in order for you to update variables or call operations on them.

Specifically, the State API Adapter works by "re-running" the run (user interactions) from the creation of the run up to the time it was last persisted in the database. This process uses the current version of the run's model. Therefore, if the model has changed since the original run was created, the retrieved run will use the new model — and may end up having different values or behavior as a result. Use with care!

To use the State API Adapter, instantiate it and then call its methods:

 var sa = new F.service.State();
 sa.replay({runId: '1842bb5c-83ad-4ba8-a955-bd13cc2fdb4f'});

Constructor options

None

Methods

load(runId[, options])

View the history of a run.

Parameters

Required? Name Type Description
Yes runId string The id of the run.
  options object Overrides for configuration options.

Example

var sa = new F.service.State();
sa.load('0000015a06bb58613b28b57365677ec89ec5').then(function(history) {
      console.log('history = ', history);
});

replay(params[, options])

Replay a run. After this call, the run, with its original run id, is now available in memory. (It continues to be persisted into the Epicenter database at regular intervals.)

Parameters

Required? Name Type Description
Yes params object Parameters object.
Yes params.runId string The id of the run to bring back to memory.
  params.stopBefore string The run is advanced only up to the first occurrence of this method.
  params.exclude Array.<string> Array of methods to exclude when advancing the run.
  options object Overrides for configuration options.

Example

var sa = new F.service.State();
sa.replay({runId: '1842bb5c-83ad-4ba8-a955-bd13cc2fdb4f', stopBefore: 'calculateScore'});

clone(params[, options])

Clone a given run and return a new run in the same state as the given run.

The new run id is now available in memory. The new run includes a copy of all of the data from the original run, EXCEPT:

  • The saved field in the new run record is not copied from the original run record. It defaults to false.
  • The initialized field in the new run record is not copied from the original run record. It defaults to false but may change to true as the new run is advanced. For example, if there has been a call to the step function (for Vensim models), the initialized field is set to true.
  • The created field in the new run record is the date and time at which the clone was created (not the time that the original run was created.)

The original run remains only in the database.

Parameters

Required? Name Type Description
Yes params object Parameters object.
Yes params.runId string The id of the run to clone from memory.
  params.stopBefore string The newly cloned run is advanced only up to the first occurrence of this method.
  params.exclude Array.<string> Array of methods to exclude when advancing the newly cloned run.
  options object Overrides for configuration options.

Example

var sa = new F.service.State();
sa.clone({runId: '1842bb5c-83ad-4ba8-a955-bd13cc2fdb4f', stopBefore: 'calculateScore', exclude: ['interimCalculation'] });