Revert

Summary

Use the REVERT command to restore all domain objects in your Connect environment to a specific snapshot savepoint. Domain objects include steps, pipelines, schedules, emails, iterators, and variables.

Syntax

revert(snapshotid=<string>);

Parameters

Parameter
Description
snapshotid
Snapshot ids uniquely identify each distinct savepoint. SHOW SNAPSHOTS will provide a list of all available snapshot savepoints present in your Connect environment. Snapshot ids are unique to each Connect environment (Sandbox, Implement1, Securex, etc.).

Details

The command runs asynchronously on the Connect server cluster. Query SHOW INVOCATION DETAILS for information about start and stop times for the process.

Warning: REVERT will reset the state of all domain objects to how the system looked when the snapshot savepoint was originally taken. For example, if your environment currently has three step domain objects and you REVERT to a snapshot that only has two steps, the newer third step will no longer be available in your current list of available domain objects.

Any objects not found in the snapshot will be removed from the system (unless stored in a different snapshot savepoint)! Xactly recommends creating a new snapshot to record the latest state of the system before reverting to a historical snapshot savepoint. The new snapshot will allow you to restore the state of the system to its prior latest state if the historical snapshot savepoint is not what you expected.

REVERT allows you to restore the environment’s domain objects to any snapshot savepoint.

Your user account must have full Read-Write access to the Xactly Connect role (configured from the Incent UI) to use REVERT.

Examples

show snapshots;

screen-shot-2016-09-22-at-9-27-36-am

/* Restore the system to the first snapshot. */

revert (snapshotid=’2c90941856a67e3401570688e2db14da’);

screen-shot-2016-09-22-at-9-27-48-am

/* Oops! I want to revert to the most recent snapshot. */

revert (snapshotid=’2c90941956a6808101570ae000202393′);

screen-shot-2016-09-22-at-9-27-57-am

Related Commands

CREATE SNAPSHOT

SHOW SNAPSHOTS