Diseñador de widgets

Un widget es cada indicador, gráfica o tabla de una página de reportes. Se configura en el editor de widgets: eliges la fuente de datos, la visualización, qué se mide, cómo se agrupa y qué se filtra, y a la derecha ves el resultado en vivo. Solo administrador y gerente diseñan widgets.

Dónde está: menú lateral → Reportes → Páginas de reportes → abre una página → Editar → Agregar widget (/reportes/paginas).

Recorrido por el editor

El editor se abre como ventana: Nuevo widget o Editar widget. A la izquierda se configura, de arriba abajo; a la derecha está la Vista previa · con los filtros de la página.

Sección	Para qué sirve
Datos	Selector Fuente de datos. Debajo sale la descripción de la fuente. Ver Fuentes de datos.
Visualización	Ocho botones: Indicador, Barras, Barras apiladas, Líneas, Área, Dona, Tabla, Tabla dinámica.
Título	Texto del encabezado del widget (hasta 150 caracteres). Si lo dejas vacío se usa el título sugerido que se ve en gris, por ejemplo «Tickets por agente asignado».
Qué se mide (Indicador) / Medidas (los demás)	Una o varias medidas. En una tabla sin agrupar, esta sección se cambia por Columnas.
Agrupar por / Filas y columnas (Tabla dinámica)	El campo por el que se agrupa, su granularidad si es fecha, y la serie. No aparece en Indicador.
Filtros	Condiciones que deben cumplir los registros. «Solo cuentan los registros que cumplen todas.»
Formato	Indicador: comparación y meta. Los demás: orden, cuántos mostrar y «Otros».
Pie de la ventana	Cancelar y Agregar a la página (widget nuevo) o Guardar cambios. El botón se activa cuando la configuración es válida y la vista previa no marca error.

Lo que el servidor rechaza (un campo que no se puede sumar, una combinación inválida) se explica dentro de la vista previa, en texto ámbar, antes de guardar.

Abre la página y clic en Editar.
Clic en Agregar widget (o en Agregar el primero si la página está vacía).
En Datos, elige la Fuente de datos.
En Visualización, elige el tipo. El editor propone una configuración de partida que ya muestra algo (por ejemplo, Líneas agrupa por la fecha de la fuente, por día).
Configura Qué se mide / Medidas (sección Medidas).
Si no es Indicador, elige Agrupar por y, si aplica, la serie.
Agrega Filtros si los necesitas.
Ajusta Formato.
Escribe un Título o deja el sugerido.
Revisa la vista previa y clic en Agregar a la página.

El widget entra en el primer hueco libre de la rejilla, con el tamaño de partida de su tipo. Clic en Listo para salir del modo de edición.

Si cambias de fuente, la configuración vuelve a una propuesta para la fuente nueva (los filtros no se conservan, porque los campos son otros). Si cambias de visualización con la misma fuente, se conservan las medidas y los filtros que sigan aplicando.

Abre la página y clic en Editar.
En el encabezado del widget:
- Lápiz (Editar widget): abre el editor con su configuración. Clic en Guardar cambios.
- Copiar (Duplicar widget): crea «<título> (copia)» del mismo tamaño en el primer hueco.
- Basura (Quitar widget): pide confirmar «¿Quitar el widget «…»?» → Quitar.

Visualización	Clave	Para qué	Qué exige	Tamaño de partida (columnas × filas)
Indicador	`kpi`	Un número grande, con comparación contra el periodo anterior.	Exactamente una medida, sin agrupar y sin serie.	3 × 2
Barras	`barras`	Comparar categorías.	Agrupar por y al menos una medida (hasta 6). Con serie, una sola medida.	6 × 4
Barras apiladas	`barras_apiladas`	Cada barra partida por una serie.	Agrupar por, una medida y una serie (sin serie se ve como Barras).	6 × 4
Líneas	`lineas`	Tendencia en el tiempo.	Agrupar por (normalmente una fecha) y al menos una medida. Con serie, una sola medida.	6 × 4
Área	`area`	Tendencia con volumen.	Igual que Líneas.	6 × 4
Dona	`dona`	Cómo se reparte un total.	Agrupar por y exactamente una medida, sin serie.	4 × 4
Tabla	`tabla`	Registros uno por uno, o un resumen agrupado.	Sin agrupar: al menos una columna. Agrupada: al menos una medida (hasta 6).	12 × 5
Tabla dinámica	`pivote`	Filas × columnas con totales.	Agrupar por (filas), Columnas (la serie) y exactamente una medida.	12 × 5

Medidas

Cada medida tiene un Cálculo y, según el cálculo, un Campo o un Nombre (opcional). Clic en Otra medida para agregar más (hasta 6; solo 1 en Indicador, Dona, Tabla dinámica o cuando hay serie). El botón de basura (Quitar medida) quita una medida si hay más de una.

Cálculo (en pantalla)	Clave	Qué campo pide	Qué devuelve
Contar registros	`conteo`	Ninguno. Puedes darle un Nombre (opcional).	Número de registros.
Sumar	`suma`	Un campo sumable (número, dinero o minutos).	La suma. Sin registros da 0.
Promedio	`promedio`	Un campo sumable.	El promedio de los registros con valor.
Mínimo	`min`	Un campo sumable.	El valor más bajo.
Máximo	`max`	Un campo sumable.	El valor más alto.
Contar distintos	`distintos`	Cualquier campo.	Cuántos valores diferentes hay (sin contar vacíos). Por ejemplo, clientes distintos.
% de «sí»	`porcentaje`	Un campo sí/no.	Registros en «sí» entre los que tienen sí o no, en %. Los vacíos no cuentan.
% que cumple…	`cumplen`	Ninguno; exige al menos una condición. Puedes darle un Nombre (opcional).	Registros que cumplen las condiciones de la medida entre todos los registros, en %.

El selector Campo solo ofrece los campos válidos para el cálculo elegido.
Los minutos se muestran como «3 h 20 min»; el dinero, en pesos (MXN); los porcentajes con «%».
Solo Contar registros y % que cumple… tienen nombre editable. Las demás toman el nombre del campo: Sumar usa la etiqueta del campo; Promedio agrega «(promedio)»; Mínimo, «(mínimo)»; Máximo, «(máximo)»; Contar distintos, «(distintos)»; % de «sí» antepone «%». Contar registros sin nombre se llama «Total de » o « (con condición)».

Condiciones de una medida («Solo contar si…»)

Cada medida puede llevar hasta 5 condiciones propias. Solo afectan a esa medida: las demás medidas del mismo widget siguen contando todo. Así pones en una tabla «Tickets» junto a «Tickets abiertos» y «Tickets en pausa».

En la medida, clic en + Solo contar si….
Clic en Agregar condición y llena campo, condición y valor (igual que en Filtros).

Con Contar registros, Sumar, Promedio, etc., la medida solo usa los registros que cumplen.
Con % que cumple… la sección se llama «Cumple si… (p. ej. la meta: tiempo neto hasta 72 horas)» y al elegir el cálculo se agrega sola una primera condición (sobre un campo de minutos con «hasta / menor o igual», si la fuente tiene uno).

Agrupar por, granularidad y serie

Control	Qué hace
Agrupar por	Una categoría por cada valor del campo (por ejemplo, una barra por agente). Solo ofrece campos agrupables. En Tabla tiene la opción — Sin agrupar (registros) —.
Granularidad	Aparece si agrupas por una fecha: Por día, Por semana, Por mes, Por año. Por omisión, por día.
Separar por (serie) (en Tabla dinámica: Columnas)	Parte cada categoría por otro campo: una serie de barras, una línea o una columna por cada valor. Opción — Sin serie — (no existe en Tabla dinámica). Aparece en Barras, Barras apiladas, Líneas, Área y Tabla dinámica.
Granularidad de la serie	Aparece si la serie es una fecha. Por omisión, por mes.

Las fechas se agrupan en hora local. La semana empieza en lunes. Las etiquetas salen como «17 oct» (día), «sem. 12 oct» (semana), «oct 2026» (mes) y «2026» (año).
Agrupado por fecha, el eje va siempre en orden cronológico, no se recorta con «Mostrar los primeros» y, si el periodo tiene inicio y fin, incluye los días (o semanas, meses) en cero.
Los registros sin valor se agrupan en Sin dato. Los campos sí/no se agrupan en Sí y No.
Una gráfica muestra hasta 8 series: las 7 más grandes y el resto junto en Otros (si la medida es contar o sumar; si no, solo las 7).
La Tabla dinámica muestra hasta 30 columnas (las de mayor valor; si son fechas, las 30 más recientes en orden) y una columna y una fila Total.

Filtros y operadores

Los Filtros del widget dejan fuera los registros que no cumplen. Hay que cumplir todos (son «y», no «o»). Hasta 20 filtros por widget.

En Filtros, clic en Agregar filtro.
Elige el Campo.
Elige la Condición (el operador).
Escribe o elige el valor.
Para quitar uno, clic en la basura (Quitar condición).

Operadores por tipo de campo:

Tipo de campo	Operadores en pantalla
Texto	es, no es, es alguno de, no es ninguno de, contiene, está vacío, tiene valor
Estado (lista cerrada)	es, no es, es alguno de, no es ninguno de, está vacío, tiene valor
Número	es, no es, mayor que, desde / mayor o igual, menor que, hasta / menor o igual, entre, es alguno de, está vacío, tiene valor
Dinero y minutos	es, no es, mayor que, desde / mayor o igual, menor que, hasta / menor o igual, entre, está vacío, tiene valor
Fecha y fecha-hora	desde / mayor o igual, hasta / menor o igual, entre, está vacío, tiene valor
Sí/no	es sí, es no, está vacío, tiene valor

Cómo se captura el valor:

Campos con valores fijos (estados, prioridad, canal…): un selector — elegir —; con es alguno de o no es ninguno de, píldoras para marcar varios.
Texto sin valores fijos con es alguno de: escribe los valores separados por comas.
Minutos: se escriben en horas («72» = 72 horas) y se guardan en minutos.
Fechas: selector de fecha. hasta / menor o igual y el segundo extremo de entre incluyen el día completo.
entre: dos valores, Desde y Hasta; puedes dejar uno vacío.
es y no es comparan el texto exacto, con mayúsculas y acentos, tal como se ve en la fuente (por ejemplo, «Sin asignar»). contiene no distingue mayúsculas.
Un filtro sin valor se marca en ámbar con «Falta el valor: esta condición no se aplica ni se guarda hasta que la completes.» y el pie dice cuántas condiciones sin valor no se guardarán.
Un campo sí/no puede estar vacío: por ejemplo, SLA cumplido de un ticket abierto que aún está en plazo. es no no incluye los vacíos.

Columnas de una tabla de registros

Con Tabla y — Sin agrupar (registros) —, la sección de medidas se cambia por Columnas: «Elige qué se ve de cada registro, en orden.».

Clic en cada campo para agregarlo o quitarlo. Se muestran en el orden en que los marcas (hasta 30).
En Formato, elige Orden (Más recientes primero o Más antiguos primero, por la fecha del periodo de la fuente) y Máximo de filas (por omisión 50).

La tabla trae una fila de totales con la suma de las columnas sumables. El enlace Mejor: agrupar y resumir cambia la tabla a agrupada, contando registros por el primer campo agrupable.

Formato

Control	Dónde aparece	Qué hace
Comparar contra el periodo anterior	Indicador	Calcula la misma medida en el periodo anterior de igual duración y muestra «+N %» y «vs. periodo anterior (valor)». No aplica con Todo el historial. La flecha es neutra: subir no es bueno ni malo por sí mismo.
Meta (opcional)	Indicador	Dibuja una barra de avance «N % de la meta (…)». Se escribe en la unidad del valor: en %, «95»; en pesos, el importe; en minutos, en minutos (no en horas).
Ordenar	Gráficas y tablas agrupadas por un campo que no es fecha	Mayor a menor, Menor a mayor (por el valor de la primera medida), A → Z, Z → A (por el nombre).
Mostrar los primeros	Igual que Ordenar	Cuántas categorías se muestran (1 a 1000; por omisión 20).
Juntar el resto en «Otros»	Igual que Ordenar	Junta las categorías que no caben en una barra o fila Otros. Solo funciona si la primera medida es Contar registros o Sumar; con promedios o porcentajes, el resto simplemente no se muestra.
Orden y Máximo de filas	Tabla de registros	Ver Columnas de una tabla de registros.

Cómo acomodar los widgets en la rejilla

La página es una rejilla de 12 columnas; cada fila mide 80 píxeles. Un widget mide de 1 a 12 columnas de ancho y de 1 a 12 filas de alto.

Abre la página y clic en Editar.
Para mover, arrastra el widget desde su título.
Para cambiar el tamaño, arrastra la esquina inferior derecha («Arrastra para cambiar el tamaño»).
Con teclado: enfoca el título y usa las flechas para mover una celda; Mayús + flechas cambian el tamaño.
Al soltar se guarda solo. Clic en Listo al terminar.

Si sueltas un widget encima de otro, el que estorba baja lo justo y después todo sube hasta tocar al de arriba: no quedan huecos ni widgets encimados. En pantallas de menos de 640 píxeles los widgets se apilan en una columna, en el orden de la rejilla.

Lo que ves	Significa
«Sin datos en el periodo.»	La consulta funcionó y no hay registros que cumplan.
«Tu rol no tiene acceso a estos datos.» con candado	La fuente o algún campo del widget no es para tu rol.
Mensaje en ámbar	La configuración quedó inválida (por ejemplo, se borró un campo personalizado). Edita el widget.
«No se pudo cargar. Reintenta en un momento.» con Reintentar	Falló la consulta.
Triángulo ámbar junto al título	«La fuente superó el tope de filas: el resultado está recortado.» (más de 50,000 registros en el periodo) o «Algún filtro de la página no aplica a esta fuente.». Pasa el cursor para leerlo.

Reglas que conviene conocer

La vista previa y la página usan el periodo y los filtros de la barra de la página.
Cada fuente entrega a lo más 50,000 registros por periodo. Si se pasa, acorta el periodo o agrega filtros.
El orden de cálculo es: periodo de la página → filtros globales (agente, área, organización) → Filtros del widget → agrupación → medidas (con sus condiciones) → orden y límite.
Una página admite hasta 40 widgets.

Errores frecuentes

Mensajes que salen en la vista previa o al guardar:

«Un indicador lleva una sola medida y sin agrupar»: quita medidas o la agrupación.
«La gráfica necesita una dimensión y al menos una medida»: elige Agrupar por.
«La dona lleva una medida y sin serie»: deja una sola medida.
«Con serie se usa una sola medida»: quita la serie o las medidas extra.
«La tabla dinámica necesita filas, columnas y una medida»: elige Agrupar por y Columnas.
«Elige columnas o agrupa por una dimensión»: marca al menos una columna.
«Una tabla agrupada necesita al menos una medida»: agrega una medida.
«Esta medida necesita un campo»: elige el Campo de la medida.
««…» no se puede sumar ni promediar»: ese campo no es numérico; usa Contar distintos o agrúpalo.
««…» no es sí/no: no se puede sacar porcentaje»: % de «sí» solo va con campos sí/no.
««% que cumple» necesita al menos una condición»: agrega una condición con valor.
«No se puede agrupar por «…»»: el campo no es agrupable (por ejemplo, un folio).
«La granularidad solo aplica a una dimensión de fecha» / «La granularidad de la serie solo aplica a una serie de fecha».
«El campo «…» no existe en «…»»: el widget usa un campo que ya no existe (por ejemplo, un campo personalizado desactivado).
«Tu rol no tiene acceso a estos datos»: la fuente o el campo es de un rol que no tienes.

Preguntas frecuentes

¿Puedo filtrar «esto o aquello»?

Sí, dentro de un mismo campo: usa es alguno de. Entre campos distintos, los filtros siempre se combinan con «y».

¿Cómo pongo una meta de 72 horas en un indicador?

Para el % que cumple la meta, usa % que cumple… con la condición «Tiempo… hasta / menor o igual 72» (en horas). El campo Meta (opcional) es otra cosa: la barra de avance del número.

¿Por qué al agrupar por fecha no aparece «Mostrar los primeros»?

El tiempo se muestra completo y en orden; no se recorta.