--- title: "技能矩阵" slug: "skill-matrix" updated: 2026-10-22T17:13:44Z published: 2026-10-22T17:13:44Z 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 账户**访问权限 - **查看服务账户** **和管理表格**的权限 - 您的**Tulip 账户 URL** **和工作区 ID** --- ## 1. 配置必填参数 ### 1.1 获取您的服务账户 Feature rename Prior to r383, Service Accounts were called "API Tokens". 1. 点击 Tulip 右上角**的用户图标**。 2. 进入**“账户设置**”。 3. 在左侧菜单中点击**“Tulip API**”。 4. 点击**“创建服务账户**”。 5. 为您的服务账户命名(例如:`SkillMatrixWidget`)。 6. 分配以下权限范围: 7. `table-queries:read` 8. `tables:read` 9. `tables:write` 10. `users:read` 11. 点击**“创建”**。 12. 复制**“Auth Header**”,但**请删除** `“Basic`”一词及其后面的空格。 13. 配置小部件时:如果系统提示您在**“服务账户**”的**“变量**”和**“静态值**”之间进行选择,请选择**“静态值**”,并将您的凭据**(不含“Basic”)**直接粘贴到该字段中。 Caution Never share your Service Account credentials publicly. --- ### 1.2 查找您的 Tulip 账户 URL 您的账户 URL 通常如下所示: `your-account.tulip.co` --- ### 1.3 查找您的任务表 ID 1. 请转至 Tulip 中的**“表”**部分。 2. 点击相应的**任务表**。 3. 从详细信息部分复制**表的 UID**。 --- ### 1.4 确定字段 ID 查找以下**字段**的**ID**: - 用户(例如:姓名或用户 ID) - 技能/任务名称 - 技能等级 要查找字段的 ID: 1. 打开表格。 2. 点击列标题。 3. 在属性面板中查看**字段 ID**。 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. 配置可选参数 您可以使用以下可选参数进一步自定义小部件: - **分组字段 ID**:按团队、部门等对数据进行分组。 - **设计状态**:按状态(例如“活动中”、“已完成”)进行筛选。 - **等级颜色**:为不同的技能等级分配自定义颜色。 --- ### 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 - 您可以在 Tulip URL 中`/w/` 后的部分找到**您的工作区 ID** `。`例如:`https://your-account.tulip.co/w/DEFAULT`→ 工作区 ID 为`DEFAULT` - 对于默认工作区,请使用`DEFAULT`或将该字段留空。 ## 3. 使用技能矩阵小部件 ### 3.1. 查看技能数据 配置完成后,该小部件将显示以下矩阵: - 用户 - 任务或技能 - 相应的技能等级 使用内置的下拉式筛选器(组、技能、等级)来缩小查看范围。 ### 3.2. 刷新并筛选 - 点击**“清除筛选条件**”以移除所有筛选选项。 - 点击**“重新加载**”以更新数据。 ### 3.3. 预筛选 预筛选功能会根据以下条件动态筛选数据: - 当前登录的用户 - 所选团队或部门 - 日期范围或班次 Tip Use pre-filters to personalize views for operators or supervisors. ## 4. 为交互式操作添加触发器 您可以配置该小部件,使其在用户点击单元格时触发操作。 1. 打开**“触发器**”面板。 2. 设置当单元格被点击时,针对**“记录 ID**”执行的操作。 3. 启用**“加载记录**”以显示有关用户或技能的更多详细信息。 ## 提示 - 请仔细核对**“表**”和**“字段”ID**,以避免输入错误。 - 使用筛选器为不同角色定制仪表板。 - 在投入生产环境前,请使用模拟数据进行测试。 ## 故障排除 | 问题 | 可能原因 | 建议的解决方法 | | --- | --- | --- | | 矩阵无法加载 | API 凭据或 URL 无效 | 请仔细核对凭据/URL | | 数据未显示 | 筛选条件过于严格 | 移除或放宽筛选条件 | | “未定义”字段 | 使用的字段 ID 错误 | 请检查表中的字段 ID | | 单元格不可点击 | 未配置触发器 | 在小部件中设置触发器 | ## 进一步阅读: [列出Tulip Table](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[的记录](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[如何设置Tulip API](https://support.tulip.co/docs/set-up-a-tulip-api)