2019-04-27 게시 됨2022-01-16 업데이트 됨PM / System26분안에 읽기 (약 3844 단어)

ScriptRunner 소개 3

ScriptRunner 소개 #3

지난 #2 소개 글에서는 Script Fields 기능까지 보았고
그 다음에 있는 아래 리스트의 기능들을 보겠습니다.

REST Endpoints
Script Fragments
Escalation Services
Script JQL Functions

소개 글을 쓰는 도중에 JIRA 시스템 버전이 7에서 8로 올라가는 과정에서 UI, 기능이 약간 변경되었습니다.
버전 변경에 따라 큰 차이는 없겠지만 참고해주세요. :)

JIRA version: 7.13 -> 8.0
ScriptRunner: 5.5.2 -> 5.5.3

REST Endpoints

https://scriptrunner.adaptavist.com/latest/jira/rest-endpoints.html
ScriptRunner 공식 문서를 보면 아래와 같은 용도로 사용할 수 있다고 합니다.

use in dashboard gadgets
- 대시보드 가젯으로 사용
receive notifications from external systems
- 외부 시스템으로부터 알림 받기
plug gaps in the official REST API
- 공식 REST API 갭을 보완(매꾸기)
allow all your XHRs to proxy through to other systems
- 모든 XHR이 다른 시스템으로 프록시되도록 허용

Create Rest Endpoint 버튼을 통해 만들 수 있습니다.

위 화면처럼 inline script 입력 창에 코드를 입력하여 REST API를 구현합니다.
공식 문서와 Show examples에서는 Simple 'get' 코드를 보여줍니다.

import com.onresolve.scriptrunner.runner.rest.common.CustomEndpointDelegate
import groovy.json.JsonBuilder
import groovy.transform.BaseScript

import javax.ws.rs.core.MultivaluedMap
import javax.ws.rs.core.Response

@BaseScript CustomEndpointDelegate delegate // 1

doSomething( // 2
  httpMethod: "GET", groups: ["jira-administrators"]) { // 3
    MultivaluedMap queryParams, String body -> // 4
    return Response.ok(new JsonBuilder([abc: 42]).toString()).build(); // 5
}

코드의 설명 내용은 공식 문서에 나와있으나 짧게 설명해보겠습니다. (영어로 되어있어 한국어로 설명할 겸..!)

이 줄이 코드는 스크립트가 엔드포인트로 사용할 수 있도록 하는 코드입니다. 엔드포인트를 사용하고자 한다면 꼭 필요한 코드입니다.
REST 엔드포인트의 이름입니다. URL에서 사용할 이름으로 이 코드에서는 doSomething으로 사용될 것입니다.
엔드포인트의 설정으로 HTTP GET, 권한 그룹은 jira-administrators 그룹이 사용할 수 있는 엔드포인트가 됩니다.
메서드 바디에 제공될 파라미터 입니다.
작성된 값은 메서드 바디에 포함되어 javax.ws.rs.core.Response 객체를 반환할 것 입니다.

이렇게 추가하게되면 아래의 링크에 접근하여 데이터를 받을 수 있습니다.
<jira_base_url>/rest/scriptrunner/latest/custom/doSomething
curl로 테스트해보면 아래와 같이 결과 값이 나올 수 있겠습니다.
(admin:admin는 username:password 값을 입력하면 됩니다.)

1 2	> curl -u admin:admin http://localhost:8080/jira/rest/scriptrunner/latest/custom/doSomething > {"abc":42}

예시

예시: ScriptRunner REST Endpoints Examples

Create Priority Object
Get the user making the request

문서에 코드도 같이 포함되어 있으니 링크 참고하셔서 설정하면 되겠습니다.
특정 URL로 요청해서 시스템 설정을 하거나 데이터를 가져오거나 할 수 있는 기능으로
REST Endpoints 소래를 마무리할 수 있겠습니다.

Script Fragments

https://scriptrunner.adaptavist.com/latest/jira/CustomisingUI.html
설정화면에 있는 설명을 그대로 가져와보겠습니다.

Use script fragments to customise the user interface and add new functionality to a Jira instance. Use customisable built-in script fragments to display web items, web panels and web sections or to include JavaScript and CSS resources using web resources. All script fragments can be customised, or use the raw XML module to create a fully custom web fragment.

간단히 설명하자면 필요한 Web items, panels, section을 만들 수 있다는 것입니다.
XML 설정이나 다른 리소스가 필요할 수는 있으나 팝업, 패널 등을 사용자가 원하는대로 만들 수 있는 기능입니다.

설정을 할 수 있는 메뉴를 하나하나 알아보겠습니다.

Raw xml module

XmlModuleItem Docs
xml 코드를 입력하여 원하는 위치에 메뉴를 보여주거나, 버튼들을 보여줄 수 있습니다.
아래 코드로 JIRA 상단 메뉴의 Projects > View all projects > My Projects를 볼 수 있습니다.

<web-item key='link-to-myprojects' name='ScriptRunner generated web item - link-to-myprojects' section='browse_link/project_view_all' weight='50'>
  <label>My Projects</label>
  <link linkId='link-to-myprojects'></link>
  <tooltip>Show only my projects</tooltip>
  <icon height="16" width="16">
    <link>/images/icons/print.gif</link>
  </icon>
</web-item>

XML 입력창에 입력만 하면 되긴 하지만 JIRA UI 아이템들이 어떻게 배치되어있는지
알고 작성해야하는 것이 어렵긴합니다.

section에 system.top.navigation.bar이 있는지, <web-item> 태그가 있는지 알기 쉽지 않지만
일단 예제로 따라해보고 다른 web-item, web-section 등의 태그를 알아가야할 것 같습니다.

참고 외부 링크

Jira Server Developer (Web Item): https://developer.atlassian.com/server/jira/platform/web-item/
Jira Server Developer (Web Section): https://developer.atlassian.com/server/jira/platform/web-section/

Install web resource

Web Resource Docs
이 기능은 Javascript, CSS 리소스를 사용할 수 있도록 하는 기능입니다.
우선 설정을 하려면 아래와 같이 환경 설정을 해야합니다. (경로는 다를 수 있습니다.)

1	JVM_REQUIRED_ARGS='-Dplugin.resource.directories=/app/home/scripts -Dother.properties...'

설정 후, 해당 폴더에 JS, CSS를 넣고 Resouces 입력창에 경로를 넣어줍니다.

커스텀한 리소스를 사용할 수 있다는 점에서는 좋은 것 같지만
잘못하면 많이 망가질 수 있다는 생각이 들긴하는 기능입니다.

Create a custom web section

Web Section Docs
웹 섹션(Web section)은 새로운 로케이션 또는 섹션, web-item을 추가할 때 사용할 수 있습니다.

web-item에서 web-section을 사용하고자 한다면,
web-section 만들 때 사용했던 key 값을 사용해야합니다.

Constrained create issue dialog

Create Constrained Issue
문서 설명 그대로 가져오자면, Create Constrained Issue -> 제한된 문제 만들기!
제한된 설정 안에서 이슈를 만들 수 있도록 설정할 수 있습니다.

문서에 나온 설명에 따르면,

This can be useful to workflow designers. Imagine a workflow where at one transition the user is required to create a new linked issue. Typically this is done by having a self or any to any transition which will created the linked issue with a post-function. Then the user is required to edit the linked issue further.

Workflow를 디자인, 만들때 유용한 기능입니다.
예를 들면 특정 트랜지션에서 이슈를 링크해야한다던지, 특정 값을 입력해야하는 옵션을 추가할 수 있습니다.

문서에서는 Behaviours와 함께 사용해서 구성한 메뉴를 눌렀을 경우,
새로운 이슈를 만들때 특정 필드를 읽기전용으로 설정하고 필드 값도 미리 설정할 수 있는 것을 보여줍니다.

TODO

이 기능은 설정할 내용이 좀 있어서 나중에 포스트로 깊게 다루는게 좋을 것 같습니다.

Custom web item

Web Item
A web-item is a button or link that will appear at your chosen location.
웹 아이템은 버튼 또는 링크로 설정한 위치에서 메뉴로 사용할 수 있습니다.

간단한 예시로 JIRA 상단에 네비게이션 바에 Search the Web 링크를 만들어봅니다.

issue에서 More Actions 메뉴에도 링크를 만들어봅니다.

결과화면은 아래와 같이 나옵니다.

Condition 조건에 따라 웹 아이템이 나오기에 Condition 설정도 필요합니다.
프로젝트로 한정하거나 이슈의 특정 값인지 조건을 사용할 수 있습니다.

차근차근 테스트 삼아 저도 웹 아이템 하나 만들어보겠습니다.

1. web-item을 하나 만들어봅니다.

Menu text는 버튼에 들어갈 텍스트니 적당히 적어줍니다.
Weight 값은 숫자가 작을수록 우선순위가 높습니다.
Condition 값은 어떤 조건에 버튼이 나올지 설정할 수 있습니다.
Do what에는 저는 dialog를 띄우는 테스트를 할 것이라 Run code and display dialog를 선택했습니다.
Link는 REST Endpoint 기능에서 만든 URL을 입력해줍니다. 다음 과정에서 만드는 방법을 보겠습니다.

2. REST Endpoint 추가

import com.onresolve.scriptrunner.runner.rest.common.CustomEndpointDelegate
import groovy.transform.BaseScript

import javax.ws.rs.core.MediaType
import javax.ws.rs.core.MultivaluedMap
import javax.ws.rs.core.Response

@BaseScript CustomEndpointDelegate delegate

showDialog { MultivaluedMap queryParams ->
    def dialog =
        """<section role="dialog" id="sr-dialog" class="aui-layer aui-dialog2 aui-dialog2-medium" aria-hidden="true" data-aui-remove-on-hide="true">
            <header class="aui-dialog2-header">
                <h2 class="aui-dialog2-header-main">Some dialog</h2>
                <a class="aui-dialog2-header-close">
                    <span class="aui-icon aui-icon-small aui-iconfont-close-dialog">Close</span>
                </a>
            </header>
            <div class="aui-dialog2-content">
                <p>This is a dialog...</p>
            </div>
            <footer class="aui-dialog2-footer">
                <div class="aui-dialog2-footer-actions">
                    <button id="dialog-close-button" class="aui-button aui-button-link">Close</button>
                </div>
                <div class="aui-dialog2-footer-hint">Some hint here if you like</div>
            </footer>
        </section>
        """

    Response.ok().type(MediaType.TEXT_HTML).entity(dialog.toString()).build()
}

위 코드를 inline script 항목에 넣어줍니다.
- 함수 이름으로 REST endpoint가 만들어질 것인데 showDialog로 만들어질 예정입니다.
생성!
다시 Web-item 만든 곳으로 돌아가서 아래 주소를 입력해줍니다.
- /rest/scriptrunner/latest/custom/showDialog
- 1번 단계에서 이미 이미지를 보고 입력하셨다면 함수 이름에 맞게 입력했는지 확인하면 끝!

3. 결과

Web 버튼을 누르면 2번째 이미지 처럼 다이얼로그가 나옵니다!
다이얼로그에 필요한 정보는 차차 넣을 수 있도록하면 되겠습니다.
문서에서는 web resource 까지 가서 close 버튼에 뭔가 더 해보라고 하지만 여기까지 하겠습니다. :)

Custom web item provider

Web Item Provider Built-In Script
문서 상에 예로 사용할 수 있는 것으로 설명을 시작하는게 좋을 것 같습니다.
Examples of a web item provider might be:

현재 사용자가 가지고 있는 이슈 중, 액티브 스프린트에 있는 상위 5개의 이슈를 보여줍니다.
- Show the top 5 issues for the current user in active sprints in the Issues top-level menu
현재 이슈의 서브태스크 각각에 대한 web item을 More Actions 메뉴에서 보여줍니다.
- Show a web item in the More Actions menu for each of the current issue’s subtasks

예시: My Top Issues

https://scriptrunner.adaptavist.com/5.5.3.1-jira8/jira/fragments/WebItemProvider.html#_example_my_top_issues

JIRA 상단의 네비게이션 바 메뉴에서 issues를 눌렀을 때,
MY TOP ISSUES 섹션에 스프린트에 있는 자신에게 할당된 이슈 상위 5개가 보입니다.
예시 링크에 있는대로 진행하시면 원하는 결과를 보실 수 있을 겁니다. (스프린트를 사용한다는 가정하에 말이죠)

Show a web panel

Web Panel
커스텀 웹 패널을 만들고 그 영역에 정보를 담을 수 있도록 설정할 수 있습니다.

Location : 설정 코멘트
Key: UI상 ID가 필요하여 사용하는 것으로 보입니다.
Menu text: 보이는 메뉴의 타이틀 문구로 사용됩니다.
Weight: UI 우선순의 값으로, 양수로 설정할 수 있으며 입력하지 않아도 됩니다.
Condition: 해당 패널이 보이는 조건을 설정할 수 있습니다.
Provider class/script: 패널에 들어갈 데이터를 넣어주는 코드를 작성할 수 있습니다.

1
2
3

writer.write("<div style='background-color: yellow; text-align: center'>" +
    "This project is going to be deprecrated. Please create" +
    " all issues in the WIDGET project</div>");

위 이미지 상에서 설정한대로 설정할 경우 이슈 오른쪽 패널에는 아래처럼 보여집니다.

부모 이슈의 설명(Description) 값을 가져와서 서브태스크에 보여주는 방법도 있습니다.
WebPanel.html#_parent_issue_example

잘 사용하면 필요한 정보를 적재적소에 보여줄 수 있을 것 같지만,
잘못 사용하면 난잡해질 수 있겠다는 생각이 드네요. 위의 예시를 살펴보고 세팅해보면 좋을 것 같습니다.
패널 뿐만 아니라 JIRA 이곳 저곳에 정보를 넣을 수 있으니 잘 사용하면 좋을 것 같습니다. :)

Hide system or plugin UI element

Hide UI Element Build-In Script
JIRA에서 특정 프로젝트나 특정 이슈에서 UI 요소를 숨길 수 있는 기능입니다.
예시로는 아래와 같은 것을 할 수 있습니다.

Move, Clone 기능을 특정 프로젝트에서 이슈 Operation 목록에서 보이지 않게 함
source control이 필요없는 프로젝트에서 Development panel을 보이지 않게 함

설정을 위해 입력해야하는 값은 많지 않습니다.

Note: script note, 이 설정의 설명을 적는 곳입니다.
Hide what: 어떤 요소를 숨길지 설정합니다. 설정할 수 있는 요소는 web items 들로 리스트는 굉장히 많습니다.
- com.atlassian.jira.plugin.system.issueoperations:* - 이슈 관련 UI 요소
- com.pyxis.greenhopper.jira:board-* - board 관련 UI 요소
Condition: 어떤 조건에서 UI를 숨길 것인지 조건을 설정합니다.
- 프로젝트, 이슈 등을 조건으로 설정할 수 있습니다.

이 설정을 사용하기전에 다른 프로젝트에 영향이 있을지 주의가 필요할 것 같습니다.
잘못하면 다른 구성원에게 필요한 기능이 보이지 않게될 수 있을테니까요.

Board Context Menu Item
Web Item 기능 중에 하나라고 볼 수 있습니다.
스크럼, 칸반 보드에서 오른쪽 버튼을 눌렀을 때 나오는 드롭다운에 메뉴를 추가할 수 있는 기능입니다.

`Ready for release` 메뉴를 추가한 모습

가이드 문서에는 메뉴를 누르면 간단한 동작을 하는 것을 보여줍니다.

스크럼 보드에서 액티브 스프린트에 있는 이슈를 Ready for release 메뉴를 누르면,
REST endpoint로 등록한 /rest/scriptrunner/latest/custom/ghAddLabel 로 이슈 정보를 보낸다.
REST endpoint 등록된 함수에서 이슈의 label 필드에 “red” 입력한다.
flag으로 오른쪽 위에 노티를 보여준다.

// ...
def flag = [
  type: 'success',
  title: "Label Added",
  close: 'auto',
  body : "This issue has been approved for release"
]
Response.ok(JsonOutput.toJson(flag)).build()

Condition은 복수의 이슈를 받을 수 있기에 List 객체를 받을 수 있게 되어있습니다.
예시 코드는 아래와 같이 볼 수 있습니다.

// All selected issues are resolved
issues.every { it.resolution }
// Selected issues in same project
issues*.projectObject.unique().size() == 1
// Only a single issue is selected
issues.size() == 1

Do what에는 사용할 수 있는 동작이 많습니다.
link로 데이터를 보내서 추가 동작을 설정하거나, 수정, 할당 등을 할 수 있습니다.

마무리

REST Endpoints, Script Fragment 내용이 많다보니 또 포스트 내용이 넘쳤네요.
다음 #4 소개 포스트에서 남은 Escalation Services, Script JQL Functions 에 대해 소개해보겠습니다.

2019-04-21 게시 됨2022-01-16 업데이트 됨PM / System16분안에 읽기 (약 2387 단어)

ScriptRunner 소개 2

ScriptRunner 소개 #2

지난 글에서는 Behaviours를 보았고 다음 내용인 콘솔, 리스너 등을 보겠습니다.

Administration > Add-ons > ScriptRunner
- Script Console
- Built-in Scripts
- Script Listeners
- Script Fields
- REST Endpoints
- Script Fragments
- Escalation Services
- Script JQL Functions

Script Console

Script Console은 실시간으로 스크립트를 작성하고 결과를 볼 수 있는 곳 입니다.

실제로 스크립트를 작성해보고 실행해본 모습입니다.

스크립트를 작성하는 곳 입니다.

자동 완성 기능은 없지만 없는 변수나 없는 함수 등은 오류를 보여줍니다.

스크립트를 작성한 뒤에 Run 버튼으로 실행할 수 있습니다.
Result / Logs / Timing 값을 각각 볼 수 있습니다.

Result: 스크립트에서 나온 결과물을 볼 수 있습니다.
Logs: 스크립트에서 출력한 log들을 볼 수 있습니다.
Timing: Elapsed: 208 ms / CPU time: 78 ms 와 같은 내용을 볼 수 있습니다.

아래는 의도적으로 함수명을 다르게 입력하면 볼 수 있는 에러 화면 입니다.

정적 타입 체크 밖에 해주지 못하지만 최소한의 체크는 할 수 있기에
스크립트 작성은 할 수 있습니다.

Built-in Scripts

ScriptRunner 에 이미 설정(구현)되어 있는 스크립트들을 사용할 수 있는 메뉴입니다.
아래 참고 문서에서 사용할 수 있는 스크립트 리스트를 볼 수 있습니다.
참고 문서: https://scriptrunner.adaptavist.com/latest/jira/builtin-scripts.html

<아래에 더 많은 스크립트가 있습니다>

위 화면의 스크립트 중 “Bulk Fix Resolutions” 스크립트를 확인해보겠습니다.
이 스크립트는 Filter에 있는 티켓들의 Resolution을 변경할 수 있습니다.
참고 링크: Bulk Fix Resolutions

JQL을 바로 작성하는 것은 아니며 기존에 만들어둔 Filter를 사용하여 동작하는 스크립트 입니다.
그 외에 다른 스크립트의 목록은 아래와 같습니다.

Listeners

Listeners는 JIRA에서 일어나는 이벤트에 따라 스크립트를 동작하게 합니다.
프로젝트, 특정 이슈, 특정 이벤트에 따라 동작할 수 있도록 설정할 수 있습니다.
참고 문서: https://scriptrunner.adaptavist.com/latest/jira/listeners.html

<여러가지 리스너를 추가할 수 있습니다>

이미 있는 리스너 타입을 사용해도 되고
아예 이벤트를 받는 처음부터 스크립트 마무리까지 관리하는 Custom listener를 사용할 수도 있습니다.

이미 있는 리스너 타입 하나를 한번 보겠습니다.
https://scriptrunner.adaptavist.com/5.4.39/jira/builtin-scripts.html
Create a sub-task: Create a sub-task, Will Optionally reopen a matching sub-task

<특정 이벤트에서 sub-task를 만들 수 있는 리스너 입니다>

Create a sub-task Listener를 등록하는 화면의 각각 입력 필드에 대해 알아보겠습니다.

Note: Listener 등록시 해당 설명으로 Listener 리스트에서 설명을 볼 수 있습니다.
Project(s): 해당 이벤트가 발생하는 프로젝트를 설정합니다.
- 프로젝트는 자동 완성되어 입력할 수 있습니다.
Events: 어떤 이벤트를 받아서 처리할 것인지 이벤트를 설정합니다.
- All Issue Events, Issue Created, Issue Updated 등의 이벤트를 추가할 수 있습니다.
Condition: 해당 이벤트가 발생했을 경우, True / False를 판단할 스크립트를 설정합니다.
- Show examples를 누르면 예시 코드를 볼 수 있습니다.
- Priority changed to Major (Listeners only) - Listeners 에서만 동작하는 코드로 priority가 Major로 변경되었을 경우 True를 반환하는 스크립트 입니다.
- 그 외에 많은 예제 스크립트가 있으니 참고하여 작성하면 됩니다.
Target Issue Type: Sub-task 카테고리의 이슈 타입을 설정합니다.
Subtask Summary: 생성할 Sub-task 제목(Summary)를 설정합니다.
Fields to copy: All / None / Custom 으로 상위 태스크의 필드 값을 복사할 것인지 설정합니다.
As User: 어떤 유저로 티켓 생성을 할 것인지 설정합니다.
- 값이 없을 경우 현재 유저로 설정합니다.
Additional issue action: Sub-task 생성 이후 타겟 이슈(부모 이슈)에 대해 추가적인 작업을 하도록 설정합니다.
- Condition과는 달리 추가적인 작업을 할 수 있도록 하는 스크립트 입력 필드입니다.
- 제목을 바꾸거나 팝업 메세지를 따로 띄우거나 할 수 있습니다.
- Show examples를 누르면 예시 코드를 볼 수 있습니다.
Subtask Action: 이미 생성된 Subtask가 있을 경우 transition을 진행할 것인지 설정합니다.
- 주의할 점은 적용하고자하는 프로젝트의 서브 태스크가 어떤 워크플로우를 쓰는가를 확인하여 적용해야 합니다.

Create a sub-task 외에 다른 listener 타입이 있으며 아예 커스텀한 listener도 만들 수 있습니다.
Custom listener의 경우 다음과 같이 만들 수 있습니다.

이 listener는 앞서 설명드린 create a sub-task 와 프로젝트, 이벤트 필드 설정하는 것은 같지만
이벤트를 받고 처리하는 방식이 다릅니다.

발생한 이벤트에서 각종 데이터를 받아 처리해야하는 listener 타입 입니다.
listener에 필요한 listener 타입이 없다면 커스텀하게 만들어서 사용하면 됩니다.

// Listener 중 Remote Custom listener는 JIRA에 등록되어있는 application에도 scriptRunner를 설치해야 사용할 수 있습니다.

Script Fields

Script fields는 아래와 같이 설명이 나와있습니다.

A script field is a custom field that allows you to automatically display a value according to the results of a ScriptRunner script.

요약하자면, “스크립트러너의 스크립트 결과를 보여주는 Custom field“ 입니다.
참고 문서: https://scriptrunner.adaptavist.com/latest/jira/scripted-fields.html

다음 글에서는 남은 기능을 소개해보겠습니다.

REST Endpoints
Script Fragments
Escalation Services
Script JQL Functions

2019-04-21 게시 됨2022-01-16 업데이트 됨PM / System6분안에 읽기 (약 879 단어)

ScriptRunner 소개 1

ScriptRunner 소개 #1

업무에서 요즘 많이 사용하는 ‘ScriptRunner’ 라는 플러그인을 소개하려 합니다.
이 포스트에서 다루는 내용은 JIRA 환경을 기준으로 작성되었습니다.
(한국 문서로는 많이 볼 수 없어서 공부 및 소개 겸 포스트 작성합니다.)

ScriptRunner란

메인 페이지: https://scriptrunner.adaptavist.com/latest/index.html
Adaptavist 라는 회사에서 만든 스크립트 플러그인
- Adaptavist inc: https://www.adaptavist.com/
- ScriptRunner, Test Management, SmartDraw 등 Atlassian 소프트웨어 플러그인 개발사
JIRA, Confluence, Bitbucket에서 커스텀 스크립트를 사용할 수 있는 플러그인
플러그인 설치 시 기본적으로 스크립트 함수, 필드 지원
스크립트 언어는 Groovy를 사용

ScriptRunner 가이드

가이드 문서는 모두 영어로 되어있으며, JIRA Server, JIRA Cloud로 나눠져있습니다.
Server 설치 버전과 Cloud 버전이 달라 기능도 약간씩 다르니 그 부분은 참고하여 사용해야합니다.

메인 페이지: https://scriptrunner.adaptavist.com/latest/index.html
Server 버전: https://scriptrunner.adaptavist.com/latest/jira/quickstart.html
Cloud 버전: http://scriptrunner-docs.connect.adaptavist.com/jiracloud/quickstart.html

ScriptRunner 플러그인을 처음 시작한다면 다음 자료들을 보면 좋습니다.

기본 컨셉: https://scriptrunner.adaptavist.com/latest/jira/
tutorialspoint/Groovy: https://www.tutorialspoint.com/groovy/index.htm
webinar: https://www.youtube.com/watch?v=ufNACtDxyD8
ScriptRunner 소개 영상: https://www.youtube.com/watch?v=sJa_bFmPoLU

Adaptavist에서는 따로 교육과정도 있으니 참고하세요.

https://learn.adaptavist.com/course-library/getting-started-with-sr4js
- 4시간짜리 강좌로 JQL, Built-in Script, Behaviours 등을 배울 수 있습니다.
- ScriptRunner 강좌는 이 강좌 밖에 없습니다.
전체 강좌: https://learn.adaptavist.com/course-library
가격은 개인 결제시 350$ 이며 러닝 사이트 내에 있는 모든 강좌를 들을 수 있습니다.
- 결제를 위해 카드 정보까지 다 입력시 계정이 생성되는 것으로 보입니다.
  (포스팅 시 결제까지 진행하지 않아 모르겠습니다.)

ScriptRunner 스크립트 작성

ScriptRunner 플러그인으로 스크립트를 작성할 수 있는 곳은 JIRA 기준으로 다음과 같습니다.

Administration > Add-ons > Behaviours
Administration > Add-ons > ScriptRunner
- Script Console
- Built-in Scripts
- Script Listeners
- Script Fields
- REST Endpoints
- Script Fragments
- Escalation Services
- Script JQL Functions

각 메뉴에서 할 수 있는 일을 정리해보겠습니다.

Behaviours

https://scriptrunner.adaptavist.com/5.5.0/jira/behaviours-overview.html
위의 링크를 참고하면 예제를 따라하면서 어떻게 사용해야할지 알 수 있습니다.
설명은 다음과 같이 나와있습니다.

behaviours 기능을 통해 관리자는 하나 이상의 behaviours를 만들 수 있습니다. behaviours는 주어진 프로젝트 또는 이슈에서 이슈에 대한 필드가 동작하는 방식을 정의합니다. 아래는 예시입니다.

예시

이슈 화면에 입력된 다른 데이터(즉, 이슈 생성 또는 이슈 전환 중)에 따라 필드를 필수 항목으로 지정.
사용자 역할 또는 그룹에 따라 필드를 읽기 전용으로 설정
이슈 화면(스크린)이 제출되기 전에 필드 데이터를 서버 측이 검증 수행
다른 이슈 화면(스크린) 데이터에 따라 필드 값 설정

https://scriptrunner.adaptavist.com/5.5.0/jira/behaviours-overview.html#_examples
링크에서는 예시로 좋은 설명이 1, 2 항목에 있습니다.

이슈 생성 시 기본 Description(설명) 포맷 값 설정
Resolved 처리 시 Resolution이 Fixed 일 경우, Fix Version 입력을 꼭 할 수 있도록 스크린 설정
Live Editing (실시간 코드 작성)

작성하다보니 내용이 많아졌네요.
ScriptRunner 소개 #2 포스트에서 다음 내용들을 다루겠습니다.

ScriptRunner 소개 3