Distributing Dashboards

Distributing Dashboards

You can create and share a dashboard template—either without your personal data or using mockup data—and send a link so that anyone can install it into their account through a customized installation page. Once the template is installed, users are free to modify the dashboards to suit their needs. The template can be added to your own profile or even to other TagoIO accounts.

When people click on the link you provided, they will be taken to a screen similar to the one shown below. Remember that both the images and the text on this page are fully customizable.


Creating & Editing a Template

To distribute a dashboard, first click on the options menu of your dashboard, and then on the Distribute option, as shown below:



You'll be redirected to the following page:


The Distribute function relies on creating a customized install page for anyone to install a copy of your dashboard, and so in order to create a customized page just the way you want it, TagoIO offers the possibility to modify the images and the title of the page.


In the image above, you can set a custom title for the install page in the field Title of the page. You can also replace the default images with custom ones using the fields Logo of the page and Main image of the page.

You can add descriptions to your Devices, or Blueprint Devices, and Analyses used on the dashboard as well. Descriptions are optional, but they help whoever is installing the template to find their own devices to associate with the ones used on the dashboard. 

For example, specifying that one of the devices is a temperature sensor in the description allows the user installing the template to select a matching device on their own profile.



Once you have made the necessary adjustments, click the Create Template button (or Update Template if the template has already been created) to save your information and build the page. When you build your template for the first time, a new section will appear on the page containing the link to be shared with other users.

Alternatively, you can download a file in JSON format—either the Dashboard Structure or Manifest. These files allow you to make your dashboard template publicly available to all TagoIO users so that they can install your template when creating new dashboards within their Admin. Read more at Public Dashboards - TagoIO GitHub.

To share your template using a link, simply click the Copy button or manually copy the link, then distribute it to anyone you would like.

Installing a Template

When using a template for a Blueprint dashboard, the Blueprint Devices will be configured exactly like in the dashboard, but with helpful descriptions in case the user needs to make any changes. This also lets the user know which tag keys and values the devices must have configured.

If the dashboard has no Analysis in its widgets, this is the only step and clicking Confirm associations will install the dashboard.


If the dashboard has Analyses, instead of Confirm associations, the button will be Next step and it will guide the user to another page to select their own Analyses to be used in place of the Analyses in the original dashboard.

Note that Analyses also have the Distribute feature, and they can be installed previously to installing a dashboard requiring Analyses. Read more about Distributing analysis.


Selecting the required Analyses will enable the Confirm associations button, and the template will be installed using the configurations made on this setup wizard.

For Normal dashboards, the device association page looks like the one above and also functions similarly: all the required devices must be associated before the Confirm associations button is enabled and allows the user to finish installing the template.

Sharing a template with mockup data

You can also share your template along with a mockup data from your device so that the widget displays data even before the template is fully configured during installation. This method allows the installer to proceed without immediately associating any device, although the analysis will still require an association.

Notes
The mock data is limited to 200KB. You can restrict the amount of data displayed per widget either by adjusting the settings in the Edit > Options menu or by using a global time filter on the dashboard.




    • Related Articles

    • Sharing Dashboards

      A great feature from TagoIO is its native sharing capability for dashboards, because we know that sometimes a dashboard can become an entire feature that you want to share. If you want to share only the template of your dashboards, use the Distribute ...
    • Grouping Dashboards

      You can group related dashboards using dashboard tags. To do so, go to “Dashboard”, click on the gear icon to edit it, then on the section “Tags” create a new tag. After that, on the section “Group dashboards using Tags” select the grouping tag. To ...
    • Data Output for dashboards

      In TagoIO, each time someone accesses data from the Dashboards using TagoIO Admin or TagoRUN, a data output is counted for each variable displayed. For instance, when an end-user loads a dashboard that displays 3,000 registers, this same number will ...
    • Downlinks using Dashboards

      Learn how to perform downlink for Class C or A devices using Analysis. Also, we will show how to send downlink data from dashboards. This approach can be used in the following cases: For devices with class C: to immediately send a downlink message to ...
    • Distributing analysis

      You can create a copy of your analysis and send a link to anyone so they can add a copy to their account through a customized install page. They will be able to edit the analysis as they wish. Others will be able to edit the analysis that they ...