JIRA Chart Macro

Confluence 사이트가 JIRA 응용 프로그램에 연결되어 있으면 Confluence 페이지에 문제를 차트로 표시할 수 있다. 

Confluence를 JIRA 소프트웨어 및 JIRA Service Desk를 포함한 JIRA 응용 프로그램에 연결할 수 있다. 

이 매크로를 사용하려면 먼저 Confluence와 JIRA 응용 프로그램이 응용 프로그램 링크를 통해 연결되어 있어야 한다. 

페이지를 보는 사용자는 공개적으로 액세스할 수 있는 문제에 대한 차트를 볼 수 있다. 

JIRA 애플리케이션이 보기가 제한된 경우 (즉, 사람들이 문제를 볼 권한이 필요한 경우) 차트를 보기 전에 인증을 받아야 한다. 이 매크로는 JIRA 5.x와 호환된다.

JIRA Chart Macro 사용

페이지에 JIRA Chart를 추가하려면 :

1. 에디터에서 Insert  >  Other macro  >  JIRA Chart 선택
2. 작성할 보고서 유형 선택(예 : 원형, Created vs Resolved 보고서)

3. JIRA 서버 선택. Confluence에 여러 개의 JIRA 서버가 연결되어 있다면 드롭 다운 메뉴는 기본 애플리케이션 링크로 기본 설정된다.

4. 문제 검색 - JQL에 쿼리를 입력하거나 JIRA URL을 검색 필드에 직접 붙여 넣을 수 있다.
5. 미리보기를 선택하여 차트 생성
6. 차트 표시 방법을 추가로 제어하려면 표시 옵션 선택 
7. 삽입 선택

이슈 검색에 대한 자세한 내용은 JQL(JIRA Query Language)을 사용하여 이슈 표시 참조

스크린 샷 : 매크로 브라우저의 JIRA Chart 매크로

Pie Chart

원형 차트는 이슈 상태, 우선 순위, 양수인 등을보고하는데 사용할 수 있다. 

이 차트가 페이지에 표시되는 방식을 추가로 제어하려면 디스플레이 옵션에서 다음을 선택 :

• Chart by - 다음과 같이 원형 차트를 분할할 필드를 선택
  • 지위
  • 버전 수정
  • 양수인 이름
  • 우선 순위
  • 구성 요소
  • 문제 유형
• Width - 차트 영역의 전체 너비를 정의. 픽셀, 백분율로 값을 입력하거나 공백으로 두어 자동으로 맞춘다.
• Show border - 차트 영역 주위에 테두리를 추가
• Show chart information - 차트 아래에 총 이슈 수 및 값순 차트가 포함된 텍스트 요약을 포함

Created vs Resolved Chart

Created vs Resolved charts는 생성된 이슈의 수와 시간이 지남에 따라 해결된 이슈의 수를 나타내는데 사용할 수 있다.

이 차트가 페이지에 표시되는 방식을 추가로 제어하려면 표시 옵션을 선택 :

• Period - (주, 월, 분기 등)기준으로 보고할 시간 프레임을 선택
• Days previously - 보고할 총 일수(오늘부터 계산)
• Cumulative totals - 누적 합계를 점진적으로 추가하거나 매 기간마다 개별값을 보고하도록 선택
• Show unresolved trend - 시간 경과에 따라 해결되지 않은 이슈를 보여주는 서브 플롯을 추가
• Show versions - 버전 릴리스 날짜를 차트에 세로선으로 표시
• Width - 차트 영역의 전체 너비를 정의. 값을 픽셀, 퍼센트로 입력하거나 공백으로 두어 자동으로 맞춘다.
• Show border - 차트 영역 주위에 테두리 추가
• Show chart information - 차트 아래에 총 이슈 수 및 값순 차트가 포함된 텍스트 요약을 포함

Two Dimensional Chart

2 차원 도표를 사용하여 문제 통계를 매트릭스로 표시할 수 있다. 이러한 문제 필드를 표시하도록 X 축과 Y 축을 구성 할 수 있다.

• 지위
• 우선 순위
• 양수인
• 버전 수정
• 구성 요소
• 문제 유형

예를 들어 차트를 사용하여 상태 별 문제 유형을 표시 할 수 있다.

차트 축을 구성하려면 표시 옵션 선택

• X축 - X축(열)에 표시할 문제 필드
• Y축 - Y축(행)에 표시할 문제 필드
• 표시할 행  - 차트에 표시할 최대 수

JIRA Chart 매크로 비활성화하기

이 기능은 'JIRA Macros'라는 부가 기능(플러그인)에 의해 제공된다. 이 매크로는 JIRA Issues 매크로에도 사용된다. 

사이트에서 매크로를 사용할 수 없게 하려면 추가 기능을 사용하지 않도록 설정하면된다. 추가 기능 비활성화 및 활성화를 참조.

노트

HTTPS : JIRA Chart 매크로는 Confluence 서버가 JIRA SSL 인증서를 받아들이도록 설정되어 있으면 SSL 하에서 동작하는 JIRA 사이트에 접근 할 수 있다. 

SSL을 통해 LDAP 또는 JIRA 응용 프로그램 또는 기타 서비스에 연결을 참조.

인증 :  쿼리에 인증이 필요한 문제(JIRA의 익명 사용자가 볼 수없는 문제)가 포함되어있는 경우 Confluence 페이지에서 차트를 볼 수 있도록 인증하라는 메시지가 표시된다.    

매크로 브라우저에서 문제를 검색하려면 인증이 필요할 수 있다. JIRA 5.x를 사용하면 제한되지 않은 문제를 익명 사용자로 검색 할 수 있다. 그러나 JIRA 6.x에서는 문제를 검색하기 위해 인증을 받아야한다.