스마트 값
- 이병욱
- 1 스마트 값이란 무엇인가요?
- 1.1 스마트 값 포맷
- 1.2 스마트 값 찾기
- 1.2.1 스마트 값 테스트
- 1.3 스마트 값 함수 체인
- 1.4 섹션 및 목록과 함께 스마트 값 사용
- 1.5 기본값
- 1.6 자신만의 스마트 값 생성
스마트 값이란 무엇인가요?
스마트 값을 사용하면 Jira 내에서 이슈 데이터에 액세스하고 조작할 수 있습니다. 이러한 기능은 규칙에 상당한 힘과 복잡성을 가중시킬 수 있습니다. 예를 들어 스마트 값{{now.plusDays(5)}}는 현재 시간을 참조하고 여기에 5일을 추가합니다. 그리고 {{issue.summary}}는 이슈의 요약을 출력합니다.
예제
스마트 값을 사용하여 전환 시 이슈에 코멘트를 추가하고 이슈의 보고자와 피할당자의 이름을 지정할 수 있습니다.
Hi {{reporter.displayName}}
We're now looking into your issue {{issue.summary}}.
We'll get back to you soon with an update.
{{assignee.displayName}}스마트 값 포맷
스마트 값은 Mustache 라이브러리를 사용하여 임의 코드가 실행되지 않도록 합니다. 대체하려면 값을 이중 곱슬 괄호로 묶어야 합니다.(예: {{value}})
마침표를 사용하여 하위 요소를 참조합니다.(예: {{issue.key}})
스마트 값 찾기
대부분의 경우 참조 문서에서 스마트 값을 선택할 수 있습니다.
이슈 데이터와 관련된 스마트 값 : 스마트 값 - 일반 참조
다중 값(예: 주석, 수정 버전, 관찰자)을 포함하는 목록 및 속성과 관련된 스마트 값 : 스마트 값 - 목록 참조
텍스트 필드(예: 요약, 설명)와 관련된 스마트 값 : 스마트 값 - 텍스트 필드 참조
사용자 데이터와 관련된 스마트 값(예: 피할당자, 보고자) : 스마트 값 - 사용자 참조
개발 정보와 관련된 스마트 값(예: 빌드, 꺼내기 요청) : 스마트 값 - 개발 참조
날짜 및 시간과 관련된 스마트 값 : 스마트 값 - 날짜 및 시간 기능 참조
숫자 식과 관련된 스마트 값 : 스마트 값 - 산술식 참조
JSON 기능과 관련된 스마트 값 : 스마트 값 - JSON 기능 참조
사용자 지정 필드 이름(예: {{issue.Team Leader}})을 사용하여 사용자 지정 필드의 값에 액세스할 수 있습니다. 필드 이름은 대소문자를 구분하지 않으며, 규칙 플레이어의 언어 설정을 사용하여 변환됩니다.
인스턴스가 많이 커스터마이징된 경우 REST API를 조사하여 올바른 스마트 값을 찾아야 합니다.
스마트 값 테스트
스마트 값이 반환하는 항목을 테스트하려면:
스마트 값 함수 체인
스마트 기능을 체인으로 지정하여 한 번에 여러 변환을 적용할 수 있습니다.
다음 예제를 보면, 이슈의 요약을 소문자로 변경할 수 있으며 처음 10자만 사용하고 끝에 !!를 추가할 수 있습니다.
{{issue.summary.toLowerCase().substring(0, 10).concat("!!")}}섹션 및 목록과 함께 스마트 값 사용
여러 항목이 있는 스마트 값으로 작업할 때 스마트 값으로 #을 사용하여 목록의 모든 항목에 규칙을 적용할 수 있습니다. 예를 들어 스마트 값 {{issue.comments}}는 이슈의 코멘트를 액세스하고 반환하는데 사용됩니다. 그러나 이슈에 여러 개의 설명이 있는 경우 스마트 값 {{#issue.comments}}는 각 코멘트에 대해 규칙을 개별적으로 반복하도록 합니다. #을 사용할 때는 식을 {{/}}로 닫아야 합니다.
예를 들어, 코멘트 작성자 목록을 출력하려면:
{{#issue.comments}}Author: {{author.displayName}}{{/}}항목을 숫자로 처리하려면 산술 함수를 사용할 때 {{#=}}을 사용하십시오. 예를 들어 Invoice Amount사용자 정의 필드에 100을 추가하려면:
기본값
필드 또는 값이 없으면 빈 값 {{invalid reference}}이 반환됩니다. 기본값을 지정하여 이를 방지할 수 있습니다.
예를 들어 잘못된 참조에 값이 없는 경우 {{invalid reference|"Hello world"}}를 사용하여 “Hello world”를 인쇄할 수 있습니다.
자신만의 스마트 값 생성