Dashboard cloning
Dashboards simplify tracking key metrics and project performance. However, manually recreating the same dashboard for multiple projects can be time-consuming and inefficient.
With the dashboard cloning feature, you only need to create a reference dashboard once you have an instance deployed for your organization. You can then replicate this dashboard across projects without wasting effort on manually recreating the same sequence of widgets from scratch.
ReportPortal offers two ways to clone dashboards:
- through the UI
- via API
Permissions:
Any user in a project, regardless of their role, can use the dashboard cloning feature.
If a user has access to multiple projects, they can clone a dashboard to any of them.
An admin can perform dashboard cloning without being assigned to a specific project.
Dashboard cloning via UI
Within a single project
To duplicate dashboard via the UI within the same project:
- Log in to ReportPortal.
- Open Dashboards page.
- Click ‘Copy’ icon next to the desired dashboard.
- Select ‘Duplicate’ option from the dropdown menu.
- In the modal window, update the duplicated dashboard's name if necessary.
- Click ‘Duplicate’ button.
As a result:
- The dashboard will be copied along with all its widgets, maintaining the same order as in the initial dashboard.
- If you haven't specified a new name for the duplicated dashboard, the word ‘copy’ will be added to the name.
- The ‘Owner’ field will display the name of the user who duplicated the dashboard, rather than the name of the original creator.
- New filters will appear on the filters page.
From one project to another
To copy dashboard configuration to another project:
- Log in to ReportPortal.
- Open Dashboards page.
- Click ‘Copy’ icon next to the desired dashboard.
- Select ‘Copy dashboard configuration to clipboard’ option from the dropdown menu.
- Open Dashboards page on another project.
- Click ‘Add New Dashboard’ button at the top of the page.
- Enter the name of a new dashboard.
- Click ‘Show dashboard configuration’ link.
- Click ‘Paste configuration’ button.
- Click ‘Add’ button.
As a result:
- The dashboard will be copied along with all its widgets, maintaining the same order as in the initial dashboard.
- If you haven't specified a new name for the dashboard, the word ‘copy’ will be added to the name.
- The ‘Owner’ field will display the name of the user who performed the dashboard configuration copying, rather than the name of the original dashboard creator.
- New filters will appear on the filters page.
Dashboard cloning via API
To clone the dashboard configuration via API:
- Log in to ReportPortal.
- Open the API section on the bottom menu.
- Click on ‘Dashboard’ controller link.
- Expand
/v1/{projectName}/dashboard/{dashboardId}/config
endpoint. - Click ‘Try it out’ button.
- Fill dashboard ID and project name fields.
- Click ‘Execute’ button.
- Copy dashboard configuration.
To add the copied dashboard configuration to another project via API:
- Expand
/v1/{projectName}/dashboard/preconfigured
endpoint. - Click ‘Try it out’ button.
- Fill project name field.
- Specify new dashboard name in the Request body field.
- Paste copied dashboard configuration the Request body field instead of sample widgets.
- Click ‘Execute’ button.
Be careful with the JSON syntax.
Dashboard ID in the response corresponds to cloned dashboard.