开始之前
您需要准备
- 工作区中的 Connections 模块：Team、Business、Partner 和 Enterprise 套餐已包含，Project 套餐可通过附加组件 Integrations for one UAT 获得。
- UAT Studio 项目中的管理员权限。
- 一个 Make 账户。免费订阅即可。
设置 · 每个项目一次
将 UAT Studio 连接到 Make
1
在 UAT Studio 中创建 API 密钥
- 登录 app.uat.studio，打开项目并前往 Setup。
- 在 API keys 卡片中输入名称，例如 Make，然后点击 Create API key。
- 点击 Copy。UAT Studio 只显示一次密钥；在粘贴之前请保持窗口打开。
2
向场景添加 HTTP 模块
- 在 Make 中点击 Create a new scenario，然后点击大大的 +。
- 搜索 HTTP 并选择 Make a request。
Make 版 UAT Studio 应用即将推出在此之前，HTTP 模块可以实现相同的功能。应用推出后，您改选 UAT Studio 并粘贴同一个 API 密钥即可。
3
填写请求
从上到下填写 Make a request 的字段。表中未列出的字段保持原样。
| 字段 | 填写内容 |
|---|---|
| Authentication type | No authentication。密钥放在下面的标头中。 |
| URL | https://app.uat.studio/api/v1/issues?order=created，或下表中的其他地址。 |
| Method | GET 用于读取，POST 用于创建，PATCH 用于修改。 |
| Headers | 点击 Add a header。Name：Authorization。Value：Bearer、一个空格，再加上您的 API 密钥。 |
| Query parameters | 留空。 |
| Body content type | 读取（GET）时：留空。创建或修改时：application/json。 |
| Body input method | 仅在创建或修改时：JSON string。 |
| Body content | 仅在创建或修改时：以 JSON 格式填写字段，例如 {"title": "Save fails", "severity": "High"}。 |
| Parse response | Yes，以便后续模块使用问题的字段。 |
| Pagination type | 留空。 |
点击 Save。
4
运行并设置计划
- 点击 Run once。输出中会显示您项目的问题。
- 添加后续模块：针对问题列表的 Iterator、一个 Filter（例如严重程度为 Critical），以及要执行操作的应用，例如 Slack 或 Google Sheets。
- 如果只想处理新问题，请添加
&since=并附上次运行的时间，或使用 Make 的 Data store 记住已处理过的编号。 - 设置计划（例如每 15 分钟一次）并开启场景。
可用内容 · https://app.uat.studio/api/v1
API 地址
| 类型 | 请求 | 作用 |
|---|---|---|
| 读取 | GET /issues?order=created | 最新的问题。order=updated：最近修改的问题。还支持 since、status 和 limit（最多 100）。 |
| 读取 | GET /issues/ISS-012 | 单个问题。 |
| 读取 | GET /signoffs | 签核记录，最新的在前。 |
| 创建 | POST /issues | 新问题：title，可选 description、severity、priority、test_number、step_number、assignee。 |
| 修改 | PATCH /issues/ISS-012 | status、severity 或 assignee，可选附带 comment。 |
| 修改 | POST /issues/ISS-012/comments | 历史记录中的一条 comment。 |
| 创建 | POST /testers | 测试人员：name，可选 email 和 group。 |
每个问题都附带编号（ISS-012）、标题、描述、严重程度、优先级、状态、负责人、测试和发现该问题的测试人员、Jira 或 Azure DevOps 中的工单，以及指向 UAT Studio 的链接。
创意
团队的实际用法
- 每个 Critical 问题都发一条消息到聊天频道，按严重程度筛选。
- 每次签核都记入电子表格或项目组合管理工具，让指导委员会看到哪些 UAT 已被接受。
- 从表单或 HR 系统导入测试人员：新增一行即成为对应分组中的测试人员。
- 来自支持工具的问题：带有某个标签的工单会成为 UAT 中的问题，并关联到相应测试。
出现问题时
常见提示信息
| 提示信息 | 处理方法 |
|---|---|
| The API key is not valid | 密钥已被撤销或输入有误。请在 Setup › API keys 下创建新密钥并重新连接。 |
| Connections … are not part of the plan | 该工作区没有 Connections 模块。请在 Plan & billing 中添加。 |
| This workspace is read-only | 套餐已到期。仍可读取，但无法创建和修改。 |
| There is no issue ISS-… | 该密钥属于另一个项目，或者问题已被合并。请检查密钥和问题编号。 |
| 出现新问题后没有任何反应 | 场景按计划运行。请检查它是否已开启，以及密钥是否属于正确的项目。 |
安全
密钥如何保持安全
- 一个密钥只能访问一个项目，无法访问工作区中的其他任何内容。
- UAT Studio 只存储密钥的指纹，从不存储密钥本身。Setup 中会显示最后四个字符和最近使用时间。
- 在 Setup 中点击 Revoke 可立即停用密钥。
- 通过密钥创建或修改的每个问题或测试人员都会显示在问题历史记录和审计日志中，并注明密钥名称。
- 切勿将密钥放入邮件、聊天或代码中；只将其粘贴到 Make。