:::(Info)To download, visit: Library.
:::
Что такое виджет «Матрица навыков»?
Виджет «Матрица навыков» позволяет визуализировать, фильтровать и управлять навыками пользователей и уровнями компетентности по задачам в таблице матричного типа.

Вы можете использовать этот виджет для:
- отслеживать навыки операторов и выявлять пробелы
- Просмотра навыков по пользователям, группам, задачам или уровням
- Динамической фильтрации данных о навыках
- Взаимодействовать с ячейками матрицы для просмотра подробных записей или запуска действий
В данном руководстве объясняется, как настроить и использовать виджет «Матрица навыков» в Tulip.
Необходимые условия
Прежде чем начать, убедитесь, что у вас есть:
- Доступ к своей учетной записи Tulip
- Права на просмотр служебных учетных записей и управление таблицами
- URL вашей учетной записи Tulip и идентификатор рабочей области
1. Настройте обязательные параметры
1.1 Получите свою служебную учетную запись
Prior to r383, Service Accounts were called "API Tokens".
- Нажмите на значок пользователя в правом верхнем углу Tulip.
- Перейдите в «Настройки учетной записи».
- Нажмите «API Tulip » в меню слева.
- Нажмите «Создать учетную запись службы».
- Назовите свою учетную запись службы (например,
SkillMatrixWidget). - Назначьте следующие области доступа:
table-queries:readtables:readтаблицы:записьusers:read- Нажмите «Создать».
- Скопируйте заголовок аутентификации, но удалите слово
«Basic»и пробел после него. - При настройке виджета: если появится запрос на выбор между «Переменное» и «Статическое значение» для учетной записи службы, выберите «Статическое значение» и вставьте свои учетные данные (без слова «Basic») непосредственно в поле.
Never share your Service Account credentials publicly.
1.2 Найдите URL-адрес вашей учетной записи Tulip
URL вашей учетной записи обычно выглядит так:
your-account.tulip.co
1.3 Найдите ID своей таблицы задач
- Перейдите в раздел «Таблицы» в Tulip.
- Нажмите на соответствующую таблицу задач.
- Скопируйте UID таблицы из раздела с подробной информацией.
1.4 Определите идентификаторы полей
Найдите идентификаторы полей для:
- Пользователя (например, имя или идентификатор пользователя)
- Название навыка/задачи
- Уровень квалификации
Чтобы найти идентификатор поля:
- Откройте таблицу.
- Щелкните заголовок столбца.
- Просмотрите идентификатор поля на панели свойств.
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.
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. Предварительная фильтрация
Предварительные фильтры динамически фильтруют данные на основе:
- Текущего авторизованного пользователя
- Выбранной команде или отделе
- Диапазона дат или смены
Use pre-filters to personalize views for operators or supervisors.
4. Добавление триггеров для интерактивных действий
Вы можете настроить виджет так, чтобы он запускал действия при нажатии пользователем на ячейку.
- Откройте панель «Триггеры ».
- Задайте действие для «Идентификатора записи » при щелчке по ячейке.
- Включите параметр «Загрузить запись», чтобы отобразить дополнительные сведения о пользователе или навыке.
Советы
- Тщательно проверьте идентификаторы таблиц и полей, чтобы избежать опечаток.
- Используйте фильтры, чтобы адаптировать информационные панели для разных ролей.
- Перед запуском в производственную среду протестируйте с помощью тестовых данных.
Устранение неполадок
| Проблема | Вероятная причина | Рекомендуемое решение |
|---|---|---|
| Матрица не загружается | Неверные учетные данные API или URL | Проверьте учетные данные/URL |
| Данные не отображаются | Слишком строгие настройки фильтров | Удалите или ослабьте фильтры |
| Поля с «неопределенным» значением | Использован неверный идентификатор поля | Проверьте идентификаторы полей в таблице |
| Ячейки недоступны для клика | Триггер не настроен | Настройте триггер в виджете |
