Ejemplos de widgets

Recetas de widgets listas para copiar en una página de reportes. Cada una dice la fuente, la visualización, las medidas, la agrupación y los filtros con los nombres exactos del editor, y la configuración que se guarda. Las arma un administrador o gerente; el detalle de cada control está en Diseñador de widgets y el de cada campo en Fuentes de datos.

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

En los bloques de configuración, los minutos van en minutos (así se guardan); en el editor se capturan en horas.

Cómo usar una receta

Abre la página y clic en Editar → Agregar widget.
Elige la Fuente de datos y la Visualización de la receta.
Ajusta Medidas, Agrupar por, Filtros y Formato como dice la tabla.
Escribe el Título y clic en Agregar a la página.

Refacciones por entregar por técnico

Cuántas piezas le faltan por recibir a cada técnico.

Sección	Valor
Fuente de datos	Refacciones
Visualización	Barras
Medidas	Sumar → Por entregar
Agrupar por	Técnico
Filtros	Por surtir → es sí
Formato	Mayor a menor, Mostrar los primeros 15
Periodo sugerido	Todo el historial o Últimos 90 días (la fecha es la de la solicitud).

{"fuente": "refacciones", "medidas": [{"agregado": "suma", "campo": "por_entregar"}],
 "dimension": "tecnico", "condiciones": [{"campo": "por_surtir", "op": "verdadero"}],
 "orden": {"por": "valor", "dir": "desc"}, "limite": 15}

Variante en tabla con detalle: Tabla, — Sin agrupar (registros) —, Columnas Refacción, Técnico, Organización, Ticket, Urgente, Por entregar, Solicitada, con el mismo filtro y Orden Más antiguos primero.

Servicios (visitas) por cliente

Visitas hechas a cada cliente y tiempo dedicado.

Sección	Valor
Fuente de datos	Visitas en sitio
Visualización	Tabla
Medidas	1) Contar registros, nombre «Visitas»; 2) Sumar → Tiempo en sitio; 3) Promedio → Tiempo en sitio (sale como «Tiempo en sitio (promedio)»)
Agrupar por	Organización (o Cliente para ver por persona)
Formato	Mayor a menor, Mostrar los primeros 100

{"fuente": "visitas", "dimension": "organizacion", "limite": 100,
 "medidas": [{"agregado": "conteo", "etiqueta": "Visitas"},
             {"agregado": "suma", "campo": "en_sitio_min"},
             {"agregado": "promedio", "campo": "en_sitio_min"}]}

Para contar tickets distintos atendidos, agrega Contar distintos → Ticket.

Tickets abiertos por agente

Sección	Valor
Fuente de datos	Tickets
Visualización	Barras apiladas
Medidas	Contar registros
Agrupar por	Agente asignado
Separar por (serie)	Estado
Filtros	Abierto → es sí
Formato	Mayor a menor, Mostrar los primeros 12
Periodo sugerido	Todo el historial (la fecha es la de creación; con 30 días dejarías fuera abiertos viejos).

{"fuente": "tickets", "medidas": [{"agregado": "conteo"}], "dimension": "agente",
 "serie": "estado", "condiciones": [{"campo": "abierto", "op": "verdadero"}], "limite": 12}

Para ver solo la carga real, agrega el filtro Agente asignado → no es → «Sin asignar».

Cumplimiento de SLA por mes

Sección	Valor
Fuente de datos	Tickets
Visualización	Líneas
Medidas	% de «sí» → SLA cumplido
Agrupar por	Creado, Por mes
Periodo sugerido	Este año o Año anterior

{"fuente": "tickets", "medidas": [{"agregado": "porcentaje", "campo": "sla_cumplido"}],
 "dimension": "creado", "granularidad": "mes"}

El % solo cuenta los tickets con SLA ya definido como cumplido o no; los que siguen abiertos en plazo o no tienen SLA no entran. Para el mismo dato en un solo número, usa Indicador con la misma medida y Comparar contra el periodo anterior.

Horas registradas por proyecto

Sección	Valor
Fuente de datos	Horas registradas (solo gestión)
Visualización	Barras
Medidas	Sumar → Tiempo
Agrupar por	Proyecto
Filtros	Proyecto → tiene valor
Formato	Mayor a menor, Mostrar los primeros 15, Juntar el resto en «Otros»

{"fuente": "worklogs", "medidas": [{"agregado": "suma", "campo": "minutos"}],
 "dimension": "proyecto", "condiciones": [{"campo": "proyecto", "op": "novacio"}],
 "limite": 15, "agrupar_otros": true}

Para el costo, cambia la medida a Sumar → Costo (solo lo ven administrador y gerente). Para separar facturable de no facturable, pon Separar por (serie) → Facturable. Pon la página en Quién la ve → Administradores, gerentes y… → Supervisores: los agentes no pueden usar esta fuente.

Costo de campo por técnico

Sección	Valor
Fuente de datos	Jornadas y costos de campo
Visualización	Tabla
Medidas	Sumar → Costo total; Sumar → Costo horas ordinarias; Sumar → Costo horas extra; Sumar → Costo de kilometraje; Sumar → Gastos y viáticos
Agrupar por	Técnico
Formato	Mayor a menor, Mostrar los primeros 50
Periodo sugerido	Mes anterior (la fuente cubre a lo más 93 días).

{"fuente": "jornadas", "dimension": "agente", "limite": 50,
 "medidas": [{"agregado": "suma", "campo": "total"},
             {"agregado": "suma", "campo": "costo_ordinario"},
             {"agregado": "suma", "campo": "costo_extra"},
             {"agregado": "suma", "campo": "costo_km"},
             {"agregado": "suma", "campo": "gastos"}]}

Los costos son solo de administrador y gerente: deja la página en Administradores, gerentes y… sin casillas. Para el costo por cliente, usa Visitas en sitio → Sumar → Costo del tiempo en sitio agrupado por Organización.

Porcentaje de tickets dentro de la meta de 72 horas

Sección	Valor
Fuente de datos	Tickets
Visualización	Indicador
Qué se mide	% que cumple…, nombre «% dentro»; Cumple si… → Tiempo abierto (neto de pausas) → hasta / menor o igual → 72 (horas)
Formato	Comparar contra el periodo anterior; Meta (opcional) 90

{"fuente": "tickets", "comparar": true, "meta": 90,
 "medidas": [{"agregado": "cumplen", "etiqueta": "% dentro",
   "condiciones": [{"campo": "antiguedad_neta_min", "op": "lte", "valor": 4320}]}]}

Para verlo por agente, cambia a Tabla, Agrupar por Agente asignado y agrega Contar registros con nombre «Tickets» como primera medida.

Refacciones instaladas en el periodo

Sección	Valor
Fuente de datos	Movimientos de refacciones
Visualización	Indicador
Qué se mide	Sumar → Cantidad
Filtros	Movimiento → es → «Instalación»
Formato	Comparar contra el periodo anterior
Periodo sugerido	Este mes

{"fuente": "refaccion_movimientos", "medidas": [{"agregado": "suma", "campo": "cantidad"}],
 "condiciones": [{"campo": "tipo", "op": "eq", "valor": "Instalación"}], "comparar": true}

Para devoluciones por motivo: Dona, Sumar → Cantidad, Agrupar por Motivo de devolución, filtro Movimiento es «Devolución».

Tickets por agente y mes (tabla dinámica)

Sección	Valor
Fuente de datos	Tickets
Visualización	Tabla dinámica
Medidas	Contar registros
Agrupar por (filas)	Agente asignado
Columnas	Creado, Granularidad de la serie Por mes
Periodo sugerido	Este año

{"fuente": "tickets", "medidas": [{"agregado": "conteo"}], "dimension": "agente",
 "serie": "creado", "granularidad_serie": "mes"}

Garantías por vencer en 90 días

Sección	Valor
Fuente de datos	Equipos
Visualización	Tabla, — Sin agrupar (registros) —
Columnas	Equipo, Modelo, Serie, Organización, Garantía hasta, Días de garantía restantes
Filtros	Días de garantía restantes → entre → 0 y 90
Formato	Máximo de filas 200

{"fuente": "equipos", "columnas": ["equipo", "modelo", "serie", "organizacion",
 "garantia_hasta", "dias_garantia"],
 "condiciones": [{"campo": "dias_garantia", "op": "entre", "valor": [0, 90]}], "limite": 200}

El periodo de la página no filtra los equipos, así que esta tabla sale igual con cualquier periodo.

Tickets abiertos con SLA vencido

Sección	Valor
Fuente de datos	Tickets
Visualización	Tabla, — Sin agrupar (registros) —
Columnas	Folio, Título, Agente asignado, Prioridad, Creado
Filtros	SLA vencido (abierto) → es sí
Formato	Orden Más antiguos primero, Máximo de filas 100

{"fuente": "tickets", "columnas": ["folio", "titulo", "agente", "prioridad", "creado"],
 "condiciones": [{"campo": "sla_vencido", "op": "verdadero"}],
 "orden": {"por": "valor", "dir": "asc"}, "limite": 100}

Llamadas por resultado

Sección	Valor
Fuente de datos	Llamadas del conmutador
Visualización	Dona
Medidas	Contar registros
Agrupar por	Resultado
Filtros	Dirección → es → «Entrante»

{"fuente": "llamadas", "medidas": [{"agregado": "conteo"}], "dimension": "estado",
 "condiciones": [{"campo": "direccion", "op": "eq", "valor": "Entrante"}]}

Reglas que conviene conocer

Los valores de los filtros es / no es van exactamente como los entrega la fuente («Instalación», «Sin asignar», «Entrante»). En campos con valores fijos, elígelos del selector.
Si la página la verán supervisores o agentes, no uses fuentes ni campos que su rol no puede ver: el widget les dirá «Tu rol no tiene acceso a estos datos.».
Para tablas grandes, la exportación a Excel de la página trae una hoja por widget.

Preguntas frecuentes

¿Puedo renombrar «Tiempo en sitio (promedio)»?

No desde el editor: solo Contar registros y % que cumple… tienen nombre editable. Usa el Título del widget para aclarar.

¿Por qué mi gráfica de SLA por mes tiene meses sin valor?

Agrupado por fecha, el eje muestra todo el periodo, también los meses sin tickets. En esos meses un porcentaje no tiene base y queda vacío; un conteo o una suma sale en cero.