¶ 1. Visión General
Nuestro sistema de notificaciones de T6 permite visualizar con un amplio nivel de detalle las ejecuciones realizadas, como cargas de datos, publicaciones del cubo y procesos del workflow. Permite visualizar el estado de la ejecución, la hora detallada de inicio y fin, y el tiempo total de ejecución. En caso de errores durante la ejecución, se mostrará una lista de errores, permitiendo seleccionar un error específico y verificar su detalle.
¶ 2. Funcionalidades
Entre las nuevas funcionalidades agregadas al sistema de notificaciones, se encuentran:
- Detalle completo de la acción disparada;
- Posibilidad de cancelar un proceso que se está ejecutando con fallas y corregirlo antes de su finalización;
- Posibilidad de descargar el archivo de carga de datos utilizado;
- Visualización de barra de estado, mostrando el porcentaje hasta la finalización;
- Carril con posibles acciones, que variarán dependiendo de la acción disparada.
- Notificaciones personalizadas, donde el usuario puede crear una notificación con un mensaje personalizado para un grupo de usuarios o un usuario específico.
- Menciones de usuarios a través de las Notificaciones.
¶ 3. Utilización
Para utilizar el sistema de notificaciones, necesitaremos realizar una acción que genere una notificación, a partir de una carga de datos, una publicación del cubo o ejecutar un proceso del workflow.
Al hacer clic en 
en la esquina superior de la pantalla del T6, se mostrará un panel lateral con la lista de notificaciones generadas por el sistema y una barra de estado con el porcentaje ejecutado. Entre ellas, tendremos algunas posibilidades:
: Se mostrará en caso de que la acción disparada esté siendo ejecutada sin ninguna falla hasta el momento;
: Se mostrará en caso de que la acción disparada haya sido ejecutada y finalizada con éxito;
: Se mostrará en caso de que la acción disparada esté siendo ejecutada con fallas;
: Se mostrará en caso de que la acción disparada haya sido ejecutada y finalizada, pero con fallas;
: Se mostrará en caso de que la acción disparada tenga uno o más errores que impidan su ejecución y finalización.
Al hacer clic en una notificación, se abrirá una nueva pestaña en T6, mostrando el detalle completo de la acción disparada.
En caso de un error que impida la ejecución, la pestaña abierta mostrará el título de la acción disparada; una breve explicación informando que la ejecución no se realizó por error; qué usuario disparó la acción; el estado de error; la fecha y hora detallada de inicio de la ejecución y un cuadro informando el detalle del error.
Si la notificación de error está dirigida a un usuario Gestor o Administrador, se mostrará la stacktrace del error, lo que permite un análisis más detallado del error ocurrido. De lo contrario, se mostrará un mensaje de error indicando al usuario que contacte al administrador, sin mostrar la stacktrace del error.
¶ 3.1. Publicación del Cubo
Al publicar el cubo después de la creación de una o más fórmulas, el sistema mostrará una notificación. Al hacer clic en la notificación, se abrirá una nueva pestaña en la cual podemos visualizar el detalle de las acciones realizadas por el sistema al publicar el cubo.
En esta pantalla tenemos:
- El nombre de la acción realizada;
- El usuario que disparó dicha acción;
- El estado de la acción;
- Fecha y hora en que la acción fue realizada por el usuario;
- Fecha y hora en que la acción fue finalizada;
- Duración total para la conclusión de la acción;
En el caso de las fórmulas, también tenemos los siguientes cards informativos:
Según el ejemplo anterior, en cada card tenemos:
- En la esquina superior izquierda, una numeración que indica el valor anterior a la publicación que generó la notificación;
- En el centro del card tenemos el valor actual en el momento de la publicación y, al lado de este valor, tendremos 3 posibilidades:
- Si el valor no sufrió cambios, el card quedará amarillo y con una línea, representando que no hubo cambios en ese valor al publicar el cubo;
- Si hubo un aumento en el valor, el card quedará rojo y con una flecha apuntando hacia arriba, representando que hubo un aumento en ese valor al publicar el cubo;
- Si hubo una reducción en el valor, el card quedará verde y con una flecha apuntando hacia abajo, representando una disminución en el valor al publicar el cubo;
Para más información acerca de las fórmulas en T6, acceda a: Fórmulas y Funciones
Justo debajo, tenemos una lista con todos los pasos realizados por el sistema al publicar el cubo, y al lado de cada paso tenemos el tiempo de duración de cada acción, representados en milisegundos;
¶ 3.2. Carga de Datos
Al ejecutar una carga de datos, el sistema muestra una notificación. Al hacer clic en la notificación, se abre una nueva pestaña en la cual podemos visualizar el detalle de las acciones realizadas por el sistema al ejecutar la carga de datos.
En caso de éxito, la pantalla mostrará solamente:
- El nombre de la acción realizada;
- El usuario que disparó dicha acción;
- El estado de la acción;
- Fecha y hora en que la acción fue realizada por el usuario;
- Fecha y hora en que la acción fue finalizada;
- Duración total para la conclusión de la acción;
- Botón para descargar el archivo utilizado para la carga de datos
En caso de ejecución concluida con fallas por error en el mapeo, además de los ítems mencionados anteriormente, tendremos también:
Un card donde se informa el nombre del mapeo realizado, el código de error generado y un botón Corregir mapeo:
Al hacer clic en Corregir mapeo seremos dirigidos a una nueva pestaña en T6, que contiene el formulario de datos utilizado para la carga de datos, permitiendo realizar las correcciones necesarias en el formulario.
También podemos hacer las modificaciones a través del archivo CSV utilizado para la carga, corrigiendo las filas que generaron errores y ejecutando la carga nuevamente.
Justo debajo del card, tenemos una lista de las fallas encontradas en la ejecución de la carga de datos y su detalle;
¶ 3.3. Procesos del Workflow
Al asignar una tarea del Workflow a un usuario, el sistema muestra una notificación informando al usuario que se le ha asignado una tarea. Al hacer clic en la notificación, se abre una nueva pestaña donde se muestra el nombre del objeto asociado a la tarea, el tiempo restante para completar la tarea y la fecha en que la tarea fue asignada al usuario.
Al hacer clic en la tarea, el usuario es redirigido al objeto asociado a la tarea, donde podrá realizar las acciones necesarias y completar o rechazar la tarea.
¶ 4. Notificaciones Personalizadas
Nos da la posibilidad de que un usuario pueda enviar un mensaje a un grupo de usuarios, o a un usuario específico cuando está realizando una actividad. Con esto, podemos crear una notificación donde podemos incluir cualquier información y no solamente la de la aplicación.
Nuestras notificaciones quedan guardadas en tablas de la base de datos que comienzan con REP_NOTIFICATION. La información que se almacena en la tabla REP_NOTIFICATION son los datos generales de una notificación.
En la tabla REP_NOTIFICATION tenemos las siguientes columnas:
codNotification: Identificador incremental, que se genera automáticamente al crear una notificación;codNotificationType: Identificador de notificación que proviene de la tablaREP_NOTIFICATION_TYPE, entre los tipos de notificación disponibles tenemos:- cubepublish = 1; (publicación del cubo)
- error = 2; (error)
- scenariocopy = 3; (copia de escenario)
- workflowstarter = 4; (disparador del workflow)
- system = 5; (notificación del sistema)
- workflowaction = 6; (acción del workflow)
- powerbi = 7; (power bi)
- custom = 8; (notificación personalizada)
flgState: Tenemos el estado de la notificación, entre los estados posibles de una notificación tenemos:- Unknown = 0; (Desconocida)
- Running = 1; (Ejecutando)
- Finished = 2; (Concluida)
- Canceled = 3; (Cancelada)
- Error = 4; (Con error)
- Stopped = 5; (Detenida)
codUser: Identificador del usuario que creó la notificación;dscObjectID: Identificador del objeto asociado a la notificación;dscObjectName: Nombre del objeto asociado a la notificación;dscTitle: Título del mensaje mostrado en la notificación;dscMessage: Cuerpo del mensaje mostrado en la notificación;dscDetails: Detalles del mensaje mostrado en la notificación;datStart: Fecha de inicio de la notificación;datEnd: Fecha de finalización de la notificación;
También tenemos la tabla REP_NOTIFICATION_USER, en la cual podemos indicar qué usuario nos gustaría que sea notificado para la notificación creada.
En una notificación personalizada vamos a llenar un registro en la tabla REP_NOTIFICATION y uno o más registros en la tabla REP_NOTIFICATION_USER.
¶ 4.1. Insertando Notificaciones Personalizadas
Para insertar una notificación personalizada, necesitaremos acceder a nuestra base de datos y realizar una inserción en la tabla REP_NOTIFICATION, por ejemplo:
INSERT INTO REP_NOTIFICATION (codNotificationType, flgState, codUser, dscObjectID, dscObjectName, dscTitle, dscMessage, dscDetails, datStart, datEnd)
VALUES
(8, 2, 1, NULL, NULL, 'Título de Ejemplo', 'Ejemplo del cuerpo del mensaje en la notificación', 'Ejemplo de detalles', GETUTCDATE(), GETUTCDATE())
Y también necesitaremos realizar una inserción en la tabla REP_NOTIFICATION_USER, por ejemplo:
INSERT INTO REP_NOTIFICATION_USER (codNotification, codUser)
SELECT TOP 1 codNotification AS codNotification, 1 AS codUser FROM REP_NOTIFICATION ORDER BY codNotification DESC
Siempre que vayamos a crear una notificación personalizada, primero debemos hacer el INSERT en la tabla
REP_NOTIFICATIONpara obtener el código de la notificación que utilizaremos en el INSERT de la tablaREP_NOTIFICATION_USER.
¶ 4.2. Llamando a la Notificación Personalizada
El usuario será notificado solo una vez; tan pronto como la notificación sea leída por el usuario, este no recibirá más la misma notificación.
Para llamar a la notificación, utilizaremos la siguiente API: .../API/Notification/Notify?notificationCode=****, donde **** serán sustituidos por el código de la notificación que creamos anteriormente.
La notificación solo será generada para los usuarios definidos en el INSERT de la tabla REP_NOTIFICATION_USER que estén conectados en el momento de la llamada a la API. Si no hay ningún usuario conectado en ese momento, la notificación simplemente no será entregada hasta que uno de los usuarios definidos inicie sesión en T6.
La notificación personalizada se mostrará de la siguiente manera:
Al hacer clic sobre la notificación, tendremos un mayor detalle, mostrando el usuario que disparó la notificación, la fecha de inicio y la fecha de finalización:
¶ 5. Mención de Usuarios a través de las Notificaciones
Los usuarios pueden ser mencionados en notificaciones personalizadas utilizando la sintaxis @nombredeusuario en el campo dscMessage de la tabla REP_NOTIFICATION.
Los usuarios también pueden recibir notificaciones de mención a través de los detalles de celdas en un formulario, donde el usuario es mencionado utilizando la sintaxis @nombredeusuario dentro del detalle de la celda.
Al ser mencionado, el usuario recibirá una notificación del tipo Mención seguida del nombre del objeto donde fue mencionado. Por ejemplo, si el usuario es mencionado en un detalle de celda de un formulario del cubo, se mostrará una notificación similar a esta:
Al hacer clic en Ver, si el usuario tiene acceso al formulario donde fue mencionado, será redirigido al formulario en la celda donde fue mencionado, con el panel de detalles abierto.
De lo contrario, se mostrará un mensaje de error informando que el usuario no tiene acceso al objeto donde fue mencionado.
¶ 6. Q&A
Preguntas Frecuentes
1. ¿Qué es el sistema de notificaciones de T6?
El sistema de notificaciones de T6 permite visualizar con detalle las ejecuciones realizadas, como cargas de datos, publicaciones del cubo y procesos del workflow, mostrando estado, horarios de inicio/fin, tiempo total y detalles de errores.
2. ¿Cómo accedo a las notificaciones?
Para acceder a las notificaciones en T6, haz clic en el ícono de campana en la esquina superior de la pantalla para abrir un panel lateral con la lista de notificaciones.
3. ¿Cuáles son los diferentes estados de notificación?
Las notificaciones en T6 pueden tener los siguientes estados:
Ejecutando;
Éxito (ejecutada y finalizada con éxito);
Ejecutando con falla;
Ejecutado con falla;
Error (impide la ejecución).
4. ¿Qué significa cada color de los cards informativos en la notificación mostrada después de la publicación del cubo?
Los colores de los cards informativos después de la publicación del cubo indican lo siguiente:
Amarillo con línea: sin cambio en el valor;
Rojo con flecha hacia arriba: aumento en el valor;
Verde con flecha hacia abajo: disminución en el valor;
5. ¿Qué puedo hacer cuando una carga de datos muestra notificación de falla?
Después de abrir la notificación, puedes hacer clic en Corregir mapeo para ir al formulario de datos y aplicar las correcciones necesarias, o corregir el archivo CSV utilizado y ejecutar la carga nuevamente.
6. ¿Puedo descargar el archivo utilizado en la carga de datos desde la notificación?
Sí. Después de abrir la notificación, puedes hacer clic en el botón de descarga disponible para el archivo utilizado en la carga de datos.
7. ¿Qué son las notificaciones personalizadas?
Las notificaciones personalizadas permiten que un usuario envíe mensajes personalizados a grupos de usuarios o a usuarios específicos, no limitadas solamente a información de la aplicación.
8. ¿Cómo creo una notificación personalizada?
Para crear notificaciones personalizadas, es necesario insertar registros directamente en las tablas de la base de datos, siguiendo la estructura descrita en la documentación (Notificaciones Personalizadas).
9. ¿Cómo llamo una notificación personalizada?
Para llamar una notificación personalizada, utiliza la API: .../api/Notification/Notify?notificationCode=**** donde **** es el código de la notificación creada anteriormente.
10. ¿Cuándo recibe el usuario la notificación personalizada?
Después de la llamada a la API, si el/los usuario(s) objetivo está(n) conectado(s) en ese momento, recibirá(n) la notificación.
Si no hay usuarios conectados, la notificación no se entregará hasta que uno de ellos inicie sesión.
11. ¿Es posible cancelar un proceso en ejecución desde la notificación?
Sí, después de abrir la notificación es posible cancelar un proceso que está ejecutándose con falla y corregirlo antes de su finalización.
12. ¿Qué muestra la barra de estado en la notificación?
Cuando la notificación muestra la barra de estado, esta indica el porcentaje de conclusión hasta la finalización del proceso (carga de datos, publicación del cubo, etc.).