--- title: "Matrice delle competenze" slug: "skill-matrix" updated: 2026-10-22T17:13:01Z published: 2026-10-22T17:13:01Z 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 delle competenze :::(Info)To download, visit: [Library](https://library.tulip.co/apps/skill-matrix). ::: ## Che cos’è il widget Skill Matrix? **Il widget Skill Matrix** consente di visualizzare, filtrare e gestire le competenze degli utenti e i livelli di competenza nelle attività in una tabella a 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) ### È possibile utilizzare questo widget per: - Monitorare le competenze degli operatori e individuare le lacune - Visualizzare le competenze per utente, gruppo, attività o livello - Filtrare dinamicamente i dati relativi alle competenze - Interagire con le celle della matrice per visualizzare record dettagliati o attivare azioni Questa guida spiega come configurare e utilizzare il widget "Matrice delle competenze" in **Tulip**. --- ## Prerequisiti Prima di iniziare, assicurati di disporre di: - Accesso al proprio **account Tulip** - Autorizzazione a **visualizzare gli account di servizio** e a **gestire le tabelle** - **L'URL del** proprio **account Tulip** e **l'ID dell'area di lavoro** --- ## 1. Configurazione dei parametri obbligatori ### 1.1 Ottieni il tuo account di servizio Feature rename Prior to r383, Service Accounts were called "API Tokens". 1. Fai clic **sull'icona utente** in alto a destra in Tulip. 2. Vai su **Impostazioni account**. 3. Fai clic su **API di Tulip** nel menu a sinistra. 4. Fai clic su " **Crea account di servizio**". 5. Assegna un nome al tuo account di servizio (ad es. `SkillMatrixWidget`). 6. Assegna i seguenti ambiti: 7. `table-queries:read` 8. `tables:read` 9. `tabelle:scrittura` 10. `users:read` 11. Fare clic su **Crea**. 12. Copia **l'intestazione di autenticazione**, ma **rimuovi** la parola " `Basic` " e lo spazio che la segue. 13. Durante la configurazione del widget: se ti viene chiesto di scegliere tra **"Variabile"** e **"Valore statico** " per **l’account di servizio**, seleziona **"Valore statico** " e incolla le tue credenziali **(senza "Basic")** direttamente nel campo. Caution Never share your Service Account credentials publicly. --- ### 1.2 Trova l’URL del tuo account Tulip L’URL del tuo account di solito ha questo formato: `il-tuo-account.tulip.co` --- ### 1.3 Individua l’ID della tua tabella delle attività 1. Vai alla sezione **"Tabelle** " in Tulip. 2. Fai clic sulla **tabella delle attività** pertinente. 3. Copia **l'UID della tabella** dalla sezione dei dettagli. --- ### 1.4 Identifica gli ID dei campi Individua gli **ID dei campi** relativi a: - L'utente (ad es., nome o ID utente) - Il nome della competenza/attività - Il livello di competenza Per trovare l'ID di un campo: 1. Apri la tabella. 2. Fare clic sull'intestazione della colonna. 3. Visualizza **l'ID del campo** nel pannello delle proprietà. 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. Configurare i parametri opzionali È possibile personalizzare ulteriormente il widget utilizzando i seguenti parametri opzionali: - **ID campo di gruppo**: organizza i dati per team, reparto, ecc. - **Stato del progetto**: filtra in base allo stato (ad es. Attivo, Completato). - **Colori dei livelli**: assegna colori personalizzati ai diversi livelli di competenza. --- ### 2.1 Filtri È possibile aggiungere filtri opzionali per personalizzare quali dati vengono visualizzati nella matrice. | Filtro | Descrizione | | --- | --- | | **Titolo** | Per impostazione predefinita, il filtro **"Titolo** " si riferisce in genere al campo relativo al gruppo, al nome della competenza o alla categoria dell'attività. | | **Visibile** | Controlla la visibilità di un record. Il valore predefinito è `true`. | Nota I filtri sono opzionali e dovrebbero riflettere il proprio caso d'uso. È possibile configurare i filtri per diverse fields e disattivare facilmente quelli non necessari dopo la configurazione. Solo i filtri attivi influiranno sui dati. --- ### 2.2 Configurazione avanzata #### Filtri di query API È possibile controllare quali record vengono visualizzati utilizzando query di filtro API personalizzate. 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. **Esempi di query:**`json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}` **Limite API:** limitare il numero di righe caricate. ### 2.3. Impostare l’ID dell’area di lavoro - È possibile trovare **l’ID dell’area di lavoro** nell’URL di Tulip dopo `/w/.` Ad esempio:`https://your-account.tulip.co/w/DEFAULT` → L’ID dell’area di lavoro è `DEFAULT` - Per l’area di lavoro predefinita, utilizzare `DEFAULT` oppure lasciare il campo vuoto. ## 3. Utilizzare il widget "Matrice delle competenze" ### 3.1. Visualizza i dati sulle competenze Una volta configurato, il widget mostra una matrice contenente: - Utenti - Attività o competenze - Livelli di competenza corrispondenti Utilizza i filtri a tendina integrati (Gruppi, Competenze, Livelli) per restringere la visualizzazione. ### 3.2. Aggiorna e filtra - Fare clic su " **Cancella filtri** " per rimuovere tutte le selezioni dei filtri. - Fai clic su " **Aggiorna** " per aggiornare i dati. ### 3.3. Pre-filtro I prefiltri filtrano dinamicamente i dati in base a: - L'utente attualmente connesso - Il team o il reparto selezionato - Intervallo di date o turno Tip Use pre-filters to personalize views for operators or supervisors. ## 4. Aggiungi trigger per azioni interattive È possibile configurare il widget in modo che attivi delle azioni quando un utente fa clic su una cella. 1. Aprire il pannello **Trigger**. 2. Imposta un'azione per **l'ID record** quando si fa clic su una cella. 3. Abilita " **Carica record** " per visualizzare ulteriori dettagli sull'utente o sulla competenza. ## Suggerimenti - Controlla attentamente **gli ID** **della tabella** e **dei campi** per evitare errori di digitazione. - Utilizza i filtri per personalizzare i dashboard in base ai diversi ruoli. - Esegui dei test con dati fittizi prima di passare all’ambiente di produzione. ## Risoluzione dei problemi | Problema | Probabile causa | Soluzione suggerita | | --- | --- | --- | | Matrix non si carica | Credenziali API o URL non validi | Ricontrollare le credenziali/l'URL | | I dati non vengono visualizzati | Filtri troppo restrittivi | Rimuovere o allentare i filtri | | Campi "non definiti" | È stato utilizzato un ID campo errato | Controllare gli ID dei campi della tabella | | Celle non cliccabili | Trigger non configurato | Configurare il trigger nel widget | ## Approfondimenti: [Elenco dei record di un'Tulip Table](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[Come configurare un'API Tulip](https://support.tulip.co/docs/set-up-a-tulip-api)