스마트 값 - 일반

{{issue.[property]}}

이슈 스마트 값은 규칙의 활성 이슈와 관련된 정보, 즉 규칙이 현재 작동 중인 이슈에 액세스하는데 사용됩니다.

이슈에 대해 액세스할 수 있는 정보는 아래의 사용 가능한 속성 섹션에 설명되어 있습니다. 일부 이슈 속성은 더 복잡하며, 이 페이지의 각 섹션에서 설명합니다.

사용 가능한 속성

이슈 필드

• {{issue.description}} - 이슈의 설명 필드에 있는 내용을 반환합니다.

• {{issue.key}} - 프로젝트 키와 이슈 번호로 구성된 고유 식별자인 이슈 키를 반환합니다.(예: PROJ-123)

• {{issue.status}} - 이슈의 상태를 반환합니다.

• {{issue.status.name}} - 이슈의 상태를 반환합니다.

• {{issue.summary}} - 이슈 요약을 반환합니다.

• {{issue.versions}} - 이슈의 영향 버전을 반환합니다.

• {{issue.issueType}} - 이슈 유형(예: 스토리, 버그 또는 작업)을 반환합니다.

• {{issue.resolution}} - 이슈의 해결책을 반환합니다.

• {{issue.updated}} - 이슈가 업데이트된 날짜를 반환합니다. 다른 날짜 및 시간 스마트 값과 결합할 수 있습니다. 

• {{issue.Story Points}} - 이슈의 스토리 포인트 추정치를 반환합니다(클래식 Jira Software Cloud만 해당).

• {{issue.Story Points estimate}} - 이슈의 스토리 포인트 추정치를 반환합니다(차세대 Jira Software Cloud만 해당).

이슈 날짜

이러한 값은 다른 날짜 및 시간 스마트 값과 결합할 수 있습니다. 

• {{issue.created}} - 이슈의 생성 날짜를 반환합니다.

• {{issue.duedate}} - 이슈의 만료 날짜를 반환합니다.

이슈 사용자

이러한 값은 다른 사용자 스마트 값과 결합할 수 있습니다. 

• {{issue.assignee.displayName}} - 이슈의 피할당자를 반환합니다.

• {{issue.reporter.displayName}} - 이슈의 보고자를 반환합니다.

{{issue.[Custom Field]}}

{{issue.[property]}}와 마찬가지로 이슈에 대한 사용자 지정 필드 정보에 액세스 할 수 있습니다.

사용 가능한 속성

• {{issue.[Custom Field].id}} - Jira가 할당한 필드의 고유 ID를 반환합니다. 변경이 불가하므로 이름대신 사용하는 것이 좋습니다.

• {{issue.[Custom Field].description}} - 단순 검색 열에 표시된 사용자 지정 필드 아래에 표시된 텍스트를 반환합니다.

• {{issue.[Custom Field].name}} - 필드 왼쪽에 표시된 표시 레이블을 반환합니다.

• {{issue.[Custom Field].defaultValue}} - 필드의 첫 번째 보기에 표시된 값을 반환합니다.

예제

아래 예제에서는 팀 리더라는 사용자 정의 필드가 있으며, 이 필드의 값은 현재 Alana Grant입니다.

{{issue.affectedServices}}

Jira Service Management 요청에만 해당됩니다. 이슈의 영향을 받는 서비스 필드의 값에 액세스합니다.

이 스마트 값은 여러 항목(즉, 이슈에는 많은 수정 버전이 있을 수 있음)을 처리하기 때문에 # 기호와 함께 사용하여 각 개별 수정 버전에 규칙을 적용할 수 있습니다. 

사용 가능한 속성

• {{issue.affectedServices.name}} - 이슈의 영향을 받는 서비스 이름을 반환합니다.

• {{issue.affectedServices.tier}} - 이슈의 영향을 받는 서비스의 계층을 반환합니다.

• {{issue.affectedServices.changeApprovers}} - 이슈 서비스의 모든 변경 승인자의 계정 ID를 반환합니다. 다른 사용자 관련 스마트 값과 결합할 수 있습니다. 예를 들어, {{issue.affectedServices.changeApprovers.displayName}}은 이름을 반환합니다. 

• {{issue.affectedServices.dependentServices}} - 이 이슈의 서비스가 종속된 서비스 목록을 반환합니다. 위의 세 가지 속성을 여기에 추가할 수도 있습니다. 예를 들어,{{issue.affectedServices.dependentServices.tier}}은 종속 서비스의 계층을 반환합니다.

{{issue.comments}}

이슈의 설명을 반환합니다. 이 스마트 값은 여러 항목(즉, 일반적으로 코멘트가 많은 이슈)을 처리하기 때문에 # 기호와 함께 사용하여 각 개별 코멘트에 규칙을 적용할 수 있습니다.

사용 가능한 속성

• {{issue.comments.last.body}} - 마지막 코멘트의 본문을 반환합니다.

• {{issue.comments.first.body}} - 첫 번째 코멘트의 본문을 반환합니다.

• {{issue.comments.reverse.body}} - 이슈의 코멘트를 역순으로 반환합니다.

• {{issue.comments.size}} - 이슈에 대한 코멘트 수를 반환합니다.

• {{issue.comments.author.displayName}} - 코멘트 작성자를 반환합니다.

예제

다음 예에서는 이슈에 대한 각 의견을 나열하고 작성자 및 작성 날짜/시간을 포함합니다 :

이 예에서는 이슈에 대한 마지막 설명을 추가한 사람의 이름을 반환합니다 :

{{issue.components}}

이슈의 구성 요소 필드에 있는 값에 액세스하는 데 사용됩니다. 이 스마트 값은 여러 항목(즉, 이슈가 많은 구성요소를 가질 수 있음)을 처리하기 때문에 # 기호와 함께 사용하여 각 개별 구성요소에 규칙을 적용할 수 있습니다.

사용 가능한 속성

• {{issue.components.name}} - 이슈의 구성 요소 필드 값을 반환합니다.

{{issue.epic}}

이슈 에픽에 대한 정보에 액세스하는 데 사용됩니다. 이 스마트 값은 에픽에 추가된 이슈에만 적용됩니다.

사용 가능한 속성

• {{issue.epic.key}} - 에픽의 키(예: PROJ-213)를 반환합니다.

• {{issue.epic.status.name}} -  에픽의 상태를 반환합니다. 예: 진행 중

• {{issue.epic.[Custom Field]}} - 에픽의 사용자 지정 필드에 값을 반환합니다. 예를 들어 에픽에 Initiative라는 사용자 지정 필드가 있는 경우{{issue.epic.Initiative}}는 Initiative 필드의 값을 반환합니다.

{{issue.fixVersions}}

이슈의 수정 버전 필드에 있는 값에 액세스하는 데 사용됩니다. 이 스마트 값은 여러 항목(즉, 이슈에는 많은 수정 버전이 있을 수 있음)을 처리하기 때문에 # 기호와 함께 사용하여 각 개별 수정 버전에 규칙을 적용할 수 있습니다.

사용 가능한 속성

• {{issue.fixVersions.name}} - 수정 버전의 이름을 반환합니다.

• {{issue.fixVersions.description}} - 수정 버전에 대한 설명을 반환합니다.

• {{issue.fix.Versions.archived}} - 수정 버전이 아카이브되면 true를 반환하고, 아카이브되지 않으면 false를 반환합니다.

• {{issue.fixVersions.released}} - 수정 버전이 릴리스되면 true를 반환하고, 릴리스되지 않은 경우에는 false를 반환합니다.

• {{issue.fixVersions.releaseDate}} - 수정 버전의 릴리스 날짜를 반환합니다. 다른 날짜 및 시간 스마트 값과 결합할 수 있습니다.

예제

아래 예제에서는 이슈가 추가된 각 수정 버전을 게시점 형식으로 나열합니다.

{{issue.latest}}

이슈 키 및 상태(예 : 할 일, 진행 중 또는 완료)를 출력합니다.

사용 가능한 속성

• {{issue.latest.description}} - 상태 설명을 반환합니다.

{{issue.parent}}

하위 작업의 상위 이슈에 대한 세부 정보에 액세스합니다. 활성 이슈가 하위 작업인 경우에만 사용할 수 있으며 표준 이슈의 상위 이슈에 액세스하는데 사용할 수 없습니다.

사용 가능한 속성

• {{issue.parent.key}} - 상위 이슈의 이슈 키를 반환합니다.

• {{issue.parent.priority.name}} - 상위 이슈의 우선 순위를 반환합니다.

• {{issue.parent.Epic Link}} - 상위 이슈의 에픽 이슈 키를 반환합니다.

• {{issue.parent.epic.summary}} - 상위 이슈의 에픽 요약을 반환합니다.

{{issue.properties}}

모든 이슈 속성에 액세스합니다. 속성은 추가 기능 및 통합에서 다음과 같은 값을 저장하는데 자주 사용됩니다 : {{issue.properties.some.value}}.

{{issue.Request Type}}

Jira Service Management 요청에서 정보에 액세스합니다.

사용 가능한 속성

• {{issue.Request Type.requestType.name}} - 고객 요청 유형을 반환합니다.

• {{issue.Request Type.currentStatus.status}} - 현재 요청의 상태를 반환합니다.

• {{issue.Customer Request Type}} - 이전 Jira 인스턴스에 대한 고객 요청 유형을 반환합니다.

{{issue.security}

보안 수준의 텍스트입니다.

사용 가능한 속성

• {{issue.security.name}} - 보안 수준 이름을 반환합니다.

• {{issue.security.id}} - 보안 수준 ID를 반환합니다.

{{issue.url}}

이슈에 액세스할 URL입니다. Jira Service Management 요청에 대한 고객 포털 URL도 제공합니다.

사용 가능한 속성

• {{issue.url}} - 이슈의 URL을 반환합니다.

• {{issue.url.customer}} - 고객 포털 URL을 반환합니다(Jira Service Management 요청 용).

{{issue.versions}}

이슈의 영향 버전 필드에 있는 값에 액세스합니다. 이 스마트 값은 여러 항목(즉, 이슈에는 여러 가지 영향 버전이 있을 수 있음)을 처리하기 때문에 # 기호와 함께 사용하여 각 개별 구성 요소에 규칙을 적용할 수 있습니다.

사용 가능한 속성

• {{versions.name}} - 영향 버전의 이름을 반환합니다.

• {{versions.description}} - 영향 버전에 대한 설명을 반환합니다.

• {{versions.archived}} - 영향 버전이 아카이브되면 true를 반환하고, 아카이브되지 않으면 false를 반환합니다.

• {{versions.released}} - 영향 버전이 릴리스되면 true를 반환하고, 릴리스되지 않은 경우에는 false를 반환합니다.

• {{versions.releaseDate}} - 영향을 받는 버전의 릴리스 날짜를 반환합니다. 다른 날짜 및 시간 스마트 값과 결합할 수 있습니다. 

예제

아래 예제에서는 이 이슈의 첫 번째 영향 버전이 출력됩니다.

{{issue.watchers}}

이슈의 현재 관찰자에 액세스합니다. 이 스마트 값은 여러 항목(즉, 이슈에 많은 관찰자가 있을 수 있음)을 처리하기 때문에 # 기호와 함께 사용하여 각 개별 구성 요소에 규칙을 적용할 수 있습니다.

사용 가능한 속성

• {{issue.watchers.displayName}} - 관찰자의 표시 이름을 반환합니다.

• {{issue.watchers.emailAddress}} - 관찰자의 전자 메일 주소를 반환합니다.

예제

아래 예제는 이슈를 보고 있는 각 사용자(표시 이름 및 전자 메일 주소 모두)를 글머리 기호 형식으로 나열합니다.

{{lookupIssues}}

이슈 조회 액션으로 인해 발생한 JQL 검색의 이슈 목록을 반환합니다.

사용 가능한 속성

• {{key}} - 이슈 키를 반환합니다.

• {{url}} - 이슈 URL을 반환합니다.

• {{summary}} - 이슈 요약을 반환합니다.

• {{assignee.displayName}} -  피할당자를 반환합니다.

• {{reporter.displayName}} -  보고자를 반환합니다.

• {{status}} - 상태를 반환합니다.

• {{issueType}} - 이슈 유형을 반환합니다.

• {{resolution}} - 해결책 상태를 반환합니다.

• {{fixVersion}} - 수정 버전을 반환합니다.

• {{created}} - 이슈가 생성된 날짜를 반환합니다.

• {{updated}} - 이슈가 업데이트된 날짜를 반환합니다.

• {{Story Points}} - 이슈에 대한 스토리 포인트를 반환합니다(클래식 Jira software).

• {{Story point estimate}} - 이슈에 대한 스토리 포인트를 반환합니다(차세대 Jira software).

예제

다음은 JQL 검색에서 반환된 모든 이슈 키를 글머리 기호 형식으로 출력하는 예제입니다 :

다음 예제에서는 JQL 검색에서 반환된 이슈에 대한 모든 스토리 포인트를 요약합니다:

{{triggerIssue}}

규칙을 트리거한 원래 이슈를 참조하며, 체인을 분기할 때 사용됩니다. 관련 이슈 조건과 함께 사용됩니다. {{issue}}에서 사용할 수 있는 모든 속성은 이 스마트 값에서도 사용할 수 있습니다.

{{attachment}}

이슈의 파일 첨부와 관련된 정보에 액세스합니다.

사용 가능한 속성

• {{attachment.filename}}: 첨부 파일의 파일 이름을 반환합니다.

• {{attachment.mimeType}}: 첨부 파일의 파일 형식을 반환합니다.

• {{attachment.created}}: 첨부 파일이 이슈에 추가된 날짜와 시간을 반환합니다.

• {{attachment.size}}: 첨부 파일 크기를 바이트 단위로 반환합니다.

• {{attachment.author}}: 첨부 파일을 추가한 사용자를 반환합니다.

  • {{attachment.author.accountId}}: 사용자 이름과 연결된 ID를 반환합니다.

  • {{attachment.author.emailAddress}}: 사용자 이름과 연결된 전자 메일 주소를 반환합니다.

  • {{attachment.author.displayName}}: Jira 인스턴스에 표시된 이름을 반환합니다.

  • {{attachment.author.active}}: 계정이 활성 상태인 경우 true를 반환하고, 활성 상태가 아닌 경우 false를 반환합니다.

  • {{attachment.author.timeZone}}: 사용자가 등록되어 있는 시간대를 반환합니다. 사용자가 로그인하는 위치에 따라 동적으로 변경되지 않으며 사용자 계정에 등록된 시간대가 됩니다.

{{baseUrl}}

Jira 인스턴스의 URL을 출력합니다.

{{changelog}}

• 이슈를 편집하는 모든 트리거와 함께 사용

이 스마트 값은 변경 로그 및 각 필드의 변경사항 목록에 액세스합니다. 예를 들어 이슈가 전환될 때 전환된 상태를 확인할 수 있습니다.

사용 가능한 속성

• {{changelog.summary}} - Summary 필드에 대한 로그 정보를 변경합니다.

• {{changelog.issuetype}} - 이슈 유형 필드에 대한 로그 정보를 변경합니다.

• {{changelog.status}} - 상태 필드에 대한 로그 정보를 변경합니다.

예제

이 예제에서는 이슈 요약 필드가 변경된 후 새 값을 반환합니다 :

이 예제에서는 이슈의 이전 유형을 변경한 후 반환합니다 :

이 예제에서는 전환된 이슈에 대한 이전 상태를 보여 줍니다 :

이 예제는 이전 상태 ID를 보여줍니다(다른 편집 작업에 사용하기 위해) :

{{comment}}

• 이슈 코멘트 트리거와 함께 사용

코멘트가 결과로 추가되더라도(예: 이슈 전환 트리거) 이 값은 다른 트리거에서는 작동하지 않습니다.

사용 가능한 속성

• {{comment.body}} - 규칙을 트리거한 코멘트 본문을 반환합니다.

• {{comment.author}} - 코멘트 작성자의 ID를 반환합니다.

• {{comment.created}} - 코멘트의 날짜와 시간을 반환합니다.

• {{comment.visibility.type}} - 코멘트 제한 유형이 있는 경우 반환합니다.(예: 역할)

• {{comment.visibility.value}} - 코멘트 제한 레이블을 반환합니다.(예: 개발자)

• {{comment.internal}} - Jira Service Management 코멘트의 경우 고객이 코멘트를 볼 수 있는 경우 false를 반환합니다.

• {{comment.properties}} - 모든 코멘트 속성에 액세스합니다. 속성은 추가 기능 및 통합에서 값을 저장하는데 자주 사용됩니다.

예제

아래 예제에서는 누군가가 이슈에 코멘트를 추가했다는 알림을 보냅니다.

{{comment.id}}

이슈 설명, 이슈 전환 또는 이슈 업데이트와 같은 코멘트를 추가하는 트리거에서 사용됩니다. 규칙을 트리거하는 설명은 이 스마트 값에 저장됩니다.

{{createdIssue}}

규칙에 생성된 이전 이슈에 액세스합니다.

사용 가능한 속성

{{issue}} 스마트 값과 함께 사용되는 모든 속성을 {{createdIssue}}와 함께 사용할 수 있습니다.

{{createdIssues}}

• 이슈 복제, 이슈 생성 및 하위 작업 생성 액션과 함께 사용

규칙에 생성된 이슈의 목록입니다.

사용 가능한 속성

{{issue}} 스마트 값과 함께 사용되는 모든 속성을 {{createdIssue}}와 함께 사용할 수 있습니다.

{{eventType}}

규칙을 트리거한 이벤트 유형입니다. 예를 들어, jira:issue_updated:issue_commented가 있습니다.

{{fieldChange}}

스마트 값이 지원되는 모든 위치에서 변경된 필드의 값에 액세스할 수 있습니다. 예를 들어, 피할당자 필드를 변경할 경우, 이슈에 설명을 추가하여 이전 피할당자가 누구이고 새 피할당자가 누구인지를 기록할 수 있습니다.

필드가 여러 개 변경된 경우 {{fieldChange}}에는 첫 번째 변경된 값만 포함됩니다. 값이 여러 개 변경된 경우 #를 사용하여 이 값을 반복합니다. 예를 들어 여러 수정 버전을 설정할 때 {{#changelog.fixVersion}}{{toString}}를 사용하여 수정 버전을 반복할 수 있습니다.

사용 가능한 속성

• {{fieldChange.fromString}} - 표시된 대로 이전 값을 반환합니다.

• {{fieldChange.toString}} - 표시된 대로 새 값을 반환합니다.

• {{fieldChange.from}} - 선택한 필드에 대한 이전 raw 값을 반환합니다.

• {{fieldChange.to}} - 선택한 필드에 대한 새 raw 값을 반환합니다.

{{rule}}

현재 실행 중인 규칙에 대한 정보에 액세스합니다.

사용 가능한 속성

• {{rule.name}} - 현재 실행 중인 규칙의 이름을 반환합니다.

• {{rule.actor}} - 규칙 행위자 사용자에게 액세스합니다.

{{Sprint}}

• 스프린트 생성, 시작 또는 완료 트리거와 함께 사용

규칙을 트리거한 스프린트와 관련된 정보에 액세스합니다.

사용 가능한 속성

• {{sprint.id}} - 스프린트 ID를 반환합니다.

• {{sprint.name}} - 스프린트 이름을 반환합니다.

• {{sprint.isStarted}} - 스프린트가 시작된 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

• {{sprint.isClosed}} - 스프린트가 닫히면 true를 반환하고, 닫히지 않으면 false를 반환합니다.

• {{sprint.startDate}} - 스프린트의 시작 날짜를 반환합니다.

• {{sprint.endDate}} - 스프린트의 종료 날짜를 반환합니다.

• {{sprint.completeDate}} - 스프린트가 완료로 표시된 날짜를 반환합니다.

• {{sprint.originBoardId}} - 스프린트가 속한 보드의 ID를 반환합니다.

• {{sprint.goal}} - 스프린트 목표를 반환합니다.

{{version}}

• 버전 생성, 업데이트, 릴리스 트리거와 함께 사용

규칙을 트리거한 버전의 정보에 액세스합니다.

사용 가능한 속성

• {{version.name}} - 버전 이름을 반환합니다.

• {{version.id}} - 버전의 ID를 반환합니다.

• {{version.description}} - 버전의 설명을 반환합니다.

• {{version.archived}} - 버전이 아카이브된 경우 true를 반환하고 아카이브되지 않은 경우 false를 반환합니다.

• {{version.startDate}} - 버전의 시작 날짜를 반환합니다.

• {{version.released}} - 버전이 릴리스되면 true를 반환하고 릴리스되지 않은 경우에는 false를 반환합니다.

• {{version.releaseDate}} - 버전의 릴리스 날짜를 반환합니다.

• {{version.project.key}} - 버전이 속한 프로젝트의 프로젝트 키를 반환합니다.

{{webhookData.[value].[childValue]}}

• 웹훅 수신 트리거와 함께 사용

웹훅 수신과 함께 전송된 데이터(예: 웹훅 요청 본문)에 액세스할 수 있습니다.

{{webhookResponse}}

• 보내는 웹 요청 전송 액션과 함께 사용(응답 대기 활성화)

요청이 성공하면 사용 가능한 스마트 값을 사용하여 웹훅 응답 데이터에 액세스할 수 있습니다. 웹훅 응답이 여러개 있는 경우 # 기호를 추가하여 각 개별 응답에 규칙을 적용할 수 있습니다.

사용 가능한 속성

• {{webhookResponse.status}} - 응답 코드(예: 200)

• {{webhookResponse.headers}} - 도트네이션으로 액세스할 수 있는 머리말

• {{webhookResponse.headers.Content-Type}} - 머리말 컨텐츠 유형

• {{webhookResponse.body}} - 도트네이션으로 액세스할 수 있는 본문

• {{webhookResponse.body.name}} - 본문의 이름

• {{webhookResponses}} - 작업 목록 작성 시 응답 목록

예제

스마트 값을 사용하여 여러 응답을 반환하는 방법은 다음과 같습니다 :

{{worklog}}

• 작업 기록 트리거와 함께 사용

이슈에 대해 방금 기록된 작업 기록 항목의 정보에 액세스합니다.

사용 가능한 속성

• {{worklog.comment}} - 작업 기록의 코멘트를 반환합니다.

• {{worklog.started}} - 작업 기록이 시작된 경우 반환합니다.

• {{worklog.timeSpentSeconds}} - 작업 기록에 소요시간을 초 단위로 반환합니다.

• {{worklog.timeSpent}} - 작업 기록에 소요시간을 반환합니다.

• {{worklog.visibility}} - 작업 로그가 제한된 경우 사용 가능하게 합니다.

• {{worklog.visibility.type}} - 작업 로그가 제한된 경우 사용 가능하게 합니다.

• {{worklog.visibility.value}} - 작업 로그가 제한된 경우 사용 가능하게 합니다.

{{issue.InsightField}}

인사이트 필드의 전체 이름, 키 또는 요약에 액세스합니다.

사용 가능한 속성

• {{issue.InsightField}} - 인사이트 필드의 이슈 이름을 반환합니다.

• {{issue.InsightField.key}} - 인사이트 필드의 이슈 키를 반환합니다.

• {{issue.InsightField.summary}} - 인사이트 필드의 이슈 요약을 반환합니다.

{{issue.TempoAccountField}}

Tempo Account 필드의 속성에 액세스합니다.

사용 가능한 속성

• {{issue.TempoAccountField}} - 계정의 이름을 반환합니다.

• {{issue.TempoAccountField.id}} - 계정의 ID를 반환합니다.

• {{issue.TempoAccountField.name}} - 계정 이름을 반환합니다.

• {{issue.TempoAccountField.value}} - 계정의 값을 반환합니다.