Jira开发实践、ScriptRunner插件开发总结

Jira简介

JIRA 是目前比较流行的基于Java架构的管理系统，由于Atlassian公司对很多开源项目实行免费提供缺陷跟踪服务，因此在开源领域，其认知度比其他的产品要高得多，而且易用性也好一些。同时，开源则是其另一特色，在用户购买其软件的同时，也就将源代码也购置进来，方便做二次开发。JIRA功能全面，界面友好，安装简单，配置灵活，权限管理以及可扩展性方面都十分出色。

自定义工作流

打开Jira管理，问题，可以自定义工作流流程
以及定义界面、字段等，可以自己新增界面和字段，并配置界面显示哪些字段

自定义工作流中可以新增流程校验、和操作人限定等

插件开发

ScriptRunner主要使用该插件进行一些相关定制开发，语言使用的是Groovy语言，该语言语法与Java类似，并且兼容java

编程过程中有几个常用类和方法
customFieldManager 自定义字段管理器
可以通过该类获取自定义字段

def customFieldManager = ComponentAccessor.getCustomFieldManager()
def field =  customFieldManager.getCustomFieldObjectByName("字段名称")
//获取值
def fieldValue =  field.getValue();

Listeners中获取子问题、父问题

// 初始化
def customFieldManager = ComponentAccessor.getCustomFieldManager()
def issueManager = ComponentAccessor.getIssueManager()
// 变更事件管理
def changeHistoryManager=  ComponentAccessor.getChangeHistoryManager()
//操作用户
def user = ComponentAccessor.getJiraAuthenticationContext().getLoggedInUser()
//获取当前问题
def issue = event.getIssue()
//获取该问题的父级任务
def parentIssue = issue.parentObject//获取相关字段
def customField = customFieldManager.getCustomFieldObjectByName("字段A")//获取值
def parentValue = mutableParentIssue.getCustomFieldValue(customField)
//父任务获取子任务数组def subtasks = mutableParentIssue.getSubTaskObjects()for(subtask in subtasks){//可以循环数组，进行操作}
// 更新父问题的字段内容
mutableParentIssue.setCustomFieldValue(customField, Double.valueOf(customFieldValue)) // 问题更新issueManager.updateIssue(user, mutableParentIssue, EventDispatchOption.DO_NOT_DISPATCH, false)

Behaviour常用
主要设置字段隐藏，必读，必填等，如果一个字段针对不同的项目有不同的效果，可以通过mapping设置

// 获取子任务的字段
def cf = ComponentAccessor.customFieldManager.getCustomFieldObjectByName("字段名称")
// 获取字段
def af = getFieldByName("字段A")
// 设置必填
af.setRequired(true)
// 设置只读
af.setReadOnly(true)
//设置隐藏
af.setHidden(true)
// 设置显示提示文字
af.setHelpText("该字段不可变编辑")

相关的Api接口文档可以参考：
https://docs.atlassian.com/software/jira/docs/api/7.1.0/com/atlassian/jira/issue/managers/package-summary.html