Search here...
< All Topics

Export and Import Dashboard

Introduction

As a step towards simplifying the efforts to showcase the results of months of work put in by various teams, the dashboard plays a key role. We at Prolaborate, have witnessed teams struggle to exchange existing dashboards across environments. Some of the groups spent more time on analysing the KPIs to display to CXOs. In such scenarios our custom built APM dashboard (download) comes handy and plays a crucial role. This brings us to develop a new feature in 5.1 where users can exchange dashboards. The new feature allows users to export and import dashboards, including all its widgets, across different repositories and instances with few simple clicks. Along with a dashboard user can also export and import the required resources such as Modeling Languages with default profile and custom properties, Color Palette Configuration, Report Configurations, Integration Projects, User Groups and User permissions referenced in the dashboards.

Prerequisites

  1. Prolaborate version should be 5.1.0 or above
  2. To export and import dashboards, the user must be an admin.

Export Dashboard with resources

When exporting a dashboard, an option to include only resources that are referenced in the dashboard is shown and selected in the export window.

To export a dashboard, navigate to the dashboard listing page. Click More under Actions and select Export.

A popup window appears showing the list of resources that are referenced in the dashboard.

Resources Details
Report Configuration Enabling this option exports the reports used in a dashboard.

Which means a chart or report which is part of a dashboard, is built using report from Report Configuration, the referenced reports will be exported.

Modeling Language Enabling this option exports the modeling languages used in a dashboard.

Which means if a chart or report present in the dashboard is configured using stereotypes that are from specific MDGs uploaded in Prolaborate, then the default MDG profile which is set for the user who is exporting the dashboard will also be exported along with the dashboard. The custom properties and their respective reports will also be exported

Color Configuration Enabling this option exports the color palette used in a dashboard.

Default color palette set for the repository will be exported if a chart is present in the dashboard

Lifecycle Configuration Enabling this option exports the lifecycle configuration used in a dashboard.

If the dashboard contains a lifecycle roadmap, the respective lifecycle configuration will be exported

User Permissions Enabling this option exports the user permissions used in a dashboard.

The respective user(s) with the access permission given to the dashboard will be exported

User Groups Enabling this option exports the user groups used in a dashboard.

The respective user group(s) with the access permission will be exported

Integrations If an integration widget is configured in the dashboard, the respective integration project will be exported

Note:

  • The resource list will be displayed in the popup window only if there are referenced in the dashboard that is to be exported.

Export Dashboard only

Users can export only the dashboard by disabling all the reference resources if required, thus exporting only the dashboard contents.

Import Dashboard with resources

Dashboards can be imported across repositories or instances easily just by selecting the exported zip file.

Note:

  • Make sure the file is exported from the relevant DB type. An error will be thrown in case if the file that is exported from Prolaborate running on MS SQL is imported to My SQL and vice versa.

Navigate to Dashboard listing page, click Import.

Choose the exported dashboard zip file from the respective file location and click Import.

The dashboard and its resources will be successfully imported. A suffix ‘imported’ will be added to the dashboard and resources name.

Note:

  • Only admin users can import dashboard and its resources directly in the repository.
  • On import, only user permission will be imported and not the user. So, if the user already exists in that specific repository or instance, then they should be able to access dashboard as per the permissions defined in source repository.

Import Dashboard only

If the exported file contains only the dashboard, choose the exported dashboard .zip file from the respective file location and click Import.

The dashboard will be successfully imported, and a suffix ‘imported’ will be added to the dashboard name.

Export and Import Multiple Dashboards

In Prolaborate v5.1, each dashboard must be exported and then imported individually. Exporting multiple dashboards is currently under development and will be part of future Prolaborate release.

How to delete imported resources?

  1. To delete the imported resources, they must be deleted manually one by one. The resources that are imported will have a suffix ‘imported’ with their name which can be used to identify them.
  2. To delete Report Configuration, click here.
  3. To delete Modeling Language, click here.
  4. To delete Lifecycle Configuration, click here.
  5. To delete Users, click here.
  6. To delete User Groups, click here.

FAQs

Export Failed

If a MDG uploaded in Prolaborate requires a dependent MDG. Currently all the active MDGs are exported when a dashboard is exported

Solution

  1. Turn off MDG while exporting the dashboard
  2. Import required MDGs separately and then export the dashboard

Import Failed

The database type should be the same in both source and target repositories to import the dashboards

For example, if a dashboard is exported from a MS SQL Prolaborate database, the target database should also be MS SQL to successfully import the dashboard

Solution

  1. Upload a file generated from the same database type (MySQL to MySQL or MS SQL to MS SQL)

Widget Not Loading

If the target database has the same model structure but the GUID values are different, then the widgets such as hyperlinks, diagrams, along with will not display

Solution

  1. Edit and save each widget individually to display the result
  2. If the widget is configured using a report from Report Configuration, then edit and save the report to display the result

Non-Default MDG Profiles not imported

When exporting a dashboard only default profiles will be exported, and custom profiles set for specific users or user groups are not exported. In such cases within repository, we have the possibility to refer profiles from another repository however the import is done on a different environment then custom profiles must be created. Option to export profiles is planned in future release.

sparxsystems-logo-inverted

Start Here
Book a Demo