From 953930977f5c49fa63056458ecf5270fe7878652 Mon Sep 17 00:00:00 2001 From: Sandhya <89508319+sandhyadeeps@users.noreply.github.com> Date: Tue, 10 Jan 2023 17:28:44 +0530 Subject: [PATCH 1/6] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2ad454e..db095e1 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ -# Cumulocity widget plugin +# Cumulocity widget plugin ![image](https://user-images.githubusercontent.com/89508319/211545879-ef79fd1c-801f-41de-bde9-7fa249d97910.png) + This is the Cumulocity module federation plugin. Plugins can be developed like any Cumulocity application, but can be used at runtime by other applications. Therefore, they export an Angular module which can then be imported by any other application. The exports are defined in `package.json`: From f4e4c5ba298d76de18c13cd9e03cdc9ef8d52a70 Mon Sep 17 00:00:00 2001 From: Sandhya <89508319+sandhyadeeps@users.noreply.github.com> Date: Thu, 12 Jan 2023 10:44:57 +0530 Subject: [PATCH 2/6] Update README.md --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index db095e1..04c088b 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,21 @@ # Cumulocity widget plugin ![image](https://user-images.githubusercontent.com/89508319/211545879-ef79fd1c-801f-41de-bde9-7fa249d97910.png) -This is the Cumulocity module federation plugin. Plugins can be developed like any Cumulocity application, but can be used at runtime by other applications. Therefore, they export an Angular module which can then be imported by any other application. The exports are defined in `package.json`: +This is the Cumulocity module federation plugin created using c8ycli. This plugin can be used in Application Builder or Cockpit.The Compass Widget displays an animated compass direction based on the measurement data provided. + + +## Please note that this plugin is in currently under BETA mode. + +### Please choose Smart Map release based on Cumulocity/Application builder version: + +|APPLICATION BUILDER | CUMULOCITY | COMPASS WIDGET | +|--------------------|------------|------------------| +| 1.3.x | >= 1011.x.x| 2.x.x | +| 1.2.x | 1010.x.x | 1.x.x | + + +![compass-widget](https://user-images.githubusercontent.com/99970126/169800960-2ebf6492-a107-47ff-910e-1aaf635559de.PNG) ``` "exports": [ { From 1c27179f5c8cbe0cb5a13ede860bc03c23f07681 Mon Sep 17 00:00:00 2001 From: Sandhya <89508319+sandhyadeeps@users.noreply.github.com> Date: Thu, 12 Jan 2023 10:45:21 +0530 Subject: [PATCH 3/6] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 04c088b..7533bd4 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ This is the Cumulocity module federation plugin created using c8ycli. This plugi ## Please note that this plugin is in currently under BETA mode. -### Please choose Smart Map release based on Cumulocity/Application builder version: +### Please choose Compass Widget release based on Cumulocity/Application builder version: |APPLICATION BUILDER | CUMULOCITY | COMPASS WIDGET | |--------------------|------------|------------------| From d5f0954b0935d8c874d4876bfaad6f6efbe55e38 Mon Sep 17 00:00:00 2001 From: Sandhya <89508319+sandhyadeeps@users.noreply.github.com> Date: Thu, 12 Jan 2023 10:45:40 +0530 Subject: [PATCH 4/6] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7533bd4..c5a88fa 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Cumulocity widget plugin ![image](https://user-images.githubusercontent.com/89508319/211545879-ef79fd1c-801f-41de-bde9-7fa249d97910.png) +# Cumulocity Widget Plugin ![image](https://user-images.githubusercontent.com/89508319/211545879-ef79fd1c-801f-41de-bde9-7fa249d97910.png) This is the Cumulocity module federation plugin created using c8ycli. This plugin can be used in Application Builder or Cockpit.The Compass Widget displays an animated compass direction based on the measurement data provided. From 4c0fcfcef8f5df4fa4230f1d6493ae47a8cca270 Mon Sep 17 00:00:00 2001 From: Sandhya <89508319+sandhyadeeps@users.noreply.github.com> Date: Thu, 12 Jan 2023 11:00:41 +0530 Subject: [PATCH 5/6] Update README.md --- README.md | 93 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 93 insertions(+) diff --git a/README.md b/README.md index c5a88fa..6b0b87d 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,99 @@ This is the Cumulocity module federation plugin created using c8ycli. This plugi ![compass-widget](https://user-images.githubusercontent.com/99970126/169800960-2ebf6492-a107-47ff-910e-1aaf635559de.PNG) + + +## Features + +**Realtime:** Realtime direction updates from defined measurement + + +## Installation + +### Runtime Widget Deployment? + +* This widget supports runtime deployment. Download the [Runtime Binary](https://github.com/SoftwareAG/cumulocity-compass-widget/releases/download/v1.0.3/compass-widget-1.0.3.zip) and use application builder to install your runtime widget. + + +## Quickstart +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 `Compass` +5. See below for the configuration options + +### Configuration options + +1. Select your device in the `Target Assets or Devices` field +2. Select the device measurement and fragment in the `Measurement` dropdown +3. Click `Save` + +The compass widget will refresh each time a new measurement value is sent from the device. + +### Sending data to the Compass widget +The compass widget will listen for the measurement and fragment which you have specified in the configuration options above + +The compass arrow will move to the numeric measurement value which must be between 0 and 360 to represent the arrow rotation in degrees. + +In the 'body' of your Cumulocity measurement, you will need to include the following: + + { + measurementseries: The measurement series which has been selected in the compass widget e.g. "weather_station" + { + measureementfragment: The measurement fragment which has been selected in the compass widget e.g. "wind_direction" + { + value: numeric value from 0 to 360 to represent the rotation of the compass arrow e.g. 270 + unit: the unit label e.g. "degrees" + } + . + . + } + + e.g. + + { + weather_station: { + wind_direction: { + value: 270, + unit: "degrees" + } + } + . + . + } + +### Development - to enhance and test this widget in your local environment +1. Clone the repository on your local machine using `git clone https://github.com/SoftwareAG/cumulocity-compass-widget.git`. +2. Run `npm install` to download the module dependencies. +3. Run `c8ycli server -u https://your_tenant_url` to start the server. +4. Go to `http://localhost:9000/apps/cockpit/` in the browser to view and test your changes. +5. (Optional) push the changes back to this repository. + +### Build - to create a new build of the compass-animation widget for the Runtime Widget Loader +1. Finish the development and testing on your local machine. +2. Run `gulp` to start the build process. +3. Use the `compass-widget.zip` file in the `dist` folder as your distribution file. + +------------------------------ + +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/tags/c/forum/1/Cumulocity-IoT). + +You can find additional information in the [Software AG TECHcommunity](https://tech.forums.softwareag.com/tag/Cumulocity-IoT). + + + + + + + + + ``` "exports": [ { From bfc34479aa3996fed9eeb6df3cf5594f66b8a621 Mon Sep 17 00:00:00 2001 From: Sandhya <89508319+sandhyadeeps@users.noreply.github.com> Date: Thu, 12 Jan 2023 11:01:56 +0530 Subject: [PATCH 6/6] Update README.md --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 6b0b87d..7629783 100644 --- a/README.md +++ b/README.md @@ -22,12 +22,16 @@ This is the Cumulocity module federation plugin created using c8ycli. This plugi **Realtime:** Realtime direction updates from defined measurement +## Prerequisite + + Cumulocity c8ycli >=1016.x.x + ## Installation ### Runtime Widget Deployment? -* This widget supports runtime deployment. Download the [Runtime Binary](https://github.com/SoftwareAG/cumulocity-compass-widget/releases/download/v1.0.3/compass-widget-1.0.3.zip) and use application builder to install your runtime widget. +* This widget supports runtime deployment. Download Runtime Binary and install via Administrations(Beta mode) --> Ecosystems --> Applications --> Packages. ## Quickstart