KPIs Personalizados

¿Qué es y para qué sirve?

Un KPI Personalizado es una tarjeta de indicador que tú mismo defines con una consulta SQL. Esa consulta debe devolver una sola fila con una columna llamada Value: ese es el número que se muestra en la tarjeta. Opcionalmente, la misma consulta puede devolver también las columnas Min, Max, HighSectorValue y LowSectorValue para que el rango y los colores del indicador se calculen dinámicamente en vez de usar los valores fijos que capturaste en el formulario.

Sirve para llevar al Panel de Control cualquier número de tu negocio que quieras monitorear constantemente y que no exista como reporte o gráfica nativa de AdmCloud: por ejemplo, "clientes con más de 30 días de atraso", "margen bruto del mes" o "artículos con stock negativo".

Para ayudarte a construir la consulta sin ser experto en SQL, la pantalla de creación incluye tres herramientas de inteligencia artificial y un diccionario de datos:

• Genera el SQL con AtIna (beta): describe en lenguaje natural lo que necesitas (por ejemplo, "ventas totales del mes agrupadas por cliente") y un agente de IA redacta y valida el SQL por ti; puedes ver el progreso en tiempo real y aceptar o descartar el resultado antes de guardarlo.
• Explicar SQL: si ya tienes una consulta (propia o heredada) y no la entiendes del todo, este botón te da una explicación en español de lo que hace.
• Sugerencias de mejoras de velocidad: analiza tu consulta y te propone cambios para que corra más rápido.
• Diccionario de Datos: lista todas las tablas disponibles de tu empresa con su nombre técnico y su descripción; desde ahí puedes ver los campos de cada tabla y una vista previa de sus datos, sin salir de la pantalla de creación.

Pantallas del área

Cómo crear un KPI paso a paso

1. Abre el listado de KPIs y pulsa Nuevo. Puedes elegir Crear KPI en blanco o partir de una de las muestras ya armadas que aparecen en el mismo menú (por ejemplo, ingresos del mes o margen de ganancia); si eliges una muestra, su SQL se precarga para que la ajustes.
2. Completa el título y el subtítulo que verás en la tarjeta del Panel de Control, y selecciona el módulo al que pertenece el indicador.
3. Define la consulta SQL en la pestaña correspondiente. Debe devolver una sola fila con la columna Value. Apóyate en el Diccionario de Datos para ubicar las tablas y campos que necesitas, o usa Genera el SQL con AtIna para que la IA la redacte por ti a partir de una descripción en lenguaje natural. Usa el botón Preview para comprobar que la consulta corre y devuelve el resultado esperado.
4. Configura el rango y los colores del indicador con los campos Mínimo, Máximo, Límite Inferior y Límite Superior (los valores por debajo del límite inferior se muestran en rojo y los que superan el límite superior se muestran en verde), o deja que estas columnas las calcule tu propia consulta SQL. Si para este KPI un valor bajo es la meta deseada, marca Reversar Metas para invertir esa lógica de colores.
5. Marca Disponible en Panel de Control si quieres que la tarjeta aparezca en tu Panel de Control, y decide si el KPI será Público (visible para toda la empresa) o restringido a ciertos grupos de usuarios.
6. Si solo tú debes poder editar su estructura, marca la opción que restringe el acceso de edición al propietario.
7. Si el KPI no es público, ve a la pestaña de Permisos y agrega los grupos de usuarios que podrán verlo.
8. Guarda. El sistema valida los datos y el KPI queda disponible en el listado y, si lo marcaste, en tu Panel de Control.

Campos clave

Validaciones al guardar

• Nombre requerido y único: no puede repetirse con el de otro KPI o reporte personalizado de tu empresa.
• SQL requerido y sin comandos prohibidos (como instrucciones que modifiquen o borren datos); solo se permiten consultas de lectura.
• Propietario requerido y debe ser un usuario activo, no anulado.
• Módulo requerido.
• Mínimo no puede ser mayor que el Máximo.
• Un KPI público no puede tener grupos de usuarios asignados: si lo marcas como público, primero quita los grupos de la pestaña de Permisos.
• Si el KPI está protegido (solo propietario), solo el propietario puede guardar sus cambios; otro usuario recibirá un error al intentar editarlo o eliminarlo.

Gestión del KPI

Desde el detalle de un KPI ya guardado puedes, según tus permisos:

• Editarlo, para ajustar su SQL, su rango, sus colores o sus permisos.
• Duplicarlo para crear una variante a partir de su configuración actual.
• Eliminarlo, siempre que no esté siendo usado como fuente de datos por un Plugin de tu empresa; si lo está, primero debes desvincularlo del Plugin.
• Consultar su bitácora de cambios, con quién y cuándo lo creó, editó o eliminó.

Disponibilidad y permisos

• El acceso se controla con el permiso "Personalización" del grupo de usuarios, con niveles separados para consultar, agregar y editar.
• Disponible en el plan Enterprise. Si tu empresa no tiene el plan Enterprise pero necesita esta función, puede solicitar a soporte de AdmCloud que la habilite específicamente para tu cuenta.
• Un KPI marcado como Solo el propietario puede editar solo puede ser modificado o eliminado por quien lo creó, aunque otros usuarios con permiso puedan verlo si es público o pertenece a su grupo.

Consejos y errores comunes