For the complete documentation index, see llms.txt. This page is also available as Markdown.

Tracking and reverting workspace changes

Required workspace permissions:

  • To view the history, View the Protection Audit Trail.

  • To restore an earlier version, Configure workspace settings.

The workspace Version History tracks updates related to detecting and protecting sensitive data in the workspace.

You can review the updates and restore the workspace to a specific version.

Types of actions that the Version History tracks

The Version History for a workspace includes the following types of actions:

  • Changes to column sensitivity.

  • Changes to table mode assignments.

  • Changes to the generator assignment.

  • Changes to the generator configuration.

  • Changes to the subsetting configuration.

  • Changes to post-job scripts.

Displaying the Version History

To display the version history, in the workspace heading, click the history icon.

The Version History is grouped by day. The most recent version is at the top of the list.

Displaying details for a day

By default, each day is collapsed. When you click a day, Structural displays the list of timestamps when changes occurred.

By default, the timestamps are collapsed.

When you expand a timestamp, the details include:

  • The specific changes.

  • Who performed each change. This might be a specific user or the Structural Agent acting on behalf of a user.

  • Version History panel with an expanded entry

Filtering the Version History

To display the available filters, click the filter icon.

Filters for the workspace Version Jistory

Displaying changes from a specific timeframe

You can filter the version history to view changes from a specific timeframe.

On the filter panel, under Date:

  1. In the Start field, specify the start date for the timeframe to include.

  2. In the End field, specify the end date for the timeframe to include.

Displaying specific types of changes

You can filter the version history to only view specific types of changes. For example, you might only want to see changes to column sensitivity.

Under Change Type, check the checkbox next to each type of change to include.

Displaying changes based on who performed them

On the filter panel, under User, you can filter the version history to only show actions performed by specific users, including the Structural Agent.

Searching for a user name

To search for a user by name, in the search field, begin to type the user name. The list of users is filtered to only display matching users.

Setting the type of actor to include

You can choose to filter actions based on the type of actor that performed the action.

By default, the version history includes actions for all types of actors, both users and the Structural Agent.

To only include actions that a user performed directly, click User.

To only include actions that the Structural Agent performed, click Agent.

Selecting specific users to include

If you configure the version history to include user-triggered actions, then you can limit the history to actions that were performed by specific users.

Check the checkbox next to each user for which to include events in the version history.

Restoring an earlier version

You can restore the workspace to an earlier version.

Structural can only undo the changes that it tracks. Structural cannot undo the following:

  • Actions that you do not have permission to perform.

  • Actions that occur outside of the workspace. For example, if a generator preset configuration changed since the version that you are restoring to, that preset configuration is not reverted.

  • Changes to the workspace data. Restoring a version does not undo any source data schema changes that occurred since then.

  • For child workspaces, changes to the parent workspace configuration.

To restore the workspace to a version, click the Restore link for that version.

Last updated

Was this helpful?