从ALM OTA迁移至API：如何获取Test Lab模块字段？

你之前调用的test-parameters端点用于操作测试参数，和Test Lab中的Cycle实体无关，所以无法获取目标字段。以下是对应OTA代码功能的等效REST API调用方案：

核心端点说明 #

Cycle实体在ALM REST API中隶属于test-labs资源，基础路径为：

http://{{SERVERNAME}}/qcbin/rest/domains/{{DOMAIN}}/projects/{{PROJECT}}/test-labs

具体调用示例 #

1. 获取指定Test Set下的所有Cycle（含目标字段） #

先定位到目标Test Set（通过其ID），再关联查询下属Cycle，并指定需要返回的字段：

GET http://{{SERVERNAME}}/qcbin/rest/domains/{{DOMAIN}}/projects/{{PROJECT}}/test-labs/{{TEST_SET_ID}}/cycles?fields=id,name,attachments,baseline

• {{TEST_SET_ID}}替换为实际的Test Set ID
• fields参数可按需添加或移除字段，确保和ALM中Cycle实体的字段名一致

2. 获取单个Cycle的详细信息 #

若已知Cycle的ID，可直接查询该Cycle的完整或指定字段：

# 获取所有字段
GET http://{{SERVERNAME}}/qcbin/rest/domains/{{DOMAIN}}/projects/{{PROJECT}}/test-labs/cycles/{{CYCLE_ID}}

# 获取指定字段
GET http://{{SERVERNAME}}/qcbin/rest/domains/{{DOMAIN}}/projects/{{PROJECT}}/test-labs/cycles/{{CYCLE_ID}}?fields=id,name,attachments,baseline,description

3. 获取Cycle的附件内容 #

Cycle的attachments字段仅返回附件元数据，若需获取实际附件内容，需调用附件专属端点：

# 获取Cycle的所有附件元数据
GET http://{{SERVERNAME}}/qcbin/rest/domains/{{DOMAIN}}/projects/{{PROJECT}}/test-labs/cycles/{{CYCLE_ID}}/attachments

# 获取单个附件的具体内容
GET http://{{SERVERNAME}}/qcbin/rest/domains/{{DOMAIN}}/projects/{{PROJECT}}/test-labs/cycles/{{CYCLE_ID}}/attachments/{{ATTACHMENT_ID}}/content

关键注意事项 #

• 请求必须携带ALM认证信息：可使用LWSSO Cookie（登录后获取的LWSSO_COOKIE_KEY）或Basic Auth
• 确认ALM版本兼容性：ALM 12.0及以上版本对Cycle相关REST API支持更完善
• 若不确定字段名称，可查询Cycle实体的所有可用字段：

  GET http://{{SERVERNAME}}/qcbin/rest/domains/{{DOMAIN}}/projects/{{PROJECT}}/customization/entities/cycle/fields
  

内容的提问来源于stack exchange，提问作者Anju