Working with UI

Resumen

El motor de flujos de trabajo OKMFlow ofrece una interfaz de usuario web para gestionar definiciones de procesos de flujo de trabajo, supervisar instancias de flujo de trabajo activas, diseñar flujos de trabajo y administrar el sistema. La interfaz está organizada en varias secciones de menú, cada una con funcionalidades específicas según los roles y permisos del usuario.

Opciones del menú principal

Opción de menú	Nivel de acceso	Descripción
Home panel	Todos los usuarios	El panel Home es el panel principal para la gestión de flujos de trabajo. Muestra dos secciones principales: - Process definitions: lista todas las definiciones de flujo de trabajo disponibles con su Id, Version, Name y estado Active. Desde aquí puede crear nuevos flujos de trabajo, activar/desactivar flujos de trabajo, importar/exportar definiciones de flujo de trabajo y acceder al Designer haciendo clic en el icono de edición. - Process instances: muestra las instancias de flujo de trabajo en ejecución con detalles como Id, Status, Start date, End date, Last activity, el Node asociado, la referencia de OpenKM Node y las Actions disponibles. Esta sección ofrece supervisión y gestión en tiempo real de los flujos de trabajo activos (instancias de tarea).
Designer panel	Todos los usuarios	El Designer es un editor gráfico de flujos de trabajo que se activa únicamente cuando un usuario hace clic en el icono de edición desde el panel Home. Ofrece: - Lienzo visual del flujo de trabajo: muestra el diagrama del flujo de trabajo con los nodos (Start, Task, Action, Decision, End, etc.) y las transiciones entre ellos. - Panel de propiedades del nodo: muestra las propiedades configurables del nodo seleccionado en la parte derecha de la pantalla, incluyendo ajustes específicos del nodo como asignaciones de Task, scripts de Action, condiciones de Decision, etc. - Controles de edición: botones de la barra de herramientas para editar, eliminar, clonar y gestionar los elementos del flujo de trabajo.
Users panel	Solo ROLE_ADMIN	La sección Users permite a los administradores gestionar los usuarios del motor de flujos de trabajo y sus privilegios de acceso. Esta opción de menú solo es visible para los usuarios que son miembros del rol ROLE_ADMIN. Las funciones clave incluyen: - Crear y gestionar cuentas de usuario del motor de flujos de trabajo - Asignar roles y permisos - Configurar los niveles de acceso de los usuarios a las funciones del flujo de trabajo Los usuarios gestionados en esta sección son específicos del motor de flujos de trabajo. Son independientes de los usuarios de la aplicación OpenKM, aunque pueden corresponder a las mismas personas.
Tools	Solo ROLE_ADMIN	El menú Tools da acceso a utilidades administrativas para la gestión del motor de flujos de trabajo. Esta opción de menú solo es accesible para los miembros del rol ROLE_ADMIN. Herramienta disponible actualmente: - Database query: permite a los administradores ejecutar consultas SQL directamente contra la base de datos del motor de flujos de trabajo. Es útil para la resolución de problemas, el análisis de datos y tareas avanzadas de gestión del flujo de trabajo. La interfaz de consulta de base de datos ofrece: - Editor SQL con resaltado de sintaxis - Botón EXECUTE para ejecutar consultas - Tabla de resultados de consulta que muestra los datos devueltos - Botones CLEAR QUERY y CLEAR RESULTS para gestionar el espacio de trabajo Importante: la herramienta de consulta de base de datos ofrece acceso directo a la base de datos. Úsela con precaución, ya que las consultas incorrectas pueden afectar a la integridad de los datos del motor de flujos de trabajo. Solo administradores con experiencia deberían usar esta herramienta.
Admin	Mixto	El menú Admin da acceso a funciones administrativas e información de la aplicación. Contiene tres opciones: - Show debug (solo ROLE_ADMIN): muestra información de depuración y diagnósticos del sistema para la resolución de problemas. Esta opción solo es visible para los administradores. - About (todos los usuarios): abre un diálogo emergente que muestra la versión actual de la aplicación del motor de flujos de trabajo y otros detalles de la aplicación. - Logout (todos los usuarios): cierra la sesión del usuario actual en la aplicación del motor de flujos de trabajo y vuelve a la pantalla de inicio de sesión.

Disposición de la interfaz de usuario

La interfaz de usuario de OKMFlow sigue una estructura de disposición consistente:

Barra de navegación superior: contiene las opciones del menú principal (Home, Designer, Users, Tools, Admin) con visibilidad basada en roles
Área de contenido principal: muestra el panel activo (panel Home, lienzo del Designer, gestión de Users, etc.)
Paneles sensibles al contexto: aparecen paneles adicionales según la operación actual (por ejemplo, propiedades del nodo en el Designer, resultados de consulta en Tools)

Control de acceso basado en roles

El motor de flujos de trabajo implementa un control de acceso basado en roles para restringir la funcionalidad según el rol del usuario:

Rol	Opciones de menú accesibles
Todos los usuarios	Home, Designer (al editar), algunas opciones de Admin (About, Logout)
ROLE_ADMIN	Todas las opciones de menú, incluyendo Users, Tools y todas las opciones de Admin

Buenas prácticas

Use nombres de flujo de trabajo descriptivos: elija nombres claros y significativos para las definiciones de proceso, con el fin de facilitar su identificación
Active los flujos de trabajo de forma selectiva: active únicamente los flujos de trabajo que estén probados y listos para producción
Supervise las instancias de proceso con regularidad: revise el panel Process instances para identificar flujos de trabajo bloqueados o problemáticos
Exporte los flujos de trabajo antes de cambios importantes: cree copias de seguridad exportando las definiciones de flujo de trabajo antes de realizar modificaciones significativas
Limite el acceso administrativo: asigne ROLE_ADMIN únicamente a los usuarios que necesiten acceso completo al sistema
Use las consultas de base de datos con cuidado: la función Tools → Database query debe usarse con precaución y solo por administradores con experiencia
Documente las versiones del flujo de trabajo: mantenga un control de versiones claro al actualizar las definiciones de flujo de trabajo
Pruebe a fondo en el Designer: valide la lógica del flujo de trabajo y la configuración de los nodos en el Designer antes de activarlos