Crear Informe

Permite a los usuarios crear grids de tópicos personalizados. El usuario selecciona las columnas a mostrar, categorías y filtros. Este grid, puede configurarse de la siguiente manera:

Crear Informe¶

Existen dos formas:

La primera, consiste en ir a Administración - Reglas y pulsar el botón Crear.

Nos aparecerá una ventana con las siguientes opciones:

Nombre - Asigna un nombre al informe. Este campo es obligatorio.
Tipo - Define el tipo de regla. Para nuestro caso, seleccionamos informe.
Modo de compilación

Para crear el informe, hacemos click en el botón Finalizado.

Por defecto, nos aparecerán tres elementos:

Seguridad - Definimos los usuarios que tienen acceso al informe.
Meta - Definimos los campos que se van a mostrar.
Datos - Tratamos los datos a mostrar.

La segunda forma para crear un informe es la siguiente:

Hacemos click en dentro del menú principal. Click derecho en Nueva Búsqueda.

Opciones¶

Nombre - Nombre del reporte.
Filas - Define el numero de filas por página en el grid.
Recursive level - Ajusta la profundidad de la relaciones entre tópicos.
Permisos - Podemos seleccionar la privacidad de nuestro informe.
- Privado - Únicamente el propietario del informe puede verlo.
- Público - Muestra un combo Usuarios y roles donde podemos seleccionar quién puede ver el informe.

Query¶

En esta pestaña, podemos definir la configuración de nuestro informe. En la izquierda aparecen todas las categorías y sus fieldlets.

A la derecha, aparece el árbol con los datos añadidos en nuestro informe:

Categorías - Arrastrar y soltar la categoría que queremos ver en el informe.
Campos - Arrastrar los fieldlets que queremos ver en el informe. Haciendo click en cada campo podemos ver las siguientes opciones:
- Cabecera - Título de la columna.
- Ancho - Ancho de la columna.
Filtros - Además, podemos añadir filtros arrastrando los fieldlets aquí. Haciendo click en cada fieldlet, podemos ver las siguientes opciones:
- String - Podemos filtrar por texto.
- CI - Podemos filtrar por alguna condición.
- Fecha - Podemos filtrar por fecha
Ordenar - Podemos definir el orden. Arrastrar un fieldlet aquí y hacer click en él. Aparecerá un menú en el que definiremos el orden ascendente o descendente.

Para terminar hacer click en Guardar.

Categorías al Mismo Nivel¶

Cuando se agregan dos o más categorías al mismo nivel (sin relación padre-hijo), un campo arrastrado desde una categoría también mostrará datos para los tópicos de las demás categorías del mismo nivel, siempre que el campo exista en ambas categorías.

Por ejemplo, si un informe incluye las categorías "Bug" y "Funcionalidad" al mismo nivel y el campo título se arrastra desde "Bug", los tópicos de la categoría "Funcionalidad" también mostrarán su título en esa columna.

Categorías Hermanas Bajo un Padre¶

Cuando una categoría padre (ej. "Release") tiene dos o más categorías hijas (ej. "Historia de Usuario" y "Corrección") vinculadas mediante la misma relación, estas categorías hermanas también comparten campos. Un campo arrastrado desde una categoría hija mostrará datos para los tópicos de las demás categorías hermanas.

Por ejemplo, si "Release" tiene las hijas "Historia de Usuario" y "Corrección" y el campo título se arrastra desde "Historia de Usuario", los tópicos de la categoría "Corrección" también mostrarán su título en esa columna.

Campos Internos¶

Además de los fieldlets de categoría, el árbol de selección de campos incluye campos internos que agregan datos calculados a partir de relaciones e información interna de los tópicos:

Asignados - Muestra todos los usuarios asignados a un tópico a través de campos de relación de tipo usuario (ej. colaborador, revisor). Muestra el avatar del usuario, nombre real y el nombre del campo que lo vincula al tópico.
Transiciones de Estado - Muestra el historial completo de transiciones de estado del tópico, indicando cada par de estado origen/destino con su fecha.
Última Transición - Muestra la transición de estado más reciente como texto (ej. "en_revision → cerrado (2024-03-15 14:30:00)").
Tiempo en Estado - Muestra un desglose del tiempo que el tópico permaneció en cada estado, con el tiempo total y el número de veces que entró en ese estado.

Filtros JSON Personalizados¶

Para usuarios avanzados que necesitan escribir condiciones de consulta MongoDB arbitrarias más allá de lo que soportan los tipos de filtro predefinidos, el editor de informes ofrece la opción de Filtro Personalizado JSON.

Para agregar un filtro JSON personalizado:

En la pestaña Consulta, haga clic derecho en el nodo Filtros del árbol de campos seleccionados.
Seleccione Agregar Filtro Personalizado en el menú contextual.
Se creará un nuevo nodo "Filtro Personalizado" con un valor hijo editable.
Haga doble clic en el nodo de valor (o clic derecho y seleccione Editar) para abrir el editor JSON.
Introduzca un objeto JSON de consulta MongoDB válido en el área de texto.
Haga clic en Aplicar para guardar el filtro.

El objeto JSON se fusiona directamente en la consulta MongoDB. Puede utilizar cualquier operador de consulta MongoDB válido. Por ejemplo:

Filtrar por título que contenga "bug" (sin distinción de mayúsculas): {"title": {"$regex": "bug", "$options": "i"}}
Filtrar por rango de fecha de creación: {"created_on": {"$gte": "2025-01-01", "$lt": "2025-07-01"}}
Combinar condiciones con $or: {"$or": [{"priority": "high"}, {"severity": "critical"}]}

Un JSON inválido será rechazado con un mensaje de error al intentar aplicar el valor del filtro.

Filtros de Fecha Dinámicos¶

Los filtros de fecha soportan palabras clave dinámicas que se resuelven en el momento de la consulta, de modo que los informes siempre reflejan la fecha actual sin necesidad de edición manual. Cuando se arrastra un campo de fecha a la sección Filtros, el desplegable de operadores incluye:

Operador	Descripción
TODAY	Registros de hoy
YESTERDAY	Registros de ayer
THIS WEEK	Registros desde el lunes de la semana actual hasta hoy
LAST WEEK	Registros del lunes al domingo de la semana anterior
THIS MONTH	Registros desde el 1 del mes actual hasta hoy
LAST MONTH	Registros del mes anterior completo
THIS YEAR	Registros desde el 1 de enero del año actual hasta hoy
LAST YEAR	Registros del año anterior completo

Los operadores de fecha dinámica no requieren valor — basta con seleccionar uno y hacer clic en Aplicar.

Filtro de Fecha Entre (Between)¶

El operador BETWEEN filtra por un rango de fechas definido por dos límites (Desde y Hasta). Cada límite puede ser una fecha específica seleccionada del calendario o una fecha Relativa como desplazamiento desde hoy.

Cuando se selecciona Relativo, se introduce un número con signo y una unidad:

Cantidad	Unidad	Significado
`-3`	Dias	3 dias antes de hoy
`+1`	Meses	1 mes desde hoy
`0`	Dias	Hoy
`-2`	Semanas	2 semanas (14 dias) antes de hoy
`+1`	Anios	1 anio desde hoy

Por ejemplo:

Desde: Relativo -7 Dias, Hasta: Relativo 0 Dias — muestra todos los registros desde hace 7 dias hasta hoy.
Desde: 2025-01-01 (Fecha Específica), Hasta: Relativo 0 Dias — muestra registros desde el 1 de enero de 2025 hasta hoy.
Desde: Relativo -1 Meses, Hasta: Relativo +1 Meses — muestra registros desde hace 1 mes hasta 1 mes en el futuro.

Nota: Los informes existentes que usan los límites basados en palabras clave antiguas (Hoy, Mes Pasado, etc.) siguen funcionando sin cambios.

Todas las insignias de filtro de fecha dinámica (operadores independientes y BETWEEN) ahora muestran las fechas reales resueltas en lugar de etiquetas de palabras clave. Por ejemplo, una insignia de filtro THIS WEEK muestra 2026-03-02 ~ 2026-03-03 en lugar de solo el nombre de la palabra clave.

Filtro de Usuario Actual¶

Los campos de usuario (como Creado Por, Modificado Por, fieldlets de tipo usuario personalizados) y el campo interno Asignados soportan el operador dinámico CURRENT USER. Al seleccionarlo, el filtro se resuelve en el momento de la consulta al usuario que está ejecutando el informe, de modo que el mismo informe guardado muestra resultados diferentes según quién lo visualice.

Para usarlo:

Arrastre un campo de usuario o Asignados a la sección Filtros.
Haga doble clic en el nodo de valor del filtro para abrir el editor.
Seleccione CURRENT USER en el desplegable de operadores — el selector de valor desaparece porque no se necesita ningún valor.
Haga clic en Aplicar y guarde el informe.

Esto es útil para crear informes de tipo "mostrar mis tópicos" que cada miembro del equipo puede ejecutar para ver solo los tópicos que creó, modificó o tiene asignados.