--- title: "Matrice des compétences" slug: "skill-matrix" status: "new" updated: 2026-10-22T17:12:58Z published: 2026-10-22T17:12:58Z canonical: "support.tulip.co/skill-matrix" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Matrice des compétences :::(Info)To download, visit: [Library](https://library.tulip.co/apps/skill-matrix). ::: ## Qu’est-ce que le widget « Skill Matrix » ? **Le widget « Skill Matrix** » vous permet de visualiser, de filtrer et de gérer les compétences des utilisateurs et leurs niveaux de maîtrise des tâches dans un tableau de type matrice. ![Screenshot 2025-08-08 at 17.32.49.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202025-08-08%20at%2017.32.49.png) ### Vous pouvez utiliser ce widget pour : - Suivre les compétences des opérateurs et identifier les lacunes - Afficher les compétences par utilisateur, groupe, tâche ou niveau - Filtrer dynamiquement les données relatives aux compétences - Interagir avec les cellules de la matrice pour consulter des fiches détaillées ou déclencher des actions Ce guide explique comment configurer et utiliser le widget « Matrice des compétences » dans **Tulip**. --- ## Prérequis Avant de commencer, assurez-vous de disposer des éléments suivants : - L'accès à votre **compte Tulip** - L'autorisation de **consulter les comptes de service** et de **gérer les tableaux** - **L'URL de** votre **compte Tulip** et **l'ID de votre espace de travail** --- ## 1. Configurer les paramètres obligatoires ### 1.1 Obtenir votre compte de service Feature rename Prior to r383, Service Accounts were called "API Tokens". 1. Cliquez sur votre **icône utilisateur** en haut à droite de Tulip. 2. Accédez aux **paramètres du compte**. 3. Cliquez sur « **API Tulip** » dans le menu de gauche. 4. Cliquez sur « **Créer un compte de service** ». 5. Donnez un nom à votre compte de service (par exemple, `SkillMatrixWidget`). 6. Attribuez les champs d'application suivants : 7. `table-queries:read` 8. `tables:read` 9. `tables : écriture` 10. `utilisateurs : lecture` 11. Cliquez sur « **Créer** ». 12. Copiez l'**en-tête d'authentification**, mais **supprimez** le mot « `Basic` » et l'espace qui le suit. 13. Lors de la configuration du widget : si vous êtes invité à choisir entre « **Valeur** **variable** » et **« Valeur statique** » pour le **compte de service**, sélectionnez « **Valeur statique** » et collez vos identifiants **(sans « Basic »)** directement dans le champ. Caution Never share your Service Account credentials publicly. --- ### 1.2 Trouver l'URL de votre compte Tulip L'URL de votre compte se présente généralement sous la forme suivante : `votre-compte.tulip.co` --- ### 1.3 Localisez l’ID de votre table de tâches 1. Accédez à la section « **Tables** » dans Tulip. 2. Cliquez sur la **table de tâches** concernée. 3. Copiez l'identifiant unique ( **UID) de la table** dans la section « Détails ». --- ### 1.4 Identifiez les identifiants des champs Recherchez les **identifiants des champs** pour : - L'utilisateur (par exemple, nom ou identifiant utilisateur) - Le nom de la compétence/tâche - Le niveau de compétence Pour trouver l’identifiant d’un champ : 1. Ouvrez le tableau. 2. Cliquez sur l'en-tête de la colonne. 3. Consultez **l'ID du champ** dans le panneau des propriétés. Tip There are no enforced default names for these fields; you must decide which of your fields will be treated as user/skill/level when configuring the widget. --- ## 2. Configurer les paramètres facultatifs Vous pouvez personnaliser davantage le widget à l'aide des paramètres facultatifs suivants : - **ID de champ de groupe**: organise les données par équipe, service, etc. - **Statut de conception**: filtre par statut (par exemple, Actif, Terminé). - **Couleurs des niveaux**: attribue des couleurs personnalisées aux différents niveaux de compétence. --- ### 2.1 Filtres Vous pouvez ajouter des filtres facultatifs pour personnaliser les données qui s'affichent dans la matrice. | Filtre | Description | | --- | --- | | **Titre** | Par défaut, le filtre « **Titre** » fait généralement référence au nom de votre groupe, de votre compétence ou de la catégorie de votre tâche. | | **Visible** | Contrôle la visibilité d'un enregistrement. La valeur par défaut est « `true` ». | Remarque Les filtres sont facultatifs et doivent correspondre à votre cas d'utilisation. Vous pouvez configurer des filtres pour plusieurs « fields » et désactiver facilement ceux dont vous n’avez pas besoin après la configuration. Seuls les filtres actifs auront une incidence sur vos données. --- ### 2.2 Configuration avancée #### Filtres de requête API Vous pouvez contrôler les enregistrements affichés à l’aide de requêtes de filtrage API personnalisées. Note When you apply multiple filter conditions, they are combined using a logical **AND**. This means **all conditions must be true** for a record to be returned. **Exemples de requêtes :**`json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}` **Limite de l’API :** limitez le nombre de lignes chargées. ### 2.3. Définir l’ID de votre espace de travail - Vous trouverez **l’ID de** votre **espace de travail** dans l’URL de Tulip, après `/w/.` Par exemple :`https://your-account.tulip.co/w/DEFAULT` → L’ID de l’espace de travail est `DEFAULT` - Pour l'espace de travail par défaut, utilisez `DEFAULT` ou laissez le champ vide. ## 3. Utiliser le widget « Skill Matrix » ### 3.1. Afficher les données relatives aux compétences Une fois configuré, le widget affiche une matrice comprenant : - Utilisateurs - Tâches ou compétences - Niveaux de compétences correspondants Utilisez les filtres intégrés dans le menu déroulant (Groupes, Compétences, Niveaux) pour affiner votre affichage. ### 3.2. Actualiser et filtrer - Cliquez sur « **Effacer les filtres** » pour supprimer toutes les sélections de filtres. - Cliquez sur **« Actualiser** » pour mettre à jour les données. ### 3.3. Pré-filtrage Les pré-filtres filtrent dynamiquement les données en fonction : - L'utilisateur actuellement connecté - L'équipe ou le service sélectionné - La période ou le service Tip Use pre-filters to personalize views for operators or supervisors. ## 4. Ajouter des déclencheurs pour des actions interactives Vous pouvez configurer le widget pour qu'il déclenche des actions lorsqu'un utilisateur clique sur une cellule. 1. Ouvrez le panneau « **Déclencheurs** ». 2. Définissez une action pour **l'ID d'enregistrement** lorsqu'un utilisateur clique sur une cellule. 3. Activez « **Charger l'enregistrement** » pour afficher plus de détails sur l'utilisateur ou la compétence. ## Conseils - Vérifiez bien **les ID** de vos **tables** et **champs** pour éviter les fautes de frappe. - Utilisez des filtres pour personnaliser les tableaux de bord en fonction des différents rôles. - Testez avec des données factices avant de passer en production. ## Dépannage | Problème | Cause probable | Solution suggérée | | --- | --- | --- | | La matrice ne se charge pas | Identifiants API ou URL non valides | Vérifiez à nouveau les identifiants/l'URL | | Les données ne s'affichent pas | Filtres trop restrictifs | Supprimez ou assouplissez les filtres | | Champs « non définis » | ID de champ incorrect utilisé | Vérifiez les identifiants des champs du tableau | | Cellules non cliquables | Déclencheur non configuré | Configurer le déclencheur dans le widget | ## Pour en savoir plus : [Lister les enregistrements d'une Tulip Table](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[Comment configurer une API Tulip](https://support.tulip.co/docs/set-up-a-tulip-api)