Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SoftwareAG/cumulocity-device-at-risk-widget
This is an Angular 8 widget designed to get a list of devices based on a group selection and display any device that has a Critical/Major Alarm or Medium/High-Risk Firmware raised against it. Runtime installation is available. Created by Global Presales.
https://github.com/SoftwareAG/cumulocity-device-at-risk-widget
cumulocity-iot cumulocity-widget device-at-risk device-at-risk-widget global-presales iot-analytics runtime widget widgets
Last synced: 3 months ago
JSON representation
This is an Angular 8 widget designed to get a list of devices based on a group selection and display any device that has a Critical/Major Alarm or Medium/High-Risk Firmware raised against it. Runtime installation is available. Created by Global Presales.
- Host: GitHub
- URL: https://github.com/SoftwareAG/cumulocity-device-at-risk-widget
- Owner: SoftwareAG
- License: apache-2.0
- Created: 2021-09-08T07:53:47.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-24T06:29:40.000Z (about 1 year ago)
- Last Synced: 2024-04-18T14:04:40.980Z (7 months ago)
- Topics: cumulocity-iot, cumulocity-widget, device-at-risk, device-at-risk-widget, global-presales, iot-analytics, runtime, widget, widgets
- Language: TypeScript
- Homepage: https://github.com/SoftwareAG/cumulocity-device-at-risk-widget
- Size: 1.11 MB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-softwareag - Cumulocity IoT devices at risk widget
README
# Cumulocity Devices at Risk Widget[
](https://github.com/SoftwareAG/cumulocity-device-at-risk-widget/releases/download/2.0.2/device-at-risk-runtime-widget-2.0.2.zip)
This is an Angular widget designed to get a list of devices based on a group selection and display any device that has a Critical/Major Alarm or Medium/High-Risk Firmware raised against it.
One can also see the Availability of those devices and can also view the data both in Real-time/offline mode.
> ### ⚠️ This project is no longer under development. Please use [Cumulocity Devices at Risk Widget Plugin](https://github.com/SoftwareAG/cumulocity-device-at-risk-widget-plugin) for Application Builder >=2.x.x and Cumulocity >=1016.x.x⚠️
### Please choose Device at Risk Widget release based on Cumulocity/Application builder version:
|APPLICATION BUILDER | CUMULOCITY | DEVICE AT RISK WIDGET |
|--------------------|------------|-----------------------|
| 1.3.x | >= 1011.x.x| 2.x.x |
| 1.2.x | 1010.x.x | 1.x.x |
## Features
- Displays Assets/Devices for given group in grid mode.
- When you click on the Id it will navigate to that particular dashboard.
- Pagination: Configurable Paginations and option to set default page size.
## Installation
### Runtime Widget Deployment?
- This widget support runtime deployment. Download [Runtime Binary](https://github.com/SoftwareAG/cumulocity-device-at-risk-widget/releases/download/2.0.2/device-at-risk-runtime-widget-2.0.2.zip) and follow runtime deployment instructions from [here](https://github.com/SoftwareAG/cumulocity-runtime-widget-loader).
### Installation of widget through App Builder
**Supported Cumulocity Environments:**
- **App Builder:** Tested with Cumulocity App Builder version 1.3.0
**Requirements:**
- Git
- NodeJS (release builds are currently built with `v14.18.0`)
- NPM (Included with NodeJS)
**External dependencies:**
```
"@angular/material": "^11.1.2"
"@ng-select/ng-select": "^6.1.0"
```
**Installation Steps For App Builder:**
**Note:** If you are new to App Builder or not yet downloaded/clone app builder code then please follow [App builder documentation(Build Instructions)](https://github.com/SoftwareAG/cumulocity-app-builder) before proceeding further.
1. Open Your existing App Builder project and install external dependencies by executing below command or install it manually.
```
npm i @angular/[email protected] @ng-select/[email protected]
```
2. Grab the Device at risk widget [Latest Release Binary](https://github.com/SoftwareAG/cumulocity-device-at-risk-widget/releases/download/2.0.2/gp-devices-at-risk-widget-2.0.2.tgz)
3. Install the Binary file in app builder.
```
npm i /gp-devices-at-risk-widget.tgz
```
4. Import DevicesAtRisk Module
Import GpDevicesAtRiskWidgetModule in app.module.ts and also place the imported Module under `@NgModule`.
```
import { GpDevicesAtRiskWidgetModule } from 'gp-devices-at-risk-widget';
@NgModule({
imports: [
GpDevicesAtRiskWidgetModule
]
})
```
5. Congratulation! Installation is now completed. Now you can run app builder locally or build and deploy it into your tenant.
```
//Start App Builder
npm run start
// Build App
npm run build
// Deploy App
npm run deploy
## Build Instructions
**Note:** It is only necessary to follow these instructions if you are modifying/extending this widget, otherwise see the [Installation Guide](https://github.com/SoftwareAG/cumulocity-device-at-risk-widget#Installation).
**Requirements:**
- Git
- NodeJS (release builds are currently built with `v14.18.0`)
- NPM (Included with NodeJS)
**Instructions**
1. Clone the repository:
```
git clone https://github.com/SoftwareAG/cumulocity-devices-at-risk-widget.git
```
2. Change directory:
```
cd cumulocity-devices-at-risk-widget
```
3. (Optional) Checkout a specific version:
```
git checkout
```
4. Install the dependencies:
```
npm install
```
5. (Optional) Local development server:
```
ng serve
```
6. Build the app:
```
npm run buildPatch
```
7. Deploy the app: Follow the [Installation instructions](https://github.com/SoftwareAG/cumulocity-device-at-risk-widget#Installation).
## QuickStart
This guide will teach you how to add widget in your existing or new dashboard.
**NOTE:** This guide assumes you have followed the [Installation instructions](https://github.com/SoftwareAG/cumulocity-device-at-risk-widget#Installation)
1. Open you application from App Switcher
2. Add new dashboard or navigate to existing dashboard
3. Click `Add Widget`
4. Search for `Device at risk`
5. Select `Target Assets or Devices`
6. Click `Save`
Congratulations! Device at risk widget is configured.
## User Guide
Click on Add Widget and select Devices at Risk as a widget. In the configuration, you only need to select the device group of interest.
- **Target assets or devices:** User can select a device/asset or device/asset group. If group is selected, list of devices/assets will be display.
- **Table Settings:** User can select table inputs such as id, name, alarms, external id, firmware, availability front page of tile. User can also select the inputs to be configured for display.
- **Default PageSize :** Select records per page.
- **Dashboard Navigation Settings (Application Builder Only):** This feature is available only in application builder. User can navigate to any other dashboard by providing below details:
- ** **All**:** Select a device type. Navigation will be applied to all the devices/assets of this device/asset to a specific dashboard
- **Dashboard ID:** Dashboard ID of a dashboard where user need to navigate. You can find dashboard id in browser URL.
- **DeviceId as TabGroup:** Select this option only if you are using Group Template as dashboard in application builder and selected deviceId as tabgroup field during group template configuration.
- **TabGroup ID(optional):** If your dashboard is based on tabgroup then provide tabgroup id.
**Device at risk On Screen Options:**
- **Realtime** : On/Off Realtime option.
- **Refresh**: Useful for force reload/refresh devices.
- **Pagination**: Page navigation options.
----------
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](https://tech.forums.softwareag.com/tag/Cumulocity-IoT).