Structure for jira 使用指南（一）

Posted 2023-03-22

参考技术A Structure for jira 是jira的一个插件，Structure 允许您使用可适应的、用户定义的问题层次结构来可视化、跟踪和管理 Jira 项目和团队的进度，此外，结构可能包含 Jira 中没有的文件夹和其他有用的组织元素。还支持以甘特图的形式展示任务进度，方便更好的管理团队的资源分配。

PS:正因为structure是用来整合jira的，所以使用他之前需要有很好的jira使用规范，确保需要观察的参数都被填写了。

官方文档： https://wiki.almworks.com/documentation/structure/getting-started-with-structure-32223517.html

1.在jira导航栏选择structure -> Create Structrue 来创建一个structure面板

2.然后你就得到了一个空白的structure面板

3.接下来，我们要使用Atuomation来添加你需要聚合的jira，这里我们先使用insert来添加jira，就像创建一个jira筛选器一样编写一个JQL。如果你还不熟悉JQL的语法可以参考 https://docs.atlassian.com/jira/jsw-docs-085/Advanced+searching

我们写一个简单的例子，这可以查找到所有issueType是epic且project属于“SAFeProgram”的jira，点击apply就可以展示所有符合条件的jira。

4.一个structure内可以添加多个automation来进行多次筛选，再点击一次添加就能对刚才instre的jira进行二次筛选。structure筛选条件的执行顺序是由下至上的，需要先执行的JQL需要放在下面。

1.structrue和jira面板一样可以通过添加来展示更多jira相关参数，点击标题栏的 “+”来进行搜索、添加

2.每个参数都支持重命名，点击参数旁边的“▽”，可以通过修改name来修改jira原始参数名。

1.上面我们已经学会在structure来创建单一的面板，但我们也可以在structure下创建多个文件夹，每个文件夹都可以添加自己的automation互不影响。

每个jira都可以通过拖动或者导航栏上的对应按钮来调整位置，同时也可以编辑、剪切、复制、粘贴、删除

如何使用 JIRA -REST-API for python 访问下一页

【中文标题】如何使用 JIRA -REST-API for python 访问下一页

【英文标题】：How to access the next page using JIRA -REST-API for python

【发布时间】：2016-02-22 06:33:56

【问题描述】：

我正在尝试获取与项目相关的所有问题。当我执行下面的代码时，我只得到 50 个结果。我需要浏览所有页面并获取所有错误。请帮助

all_issues = jira.search_issues('project=ProjectName')
    each_issue = sorted([issue.key for issue in all_issues])
    for item in each_issue:
        print item

这只给了我 50 个问题，因为该页面的默认值为 50。我需要获取所有问题。

【参考方案1】：

-- 2021 年 10 月 18 日更新

正如在answer below 中发现的那样，将 maxResults 设置为 False 似乎可以消除对结果集的限制。

all_issues = jira.search_issues('project=ProjectName', maxResults=False)

-- 原帖

试试；

all_issues = jira.search_issues('project=ProjectName', maxResults=50, startAt=50)

对来自 REST API 的结果进行分页，默认结果数为 50。您可以提供 startAt 值以从结果集中的某个点开始结果。默认情况下，此值为 0。

因此，您的原始查询将获得 0-49 的结果，上面的查询将获得 50-99 的结果，将 startAt 更改为 100 将获得 100-149，依此类推。

您还可以增加maxResults 的值以在每页返回更多结果。但是，这仅限于您的 JIRA 实例中配置的 jira.search.views.default.max 的最大值（默认设置为 1000）。

不可能在不分页的情况下让 API 返回所有问题。您必须将jira.search.views.default.max 配置为一个非常大的值并将该值提供为maxResults。

【讨论】：

非常感谢！它工作得很棒。正如您所说，它将值限制为 1000。我尝试将值设置为“jira.search.views.default.max”。但我得到一个错误'AttributeError：'JIRA'对象没有属性'search''。我想获取大约 10000 个问题。有办法吗？

你在哪里设置 jira.search.views.default.max？这是一个JIRA全局配置，JIRA安装需要在jira-config.properties中设置。

@rakesh：有什么方法可以轻松地对其进行分页吗？我可以预测总共可以退回多少件商品吗？

@Lormitto 我猜返回的项目数取决于您为 maxResults 设置的值。

这个答案是不正确的，因为当你改变 startAt 时你总是会做一个新的请求。如果你例如以一种不会出现在搜索中的方式处理问题，您将跳过一些问题

【参考方案2】：

根据源码： https://github.com/pycontribs/jira/blob/f5d7dd032e719fe35f5fc377f302200f6c69afd4/jira/client.py#L2737

设置 maxResults=False 应该可以解决问题，因此您的示例如下所示：

all_issues = jira.search_issues('project=ProjectName', maxResults=False)
    each_issue = sorted([issue.key for issue in all_issues])
    for item in each_issue:
        print item

我现在对它进行了短暂的测试，它在这里工作。