--- title: "Матрица навыков" slug: "skill-matrix" updated: 2026-10-22T17:13:37Z published: 2026-10-22T17:13:37Z 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. # Матрица навыков :::(Info)To download, visit: [Library](https://library.tulip.co/apps/skill-matrix). ::: ## Что такое виджет «Матрица навыков»? **Виджет «Матрица навыков»** позволяет визуализировать, фильтровать и управлять навыками пользователей и уровнями компетентности по задачам в таблице матричного типа. ![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) ### Вы можете использовать этот виджет для: - отслеживать навыки операторов и выявлять пробелы - Просмотра навыков по пользователям, группам, задачам или уровням - Динамической фильтрации данных о навыках - Взаимодействовать с ячейками матрицы для просмотра подробных записей или запуска действий В данном руководстве объясняется, как настроить и использовать виджет «Матрица навыков» в **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](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[Как настроить API Tulip](https://support.tulip.co/docs/set-up-a-tulip-api)