Stand with Ukraine flag
Try it now Pricing
Trendz Analytics
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker
Documentation > Share views > Trendz widget bundle
Getting Started
Guides Installation
On this page

Import Trendz bundle into ThingsBoard

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.

Import Trendz widget bundle

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 button to add Trendz widget library to the ThingsBoard.
  • In case when ThingsBoard already contains Trendz bundle but it is not up-to-date, the Upload bundle button would apply the 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:

1
2
3
4
5
6

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
1

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

ThingsBoard 3.5+ blank widget with error

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
Open widget bundle
Open widget bundle
Search for Trendz bundle
Search for Trendz bundle
Edit widget
Edit widget
Update library link
Update library link

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.

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.

  • 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.