Distribution

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
  1. In your identity config, you will need to set the scope to read.
  2. 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
  1. In your identity config, you will need to set the scope to read_write.
  2. Set the user reference in the same identity config to a unique identifier for each of your users.
  3. 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
  1. In your identity config, you will need to set the scope to read_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 to read.
  2. Set the user reference in the same identity config to be a unique reference of the group.
  3. 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.