Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Cumulocity-IoT/cumulocity-device-control-widget
Widget to allow display and control of devices and groups of devices. Developed by Global Presales.
https://github.com/Cumulocity-IoT/cumulocity-device-control-widget
control cumulocity-iot cumulocity-widget dashboard device group iot-analytics runtime-widget widget
Last synced: 4 days ago
JSON representation
Widget to allow display and control of devices and groups of devices. Developed by Global Presales.
- Host: GitHub
- URL: https://github.com/Cumulocity-IoT/cumulocity-device-control-widget
- Owner: Cumulocity-IoT
- License: apache-2.0
- Archived: true
- Created: 2024-09-05T09:25:38.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2024-09-05T09:29:05.000Z (2 months ago)
- Last Synced: 2024-09-05T15:35:19.364Z (2 months ago)
- Topics: control, cumulocity-iot, cumulocity-widget, dashboard, device, group, iot-analytics, runtime-widget, widget
- Language: TypeScript
- Size: 8.59 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-softwareag - Cumulocity IoT device control and status widget
README
# Device control and status widget [
](https://github.com/SoftwareAG/cumulocity-datapoints-charting-widget/releases/download/v1.1.0/device-control-widget-1.1.0.zip)
This widget allows display and control of devices and groups of devices.
### ⚠️ This project is no longer under development. Please use [cumulocity-device-control-plugin](https://github.com/SoftwareAG/cumulocity-device-control-plugin) for Application Builder >=2.x.x and Cumulocity >=1016.x.x⚠️
## Features
* The user can select groups and individual devices.
* The user can use images (including vector graphics) to represent the devices.
* Select operations and define tooltips, and payload for each.
* Filter and display **at risk** devices
* Toggling of flags on the managed object supported.
* N.B. referred to as **toggles** below.
* Supports group template dashboard
* Realtime update of the managed objects
## Installation
### Runtime Widget Deployment?
- This widget supports runtime deployment. Download the [Runtime Binary](https://github.com/SoftwareAG/cumulocity-datapoints-charting-widget/releases/download/v1.1.0/device-control-widget-1.1.0.zip) and follow runtime deployment instructions from [here](https://github.com/SoftwareAG/cumulocity-runtime-widget-loader).
## User guide
This guide will teach you how to add the widget in your existing or new dashboard.
NOTE: This guide assumes that you have followed the [installation](https://github.com/SoftwareAG/cumulocity-runtime-widget-loader) instructions
1. Open the Application Builder application from the app switcher (Next to your username in the top right)
2. Add a new dashboard or navigate to an existing dashboard
3. Click `Add Widget`
4. Search for `Device Control`
5. See below for the configuration options
The widget configuration page contains a number of configuration attributes.
- **Title** : Enter the title which will display at the top of your widget
**Device Options**
- **Select device** : Choose a group of devices and/or individual devices to display on the widget. As you choose the Preview section will update to reflect your choices.
- **Device icon** : click on the icon to change the displayed image for each device.
- **Icon height** : use the slider to change the image display size.
- **Columns** : use the slider to change how many devices will display side by side before wrapping.
- **Show Availability** : check to show the current status of the device - based on the fragment `c8y_Availability`.
- **Show alarms** : Check this option to display a pill containing the number of alarms for this device.
- **Show operations** : Check this option to display the buttons to allow operations and toggles to be invoked.
- **Show at risk only** : Check this option to default the widget to display only those devices that are offline, in maintenance or have alarms.
**Select operations or add toggles**
> N.B. (reminder) "toggles" are a name for a mechanism the widget provides to flip a boolean fragment on the Managed Object that represents the device. It is intended to be a generic mechanism to help demos, but may well have utility in other areas.
- **Select operations** : if the selected devices have the `c8y_SupportedOperations` fragment then the list will be displayed here. The list will be a composite of the `c8y_SupportedOperations` fragments from all selected devices with duplicates removed.
After selecting an operation a column of options for the operation will appear.
- **Display Name** : This is a tool tip which will be displayed when you mouse over the operation on the widget.
- **Button icon** : select an icon from the font awsome 4 list of icons to represent the selected operation.
- **payload** : this is an arbitrary payload (json) that will be sent in the operation. Typically the payload can be anything but is the value of a fragment of the operation object that will be sent. a code representation is shown below but the contents of the field will depend wholly on what operation the user selects and what it expects. See [Cumulocity create](http://resources.cumulocity.com/documentation/websdk/client/classes/operationservice.html) section for more details
```
//this is an example for supplorted operation 'myOperation'
//deviceId is supplied by the widget
let operation: IOperation = {
deviceId: xxxxxx,
myOperation:
}
```
- **Add toggle** : Clicking this will add a column, similar to the one added by selecting a command above. However the fields are slightly different.
The following shows the widget responding to the change in managed object flag state. because it has the `c8y_Availability` when the fragment `sag_IsShutDown` is toggled to true (and its status is available) the device shows as being in standby.
**Group template**
You can use this widget with a group template dashboard:
for example the Laboratory group in my examples above:
Now each page can have a widget that displays the device linked to the route selected.
Additionally you can set up a link from the individual devices on the widget to the individuals group page:
## Widget display
Once configured the widget displays the selected devices, or all devices in a selected group. You can configure the widget to only display "at risk" devices by default also.
Additionally by checking/unchecking the "Only ay risk" option you can change what is seen.
Lastly there is a search facility allowing you to select a subset of devices based off their name.
as shown above in the configuration, if the group dashboard link is set then clicking on the icon will take you to that devices page in the group template dashboard.
The devices will update when the managed objects change.
---
These tools are 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 [Tech Community Forums](https://tech.forums.softwareag.com/tags/c/forum/1/Cumulocity-IoT).
You can find additional information in the [Software AG Tech Community](https://techcommunity.softwareag.com/en_en/cumulocity-iot.html).