如何使用 TFS 获取 WorkItem 链接 Java API

How to fetch WorkItem links with the TFS Java API

我们使用 TFS Java API 从 TFS 服务器获取工作项:

    TFSTeamProjectCollection collection = TFSTeamProjectCollectionUtils
            .openTeamProjectCollection(serverUrl, credentials,
                    new DefaultConnectionAdvisor(Locale.getDefault(),
                            TimeZone.getDefault()));
    WorkItemClient client = collection.getWorkItemClient();

    List<WorkItem> result = new ArrayList<>();
    try {
        WorkItemCollection workItems = client.query(wiqlQuery, null, false);
        for (int i = 0; i < workItems.size(); i++) {
            WorkItem item = workItems.getWorkItem(i);
            result.add(item);
        }
        return result;
    } catch (TECoreException e) {
        throw new ConQATException("Failed to fetch work items from TFS", e);
    }

如果我 运行 查询 select * from workitems 我会得到服务器上的所有工作项,包括所有字段和所有链接。由于我只对某些字段感兴趣,因此我想将查询限制为仅那些字段并保存一些 bandwidth/time: select ID, Title from workitems

这工作正常,但现在缺少项目的链接(即 item.getLinks() 总是 returns 一个空集合)。

有没有办法 select 除了 select * from workitems 之外的链接?

经过进一步挖掘,我发现您可以创建一个 link 查询并 运行 如下所示:

WorkItemLinkInfo[] infos = client.createQuery("select * from workitemlinks").runLinkQuery()

这样,您可以获得 links 作为 WorkItemLinkInfo 对象,其中包含目标和源节点的 ID 以及 link 类型。

使用WorkItemLinkInfo 的解决方案是正确的。 正如评论:使用 WIQL 查询,您只会收到您正在查询的属性 - 这不能是工作项的链接集(因此始终为空)。如果您使用

查询单个工作项
WorkItemClient client = TFSConnection.getClient();
WorkItem firstWorkItem = client.getWorkItemByID(id);

然后您还可以使用(包含 RelatedLinks、ExternalLinks 或 HyperLinks)

获取 LinkCollection
LinkCollection linkcoll = firstWorkItem.getLinks()