Saltar a contenido

Modal Novedades

El modal de novedades muestra las notas de la versión a los usuarios cuando hay una nueva versión de Clarive disponible. El modal aparece automáticamente al iniciar sesión o al recargar la página cuando cambia la versión.

Permisos

El modal requiere que el permiso action.user.whatsnew esté habilitado para los roles de usuario.

Por defecto, ningún rol tiene este permiso asignado. Los administradores deben asignar manualmente el permiso a los roles deseados.

Habilitar el modal de novedades

  1. Acceder a Administración - Roles
  2. Seleccionar el rol a editar (ej: user o developer)
  3. Abrir la pestaña Acciones Disponibles
  4. Arrastrar Ver novedades al iniciar sesión desde el panel izquierdo al panel derecho
  5. Guardar el rol

Nota Si ningún rol tiene este permiso asignado, el modal no aparecerá para ningún usuario.

Comportamiento del modal

El modal se muestra cuando:

  • Se detecta una nueva versión (diferente a la última versión vista por el usuario)
  • El usuario no ha deshabilitado el modal para la versión actual

El modal no se muestra cuando:

  • El usuario no tiene el permiso action.user.whatsnew
  • El usuario ya ha aceptado la versión actual
  • El usuario ha marcado "No mostrar de nuevo" (hasta que se publique una nueva versión)

Acciones del usuario

Los usuarios pueden interactuar con el modal de tres formas:

  • Cerrar (X) - Cierra el modal sin guardar. El modal aparecerá de nuevo en la siguiente recarga.
  • Aceptar - Marca la versión actual como vista. El modal no aparecerá de nuevo para esta versión.
  • Aceptar + "No mostrar de nuevo" - Marca la versión como vista y deshabilita futuras notificaciones hasta que se publique una nueva versión.

Comportamiento con nuevas versiones

Cuando se publica una nueva versión, el modal aparece automáticamente incluso si los usuarios previamente marcaron "No mostrar de nuevo". Esto asegura que la información importante de las nuevas versiones llegue a todos los usuarios.

Persistencia de datos

Las preferencias del usuario para el modal de novedades se almacenan como atributos en el modelo de usuario:

  • whats_new_last_seen - Almacena el número de versión visualizada por última vez por el usuario
  • whats_new_disabled - Almacena si el usuario deshabilitó futuras notificaciones (0 o 1)

Estos atributos se almacenan en MongoDB y se incluyen automáticamente en las copias de seguridad de la base de datos. No se requieren procedimientos especiales de exportación o importación.

Para más información sobre los atributos del modelo de usuario, consulte la documentación de Usuarios.

Resolución de problemas

El modal no aparece

  1. Verificar que el rol del usuario tiene el permiso action.user.whatsnew
  2. Comprobar que existe el archivo CHANGELOG.txt en el directorio raíz de Clarive
  3. Verificar que el formato del CHANGELOG sigue la estructura requerida:
----- 7.16.1 -----
[ENHANCEMENTS]
- #1234 Descripción de la funcionalidad

[FIXES]
- #5678 Descripción de la corrección

El modal aparece repetidamente

Este es el comportamiento esperado si el usuario cierra el modal con el botón X sin hacer clic en Aceptar. Para evitar que el modal aparezca, el usuario debe hacer clic en el botón Aceptar.