Guía de uso de las Aplicaciones
Introducción
El concepto de Aplicación (también conocido como Proyecto) agrupa a usuarios y recursos, permitiendo crear un entorno colaborativo en el que los usuarios de la Plataforma con diferentes roles pueden gestionar los conceptos agrupados, permitiendo no solo asignar permisos sino también añadir un dominio de seguridad como una aplicación web accesible para los usuarios finales y todo ello gestionado desde un único punto.
Sólo los usuarios con roles de «desarrollador» y «analista» pueden crear Aplicaciones.
A continuación se explica cómo trabajar con las Aplicaciones.
Creación de Aplicaciones
Nada más acceder a Control Panel, se mostrará una vista con las aplicaciones disponibles para el usuario.
También se puede acceder a las Aplicaciones desde el menú de Aplicaciones.
Se mostrará el listado de Aplicaciones disponibles para el usuario, en donde se podrá visualizar los permisos para el usuario.
Para crear una nueva Aplicación, se pulsará en el botón «+» situado en la parte superior derecha de la pantalla.
Hecho esto, se mostrará el asistente de creación de Aplicaciones, en donde habrá que introducir cierta información básica:
Nombre: el nombre único con el que identificar a la Aplicación.
Descripción: texto descriptivo extendido de la Aplicación, como su uso, propiedades, características, etc.
Imagen: selector de imagen para caracterizar la portada de la Aplicación en el listado de Aplicaciones.
Una vez definidos estos campos, se terminará de crear la Aplicación pulsando el botón de «Crear».
Con esto, la Aplicación queda creada, mostrándose el asistente de edición de la Aplicación donde se podrá configurar.
Configuración de la Aplicación
Una Aplicación tiene las siguientes opciones:
Entorno de la Aplicación
En este apartado de la Aplicación, se puede visualizar un gráfico con los conceptos asociados a ésta, pudiendo acceder directamente desde el grafo a los recursos.
Información general
Esta sección muestra la información principal de la Aplicación: el nombre, el dueño (propietario), la descripción y la imagen asociada.
Se puede actualizar tanto la descripción como la imagen, mientras que el nombre y el dueño se encuentran bloqueados.
Desarrolladores de Aplicaciones
Este apartado va a permitir la gestión de permisos sobre el desarrollo de la Aplicación; es decir, se añadirán a los usuarios colaboradores en el desarrollo, los cuales van a poder modificar los diferentes conceptos asociados a la Aplicación, como la creación de los mismos, habilitando un entorno de desarrollo colaborativo para la evolución del proyecto de manera sencilla.
Usuarios
La gestión de usuarios finales se define en este apartado, donde se dispone de dos opciones para añadir dichos permisos:
A nivel de usuarios de la Plataforma: en donde se pueden añadir todos los usuarios que sean necesarios, aunque posteriormente la gestión de permisos se realizará usuario a usuario y no por roles.
A nivel de dominio de seguridad: marcando el selector de «¿Vincular con el Dominio de Seguridad?» se va a poder enlazar un Realm generado en la Plataforma, añadiendo así la configuración previa y poder gestionar los accesos sobre los recursos mediante los roles definidos en el Realm, facilitando la gestión de los propios permisos.
Recursos de la Aplicación
En la interfaz de proyectos se han incorporado nuevos controles, que van a permitir realizar el alta de todos los conceptos gestionables vía Aplicación.
Los usuarios dispondrán de una gestión centralizada de todos los recursos: asociados a la Aplicación, con acceso todas opciones como su visualización, edición o eliminación de la aplicación (que no de la Plataforma) de cada recurso, como aquellas opciones singulares, como por ejemplo el acceso al Swagger para las APIs.
De manera adicional, los usuarios no solo pueden gestionar los recursos incluidos en la Aplicación, sino que disponen de diferentes vías para evolucionar la misma con nuevos recursos:
Asignación de nuevos recursos: seleccionado el acceso arriba a la derecha de «Asignar», se va a disponer de un buscador con todos los diferentes conceptos de la Plataforma, donde se realizará una búsqueda por tipo de recurso y si está o no asignado al proyecto. Esto facilita la reutilización de recursos ya generados y la asignación de permisos.
Una vez seleccionado el concepto, se añadirán los permisos deseados sobre los usuarios finales, adjudicando accesos de lectura y/o escritura por roles o usuarios (dependiendo de la gestión de los mismos en el paso anterior).
Generación de nuevos recursos: para disponer de la mejor gestión centralizada del desarrollo, desde la paleta de recursos en el menú, donde no solo se verá la agrupación de recursos asociados de cada tipo en la aplicación, sino que también se podrán generar nuevos elementos desde la opción «+».
Una vez seleccionado el tipo de recurso, se podrá acceder a la creación del mismo.
Una vez creado el nuevo recurso, el sistema se redirigirá a la Aplicación y solicitará dar los permisos deseados a los diferentes roles o usuarios.
WebApp
La Aplicación no solo agrupa y gestiona conceptos de la Plataforma, sino que también puede gestionar el proyecto web relacionado con la misma. Desde esta opción, se puede no solo enlazar una Aplicación web pre-generada en la Plataforma, sino que también se tendrá la opción de crear un concepto nuevo de WebApp.
Documentación
Documentar la Aplicación va a permitir mantener un mejor seguimiento y disponer de una herramienta para la gestión del proyecto. Seleccionando este apartado, va a permitir seleccionar todos aquellos recursos asociados a la Aplicación a partir de un árbol de todos los conceptos de la Plataforma.
Una vez seleccionados aquellos recursos que se quieren incluir, e introducida la información para la documentación (identificación, título, breve descripción e introducción), se dispondrá en la Aplicación del listado de todas las documentaciones generadas y opciones como su descarga, generar nuevas versiones o eliminar la documentación.
Del mismo modo, seleccionando la opción de vista, se accederá a la documentación generada en detalle:
Flujo de fomularios
En esta opción dentro de las Aplicaciones, aparecerá un gráfico con los formularios asociados a la Aplicación, en donde se podrá acceder directamente a ellos, seleccionando el formulario y accediendo mediante «Ir al formulario».
Versionado Git de Aplicaciones
La Plataforma también permite no solo disponer de la gestión centralizada del proyecto, sino que también añade la funcionalidad de versionado Git a nivel de las Aplicaciones, para así añadir la gestión de versiones tanto de la Aplicación como los recursos asociados a los mismos.
Para ello, únicamente habrá que introducir la información referente a la configuración de Git:
Una vez completada la configuración del repositorio Git, la Aplicación gestionará la versión de todos los recursos generados permitiendo nuevas opciones, como la generación o restauración de versiones, como la restauración de recursos independientes de la Aplicación.