Import Trendz bundle into ThingsBoard

Import Trendz widget bundle
Troubleshooting
Next Steps

All visualizations created in Trendz Analytics could be added on ThingsBoard Dashboards. We created special Trendz widget bundle for ThingsBoard - widgets collection that should be imported into ThingsBoard Widget Library. You can use them to add views from Trendz into ThingsBoard dashboards and share analysis results with other users.

ThingsBoard 3.4+ and Trendz 1.9+

You can import Trendz bundle to the ThingsBoard via Trendz UI:

Open Trendz settings page as tenant administrator
Scroll to Trendz Widget Bundle Management section
Press Upload bundle to ThingsBoard button to add Trendz widget library to the ThingsBoard.
In case when ThingsBoard already contains Trendz bundle but it is not up-to-date - you should click on Update bundle button to apply latest changes.

ThingsBoard 3.3+ and Trendz 1.8+

Starting from ThingsBoard 3.3 and Trendz 1.8 - Trendz widgets can be natively embedded into the ThingsBaord dashboard. Native Trendz widgets works much faster compared to original Trendz widgets that are based on iFrame.

Add native Trendz library into ThingsBaord extensions:

Download Native Trendz Library
Deploy library into ThingsBoard extension directory

scp trendz-tb-lib-1.8.0-SNAPSHOT.jar ubuntu@${THINGSBOARD_SERVER}:~/.

ssh ${THINGSBOARD_SERVER}

sudo cp trendz-tb-lib-1.0.0-SNAPSHOT.jar /usr/share/thingsboard/extensions/
sudo chown thingsboard:thingsboard /usr/share/thingsboard/extensions/trendz-tb-lib-1.0.0-SNAPSHOT.jar

Restart ThingsBoard service to apply changes

sudo service thingsboard restart

Import Native Trendz widgets bundle

Download Native_Trendz_widgets_bundle
Login as Tenant Administrator into ThingsBoard and go to Widget Library
Press Add new widget bundle and select import widget bundle
Import downloaded widget bundle

ThingsBoard 3.0 - 3.2

Download a Trendz_widgets_bundle V3
Login as Tenant Administrator into ThingsBoard and go to Widget Library
Press Add new widget bundle and select import widget bundle
Import downloaded widget bundle

ThingsBoard 2.x

Download a Trendz_widgets_bundle V2
Login as Tenant Administrator into ThingsBoard and go to Widget Library
Press Add new widget bundle and select import widget bundle
Import downloaded widget bundle

This bundle contains 3 widgets:

Trendz View Static- allow adding saved Trendz visualizations into ThingsBoard dashboards
Trendz View - with filter alias- similar to previous but also support dashboard aliases for resolving entities
Trendz Builder - Trendz Visualization Builder for providing self-service interface to your end-users, so they can create their own analysis using ThingsBoard dashboard.

Note: If after importing Trendz Widget Bundle into ThingsBoard, widgets do not work and white screen with error displayed - double-check that correct bundle was imported. Widget API in ThingsBoard v2.x and v3.x is different. Ensure that you downloaded bundle for the correct ThingsBoard version.

Troubleshooting

Starting from ThingsBoard 3.5 we are using Angular 15 and link to library should be updated because standard link loads library that is based on Angluar 12, and it is not compatible with Angular 15. To solve the problem you should follow next steps:

Update Trendz to the latest version (1.10.1 or higher). If you are using Trendz Cloud just skip this step.
Login to ThingsBoard as Tenant administrator
Navigate to Resources -> Widgets Library
Select and Edit Trendz Bundle
For each widget in Trendz bundle
- Open for edit
- Switch to resources tab (top left corner)
- Update link to Trendz library
  - In case of ThingsBoard/Trendz cloud use the following URL - https://thingsboard.cloud/trendz/bundle/trendz-tb-lib.js
- Save widget
Navigate to your dashboard and refresh the page - issue should be solved

Wrong bundle version

If after importing Trendz Widget Bundle into ThingsBoard, widgets do not work and white screen with error displayed - double-check that correct bundle was imported. Widget API in ThingsBoard v2.x and v3.x is different. Ensure that you downloaded bundle for the correct ThingsBoard version.

HTTPS to HTTP links

If ThingsBoard uses HTTPS and link to Trendz library uses http - you will see mixed content error in browser console and widget will not load. You should enable HTTPS for Trendz as well.

Next Steps

Getting started guide - These guide provide quick overview of main Trendz features.
Installation guides - Learn how to setup ThingsBoard on various available operating systems.
Calculated Fields - Learn about Calculated fields and how to use them.
States - Learn how to define and analyse states for assets based on raw telemetry.
Group and Aggregate data - Learn how to group and aggregate data in Trendz.
Prediction - Learn how to make forecasts and predict telemetry behavior.
Filters - Learn how filter dataset during analysis.
Available Visualizations - Learn about visualization widgets available in Trendz and how to configure them.