Refreshing Shared Variables

When Shared Variables are added to a Report Package, the service notifies the Report Package Owners about any modifications to those variables. The Report Package Owner then needs to refresh the variables within the report package to receive the updated values and process them within the report.

Most commonly, the shared variable value changes and the report package needs to be refreshed to receive the new value. Only the Report Package Owner receives notifications for changes to the values within the Value Set selected within the report package.

Report Packages in a completed or final status are not notified of any shared variable modifications. To update Shared Variables within Variable Lists, see Managing Shared Variable Lists.

To refresh shared variables from a Report Package, perform the following steps:

  1. Click on the Variables tab, variables tab.
  2. Click Actions, select Shared Variables, and then click Refresh.
  3. If the Refresh is successful, a confirmation dialog is shown. Click OK.
  4. If any issues are found within the variable refresh process, a warning dialog will be displayed indicating the variable and issue identified. Click Yes to complete the refresh or No to cancel the refresh.
The Shared Variable refresh may fail under the following situations:
  • The Shared Variable cannot be located within the Variable List.
  • The Shared Variable’s Value Set cannot be located within the Variable List.
  • The Variable List cannot be located.

Shared Variables which fail to refresh display a warning icon and have a value of #Missing.

These variables can be remapped to other shared variables or converted to static variables. For more information, see the Remapping a Shared Variable and Converting a Shared Variable to a Static Variable topics.

In the case where the Value Set cannot be found within the Variable List, you can update the Value Set on the Shared Variable List to populate the values on the shared variables. For more information, see Changing the Value Set for a Shared Variable List.