问题跟踪器
观看会话时即可将其转为工单:播放器中的一个按钮、您自己填写的描述,以及已附加的回放链接。
1. 为什么手动触发
MousePlayer 中的其他桥接都会自动触发。此桥接不会,这正是设计的全部用意。
工单意味着某个人要处理的工作。如果每次愤怒点击都创建一张,看板就会堆满无人分流处理的事项;不到一周,团队就会把它们过滤掉——真正的问题也会一起被过滤掉。
因此,触发者是您。观看会话、发现问题、按下按钮,再写下所见。录制链接已经放入描述;判断由您作出。
按钮仅对所有者和管理员显示,分享链接视图中绝不显示。收到录制分享的人不应能在您的跟踪器中创建工单。
2. 五种跟踪器及各自所需信息
| 创建位置 | 需要提供 | |
|---|---|---|
| Jira | 项目中的问题 | 站点 URL、账户电子邮箱、API 令牌、项目键、问题类型 |
| Linear | 团队中的问题 | API 密钥、团队 ID |
| Asana | 项目中的任务 | 个人访问令牌、项目 ID |
| Trello | 列表中的卡片 | 密钥、令牌、列表 ID |
| GitHub | 仓库中的问题 | 个人访问令牌、owner/repo |
一个卡片,每次选择一个提供商。日后添加第二个跟踪器是更改选择,并非迁移。
标识符从哪里来
在浏览器中打开团队或项目时,可在 URL 中看到 Linear 团队 ID 和 Asana 项目 ID。Trello 列表 ID 在这五者中最难获取:在看板 URL 后附加 .json ,然后找到所需列表。Jira 项目键是每个问题编号前的前缀,例如前缀 ACME 出现在问题编号 ACME-1234中。
3. 工单中的链接由服务器构建
描述由您填写,回放链接则不是:链接由我们根据您实际观看的会话在服务器端组装,表单无法影响它。
这很重要,因为工单中的链接会被其他人点击。如果链接来自浏览器,精心构造的请求就可能将任意地址放到团队面前,而且看起来像来自自己的工具。
HTTP 200 不等于工单存在
Linear 使用 GraphQL 返回结果,而 GraphQL 拒绝时会返回 200 OK ,并带有 errors 数组。如果桥接只看状态码,就会对从未创建的工单报告成功。我们读取正文。
跟踪器返回新问题标识符时,我们会将其放进确认消息,使您能够核实它确实存在,而非只相信绿色提示。
4. 刻意不提供的功能
不自动创建工单
原因见上文。如果需要自动化,Webhook 桥接可将挫败感信号发送至 Zapier 或 Make,由您在那里决定什么值得创建工单。
不双向同步
关闭工单不会改变 MousePlayer 中的任何内容,MousePlayer 也不会重新打开它。只实现一个半方向的同步,比完全没有更糟,因为人们会开始依赖它。
不添加附件
录制保留在我们这里,也在我们这里观看。将视频导出到跟踪器,会把个人数据推送至保留规则不同于您与访客约定规则的系统。
令牌以 AES-256-GCM 加密存储,不再显示,也绝不放入内部队列。此调用直接由请求执行,在您等待期间完成。
5. GitLab、Azure DevOps 与 ClickUp
又增加了三种跟踪器,使用同一个按钮,同样手动触发。
| 需要提供 | |
|---|---|
| GitLab | 主机、项目 ID 和令牌,也支持自有 GitLab |
| Azure DevOps | 组织、项目、工作项类型和 PAT |
| ClickUp | 列表 ID 和个人令牌 |
GitLab 询问主机,因为您可能自行托管
与其他平台不同,GitLab 经常自行托管,因此主机是可填写字段,而非固定值。若使用的是该服务,请粘贴 gitlab.com 。
Azure DevOps 同时有两个特殊之处
正文是 JSON Patch 文档,而非对象,内容类型必须为 application/json-patch+json ,否则返回 415。URL 中工作项类型前的美元符号是地址的一部分,并非我们忘记填写的占位符。
ClickUp 需要纯令牌
前面不要加 Bearer 。在令牌前加上这个词会被以 401 拒绝,看起来与令牌错误完全相同。
此处提及的所有商标均属于各自所有者。MousePlayer 与这些提供商不存在商业关系。