https://github.com/cumulocity-iot/cumulocity-barchart-widget-plugin

The Bar Chart Widget allows you to define multiple datapoints as constant values or realtime measurements from a device or device group. Created by Global Presales.
https://github.com/cumulocity-iot/cumulocity-barchart-widget-plugin

barchart cockpit cumulocity cumulocity-iot cumulocity-package cumulocity-widget global-presales iot-analytics plugin plugins widget widgets

Last synced: 5 months ago
JSON representation

The Bar Chart Widget allows you to define multiple datapoints as constant values or realtime measurements from a device or device group. Created by Global Presales.

• Host: GitHub
• URL: https://github.com/cumulocity-iot/cumulocity-barchart-widget-plugin
• Owner: Cumulocity-IoT
• License: apache-2.0
• Created: 2023-01-09T06:22:34.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-10-31T12:50:53.000Z (over 1 year ago)
• Last Synced: 2024-12-20T17:16:45.186Z (5 months ago)
• Topics: barchart, cockpit, cumulocity, cumulocity-iot, cumulocity-package, cumulocity-widget, global-presales, iot-analytics, plugin, plugins, widget, widgets
• Language: TypeScript
• Homepage:
• Size: 2.22 MB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Bar Chart widget for Cumulocity [](https://github.com/SoftwareAG/cumulocity-barchart-widget-plugin/releases/download/1.1.0/sag-ps-pkg-barchart-widget-1.1.0.zip)

The Bar Chart widget is the Cumulocity module federation plugin created using c8ycli. This plugin can be used in Application Builder or Cockpit. The Bar Chart widget allows you to define multiple datapoints as constant (fixed) values or actual measurement values in realtime from Device or Device Groups. In addition, you can add custom icon respective to each datapoint. 

### Please choose Bar Chart release based on Cumulocity/Application builder version:

|APPLICATION BUILDER  |   CUMULOCITY  |  BAR CHART WIDGET  |

|--------------------|------------|------------------|

| 2.0.x              | >= 1016.x.x| 1.x.x            | 

![Preview](assets/img-preview.png)

## Prerequisite

   Cumulocity c8ycli >=1016.x.x

   

   

## Installation

### Runtime Widget Deployment?

* This widget support runtime deployment. Download [Runtime Binary](https://github.com/SoftwareAG/cumulocity-barchart-widget-plugin/releases/download/1.1.0/sag-ps-pkg-barchart-widget-1.1.0.zip) and install via Administrations --> Ecosystems --> Applications --> Packages.

## QuickStart

  

This guide will teach you how to add widget in your existing or new dashboard.

  

1. Open you application from App Switcher

  

2. Add new dashboard or navigate to existing dashboard

  

3. Click `Add Widget`

  

4. Search for `Bar Chart`

  

5. Select `Target Assets or Devices`

  

7. Click `Save`

  

Congratulations! Bar Chart is configured.

## User Guide

### Configuration - to view the Bar Chart widget

1. Make sure you have successfully installed the widget.

2. Click on `Add widget`.

3. Choose `Bar chart` widget.

4. `Title` is the title of widget. Provide a relevant name. You may choose to hide this. Go to `Appearance` tab and choose `Hidden` under `Widget header style`.

5. `Delete datapoint` allows you to delete a datapoint.

6. `Label` is the name of the datapoint that will appear on the x-axis.

7. `Icon` is for the icon you want to show on the top of the datapoint.

8. `Value type` allows to you choose whether datapoint will have a `Constant` value or a `Measurement` value from a Device or a Device Group.

9. `Value type` is `Constant`.

    1. `Value` allows you provide a fixed value (numerical) for the datapoint.

10. `Value type` is `Measurement`.

    1. `Select device/ device group` allows you to choose a Device or Device Group.

    2. `Select fragment series` allows you to choose a `Fragment` and `Series` combined. It automatically gets populated based on the device or device group selected.

11. `Color` allows you choose a color specific for the bar.

12. `Add new datapoint` allows you to define additional datapoints.

13. Click `Save` to add the widget on the dashboard.

14. In case you see unexpected results on the widget, refer to browser console to see if there are error logs.

------------------------------

This widget is provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.

------------------------------

For more information you can Ask a Question in the [TECHcommunity Forums](http://tech.forums.softwareag.com/techjforum/forums/list.page?product=cumulocity).

  

  

You can find additional information in the [Software AG TECHcommunity](http://techcommunity.softwareag.com/home/-/product/name/cumulocity).