Matriz de Habilidades

Prev Next

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

O que é o widget Matriz de Habilidades?

O widget Matriz de Habilidades permite visualizar, filtrar e gerenciar as habilidades dos usuários e os níveis de competência nas tarefas em uma tabela no estilo de matriz.

Screenshot 2025-08-08 at 17.32.49.png

Você pode usar este widget para:

  • Acompanhar as habilidades dos operadores e identificar lacunas
  • Visualizar habilidades por usuário, grupo, tarefa ou nível
  • Filtrar dados de habilidades dinamicamente
  • Interagir com as células da matriz para visualizar registros detalhados ou acionar ações

Este guia explica como configurar e usar o widget Matriz de Competências no Tulip.


Pré-requisitos

Antes de começar, certifique-se de ter:

  • Acesso à sua conta do Tulip
  • Permissão para visualizar Contas de Serviço e gerenciar tabelas
  • A URL da sua conta do Tulip e o ID do espaço de trabalho

1. Configure os parâmetros obrigatórios

1.1 Obtenha sua conta de serviço

Feature rename

Prior to r383, Service Accounts were called "API Tokens".

  1. Clique no ícone do usuário no canto superior direito do Tulip.
  2. Acesse “Configurações da conta”.
  3. Clique em API do Tulip no menu à esquerda.
  4. Clique em “Criar conta de serviço”.
  5. Dê um nome à sua conta de serviço (por exemplo, SkillMatrixWidget).
  6. Atribua os seguintes escopos:
  7. table-queries:read
  8. tables:read
  9. tabelas:gravação
  10. users:read
  11. Clique em Criar.
  12. Copie o cabeçalho de autenticação, mas remova a palavra “Basic” e o espaço após ela.
  13. Ao configurar o widget: se for solicitado que você escolha entre “Valor variável” e “Valor estático” para a conta de serviço, selecione “Valor estático” e cole suas credenciais (sem “Basic”) diretamente no campo.
Caution

Never share your Service Account credentials publicly.


1.2 Encontre a URL da sua conta Tulip

A URL da sua conta geralmente tem o seguinte formato:
sua-conta.tulip.co


1.3 Localize o ID da sua tabela de tarefas

  1. Acesse a seção “Tabelas” no Tulip.
  2. Clique na tabela de tarefas relevante.
  3. Copie o UID da tabela na seção de detalhes.

1.4 Identifique os IDs dos campos

Localize os IDs dos campos para:

  • O usuário (por exemplo, nome ou ID do usuário)
  • O nome da habilidade/tarefa
  • O nível de habilidade

Para encontrar o ID de um campo:

  1. Abra a tabela.
  2. Clique no cabeçalho da coluna.
  3. Visualize o ID do campo no painel de propriedades.
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. Configurar parâmetros opcionais

Você pode personalizar ainda mais o widget usando os seguintes parâmetros opcionais:

  • ID do campo de grupo: organiza os dados por equipe, departamento etc.
  • Status do projeto: Filtra por status (por exemplo, Ativo, Concluído).
  • Cores de nível: atribui cores personalizadas a diferentes níveis de habilidade.

2.1 Filtros

Você pode adicionar filtros opcionais para personalizar quais dados aparecem na matriz.

Filtro Descrição
Título Por padrão, o filtro “Título” geralmente se refere ao seu grupo, nome da habilidade ou campo de categoria da tarefa.
Visível Controla a visibilidade de um registro. O padrão é verdadeiro.

:::(Informações) (Observação)
Os filtros são opcionais e devem refletir o seu caso de uso.

Você pode configurar filtros para vários fields e desativar facilmente aqueles que não precisar após a configuração. Apenas os filtros ativos afetarão seus dados.
:::


2.2 Configuração avançada

Filtros de consulta da API

Você pode controlar quais registros são exibidos usando consultas de filtro personalizadas da API.

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.

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

Limite da API: restrinja o número de linhas carregadas.

2.3. Defina o ID do seu Workspace

  • Você pode encontrar o ID do seu Workspace na URL do Tulip após /w/. Por exemplo:https://your-account.tulip.co/w/DEFAULT → O ID do Workspace é DEFAULT
  • Para o espaço de trabalho padrão, use DEFAULT ou deixe o campo em branco.

3. Use o widget Matriz de Competências

3.1. Visualizar dados de competências

Depois de configurado, o widget exibe uma matriz com:

  • Usuários
  • Tarefas ou habilidades
  • Níveis de competência correspondentes

Use os filtros integrados no menu suspenso (Grupos, Competências, Níveis) para refinar sua visualização.

3.2. Atualizar e filtrar

  • Clique em “Limpar filtros” para remover todas as seleções de filtro.
  • Clique em “Atualizar” para atualizar os dados.

3.3. Pré-filtragem

Os pré-filtros filtram os dados dinamicamente com base em:

  • O usuário conectado no momento
  • Equipe ou departamento selecionado
  • Intervalo de datas ou turno
Tip

Use pre-filters to personalize views for operators or supervisors.

4. Adicionar gatilhos para ações interativas

Você pode configurar o widget para acionar ações quando um usuário clicar em uma célula.

  1. Abra o painel “Gatilhos ”.
  2. Defina uma ação para o ID do registro quando uma célula for clicada.
  3. Ative “Carregar registro” para exibir mais detalhes sobre o usuário ou a habilidade.

Dicas

  • Verifique novamente os IDs da tabela e dos campos para evitar erros de digitação.
  • Use filtros para personalizar painéis para diferentes funções.
  • Teste com dados simulados antes de lançar em produção.

Solução de problemas

Problema Causa provável Solução sugerida
A matriz não carrega Credencial de API ou URL inválida Verifique novamente as credenciais/URL
Os dados não aparecem Filtros muito restritivos Remova ou flexibilize os filtros
Campos “indefinidos” ID de campo incorreto utilizado Verifique os IDs dos campos da tabela
Células não clicáveis Gatilho não configurado Configure o gatilho no widget

Leitura complementar:

Listar registros de um Tulip TableComo configurar uma API do Tulip