Skip to main content
Gainsight Inc.

How User State Preservation works with Dashboards

Introduction

This article describes how “User State Preservation” works with Dashboards, and in particular, when admins make changes to the reports in the Report Builder.

What is User State Preservation: Selections or actions made by a user on Gainsight Home are remembered and their most recent selection or action persists when they return to the page after navigating away.

Selections/Actions - User State Preserved

The following selections or actions in Reporting are “User State Preserved”:

  • Report Filters
  • Visualization Type
  • Ranking
  • Chart Options
  • Table Options

Report Filters

Modifying Existing Filters

Filters are User State Preserved, which enables multiple users to have their own state maintained on the filters. When admins make any changes to the Filters on a report on which a CSM has already modified to have his own state of filters, those changes are not automatically propagated to the Gainsight Home tab, instead CSM’s state prevails.

The following use case explains how User State Preservation works when Filters are modified:

  1. Navigate to Administration > Report Builder.
  2. Select a report from the repository.
  3. Click on the existing report filter to modify it.
  4. Click Save.
  5. Navigate to Gainsight Home.
  6. Select the relevant dashboard from the dropdown list, under which the relevant report is available.

You see that the changes made above are not propagated to the Gainsight Home due to User State Preservation.

Raw Filters.gif

To propagate any changes made to the report filter to Gainsight Home, remove the report from the dashboard and add it again.

Remove and Add Container.gif

Visualization Type

Visualization Types are User State Preserved which enables multiple users to have their own state preserved. When admins make any changes to the Visualization Type for a report on which a CSM has already modified to have his own state of visualization type, those changes are not automatically propagated to the Gainsight Home tab, instead CSM’s state prevails.

The following use case explains how User State Preservation works with Visualization Type:

  1. Navigate to Administration > Report Builder.
  2. Select a report from the repository.
  3. Click Select Visualization Type to modify the type from Bar chart to Column chart.
  4. Click Save.
  5. Navigate to Gainsight Home.
  6. Select the relevant dashboard from the dropdown list, under which the relevant report is available.

You see that the changes made above are not propagated to the Gainsight Home due to User State Preservation.

Visualization 1.gif

Ranking

Ranking assigned for Reports by a CSM on the Gainsight Home tab is User State Preserved, which enables multiple users to have their own state preserved. When admins make any changes to the Ranking for a report on which a CSM has already modified to have his own state of ranking, those changes are not automatically propagated to the Gainsight Home tab, instead CSM’s state prevails.

The following use case explains how User State Preservation works with Ranking:

  1. Navigate to Administration > Report Builder.
  2. Select a report from the repository.
  3. Click the gear icon on the report you want to assign ranking.
  4. Click Ranking to modify the existing setting.
  5. Click Save.
  6. Navigate to Gainsight Home.
  7. Select the relevant dashboard from the dropdown list, under which the relevant report is available.

You see that the changes made above are not propagated to Gainsight Home due to User State Preservation.

Ranking in USP.gif

Chart Options

Chart Options assigned for Reports by a CSM on the Gainsight Home tab is User State Preserved, which enables multiple users to have their own state preserved. When admins make any changes to the Chart Options for a report on which a CSM has already modified to have his own state of chart options, those changes are not automatically propagated to the Gainsight Home tab, instead CSM’s state prevails.

The following use case explains how User State Preservation works with Chart Options:

  1. Navigate to Administration > Report Builder.
  2. Select a report from the repository.
  3. Click the gear icon on the report you want to assign Chart Options.
  4. Click Chart Options to modify the existing setting.
  5. Click Save.
  6. Navigate to Gainsight Home.
  7. Select the relevant dashboard from the dropdown list, under which the relevant report is available.

You see that the changes made above are not propagated to Gainsight Home due to User State Preservation.

Chart Options.gif

Table Options

Table Options assigned for Reports by a CSM on the Gainsight Home tab is User State Preserved, which enables multiple users to have their own state preserved. When admins make any changes to the Table Options for a report on which a CSM has already modified to have his own state of table options, those changes are not automatically propagated to the Gainsight Home tab, instead CSM’s state prevails.

The following use case explains how User State Preservation works with Table Options:

  1. Navigate to Administration > Report Builder.
  2. Select a report from the repository.
  3. Click the gear icon on the report you want to assign Table Options.
  4. Click Table Options to modify the existing setting.
  5. Click Save.
  6. Navigate to Gainsight Home.
  7. Select the relevant dashboard from the dropdown list, under which the relevant report is available.

You see that the changes made above are not propagated to Gainsight Home due to User State Preservation.

Table Options.gif

To Remove User State Preservation

Users can clear all the state preserved selections/actions made by them on Gainsight Home. The following use case explains about how to remove the state preserved Ranking and Chart Options:

  1. Navigate to Gainsight Home.
  2. Click the gear icon on the report you want to remove existing state preserved selections/actions.
  3. Click Clear Settings/Filters.
  4. Click YES.

Clear Settings.gif

Selections/Actions - Automatically Propagated to GS Home tab

The following structural changes to the report made by admin are automatically propagated to the Gainsight Home tab:

Show me

When admins add a new field to Show me, or removes a field from Show me to the report that already exists in a dashboard, the changes are propagated to Gainsight Home automatically.

The following use case explains about the Show me fields:

  1. Navigate to Administration > Report Builder.
  2. Select a report from the repository.
  3. Click + on Show me to add an additional field.
  4. Click Save.
  5. Navigate to Gainsight Home.
  6. Select the relevant dashboard from the dropdown list, under which the relevant report is available.

CSMs can see the new Show me field in the latest dashboard on Gainsight Home.

Show Me.gif

By

When admins add a new field to By, or removes a field from By to the report that already exists in a dashboard, the changes are propagated to Gainsight Home automatically.

The following use case explains about By fields:

  1. Navigate to Administration > Report Builder.
  2. Select a report from the repository.
  3. Click + on By to add an additional field.
  4. Click Save.
  5. Navigate to Gainsight Home.
  6. Select the relevant dashboard from the dropdown list, under which the relevant report is available.

CSMs can see the new By field in the latest dashboard on Gainsight Home tab.

By .gif

New Filters

When admins add a new Filter to the report that already exists in a dashboard, the changes are propagated to Gainsight home automatically.

The following use case explains about the New Filters:

  1. Navigate to Administration > Report Builder.
  2. Select a report from the repository.
  3. Click the filter icon to add an additional filter.
  4. Click Save.
  5. Navigate to Gainsight Home.
  6. Select the relevant dashboard from the dropdown list, under which the relevant report is available.

CSM’s can see the new filter in the latest dashboard on Gainsight Home.

Aggregated Filters.gif

Selections/Actions - Not State Preserved

Currently the following selections or actions in Reporting are “Not User State Preserved”:

Column Sorting

Sorting a table column in a report on Gainsight Home is not state preserved.

For instance, on Gainsight Home, when a CSM sorts the table column in a report, and refreshes the page, CSM cannot see the new changes made. Instead, the column sorting returns to the previous state as original.

Sorting Options.gif

Column Resizing

Resizing a table column in a report on Gainsight Home is not state preserved.

For instance, on Gainsight Home, when a CSM modifies the size of the table column in a report, and refreshes the page, CSM cannot see the new changes made. Instead, the column size returns to the previous state as original.

Resize Column.gif

  • Was this article helpful?