Матрица навыков

Prev Next

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

Что такое виджет «Матрица навыков»?

Виджет «Матрица навыков» позволяет визуализировать, фильтровать и управлять навыками пользователей и уровнями компетентности по задачам в таблице матричного типа.

Screenshot 2025-08-08 at 17.32.49.png

Вы можете использовать этот виджет для:

  • отслеживать навыки операторов и выявлять пробелы
  • Просмотра навыков по пользователям, группам, задачам или уровням
  • Динамической фильтрации данных о навыках
  • Взаимодействовать с ячейками матрицы для просмотра подробных записей или запуска действий

В данном руководстве объясняется, как настроить и использовать виджет «Матрица навыков» в Tulip.


Необходимые условия

Прежде чем начать, убедитесь, что у вас есть:

  • Доступ к своей учетной записи Tulip
  • Права на просмотр служебных учетных записей и управление таблицами
  • URL вашей учетной записи Tulip и идентификатор рабочей области

1. Настройте обязательные параметры

1.1 Получите свою служебную учетную запись

Feature rename

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

  1. Нажмите на значок пользователя в правом верхнем углу Tulip.
  2. Перейдите в «Настройки учетной записи».
  3. Нажмите «API Tulip » в меню слева.
  4. Нажмите «Создать учетную запись службы».
  5. Назовите свою учетную запись службы (например, SkillMatrixWidget).
  6. Назначьте следующие области доступа:
  7. table-queries:read
  8. tables:read
  9. таблицы:запись
  10. users:read
  11. Нажмите «Создать».
  12. Скопируйте заголовок аутентификации, но удалите слово «Basic» и пробел после него.
  13. При настройке виджета: если появится запрос на выбор между «Переменное» и «Статическое значение» для учетной записи службы, выберите «Статическое значение» и вставьте свои учетные данные (без слова «Basic») непосредственно в поле.
Caution

Never share your Service Account credentials publicly.


1.2 Найдите URL-адрес вашей учетной записи Tulip

URL вашей учетной записи обычно выглядит так:
your-account.tulip.co


1.3 Найдите ID своей таблицы задач

  1. Перейдите в раздел «Таблицы» в Tulip.
  2. Нажмите на соответствующую таблицу задач.
  3. Скопируйте UID таблицы из раздела с подробной информацией.

1.4 Определите идентификаторы полей

Найдите идентификаторы полей для:

  • Пользователя (например, имя или идентификатор пользователя)
  • Название навыка/задачи
  • Уровень квалификации

Чтобы найти идентификатор поля:

  1. Откройте таблицу.
  2. Щелкните заголовок столбца.
  3. Просмотрите идентификатор поля на панели свойств.
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. Настройка дополнительных параметров

Вы можете дополнительно настроить виджет с помощью следующих дополнительных параметров:

  • Идентификатор поля группы: группирует данные по команде, отделу и т. д.
  • Статус проекта: фильтрация по статусу (например, «Активен», «Завершен»).
  • Цвета уровней: назначение пользовательских цветов для разных уровней квалификации.

2.1 Фильтры

Вы можете добавить дополнительные фильтры, чтобы настроить, какие данные будут отображаться в матрице.

Фильтр Описание
Название По умолчанию фильтр «Название » обычно относится к полю «Группа», «Название навыка» или «Категория задачи».
«Видимость» Управляет видимостью записи. По умолчанию установлено значение «true».

:::(Информация) (Примечание)
Фильтры являются опциональными и должны соответствовать вашему сценарию использования.

Вы можете настроить фильтры для нескольких « fields » и легко отключить те из них, которые вам не нужны, после настройки. Только активные фильтры будут влиять на ваши данные.
:::


2.2 Расширенная настройка

Фильтры запросов API

Вы можете контролировать, какие записи отображаются, с помощью настраиваемых запросов-фильтров 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.

Примеры запросов:json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}

Ограничение API: ограничьте количество загружаемых строк.

2.3. Укажите ID вашей рабочей области

  • Идентификатор рабочей области можно найти в URL-адресе Tulip после /w/. Например:https://your-account.tulip.co/w/DEFAULT → Идентификатор рабочей области — DEFAULT
  • Для рабочей области по умолчанию используйте DEFAULT или оставьте поле пустым.

3. Использование виджета «Матрица навыков»

3.1. Просмотр данных о навыках

После настройки виджет отображает матрицу, содержащую:

  • Пользователей
  • Задачи или навыки
  • Соответствующие уровни навыков

Используйте встроенные фильтры в виде раскрывающихся списков («Группы», «Навыки», «Уровни»), чтобы сузить область просмотра.

3.2. Обновить и применить фильтры

  • Нажмите «Очистить фильтры», чтобы сбросить все настройки фильтров.
  • Нажмите «Обновить», чтобы обновить данные.

3.3. Предварительная фильтрация

Предварительные фильтры динамически фильтруют данные на основе:

  • Текущего авторизованного пользователя
  • Выбранной команде или отделе
  • Диапазона дат или смены
Tip

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

4. Добавление триггеров для интерактивных действий

Вы можете настроить виджет так, чтобы он запускал действия при нажатии пользователем на ячейку.

  1. Откройте панель «Триггеры ».
  2. Задайте действие для «Идентификатора записи » при щелчке по ячейке.
  3. Включите параметр «Загрузить запись», чтобы отобразить дополнительные сведения о пользователе или навыке.

Советы

  • Тщательно проверьте идентификаторы таблиц и полей, чтобы избежать опечаток.
  • Используйте фильтры, чтобы адаптировать информационные панели для разных ролей.
  • Перед запуском в производственную среду протестируйте с помощью тестовых данных.

Устранение неполадок

Проблема Вероятная причина Рекомендуемое решение
Матрица не загружается Неверные учетные данные API или URL Проверьте учетные данные/URL
Данные не отображаются Слишком строгие настройки фильтров Удалите или ослабьте фильтры
Поля с «неопределенным» значением Использован неверный идентификатор поля Проверьте идентификаторы полей в таблице
Ячейки недоступны для клика Триггер не настроен Настройте триггер в виджете

Дополнительная информация:

Список записей A Tulip TableКак настроить API Tulip