https://github.com/cumulocity-iot/cumulocity-advanced-radial-gauge-widget-plugin
This Advanced Radial Gauge widget shows the latest realtime measurement on a radial gauge. Runtime Installation is available. Created by Global Presales.
https://github.com/cumulocity-iot/cumulocity-advanced-radial-gauge-widget-plugin
advanced-radial-gauge cockpit cumulocity cumulocity-iot cumulocity-package cumulocity-widget global-presales plugin plugins runtime widget
Last synced: about 2 months ago
JSON representation
This Advanced Radial Gauge widget shows the latest realtime measurement on a radial gauge. Runtime Installation is available. Created by Global Presales.
- Host: GitHub
- URL: https://github.com/cumulocity-iot/cumulocity-advanced-radial-gauge-widget-plugin
- Owner: Cumulocity-IoT
- License: apache-2.0
- Created: 2022-09-05T06:24:12.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-10-25T06:26:55.000Z (almost 2 years ago)
- Last Synced: 2024-12-20T17:16:49.385Z (10 months ago)
- Topics: advanced-radial-gauge, cockpit, cumulocity, cumulocity-iot, cumulocity-package, cumulocity-widget, global-presales, plugin, plugins, runtime, widget
- Language: TypeScript
- Homepage:
- Size: 1.43 MB
- Stars: 0
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Deprecation notice
This plugin is not further developed and it might break with upcoming Cumulocity releases. Use it at your own risk.
The repository is archived but feel free to fork & adapt it to your needs in a new repo.
# Cumulocity Advanced Radial Gauge Widget Plugin [
](https://github.com/Cumulocity-IoT/cumulocity-advanced-radial-gauge-widget-plugin/releases/download/1.2.2/sag-ps-pkg-advanced-radial-gauge-1.2.2.zip)
This Advanced Radial Gauge widget is the Cumulocity module federation plugin. This plugin can be used in Application Builder or Cockpit. It shows the latest realtime measurement on a radial gauge.
### Please choose Advanced Radial Gauge Widget release based on Cumulocity/Application builder version:
|APPLICATION BUILDER | CUMULOCITY | ADVANCED RADIAL GAUGE WIDGET PLUGIN |
|--------------------|------------|--------------------------------------|
| 2.x.x | >= 1016.x.x| 1.x.x |
## Prerequisite
Cumulocity c8ycli >=1016.x.x
## Installation
### Runtime Widget Deployment?
* This widget support runtime deployment. Download [Runtime Binary](https://github.com/Cumulocity-IoT/cumulocity-advanced-radial-gauge-widget-plugin/releases/download/1.2.2/sag-ps-pkg-advanced-radial-gauge-1.2.2.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 your application from App Switcher
2. Add new dashboard or navigate to existing dashboard
3. Click `Add Widget`
4. Search for `Advanced Radial Gauge`
5. Select `Target Assets or Devices`
7. Click `Save`
Congratulations! Advanced Radial Gauge is configured.
### Configuration - to add the plugin on dashboard
1. Make sure you have successfully installed the plugin.
2. Click on `Add widget`.
3. Choose `Advanced Radial Gauge` 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. Select the `device`.
6. `Measurement name` is the measurement supported by the selected device. Latest value of this measurement will be shown.
7. `Measurement font size` is to define the font size of the measurment value.
8. `No. of digits after decimal` is to define the number of digits to be shown after decimal point in measurment value.
9. `Indicator type` is how you want to indicate the current value on the chart. It can be `Pointer` or `Progress Bar`.
10. `Axis width` is the width of axis.
11. `Axis label distance` is the distance of labels from the axis.
12. `Pointer offset (in %)` is the distance of pointer from the center of the chart. This is only applicable when `Indicator type` is `Pointer`.
13. `Progress bar color` is the color of progress bar. This is only application when `Indicator type` is `Progress bar`.
14. `Text` is Label Text. It's a free text field that can be used to name the measurement or radial guage.
15. `Font size` is Label font size. It is to set the Label font size.
15. `Hyperlink` is to provide a url where you would like to navigate on click of the label. It is optional.
15. `Starting value` is the minimum measurement value expected.
16. `Limit value` is the maximum measurement value expected in case of single range. It will be limit value of a range in case of multiple ranges.
17. `Color` is range color. It is to set color of the defined range on axis.
18. `Add range` is to define additional ranges. Make sure the limit value of a next range is higher than its previous one.
19. `Remove range` is to delete a particular range.
20. Click `Save` to add the widget on the dashboard.
21. 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 Cumulocity product suite. Users are free to use, fork and modify them, subject to the license agreement. While Cumulocity GmbH welcomes contributions, we cannot guarantee to include every contribution in the master project.
_____________________
For more information you can Ask a Question in the [Tech Community Forums](https://techcommunity.cumulocity.com).