使用Rally REST API和Java创建测试用例时无法添加新标签求助

嗨，我来帮你搞定这个标签没成功添加的问题！核心原因是你对Rally API中Tags字段的类型理解错了，它不是普通字符串，而是需要关联已存在的Tag对象引用集合。下面给你拆解问题和修正方案：

问题出在哪？ #

你的代码里直接把带@的字符串赋值给Tags字段：

newTestCase.addProperty("Tags" , tags);

但Rally的Tags是多值关联字段，它需要接收的是Tag对象的_ref值组成的数组，而不是纯文本字符串，所以系统根本识别不了你传的@tag1 ,@tag2。

正确的实现步骤 #

1. 先获取目标标签的引用（_ref） #

首先要查询Rally中已存在的标签，拿到它们的_ref值（如果标签不存在，你可以选择先创建标签再获取引用）。

2. 构建标签引用数组并关联到测试用例 #

把获取到的标签引用组成JsonArray，再添加到测试用例的Tags字段中。

修正后的代码示例 #

首先写一个工具方法用来获取标签的引用：

private JsonArray getTagRefs(RallyRestApi restApi, String[] tagNames) throws IOException {
    JsonArray tagRefs = new JsonArray();
    for (String tagName : tagNames) {
        // 查询对应名称的Tag
        QueryRequest tagRequest = new QueryRequest("Tag");
        tagRequest.setQueryFilter(new QueryFilter("Name", "=", tagName));
        tagRequest.setFetch(new Fetch("_ref")); // 只需要获取_ref字段
        QueryResponse tagResponse = restApi.query(tagRequest);

        if (tagResponse.getTotalResultCount() > 0) {
            // 取出第一个匹配的Tag的_ref
            JsonObject tag = tagResponse.getResults().get(0).getAsJsonObject();
            tagRefs.add(tag.get("_ref").getAsString());
        } else {
            System.out.println("警告：标签「" + tagName + "」不存在，请先在Rally中创建！");
            // 如果你想自动创建不存在的标签，可以在这里添加创建Tag的逻辑
        }
    }
    return tagRefs;
}

然后在创建测试用例的代码中调用这个方法：

// 定义要添加的标签名（注意不要带@）
String[] targetTags = {"tag1", "tag2"};
RallyRestApi restApi = new RallyRestApi(new URI("你的Rally API地址"), "你的API密钥");

try {
    // 获取标签的引用数组
    JsonArray tagRefs = getTagRefs(restApi, targetTags);

    // 构建测试用例对象
    JsonObject newTestCase = new JsonObject();
    newTestCase.addProperty("Name", testCaseName); // 这里替换成你的测试用例名称
    newTestCase.addProperty("Method", "Manual"); // 注意Manual要加引号，是字符串类型

    // 关键：把标签引用数组添加到Tags字段，用add而不是addProperty
    newTestCase.add("Tags", tagRefs);

    // 发送创建请求
    CreateRequest createRequest = new CreateRequest("TestCase", newTestCase);
    CreateResponse createResponse = restApi.create(createRequest);

    if (createResponse.wasSuccessful()) {
        System.out.println("测试用例创建成功，标签已添加！");
    } else {
        System.err.println("创建失败：" + createResponse.getErrors());
    }
} finally {
    restApi.close();
}

额外注意事项 #

• 如果需要创建新的标签，可以先调用CreateRequest创建Tag对象，拿到它的_ref后再关联到测试用例。
• Rally API的字段名是区分大小写的，比如Name、Method、Tags都要严格匹配。
• 不要给标签名加@，Rally里的标签名本身不带这个符号，@只是界面上的显示格式。

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