History enables you to see how and when a model was changed and by whom. You can also view all changes made to a module or a range of cells in a module. In dashboards, your users can retrieve previous cell values by viewing the change history of a single data cell or column, range of cells or columns, or the entire grid.

You can view History for:

Although a Breakback operation can update many cells, this shows as a single event in History:

When you build and develop a model, it's saved by historical ID as you make your changes. If you want to step back in your model's history, drop some recent changes, and continue from an earlier point, you can restore the model to an earlier version by historical ID:

View change history for the entire model

The History option in Model Settings displays the last 1,000 changes made to the model. It shows what the change was, who made the change, and when. You can filter the changes by date.

  1. In Model Settings, click History.
  2. To view History for:
    • All changes that have occurred over the past 24 hours, select Last 24 hours, it's the default option.
    • The entire change history, select All.
    • A particular period, select Date range and then choose From and To dates. If you choose to:
    • Leave the From and To fields blank, all results are displayed from the beginning of time.
    • Select a From date but leave the To field blank, all results from the selected date until today's date are displayed.
    • Leave the From date blank but select a To date, all results from the beginning of time until the selected date are displayed.
  3. If you want to save the export as an Action for later use:
    1. Select the Save Options checkbox.
    2. If needed, edit the name for the Action.
    3. Note: The Save Options checkbox is only visible in Standard mode.
  4. Click Show History. A maximum of 1,000 model changes are shown.
  5. To save the complete list of changes, click Export. The export process respects any date filtering you have set and only those results appear in the text file. Changes to the model are listed in reverse chronological order with the most recent change shown first.
  6. Click OK to close the dialog.

If you view the model history filtered by date, you may see the message No changes found for selection. This is because only the last 1,000 changes are shown. If you're expecting to see model changes but instead receive a message that no changes are found, simply export. The export file will show all changes for the selected date range.

Because the index of cell changes must be initialized for each model, a timeout error, History truncated after 20s may display. If this happens, please try viewing the change history again.

Specific changes recorded

The change history of a model records one or more specific changes when a user adds, edits, deletes, or renames one of the following:

  • Actions
  • Currency qualifiers
  • Dashboards
  • Functional Areas
  • Import Data Sources
  • Import source mappings
  • Line item subsets
  • Line items
  • List properties
  • Lists, including list items
  • Modules
  • Processes
  • Revision tags
  • Roles
  • Saved views
  • Subsets of lists
  • Time settings
  • Undo operations.
  • If multiple cells were updated by a single operation—for example, when undoing Copy Across or Copy Down in a module—a separate change is recorded against every cell.
  • Users added or deleted
  • Versions

Changes made to elements not listed above, such as exports, appear in the change history with the general description Model change (no details available).

Specific changes are also recorded when a user runs most types of import.

Bulk data changes for imports

The change history records a "Bulk data change" when a user:

  • Imports a module from another Anaplan model.
  • Imports a new or existing list with corresponding list properties.

Imported list properties do not appear in the change history as separate changes. For example, if you updated two list properties for a large list of products via a list import, the change history records the following:

Importing these elements in bulk improves the speed and performance of list and module imports.

Security changes

Changes involving access drivers are recorded in the change history of a model as Security Changes.

Value of "Security Change" field Description

Indicates that an access driver was:

  • Manually enabled or disabled.
  • Enabled or disabled via a formula.
  • Applied to line items in one or both the Read Access Driver or Write Access Driver columns in Blueprint view.
NULL Indicates that an access driver wasn't involved in the change.

Access drivers are a component of Dynamic Cell Access.

View change history for cells in a module or a dashboard grid

All users can view data changes for a single module or selected cells; modeling changes are not shown. All user access permissions set within the model are respected.

The Show History menu option is only visible if your workspace administrator has enabled it. If you don't see it, check with your workspace administrator.

  1. In a module, or on a grid on a dashboard, select the cells for which you want to view change history.
  2. Tip: You can select a single cell, a range of cells, or one or more columns or rows. Select all visible cells in the module by clicking the top-left cell.
  3. View the Show History menu in one of the following ways:
    • Right-click the highlighted cells to view the context menu, then click Show History.
    • In modules, in the toolbar, click Data > Show History.
    • In dashboards, in the Dashboard Element menu for the grid, click Show History.
  4. Under Show History, you can view the change history for:
    • The previous 24 hours, seven days, or 30 days.
    • All changes made since the module or grid was created.
    • A specified date range.
    Caution: Retrieving all changes can take a long time, especially in large models.
  5. Review the change history in the History dialog. A maximum of 1,000 changes are shown in the dialog.
  6. If you want to export the complete change history as a tab delimited text file, click Export.

For dashboard grids, you can roll back to a previous value by copying the cell value and pasting it into the grid.

Breakback and History

Since a Breakback calculation can cause many cell values to change, a single entry is recorded for the Breakback operation. The individual cell columns are left blank and under Description the number of cells edited and affected is given.

Restore model to historical ID

When you view model history from the Settings tab, you can restore the model to an earlier version by ID.

  1. In the History dialog, select the ID that you want to revert to, and then click Restore to ID.
    • A dialog appears with the ID of the restore point you entered. If you want to revert to a different historical model version, you can overwrite the entered restore point ID.
    • If you click Restore to ID without selecting a restore point from the model history, the ID immediately before the current model version ID is entered as the default restore point.
  2. Click Restore. A confirmation dialog appears.
  3. Click OK. The model is restored to the entered ID restore point.
  4. Go to the Settings tab again and click History. The current model version is listed as restored from an earlier version and you can read-off the restore point ID.

Restore models in Deployed mode

If a model is in Deployed mode, you can only restore back to a restore point ID that existed after the model was last synchronized. Deployed mode is an Application Lifecycle Management (ALM) feature.