Chart Macro
표 형식의 데이터를 기반으로 차트를 표시할 수 있다.
페이지에 매크로를 추가하면 다음 작업을 수행 할 수 있다.
- 매크로에 의해 차트로 표시할 데이터를 매크로의 자리 표시자에 테이블로 제공
- 매크로 브라우저에서 매크로 매개 변수를 편집하여 차트의 형식을 구성
차트 매크로 사용
차트 매크로를 페이지에 추가하려면 :
- 페이지를 편집하고 자동완성을 사용하여 차트 매크로 추가('{chart}' 입력)
- 차트 데이터를 매크로 자리 표시자 본문에 하나 이상의 테이블로 입력
- 매크로 자리 표시자를 클릭하고 편집 선택
- Type 매개변수를 사용하여 차트 유형 선택
- 매크로 브라우저에서 다른 매개변수 설정을 선택
- '미리보기'영역에서 새로고침을 클릭하여 원하는대로 차트가 나타나는지 확인
- 저장을 클릭하여 차트를 페이지에 추가
- 페이지를 저장할 준비가되면 저장을 다시 클릭
매개변수
차트 유형 매개 변수
매개변수 | 기본값 | 설명 |
---|---|---|
유형 | pie | 표시할 차트의 유형. XY 차트에는 숫자로 된 x축과 y축이 있다. x값은 선택적으로 시간 기반 일 수 있다(시계열 매개변수 참조).
|
디스플레이 방향 | 수직 | 영역, 막대 및 선형 차트에 적용
|
Show in 3D | false | 영역, 막대 및 선형 차트에 적용 |
누적 값 | false | 영역 및 막대형 차트에 적용 |
외곽선 표시 | true | 꺾은 선형 차트에 적용. 외곽선은 각 데이터 요소에 표시 |
투명도 |
| 전경 영역과 막대가 얼마나 불투명한지를 결정하는 0(투명)과 100(불투명) 사이의 백분율 값 |
디스플레이 컨트롤 매개변수
매개변수 | 기본값 | 설명 |
---|---|---|
너비 | 300 | 차트의 폭(픽셀) |
높이 | 300 | 차트의 높이(픽셀) |
디스플레이 렌더링 데이터 | false | 렌더링 된 매크로 본문(일반적으로 데이터 테이블)을 표시할지 여부를 설정. 기본적으로 차트 데이터 테이블은 렌더링되지 않는다.
|
이미지 형식 | png | 차트에 사용할 이미지 형식
|
제목 및 라벨 매개변수
매개변수 | 기본값 | 설명 |
---|---|---|
차트 제목 | 없음 | 차트의 제목 |
차트 자막 | 없음 | 제목보다 작은 글꼴을 사용하는 차트의 자막 |
가로 축 라벨 | 없음 | x축(도메인)의 라벨 |
수직 축 라벨 | 없음 | y축(범위)의 라벨 |
Show Legend | true | 범례 또는 키를 표시 |
데이터 사양 매개변수
차트의 데이터는 매크로 본문이 렌더링 될때 찾은 표에서 가져온다. 이 옵션은 데이터의 해석 방법을 제어한다.
기본적으로 숫자 및 날짜값은 Confluence 기본 언어(로컬) 형식에 따라 해석된다. 변환이 실패하면 Confluence에 정의된 다른 언어가 시도된다.
아래의 매개 변수를 사용하여 추가 변환 옵션을 지정할 수 있다.
매개변수 | 기본값 | 설명 |
---|---|---|
Tables | 모든 첫번째 레벨 테이블 | 매크로 본문에 포함되어 차트의 데이터로 사용되어지는, 쉼표로 구분된 테이블ID 또는 테이블번호(1부터 시작) 목록 데이터 테이블이 다른 테이블에 포함된 경우 테이블 선택이 필요하다. 이것은 보다 복잡한 형식 지정(예 : 섹션 및 열 매크로 사용)이 수행될 때 발생한다. |
열 | 모든 열 | 차트 데이터에 사용되는 테이블의 열 라벨/열 제목/열 번호의 쉼표로 구분된 목록. 이것은 처리된 모든 테이블에 적용된다. 열은 1부터 열거. 열 라벨은 머리글 행의 열에 대한 텍스트이다. 열 제목은 머리글 행의 열에 대한(html) 제목 속성이다. |
내용 방향 | 수평 |
|
시계열 | false |
|
날짜 형식 | Confluence 언어 정의 날짜 형식 | 시계열 데이터의 경우 날짜 형식을 사용하면 데이터를 날짜 값으로 변환하는 과정을 추가로 사용자 지정할 수 있다. 날짜 형식이 지정되면 날짜 값을 해석하는데 사용되는 첫 번째 형식이 된다. 시계열 데이터와 일치하는 형식을 지정. |
시간대 | 일 | 시계열 데이터의 기간. 데이터가 해석되는 방법의 세분성을 정의한다. 유효한 값은 밀리 초, 초, 분, 시, 일, 주, 월, 분기, 연도이다. |
언어 | 없음 | 로컬을 구성하려면 국가 매개변수와 함께 사용. 이러한 추가 숫자 및 날짜 형식은 기본 언어 이전의 데이터 변환에 사용된다. 유효한 값은 ISO 639-1 alpha-2 codes |
국가 | 없음 | 언어 매개변수와 함께 사용하여 로컬을 구성. 유효한 값은 ISO 3166 codes |
Forgive | true |
|
색상 매개변수
16진수 표기법 또는 HTML색상 이름을 사용하여 지정
매개변수 | 기본값 | 설명 |
---|---|---|
배경색 | 흰색 | 차트의 배경 |
테두리 색 | 테두리 없음 | 차트 주위에 테두리 지정 |
색상 | 범주, 섹션 및 시리즈 색상을 사용자 정의하는데 사용되는 쉼표로 구분된 색상 목록 |
축 매개변수
차트 유형에 따라 범위 및 도메인 축을 사용자 정의 할 수 있다. 이러한 값은 데이터를 기반으로 자동 생성되지만 하나 이상의 매개변수를 지정하여 재정의 할 수 있다.
매개변수 | 기본값 | 설명 |
---|---|---|
범위 최소값 | 없음 | 범위 축 하한 |
범위 최대값 | 없음 | 범위 축 상한 |
범위 축 눈금 단위 | 없음 | 축 눈금 사이의 범위 축 단위 |
범위 축 라벨 각도 | 없음 | 범위 축 라벨의 각도(도) |
도메인 축 하한선 | 없음 | XY플롯에만 적용. 도메인 축 하한. 날짜 축의 경우,이 값은 날짜 형식 매개변수로 지정된 날짜 형식으로 표시되어야한다. |
도메인 축 상한선 | 없음 | XY플롯에만 적용. 도메인 축 상한. 날짜 축의 경우,이 값은 날짜 형식 매개변수로 지정된 날짜 형식으로 표시되어야한다. |
도메인 축 눈금 단위 | 없음 | XY플롯에만 적용. 축 눈금 사이의 도메인 축 단위. 날짜 축에 대해 이 값은 기간 매개변수에 지정된 단위의 수를 나타낸다. 기간 단위는 y(년), M(월), d(일), h(시), m(분), s(초), u(밀리 초)의 후행 문자를 지정하여 무시할 수 있다. |
도메인 축 라벨 각도 | 없음 | XY플롯에만 적용. 도메인 축 라벨의 각도(도) |
범주 라벨 위치 | 없음 | 카테고리에 대한 축 라벨 텍스트 배치
|
날짜 눈금 표시 위치 | start | 날짜 눈금 표시 위치
|
원형 차트 매개변수
매개변수 | 기본값 | 설명 |
---|---|---|
원형 섹션 라벨 | 원형 섹션 키값만 표시 | 원형 섹션 라벨이 표시되는 형식. 형식은 특수 대체변수가 있는 문자열을 사용
예1 : "%0%=%1%"는 "Independent=20"과 같은 것을 표시 예2 : "%0%(%2%)"는 "독립(20%)"과 같은 것을 표시 |
원형 섹션 분해 | 분해 섹션이 없음 | 쉼표로 분리된 파이 키 목록. 참고 : jFreeChart 버전1.0.3 이상이 필요 |
첨부 파일 매개변수
차트 버전 관리, 자동화 및 성능 향상을 위해 사용할 수 있는 고급 옵션. 일반적으로 페이지가 표시 될 때마다 차트 이미지가 재생성.
이 옵션을 사용하면 생성된 이미지를 첨부 파일로 저장하고 다음 접속시 첨부 파일을 다시 사용할 수 있다.
이는 캐시 플러그인과 결합하여 성능을 향상시킬때 특히 유용하다. 선택한 옵션에 따라 차트 이미지 기록용으로 버전을 지정할 수 있다.
매개변수 | 기본값 | 설명 |
---|---|---|
첨부 파일 | 없음 | 차트 이미지가 첨부 파일로 저장 될 이름 및 위치. 지정된 페이지에 첨부 파일을 추가할 수 있는 권한 필요
|
첨부 파일 버전 | new | 저장된 차트의 버전 관리 메커니즘을 정의
|
첨부 파일 설명 | 없음 | 저장된 차트 첨부 파일에 사용된 설명 |
썸네일 | false |
|