개요
개요
Jira 라이브러리는 사용자가 Jira 서버와 연동하여 ConnectJira, CreateIssue, UpdateIssue, DeleteIssue, AssignIssue, QueryIssues, AddComment, DeleteComment, GetComments등의 작업을 수행할 수 있습니다.
Jira 라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.
Jira 기능: ConnectJira
Issue 관리: CreateIssue, UpdateIssue, DeleteIssue, AssignIssue, QueryIssues
Comment 관리: AddComment, DeleteComment, GetComments
공통 속성
공통 속성
MORE OPTION
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
On Error | 콤보박스 | N | - | N | 오류 발생 시 수행할 동작을 지정합니다. - 미지정: 오류를 출력하고 작업을 종료합니다. - Ignore: 해당 오류를 무시합니다. - Retry: 해당 액티비티를 1회 재시도합니다. - Goto: 해당 엑티비티가 실패한 경우 지정한 엑티비티로 이동하여 시나리오를 수행합니다. - Event: 프로젝트에 등록된 이벤트를 호출합니다. |
DESCRIPTION
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
Description | 문자 | N | - | N | 해당 액티비티 카드에 대한 설명을 추가합니다. Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다. |
ConnectJira
ConnectJira
개요
연결하려는 Jira에 대한 인증을 시작합니다.
사용 절차
[Output] Connection에 연결 정보가 할당될 변수를 입력합니다.
Authentication Type에 인증 유형을 선택합니다.
Server URL에 Jira project url을 입력합니다.
API Token, Client ID, Client Secret은 아래 Jira Developer console에서 발급 및 확인합니다.
https://developer.atlassian.com/console/myapps/
My apps에서 해당 app 선택 > Settings > Authentication details (Client ID, Secret)
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Connection | 변수 | Y | - | N | 연결 정보가 할당될 변수를 입력합니다. |
N | Authentication Type | 콤보박스 | Y | - | N | Jira 서비스에 접근하는데 사용할 인증 유형을 선택합니다. 다음 옵션이 표시됩니다: - API Token - OAuth 2.0 |
N | Server URL | 문자열 | Authentication Type이 API Token이라면 Y, 아니면 N | - | N | Jira project url을 입력합니다. |
N | API Token | 문자열 | Authentication Type이 API Token이라면 Y, 아니면 N | - | N | API Token을 입력합니다. |
N | User email | 문자열 | Authentication Type이 API Token이라면 Y, 아니면 N | - | N | User email을 입력합니다. |
N | Client ID | 문자열 | Authentication Type이 OAuth 2.0이라면 Y, 아니면 N | - | N | Client ID을 입력합니다. |
N | Client Secret | 문자열 | Authentication Type이 OAuth 2.0이라면 Y, 아니면 N | - | N | Client Secret을 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
ConnectJira를 사용하여 Jira에 연결합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
this.connection = 연결 정보가 할당될 변수 this.serverUrl = Jira Project url this.apiToken = 사용자 API 토큰 this.userEmail = 사용자 User Email this.clientId = Jira 계정의 사용자 아이디 this.clientSecret = Jira 계정의 사용자 Secret
사용된 속성
[Output] Connection = this.connection
Server URL = this.serverUrl
API Token = this.apiToken
User email = this.userEmail
Client ID = this.clientId
Client Secret = this.clientSecret
연관/유사 액티비티
CreateIssue
CreateIssue
개요
Jira Issue를 생성합니다.
사용 절차
[Output] Issue에 결과를 저장할 변수를 입력합니다.
[Input] Connection에 연결 정보 변수를 입력합니다.
Project Key에 project key를 입력합니다.
Jira Cloud platform REST API, version 3 기준 default 스키마의 이슈 생성이 가능합니다.
Components는 Jira Project에서 미리 생성한 값을 입력합니다.
(ex> [https://testrpa.atlassian.net/jira/software/c/projects/RPATEST/components)]
Additional Fields는 Jira Project 세팅에서 Fields를 추가한 후 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Issue | 변수 | Y | - | N | 생성된 Issue 결과를 저장할 변수를 입력합니다. |
N | [Input] Connection | 변수 | Y | - | N | 연결 정보 변수를 입력합니다. |
N | Project Key | 문자열 | Y | - | N | Project Key를 입력합니다. |
N | Summary | 문자열 | Y | - | N | Summary를 입력합니다. |
N | Type | 콤보박스 | Y | - | N | Type을 입력합니다. - Epic - Story - Bug - Task |
N | Additional Fields | 문자열 | N | - | N | Additional Fields를 입력합니다.
|
N | Components | 문자열 | N | - | N | Components를 입력합니다.
|
N | Description | 문자열 | N | - | N | Description을 입력합니다. |
N | Attachment | 문자열 | N | - | N | Attachment 경로를 입력합니다. |
N | Parent Issue Key | 문자열 | N | - | N | Parent Issue Key를 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
CreateIssue를 사용하여 Jira Issue를 생성합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
RESULT = 생성된 Issue 정보가 할당될 변수 this.connection = 연결 정보 변수 this.projectKey = Project Key this.summary = Summary this.description = Description
사용된 속성
[Output] Issue = RESULT
[Input] Connection = this.connection
Project Key = this.projectKey
Summary = this.summary
Description = this.description
연관/유사 액티비티
UpdateIssue, DeleteIssue, AssignIssue, QueryIssues
UpdateIssue
UpdateIssue
개요
Jira Issue를 수정합니다.
사용 절차
[Output] Issue에 결과를 저장할 변수를 입력합니다.
[Input] Connection에 연결 정보 변수를 입력합니다.
Issue Key에 Issue key를 입력합니다.
Components는 Jira Project에서 미리 생성한 값을 입력합니다.
(ex> [https://testrpa.atlassian.net/jira/software/c/projects/RPATEST/components)]
Additional Fields는 Jira Project 세팅에서 Fields를 추가한 후 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Issue | 변수 | Y | - | N | 수정된 Issue 결과를 저장할 변수를 입력합니다. |
N | [Input] Connection | 변수 | Y | - | N | 연결 정보 변수를 입력합니다. |
N | Issue Key | 문자열 | Y | - | N | Issue Key를 입력합니다. |
N | UpdateSummary | 토글버튼 | N | - | N | Summary 수정 여부를 지정합니다. |
N | Summary | 문자열 | UpdateSummary가 On이면 Y, 아니면 N | - | N | Summary를 입력합니다. |
N | Additional Fields | 문자열 | N | - | N | Additional Fields를 입력합니다.
|
N | UpdateComponents | 토글버튼 | N | - | N | Components 수정 여부를 지정합니다. |
N | Components | 문자열 | UpdateComponents가 On이면 Y, 아니면 N | - | N | Components를 입력합니다.
|
N | UpdateDescription | 토글버튼 | N | - | N | Description 수정 여부를 지정합니다. |
N | Description | 문자열 | UpdateDescription이 On이면 Y, 아니면 N | - | N | Description을 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
UpdateIssue를 사용하여 Jira Issue를 수정합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
RESULT = 수정된 Issue 정보가 할당될 변수 this.connection = 연결 정보 변수 this.issueKey = IssueKey
사용된 속성
[Output] Issue = RESULT
[Input] Connection = this.connection
Issue Key = this.issueKey
Summary = 'Update Summary'
Components = 'component1;component2'
Description = 'Update Description'
연관/유사 액티비티
CreateIssue, DeleteIssue, AssignIssue, QueryIssues
DeleteIssue
DeleteIssue
개요
Jira Issue를 삭제합니다.
사용 절차
[Input] Connection에 연결 정보 변수를 입력합니다.
Issue Key에 Issue key를 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Input] Connection | 변수 | Y | - | N | 연결 정보 변수를 입력합니다. |
N | Issue Key | 문자열 | Y | - | N | Issue Key를 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
DeleteIssue를 사용하여 Jira Issue를 삭제합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
this.connection = 연결 정보 변수 this.issueKey = IssueKey
사용된 속성
[Input] Connection = this.connection
Issue Key = this.issueKey
연관/유사 액티비티
CreateIssue, UpdateIssue, AssignIssue, QueryIssues
AssignIssue
AssignIssue
개요
Jira Issue Assignee를 할당합니다.
사용 절차
[Output] Issue에 결과를 저장할 변수를 입력합니다.
[Input] Connection에 연결 정보 변수를 입력합니다.
Issue Key에 Issue key를 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Issue | 변수 | Y | - | N | Assign된 Issue 결과를 저장할 변수를 입력합니다. |
N | [Input] Connection | 변수 | Y | - | N | 연결 정보 변수를 입력합니다. |
N | Issue Key | 문자열 | Y | - | N | Issue Key를 입력합니다. |
N | Assignee | 문자열 | Y | - | N | Assignee를 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
AssignIssue를 사용하여 Jira Issue Assignee를 할당합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
this.connection = 연결 정보 변수 this.issueKey = IssueKey this.assignee = Assignee
사용된 속성
[Output] Issue = RESULT
[Input] Connection = this.connection
Issue Key = this.issueKey
Assignee = this.assignee
연관/유사 액티비티
CreateIssue, UpdateIssue, DeleteIssue, QueryIssues
QueryIssues
QueryIssues
개요
JQL을 활용하여 Jira Issue를 조회합니다.
사용 절차
[Output] Issue에 결과를 저장할 변수를 입력합니다.
[Input] Connection에 연결 정보 변수를 입력합니다.
JQL에 jql 쿼리를 입력합니다.
Output의 Issues는 1차원 배열 형태로 확인합니다.
issues[0]
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Issue | 변수 | Y | - | N | Assign된 Issue 결과를 저장할 변수를 입력합니다. |
N | [Input] Connection | 변수 | Y | - | N | 연결 정보 변수를 입력합니다. |
N | JQL | 문자열 | Y | - | N | JQL을 입력합니다. |
N | Max Results | 숫자 | Y | - | N | Max Results를 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
QueryIssues를 사용하여 Jira Issue를 조회합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
this.connection = 연결 정보 변수
사용된 속성
[Output] Issue = RESULT
[Input] Connection = this.connection
JQL = 'project = "RPATEST"'
Max Results = 50
연관/유사 액티비티
CreateIssue, UpdateIssue, DeleteIssue, AssignIssue
AddComment
AddComment
개요
Jira Issue에 comment를 추가합니다.
사용 절차
[Output] Comment에 결과를 저장할 변수를 입력합니다.
[Input] Connection에 연결 정보 변수를 입력합니다.
Issue Key에 issue key를 입력합니다.
Format된 Comment는 아래와 같은 형식으로 입력합니다.
Bold: *comment*
Italic: _comment_
Underline: +comment+
Strikethrough: -comment-
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Comment | 변수 | Y | - | N | 입력된 Comment 결과를 저장할 변수를 입력합니다. |
N | [Input] Connection | 변수 | Y | - | N | 연결 정보 변수를 입력합니다. |
N | Issue Key | 문자열 | Y | - | N | Issue Key를 입력합니다. |
N | Comment | 문자열 | Y | - | N | Comment를 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
AddComment를 사용하여 Jira comment를 입력합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
this.connection = 연결 정보 변수 this.issuekey = Issue Key
사용된 속성
[Output] comment = RESULT
[Input] Connection = this.connection
Issue Key = this.issueKey
Comment = 'sample comment'
연관/유사 액티비티
DeleteComment
DeleteComment
개요
Jira Issue의 comment를 삭제합니다.
사용 절차
[Input] Connection에 연결 정보 변수를 입력합니다.
Issue Key에 issue key를 입력합니다.
Comment ID에 삭제하고자 하는 comment ID를 입력합니다.
삭제를 하고자하는 comment의 'Copy link to comment'를 통해 Comment Id를 얻어옵니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Input] Connection | 변수 | Y | - | N | 연결 정보 변수를 입력합니다. |
N | Issue Key | 문자열 | Y | - | N | Issue Key를 입력합니다. |
N | Comment ID | 문자열 | Y | - | N | 삭제하고자 하는 Comment ID를 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
DeleteComment를 사용하여 Jira comment를 삭제합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
this.connection = 연결 정보 변수 this.issuekey = Issue Key this.commentID = Comment ID
사용된 속성
[Output] Issue = RESULT
[Input] Connection = this.connection
Issue Key = this.issueKey
Comment ID = this.commentID
연관/유사 액티비티
GetComments
GetComments
개요
Jira Issue의 comment를 조회합니다.
사용 절차
[Output] Comments에 결과를 저장할 변수를 입력합니다.
[Input] Connection에 연결 정보 변수를 입력합니다.
Issue Key에 issue key를 입력합니다.
Output의 Comments는 1차원 배열 형태로 확인합니다.
comments[0]
Format된 Comment는 아래와 같은 형식으로 표시됩니다.
Bold: *comment*
Italic: _comment_
Underline: +comment+
Strikethrough: -comment-
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Comments | 변수 | Y | - | N | 조회된 Comment 결과를 저장할 변수를 입력합니다. |
N | [Input] Connection | 변수 | Y | - | N | 연결 정보 변수를 입력합니다. |
N | Issue Key | 문자열 | Y | - | N | Comment를 조회할 Issue Key를 입력합니다. |
Y | MORE OPTIONS | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
Y | DESCRIPTION | - | - | - | - | Jira 라이브러리의 공통 속성입니다. |
활용 예시
GetComments를 사용하여 Jira comment를 조회합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Jira
사용된 변수
this.connection = 연결 정보 변수 this.issuekey = Issue Key
사용된 속성
[Output] comments = RESULT
[Input] Connection = this.connection
Issue Key = this.issueKey
연관/유사 액티비티