Índice

Evolution Wave

Evolution Wave Portal Versión 4.8.0

Recomendaciones generales

Antes de iniciar con la actualización, se recomienda hacer un backup de la versión anterior y validar la actualización en un ambiente de pruebas antes de aplicarla en producción. Se deben respaldar los siguientes archivos del folder del sitio web, normalmente ubicados en “C:\inetpub\wwwroot\EvoWave”:

web.config
manifest.json
appsettings.json (ubicado en la carpeta de assets)
appsettings.production.json (ubicado en la carpeta de assets)
logger-config.json (ubicado en la carpeta de assets)

Nuevos requisitos de software

Evolution 1.24.2.4 o superior
Evolution Connect 2.9.0 o superior
Identity Server 2.6.0 o superior

Advertencias y cambios que rompen compatibilidad

Nuevo método de inicio de sesión (authorization_code con PKCE)

Evolution Wave Portal ahora inicia sesión con el flujo authorization_code con PKCE en lugar del flujo implícito. Antes de publicar esta versión se debe actualizar el cliente EvolutionPWA en Identity Server; de lo contrario, los usuarios no podrán iniciar sesión. Los scripts se encuentran en el instalador de Identity Server.

Nuevas funcionalidades

Dashboards de Colaborador y Gerente

Se agrega un dashboard de inicio que presenta al usuario un resumen de su información y accesos rápidos a las opciones que más utiliza, con la posibilidad de agregar y quitar favoritos. Existen dos experiencias, Colaborador y Gerente; el portal muestra una u otra según los permisos ABAC del usuario (si tiene ambos, prevalece Gerente). Cada tarjeta se muestra únicamente si el usuario tiene permiso sobre ella o sobre la pantalla de la que proviene la información.

Soporte a Plugins

Permite incorporar pantallas externas (plugins) al portal sin modificar el producto. Los plugins se publican en una carpeta separada del sitio en IIS, se registran en un archivo catalog.json y aparecen en el menú lateral según los permisos ABAC del usuario. La funcionalidad viene deshabilitada por defecto y se activa con las claves PluginsEnabled y PluginsBaseUrl del archivo de configuración.

Integración de Notificaciones

Se agrega la bandeja de notificaciones dentro del portal: una campana en la barra superior y la pantalla Notificaciones, donde el usuario puede marcar avisos como leídos o no leídos, marcar todos como leídos y archivarlos. Funciona de forma independiente a las notificaciones push de OneSignal. Viene deshabilitada por defecto y se activa con la clave notifications.isActive del archivo de configuración.

Íconos individuales para Entidades Adicionales y Consultas Genéricas

Se puede asignar un ícono propio a cada entidad adicional y a cada consulta genérica copiando un archivo SVG en assets/svg/custom/ y registrándolo en la sección dynamicCardIcons del archivo de configuración. Si no se configura, se mantiene el ícono genérico.

Mejoras en Funcionalidades Existentes

Actualización de diseño: librería de componentes Evolution

Se migró la interfaz gráfica de todo el portal a la librería de componentes Evolution, para unificar el aspecto y el comportamiento de tablas, formularios, diálogos, tarjetas y botones. La migración abarca los módulos de Consultas (incluidas todas las secciones de Mi Expediente y Expediente de Subalternos), Solicitudes, Acciones, Autorizaciones y Cuenta, así como los elementos generales del portal: títulos, barra de búsqueda, ruta de navegación (breadcrumb), pie de página, paleta de colores y espaciado de las pantallas.

Actualización a Angular 20

Se actualizó la aplicación a Angular 20.

Autenticación con authorization_code y PKCE

Se reemplazó el flujo implícito de inicio de sesión por authorization_code con PKCE, con renovación automática de la sesión. Consulte la sección Advertencias y cambios que rompen compatibilidad para los ajustes requeridos en Identity Server.

Límites de fechas alineados con Evolution

Los rangos de fechas permitidos en los formularios ahora coinciden con los de Evolution y se configuran de forma centralizada en el archivo assets/date-ranges-config.json, que no requiere cambios durante la instalación.

Reemplazo de GraphQL por endpoints nativos de Evolution Connect

Se reemplazaron las consultas que el portal realizaba mediante GraphQL por endpoints nativos de Evolution Connect.

Correcciones

Documentos Gestionados: el filtro de la consulta ya se puede reiniciar.
Limpiar caché: se corrigieron inconsistencias al limpiar la caché cuando se tiene un tema personalizado.
Relaciones de Fiador: los mensajes de máximo de caracteres en Mi Expediente y Expediente de Subalternos ahora coinciden con los límites reales.
Documentos de identificación: se corrigió el mensaje de validación al guardar un número de identificación que ya existe, en Mi Expediente y Expediente de Subalternos.
Propiedades: se corrigió la localización del campo Valor en Mi Expediente y Expediente de Subalternos.
Disponibilidad de Tiempo de Mis Subalternos: la descripción ya no muestra NaN/NaN/NaN.
Menú en móvil: las opciones del menú se muestran completas cuando el dispositivo está en posición horizontal.
Consulta de solicitudes: se corrigió el mensaje del diálogo de la consulta.
Autorizaciones: la información de las solicitudes de Ayuda Económica ya se muestra.
Mis Vacaciones: la tabla ya no muestra información cortada.
Solicitud de Horas Extras: se corrigió el nombre de un campo.

Instrucciones de Instalación

Base de Datos

Todos los archivos necesarios para la instalación o actualización de la base de datos se encuentran disponibles en la carpeta Evolution Connect / Databases ubicada en su propio paquete. Para conocer el procedimiento específico a seguir según el caso (instalación nueva o actualización), consulte el archivo README incluido en la carpeta Evolution Connect.

Adicionalmente, para el nuevo método de inicio de sesión se debe ejecutar en la base de datos de Identity Server el script del cliente EvolutionPWA indicado en la sección Advertencias y cambios que rompen compatibilidad.

Ubicación

Se sugiere instalar respetando la siguiente estructura de folders y archivos:

C:\aseinfo
    \Evolution Components 1.24.2.4
    \Connect 2.9.0
    \Evolution Wave Portal 4.8.0
      \dist
      Readme Evolution Wave Portal 4.8.0.pdf
      Release Notes.txt

Configuración del archivo appsettings.json

El archivo appsettings.json distribuido en el paquete debe conservarse intacto dentro de “\Evolution Wave Portal 4.8.0\dist\assets\”.

Los ajustes propios del ambiente deben realizarse en un archivo adicional llamado appsettings.production.json, ubicado en la misma carpeta assets y con la configuración productiva del cliente. El portal carga primero appsettings.json y luego aplica encima los valores de appsettings.production.json. Durante futuras actualizaciones, se debe comparar el appsettings.json del nuevo paquete contra el appsettings.production.json del ambiente e incorporar en este último cualquier clave nueva o ajuste requerido por la liberación.

Claves nuevas en esta versión (opcionales; si no se agregan, la funcionalidad queda deshabilitada):

PluginsEnabled y PluginsBaseUrl: habilitan el soporte a plugins y la URL donde se publica el catálogo.
notifications.isActive: habilita la bandeja de notificaciones dentro del portal.
dynamicCardIcons: íconos personalizados para entidades adicionales y consultas genéricas.