Diferencias

Muestra las diferencias entre dos versiones de la página.

--- reportes [2025/11/20 19:10] – [Ejecutar reportes de tipo Extracción] aolano
+++ reportes [2026/09/03 22:32] (actual) – clopez
@@ Línea 4: / Línea 4: @@
   * [[reportes#Mejores prácticas para la construcción de reportes|Mejores prácticas para la construcción de reportes]].
+  * [[reportes#Palabras reservadas|Palabras reservadas]].
   * [[modelo_datos#Modelo de datos de Be Aware 360|Modelo de datos de Be Aware 360]].
   * [[funcionesreportes#Funciones especiales para reportes|Funciones especiales para reportes]].
@@ Línea 10: / Línea 11: @@
   * [[tableau#Reportes y Dashboards de Tableau para Be Aware 360|Reportes y Dashboards de Tableau para Be Aware 360]].
   * [[reportesestandar#Reportes estándar de Be Aware 360|Reportes estándar de Be Aware 360]].
+  * [[reportes#Registros de actividad sobre los reportes|Registros de actividad sobre los reportes]].
 ===== Mejores prácticas para la construcción de reportes =====
@@ Línea 37: / Línea 40: @@
 Para mayor información sobre optimización de consultas, visitar el siguiente [[https://dev.mysql.com/doc/refman/5.7/en/select-optimization.html|enlace]].
+Cuando una columna del reporte no trae valor para un registro, se entrega vacía y conserva su posición y su encabezado. Esto aplica a la vista previa, a la ejecución de los reportes de tipo //Dashboard// y a la exportación a Excel desde la consola.
+===== Palabras reservadas =====
+Cada instancia mantiene una lista de palabras que no pueden aparecer en la consulta de un reporte, porque corresponden a estructuras internas de la plataforma. La lista se define por instancia, de modo que no es la misma en todas.
+Si la consulta utiliza una de esas palabras, la plataforma la rechaza e indica cuál es. El reporte no se guarda y la consulta no se ejecuta.
+La validación se aplica sobre el texto completo de la consulta, comparando palabra por palabra. Una columna o un alias que coincida exactamente con una palabra reservada provoca el rechazo aunque el resto de la consulta sea válida; en ese caso basta con renombrar la columna o el alias:
+<code>SELECT categorias.NOMBRE AS categoria FROM caso</code>
+**Nota:** Para conocer la lista vigente en su instancia, contacte con su administrador.
 ===== Crear reportes en Be Aware 360 =====
@@ Línea 42: / Línea 58: @@
 Be Aware 360 ofrece un menú para gestionar reportes con el fin que se puedan crear nuevos reportes que satisfagan las necesidades de cada organización, adicionales a los reportes estándar que ofrece la herramienta.
-Los reportes que ofrece la herramienta son de dos tipos:
+Los reportes que ofrece la herramienta son los siguientes:
   * **Dashboard:** Los reportes de este tipo pueden ser utilizados en los dashboards. Cuando se abre un Dashboard, por defecto se muestra un rango de fechas de 1 día.
   * **Extracción:** Los reportes de este tipo se ejecutan en segundo plano y su resultado es enviado al correo electrónico del usuario que lo ejecuta. Los reportes de este tipo no serán seleccionables desde un dashboard.
+  * **Gráficos:** Los reportes se presentan como gráficos en la consola, con los siguientes tipos:
+| Grafico Torta | El resultado se presenta como gráfico de torta. |
+| Grafico Barra | El resultado se presenta como gráfico de barras. |
+| Grafico Lineal | El resultado se presenta como gráfico de líneas. |
+| Grilla | El resultado se presenta como tabla de filas y columnas . |
+| Numerico | El resultado se presenta como un único valor destacado. |
+**Importante:** el tipo de salida determina dónde termina el reporte. Los de tipo Gráfico lo muestran en la consola, los de tipo Dashboard quedan disponibles para componer un tablero y los de tipo Extracción salen de la consola: no aparecen en ningún listado, solo en la pantalla de Extracción.
 Para crear nuevos reportes, realice los siguientes pasos:
@@ Línea 55: / Línea 80: @@
   - Seleccione el valor //Activo// en el campo **Estado** para dejar el reporte activo para su ejecución.
   - Seleccione el tipo de reporte en el campo **Tipo de salida**.
+  - Seleccione la clasificación del reporte en el campo **Tipo**. Es una clasificación libre de cada organización: agrupa los reportes en el listado y no altera su comportamiento.
+  - Seleccione el color con el que se presenta el resultado en el campo **Color**. Aplica a los reportes de tipo Numerico y de gráfico.
   - Seleccione el(los) rol(es) que tendrán permiso de visualizar el reporte en el campo **Roles**.
   - Seleccione la o las segmentaciones que tendrán permiso de visualizar el reporte en el campo **Segmentación**.
@@ Línea 62: / Línea 89: @@
   - Para visualizar una muestra de datos del resultado del reporte, haga clic en el botón **Previsualizar reporte**. Se aplica una validación en las consultas de reportes, ya sean del tipo Dashboard o Extracción, para evitar tiempos de espera excesivos en la vista previa:
     - Si la query/consulta posee menos de 7 “join” entre tablas, se ejecuta la vista previa al guardar.
-      - El tiempo de respuesta de la vista previa dependerá del tamaño de la respuesta. Tiempo máximo: 30 segundos.
+      - El tiempo de respuesta de la vista previa dependerá del tamaño de la respuesta. El tiempo máximo de ejecución está configurado por instancia; su valor por defecto es de 45 segundos.
-    - Si la query/consulta posee 7 o más “join” entre tablas, no se ejecuta la vista previa al guardar.
+      - La vista previa muestra hasta 50 filas, con independencia de la cantidad de registros que devuelva la consulta.
-      - Se recibe el mensaje: “Vista Previa no disponible por tamaño de la consulta”.
+    - Si la query/consulta posee 7 o más “join” entre tablas, no se ejecuta la vista previa al guardar. Se recibe el mensaje: “Vista Previa no disponible por tamaño de la consulta”.
 ===== Ejecutar reportes de tipo Extracción =====
 Los reportes de tipo **Extracción** se ejecutan en segundo plano y es enviado un link de descarga al correo electrónico del usuario que lo ejecuta.
+El listado muestra el nombre, la descripción y el tipo con que se definió cada reporte, y solo aquellos a los que el rol del usuario conectado tiene acceso. La pantalla no permite crear, editar ni eliminar: cada fila tiene una única acción, que ejecuta el reporte. Cualquier cambio sobre la definición se hace en **Reportes** > **Reportes**.
+**Importante:** si un reporte esperado no aparece en el listado, revise en **Reportes** > **Reportes** que su Tipo de salida sea **Extracción**, que su Estado sea **Activo** y que su rol esté incluido en el campo Roles.
 Para ejecutar un reporte de tipo //Extracción//, realice los siguientes pasos:
   - Navegue al menú **Reportes** > **Extracción**.
-  - El sistema lista todos los reportes de tipo extracción creados en la herramienta que pueden ser accedidos por el rol del usuario conectado.
   - Ubique el reporte que desea ejecutar. Puede ayudarse del buscador ubicado en la parte superior derecha.
   - Clic en el botón **Extraer reporte** ubicado al final del registro del reporte.
@@ Línea 79: / Línea 110: @@
   - Clic en el botón **Ejecutar** para ejecutar el reporte en segundo plano.
   - El sistema muestra un mensaje de confirmación: "Reporte enviado a proceso de extracción de manera satisfactoria".
-  - Revisar su bandeja de correos. El sistema le enviará un correo con el link de descarga del reporte solicitado.
+  - Revisar su bandeja de correos. El sistema le enviará un correo con el link de descarga del reporte solicitado. El nombre del archivo es aleatorio y su extensión es .csv.
-    - El nombre del archivo es aleatorio y su extensión es .csv.
-    - El link para descargar el archivo tiene una vigencia de 60 minutos.
+**Nota Importante:** El enlace para descargar el archivo generado desde los reportes de tipo extracción tiene un tiempo de expiración de **60 minutos**. El archivo debe ser descargado antes de cumplirse los 60 minutos después de recibir el correo electrónico; superado ese tiempo el enlace pasará a estar inactivo y deberá generar nuevamente el reporte.
+===== Registros de actividad sobre los reportes =====
+La plataforma mantiene dos registros sobre la actividad de los reportes:
-** Nota Importante: ** El enlace para descargar el archivo generado desde los reportes de tipo extracción tienen un tiempo de expiración de **60 minutos**. El archivo debe ser descargado antes de cumplirse los 60 min después de recibir el correo electrónico; superado ese tiempo  el enlace pasará a estar inactivo y deberá generar nuevamente el reporte.
+  * **Registro de ejecuciones:** cada vez que un reporte se ejecuta se guarda qué usuario lo ejecutó y en qué momento. Permite revisar el uso de los reportes de la instancia y dimensionar su impacto sobre el rendimiento.
+  * **Registro de cambios:** la creación, la modificación y la eliminación de un reporte quedan registradas junto con el usuario que realizó la acción y el momento en que ocurrió.