Jira Cloud 자동화 smart value 사용 가이드

이 문서는 Jira Cloud에서 제공하는 자동화 기능 중 smart value 사용 방법을 정리한다.

원본 문서 : https://support.atlassian.com/jira-software-cloud/docs/smart-values-general/

개념

• smart value를 사용하면 Jira issue 데이터에 접근이 가능하다.

          예를 들어, 하단의 표를 참고하여 {{issue.key}} {{issue.description}}와 같은 smart value를 사용하여 이슈키, 이슈의 설명이 포함된 메일&Slack을 보내거나 필드의 값을 채워넣을 수 있다.

• smart value의 종류는 Smart values - general에서 검색한다.
  
  smart value의 종류 중 {{issue.[property]}} 

  	{{issue.[property]}} available property	description
  fields	{{issue.description}}	이슈의 "설명" 필드의 값 반환
  	{{issue.key}}	이슈의 "Key" 반환
  	{{issue.status}}	이슈의 "상태" 반환
  	{{issue.status.name}}	이슈의 "상태" 반환
  	{{issue.summary}}	이슈의 "제목" 반환
  	{{issue.versions}}	이슈의 "버전" 반환
  	{{issue.issueType.name}}	이슈의 "이슈 유형" 반환
  	{{issue.resolution}}	이슈의 "해결" 반환
  	{{issue.updated}}	이슈의 "업데이트 된 날짜" 반환
  	{{issue.Story Points}}	이슈의 "스토리 포인트" 반환 (company-managed Jira Software Cloud only)
  	{{issue.Story Points estimate}}	이슈의 "스토리 포인트" 반환 (team-managed Jira Software Cloud only)
  dates	{{issue.created}}	이슈의 "생성 날짜" 반환
  	{{issue.duedate}}	이슈의 "마감일" 반환
  users	{{issue.assignee.displayName}}	이슈의 "담당자" 반환
  	{{issue.reporter.displayName}}	이슈의 "보고자" 반환

예시

이슈 생성 시 댓글로 해당 이슈 데이터 남기기

1. smart value로 Jira issue 데이터 값을 받아와 댓글 자동 생성
   - {{issue.summery}} : 이슈 제목
   - {{issue.key}} : 이슈 키
   - {{issue.created.format("dd/MM/yyyy")}} : 이슈생성 날짜 (형식 : "dd/MM/yyyy")
   - {{issue.assignee.displayName}} : 담당자
   
   
   
2. 이슈생성 후 자동 생성된 댓글
   

# Symbol

• smart value는 여러개의 데이터를 가질 수 있다.

          예를 들어, issue의 컴포넌트, 댓글, (fix) version, change log, 지켜보는 사람 등의 smart vaule의 데이터는 여러개가 있을 수 있다.

• "#"은 여러개의 데이터를 가진 smart value에 사용한다.

• "#" 을 사용하면 {{/}}로 반드시 닫아주어야 한다.
  {{#issue.comments}} Author: {{author.displayName}}{{/}}
  
  

• 예시
  여러개의 댓글 정보를 해당 이슈의 설명 필드값에 채우기

  1. 댓글이 3개 존재
  
  
  2. 해당 이슈의 설명 필드 값에 댓글 정보를 입력하는 자동화 규칙 생성

   원본 펼치기

  {{#issue.comments}}
  Comment by: {{author.displayName}} at:{{created.format("dd/MM/yyyy")}}
  {{body}}
  {{/}}

  
  
  3. 규칙 실행 후 3개의 댓글에 대한 정보가 이슈의 설명 필드에 업데이트
  
  

Smart value 반환값 테스트하기

 smart value가 반환하는 내용을 테스트하려면 로그(Log)와 함께 수동 트리거(Manual Trigger)를 사용합니다.

1. 규칙 만들기 선택하기
   
   
   
2. 수동 트리거 선택하기
   
   
   
3. 동작 추가하기
   
   
   
4. 로그 작업 선택하기
   
   
   
5. 반환하고 싶은 smart value 입력하기
   ex) {{reporter.displayName}} created {{issue.summary}}({{issue.key}}) : 보고자 이름, 이슈 제목, 이슈 키 반환을 테스트
   
   
   
6. 이름 지정 후 저장하기
   
   
   
7. 이슈로 이동>Automation의 Rule executions 클릭
   
   
   
8. 1~6단계에서 만든 규칙 선택 후 run 클릭
   
   
   
9. Recent rule executions 하단에 실행 완료된 규칙 link 클릭
   
   
   
10. smart value 반환값 확인
    1) 규칙 세부 정보 페이지 > 감사 로그 클릭
    2) smart value 반환값 확인  {{reporter.displayName}} created {{issue.summary}}({{issue.key}})
       - reporter.displayName = kimnawoo
       - issue.summary = 테스트얌
       - issue.key = STP-1
    3) 해당 이슈로 이동