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

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'});

rewind(params[, options])

'Rewind' applies to time-based models; it replays the model and stops before the last instance of the rewind operation.

Note that for this action to work, you need define "rewind":{"name": "step"} in your model context file, where step is the name of the operation you typically rewind.

Parameters

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

Example

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

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'] });