An open API service indexing awesome lists of open source software.

https://github.com/cumulocity-iot/c8y-ticketing-integration-viewer-widget

It allows to view tickets from the configured Ticketing Platform using Ticketing Integration microservice
https://github.com/cumulocity-iot/c8y-ticketing-integration-viewer-widget

cumulocity cumulocity-iot global-presales iot-analytics runtime-widget viewer

Last synced: 5 months ago
JSON representation

It allows to view tickets from the configured Ticketing Platform using Ticketing Integration microservice

Awesome Lists containing this project

README

        

For Cumulocity IoT version >= 10.16 and Application Builder version >= 2.0.0, please refer to https://github.com/SoftwareAG/c8y-ticketing-integration-plugin

# Ticketing Integration Viewer Widget for Cumulocity IoT

This widget allows to view tickets from the configured Ticketing Platform using Ticketing Integration microservice.

![Preview](src/c8y-ticketing-integration-viewer-widget/assets/img-preview.png)

### Installation - for the dashboards using Runtime Widget Loader
1. Download the latest `c8y-ticketing-integration-viewer-widget-{version}.zip` file from the Releases section.
2. Make sure you have Application Builder app installed.
3. Open a dashboard.
4. Click `more...`.
5. Select `Install Widget` and follow the instructions.

### Configuration - to add the widget on dashboard
1. Make sure you have successfully installed the widget.
2. Click on `Add widget`.
3. Choose `Ticket Integration Viewer` 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. Choose `Target assets or devices` to view tickets for that specific device or leave unselected to view all tickets.
6. Select or unselect respective table columns in `Show columns` to be shown in table.
7. `Max total tickets` is total number of tickets to be retrieved from ticketing platform.
8. `Page size` is total number of tickets to shown at once in a table.
9. Click `Save` to add the widget on the dashboard.
10. In case you see unexpected results on the widget, refer to browser console to see if there are error logs.

### Development - to do the enhancements and testing locally
1. Clone the repository on local machine using `git clone https://github.com/SoftwareAG/c8y-ticketing-integration-viewer-widget.git`.
2. Run `npm install` to download the module dependencies.
3. Install c8ycli `npm install -g @c8y/cli` if not already.
4. Run `c8ycli server -u https://your_tenant_url` to start the server.
5. Go to `http://localhost:9000/apps/cockpit/` in the browser to view and test your changes.
6. (Optional) push the changes back to this repository.

### Build - to create a new build for the Runtime Widget Loader
1. Finish the development and testing on your local machine.
2. Run `gulp` to start the build process. Run `npm install -g gulp` to install gulp if not already.
3. Use `c8y-ticketing-integration-viewer-widget-{version}.zip` file in the `dist` folder as a distribution.

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

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 [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).