¿Cómo construir un Sistema de Gestión de incidencias con la Plataforma?
En este ejemplo se muestra cómo se podría utilizar la plataforma para la gestión y creación de incidencias.
Este ejemplo utiliza el API JavaScript para comunicarse con la plataforma. Más información sobre esta API en /wiki/spaces/PT/pages/52592648.
El ejemplo está accesible en https://lab.onesaitplatform.com/web/issue-manager/index.html
Puedes descargarlo comprimido desde aquí: issue-manager.zip
o bien clonarte el repositorio de ejemplos de la plataforma: https://github.com/onesaitplatform/onesait-cloud-platform-examples e ir a la carpeta example-issue-management
Primero se debe crear una ontología para representar las incidencias y asignarla a un device con permisos. En el archivo issueController.js se deben definir:
- Ontology
- Device
- Device instance
- Device token
- URLs IoTBroker y OAuthServer
En este caso se han escogido elementos ya predefinidos en la plataforma. En caso de querer crear una nueva ontología para almacenar las issues, se crearía una Ontología y se escogería como schema "EmptyBase". A continuación se completa con los siguientes campos:
Después se debe crear un device asociado a esa ontología que se acaba de crear. Se debe utilizar el token asociado a ese device para acceder a él desde la API JavaScript.
Para crear una incidencia, el usuario deberá hacer click en "Send". A continuación, deberá rellenar el formulario que aparece con los datos sobre la incidencia y pulsar el botón "Send Issue". Esto devolverá un ID de la incidencia.
En caso de que el usuario tenga permisos para gestionar incidencias, podrá visualizarlas pulsando en el botón "Search". Para que las incidencias se muestren, primero el usuario deberá autenticarse.
Una vez autenticado, se pueden ver todas las incidencias y actualizar su estado si se desea. En caso de que sea cambiado, un flow se activa en el flow engine y se envía una notificación via email al creador de la incidencia.