Distribution
Vizzly allows you to automatically distribute dashboards to your users using a variety of different strategies.
Strategies
Read-only dashboards
This is a dashboard that you as the organisation controls. Your users will see a read-only copy of this dashboard, and any updates you make to it will appear instantly to your users.
Implementation
- In your identity config, you will need to set the
scope
toread
. - Set the
parentDashboardId
dashboard property if you will have multiple read-only dashboards throughout your application.
Self-serve dashboards
Allow your users to add and edit views on their own dashboard, and in their library.
Implementation
- In your identity config, you will need to set the
scope
toread_write
. - Set the user reference in the same identity config to a unique identifier for each of your users.
- Set the
parentDashboardId
dashboard property if you will have multiple self-serve dashboards throughout your application.
Read and write access within a user group
In SaaS products, it is very common to have groups of users such as 'organisations' or 'teams'. Within each 'organisation' or 'team' on your platform you might want to control which users have read access, and which users have write access.
Implementation
- In your identity config, you will need to set the
scope
toread_write
for those in the group who should have write access. For users in the group with read access, you will need to set the scope toread
. - Set the user reference in the same identity config to be a unique reference of the group.
- Set the
parentDashboardId
dashboard property if you will have multiple instances of dashboards throughout your application.
Sharing read-only dashboards between users
To support a dashboard sharing feature, you can setup the identity config exactly how you would for the user's dashboard that you want to share, but then
set the scope to read
. Then, you can set the parentDashboardId
and dashboardId
properties
on the dashboard, to control the exact dashboard which is shared.
For all distribution strategies, it is extremely important that the access type value of
the identity config is only set to admin
for trusted members of your own organisation.
This is because they will control the parent dashboards and verified views, which is the foundation for all distribution stratagies.