30.7. JQL
JQL URI 选项都由两个使用者端点使用。理论上,"project key"等项目可以是 URI 选项本身。但是,通过要求使用 JQL,消费者变得更灵活且强大。
至少,消费者需要以下内容:
jira://[type]?[required options]&jql=project=[project key]
需要注意的是 newIssues 消费者将自动将 JQL 设置为:
-
将
ORDER BY 键 desc
附加到 JQL -
prepend
id > latestIssueId
以检索在 camel 路由启动后添加的问题。
这是为了优化启动处理,而不必对项目中的每一 个问题进行索引。
另一个备注是,newComments 消费者也必须索引项目中每个单个问题 和注释。因此,对于大型项目,尽可能优化 JQL 表达式非常重要。例如,JIRA Toolkit 插件在查询中包含一个 "Number of comment" 自定义字段,用于您的查询中的 '"Number of comments" > 0'。另外,还会尝试根据状态(status=Open)最小化,增加轮询延迟等。Example:
jira://[type]?[required options]&jql=RAW(project=[project key] AND status in (Open, \"Coding In Progress\") AND \"Number of comments\">0)"