Matriz de habilidades

:::(Info)To download, visit: Library.
:::

¿Qué es el widget «Skill Matrix»?

El widget «Matriz de habilidades» te permite visualizar, filtrar y gestionar las habilidades de los usuarios y los niveles de competencia en las tareas en una tabla de estilo matricial.

Puedes utilizar este widget para:

• Realizar un seguimiento de las habilidades de los operadores e identificar carencias
• Ver las habilidades por usuario, grupo, tarea o nivel
• Filtrar los datos de habilidades de forma dinámica
• Interactuar con las celdas de la matriz para ver registros detallados o activar acciones

Esta guía explica cómo configurar y utilizar el widget «Matriz de competencias» en Tulip.

Requisitos previos

Antes de empezar, asegúrate de que dispones de:

• Acceso a tu cuenta de Tulip
• Permiso para ver cuentas de servicio y gestionar tablas
• La URL de tu cuenta de Tulip y el ID del espacio de trabajo

1. Configurar los parámetros obligatorios

1.1 Obtén tu cuenta de servicio

1. Haz clic en el icono de usuario situado en la esquina superior derecha de Tulip.
2. Ve a «Configuración de la cuenta».
3. Haz clic en «API de Tulip» en el menú de la izquierda.
4. Haz clic en «Crear cuenta de servicio».
5. Asigna un nombre a tu cuenta de servicio (por ejemplo, SkillMatrixWidget).
6. Asigna los siguientes ámbitos:
7. table-queries:read
8. tables:read
9. tables:write
10. users:read
11. Haz clic en «Crear».
12. Copia el encabezado de autenticación, pero elimina la palabra «Basic» y el espacio que hay después.
13. Al configurar el widget: si se te pide que elijas entre «Valor variable» y «Valor estático» para la cuenta de servicio, selecciona «Valor estático» y pega tus credenciales (sin «Basic») directamente en el campo.

1.2 Busca la URL de tu cuenta de Tulip

La URL de tu cuenta suele tener este formato:
tu-cuenta.tulip.co

1.3 Localiza el ID de tu tabla de tareas

1. Ve a la sección «Tablas» en Tulip.
2. Haz clic en la tabla de tareas correspondiente.
3. Copia el UID de la tabla de la sección de detalles.

1.4 Identifica los ID de los campos

Localiza los ID de los campos correspondientes a:

• El usuario (por ejemplo, nombre o ID de usuario)
• El nombre de la habilidad o tarea
• El nivel de habilidad

Para encontrar el identificador de un campo:

1. Abre la tabla.
2. Haz clic en el encabezado de la columna.
3. Consulta el ID del campo en el panel de propiedades.

2. Configurar parámetros opcionales

Puedes personalizar aún más el widget utilizando los siguientes parámetros opcionales:

• ID de campo de grupo: organiza los datos por equipo, departamento, etc.
• Estado de diseño: filtra por estado (p. ej., Activo, Completado).
• Colores de nivel: asigna colores personalizados a los distintos niveles de habilidad.

2.1 Filtros

Puedes añadir filtros opcionales para personalizar qué datos aparecen en la matriz.

:::(Información) (Nota)
Los filtros son opcionales y deben ajustarse a tu caso de uso.

Puedes configurar filtros para varios « fields » y desactivar fácilmente aquellos que no necesites tras la configuración. Solo los filtros activos afectarán a tus datos.
:::

2.2 Configuración avanzada

Filtros de consulta de la API

Puedes controlar qué registros se muestran utilizando consultas de filtro personalizadas de la API.

Ejemplos de consultas:json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}

Límite de la API: restringe el número de filas cargadas.

2.3. Configurar el ID de tu espacio de trabajo

• Puedes encontrar el ID de tu espacio de trabajo en la URL de Tulip, después de /w/. Por ejemplo:https://your-account.tulip.co/w/DEFAULT → El ID del espacio de trabajo es DEFAULT
• Para el espacio de trabajo predeterminado, utiliza DEFAULT o deja el campo en blanco.

3. Utilizar el widget «Matriz de habilidades»

3.1. Ver datos de competencias

Una vez configurado, el widget muestra una matriz con:

• Usuarios
• Tareas o competencias
• Niveles de competencia correspondientes

Utiliza los filtros desplegables integrados (Grupos, Competencias, Niveles) para acotar la vista.

3.2. Actualizar y filtrar

• Haz clic en «Borrar filtros » para eliminar todas las selecciones de filtro.
• Haz clic en «Actualizar » para actualizar los datos.

3.3. Prefiltro

Los prefiltro filtran los datos de forma dinámica en función de:

• El usuario que ha iniciado sesión actualmente
• El equipo o departamento seleccionado
• El intervalo de fechas o el turno

4. Añadir desencadenantes para acciones interactivas

Puedes configurar el widget para que active acciones cuando un usuario haga clic en una celda.

1. Abre el panel «Desencadenantes ».
2. Establezca una acción para el ID de registro cuando se haga clic en una celda.
3. Activa «Cargar registro » para mostrar más detalles sobre el usuario o la competencia.

Consejos

• Comprueba dos veces los ID de tabla y de campo para evitar errores tipográficos.
• Utiliza filtros para adaptar los paneles a las diferentes funciones.
• Realiza pruebas con datos de prueba antes de ponerlo en producción.

Solución de problemas

Más información:

Listar registros de A Tulip TableCómo configurar una API de Tulip