/
Chart Macro

Chart Macro

표 형식의 데이터를 기반으로 차트를 표시할 수 있다.
페이지에 매크로를 추가하면 다음 작업을 수행 할 수 있다.

  • 매크로에 의해 차트로 표시할 데이터를 매크로의 자리 표시자에 테이블로 제공
  • 매크로 브라우저에서 매크로 매개 변수를 편집하여 차트의 형식을 구성


차트 매크로 사용

차트 매크로를 페이지에 추가하려면 :

  1. 페이지를 편집하고 자동완성을 사용하여 차트 매크로 추가('{chart}' 입력)
  2. 차트 데이터를 매크로 자리 표시자 본문에 하나 이상의 테이블로 입력
  3. 매크로 자리 표시자를 클릭하고 편집 선택
  4. Type 매개변수를 사용하여 차트 유형 선택
  5. 매크로 브라우저에서 다른 매개변수 설정을 선택
  6. '미리보기'영역에서 새로고침을 클릭하여 원하는대로 차트가 나타나는지 확인
  7. 저장을 클릭하여 차트를 페이지에 추가
  8. 페이지를 저장할 준비가되면 저장을 다시 클릭

 

매개변수
차트 유형 매개 변수
매개변수기본값설명
유형pie

표시할 차트의 유형. XY 차트에는 숫자로 된 x축과 y축이 있다.

x값은 선택적으로 시간 기반 일 수 있다(시계열 매개변수 참조).

  • 표준 - pie, bar, line, area
  • XY 플롯 - xyArea, xyBar, xyLine, xyStep, xyStepArea, scatter, timeSeries
  • 기타 - gantt
디스플레이 방향수직

영역, 막대 및 선형 차트에 적용

  • 수직 - y축이 세로
  • 수평 - x축이 세로
Show in 3Dfalse영역, 막대 및 선형 차트에 적용
누적 값false영역 및 막대형 차트에 적용
외곽선 표시true꺾은 선형 차트에 적용. 외곽선은 각 데이터 요소에 표시
투명도
  • 3D 차트 75 %
  • 비 스택 영역 차트의 경우 50 %
  • 다른 모든 차트의 경우 100 %
전경 영역과 막대가 얼마나 불투명한지를 결정하는 0(투명)과 100(불투명) 사이의 백분율 값

디스플레이 컨트롤 매개변수
매개변수기본값설명
너비300차트의 폭(픽셀)
높이300차트의 높이(픽셀)
디스플레이 렌더링 데이터false

렌더링 된 매크로 본문(일반적으로 데이터 테이블)을 표시할지 여부를 설정.

기본적으로 차트 데이터 테이블은 렌더링되지 않는다.

  • 이전 - 차트 앞에 데이터가 표시
  • 이후 - 차트 뒤에 데이터가 표시
이미지 형식png

차트에 사용할 이미지 형식

  • png
  • jpg

제목 및 라벨 매개변수
매개변수기본값설명
차트 제목없음차트의 제목
차트 자막없음제목보다 작은 글꼴을 사용하는 차트의 자막
가로 축 라벨없음x축(도메인)의 라벨
수직 축 라벨없음y축(범위)의 라벨
Show Legendtrue범례 또는 키를 표시

 

데이터 사양 매개변수

차트의 데이터는 매크로 본문이 렌더링 될때 찾은 표에서 가져온다. 이 옵션은 데이터의 해석 방법을 제어한다.
기본적으로 숫자 및 날짜값은 Confluence 기본 언어(로컬) 형식에 따라 해석된다. 변환이 실패하면 Confluence에 정의된 다른 언어가 시도된다.
아래의 매개 변수를 사용하여 추가 변환 옵션을 지정할 수 있다.

매개변수기본값설명
Tables모든 첫번째 레벨 테이블

매크로 본문에 포함되어 차트의 데이터로 사용되어지는, 쉼표로 구분된 테이블ID 또는 테이블번호(1부터 시작) 목록

데이터 테이블이 다른 테이블에 포함된 경우 테이블 선택이 필요하다. 이것은 보다 복잡한 형식 지정(예 : 섹션 및 열 매크로 사용)이 수행될 때 발생한다.

모든 열

차트 데이터에 사용되는 테이블의 열 라벨/열 제목/열 번호의 쉼표로 구분된 목록. 이것은 처리된 모든 테이블에 적용된다.

열은 1부터 열거. 열 라벨은 머리글 행의 열에 대한 텍스트이다. 열 제목은 머리글 행의 열에 대한(html) 제목 속성이다.

내용 방향수평
  • 수직 - 데이터 테이블 열은 시리즈로 해석
  • 수평 - 데이터 테이블 행은 시리즈로 해석
시계열false
  • true - XY플롯의 x 값은 시계열 데이터로 취급되므로 날짜 형식에 따라 변환
날짜 형식Confluence 언어 정의 날짜 형식

시계열 데이터의 경우 날짜 형식을 사용하면 데이터를 날짜 값으로 변환하는 과정을 추가로 사용자 지정할 수 있다.

날짜 형식이 지정되면 날짜 값을 해석하는데 사용되는 첫 번째 형식이 된다. 시계열 데이터와 일치하는 형식을 지정.

시간대시계열 데이터의 기간. 데이터가 해석되는 방법의 세분성을 정의한다. 유효한 값은 밀리 초, 초, 분, 시, 일, 주, 월, 분기, 연도이다.
언어없음

로컬을 구성하려면 국가 매개변수와 함께 사용. 이러한 추가 숫자 및 날짜 형식은 기본 언어 이전의 데이터 변환에 사용된다.

유효한 값은  ISO 639-1 alpha-2 codes

국가없음언어 매개변수와 함께 사용하여 로컬을 구성. 유효한 값은 ISO 3166 codes
Forgivetrue
  • true - 매크로는 기본 또는 사용자 지정 형식과 완전히 일치하지 않는 숫자 및 날짜 값을 변환하려고 한다.
  • false - 엄격한 데이터 형식을 적용. 데이터 형식 오류로 인해 차트가 생성되지 않는다.

 

색상 매개변수

16진수 표기법 또는 HTML색상 이름을 사용하여 지정

매개변수기본값설명
배경색흰색차트의 배경
테두리 색테두리 없음차트 주위에 테두리 지정
색상 범주, 섹션 및 시리즈 색상을 사용자 정의하는데 사용되는 쉼표로 구분된 색상 목록

 

축 매개변수

차트 유형에 따라 범위 및 도메인 축을 사용자 정의 할 수 있다. 이러한 값은 데이터를 기반으로 자동 생성되지만 하나 이상의 매개변수를 지정하여 재정의 할 수 있다.

매개변수기본값설명
범위 최소값없음범위 축 하한
범위 최대값없음범위 축 상한
범위 축 눈금 단위없음축 눈금 사이의 범위 축 단위
범위 축 라벨 각도없음범위 축 라벨의 각도(도)
도메인 축 하한선없음XY플롯에만 적용. 도메인 축 하한. 날짜 축의 경우,이 값은 날짜 형식 매개변수로 지정된 날짜 형식으로 표시되어야한다.
도메인 축 상한선없음XY플롯에만 적용. 도메인 축 상한. 날짜 축의 경우,이 값은 날짜 형식 매개변수로 지정된 날짜 형식으로 표시되어야한다.
도메인 축 눈금 단위없음

XY플롯에만 적용. 축 눈금 사이의 도메인 축 단위. 날짜 축에 대해 이 값은 기간 매개변수에 지정된 단위의 수를 나타낸다.

기간 단위는 y(년), M(월), d(일), h(시), m(분), s(초), u(밀리 초)의 후행 문자를 지정하여 무시할 수 있다.

도메인 축 라벨 각도없음XY플롯에만 적용. 도메인 축 라벨의 각도(도)
범주 라벨 위치없음

카테고리에 대한 축 라벨 텍스트 배치

  • up45 - 45도 상승
  • up90 - 90도 상승
  • down45 - 45도 하강
  • down90 - 90도 하강
날짜 눈금 표시 위치start

날짜 눈금 표시 위치

  • start - 눈금 표시는 날짜 기간의 시작 부분
  • middle - 눈금표시는 날짜 기간의 중간 부분
  • end - 눈금표시는 날짜 기간의 끝 부분

 

원형 차트 매개변수
매개변수기본값설명
원형 섹션 라벨원형 섹션 키값만 표시

원형 섹션 라벨이 표시되는 형식. 형식은 특수 대체변수가 있는 문자열을 사용

  • %0%는 파이 섹션 키로 대체
  • %1%는 파이 섹션 숫자 값으로 대체
  • %2%는 파이 섹션 퍼센트 값으로 대체

예1 : "%0%=%1%"는 "Independent=20"과 같은 것을 표시

예2 : "%0%(%2%)"는 "독립(20%)"과 같은 것을 표시

원형 섹션 분해분해 섹션이 없음쉼표로 분리된 파이 키 목록. 참고 : jFreeChart 버전1.0.3 이상이 필요

 

첨부 파일 매개변수

차트 버전 관리, 자동화 및 성능 향상을 위해 사용할 수 있는 고급 옵션. 일반적으로 페이지가 표시 될 때마다 차트 이미지가 재생성.
이 옵션을 사용하면 생성된 이미지를 첨부 파일로 저장하고 다음 접속시 첨부 파일을 다시 사용할 수 있다.
이는 캐시 플러그인과 결합하여 성능을 향상시킬때 특히 유용하다. 선택한 옵션에 따라 차트 이미지 기록용으로 버전을 지정할 수 있다.

매개변수기본값설명
첨부 파일없음

차트 이미지가 첨부 파일로 저장 될 이름 및 위치. 지정된 페이지에 첨부 파일을 추가할 수 있는 권한 필요

  • ^attachmentName.png - 현재 페이지의 첨부 파일로 저장
  • page^attachmentName.png - 차트가 표시된 페이지 이름의 첨부 파일로 저장
  • space:page^attachmentName.png - 차트가 표시된 공간에 제공된 페이지 이름의 첨부 파일로 저장
첨부 파일 버전new

저장된 차트의 버전 관리 메커니즘을 정의

  • new - 첨부 파일의 새 버전을 생성
  • replace - 차트의 이전 버전을 모두 대체. 기존 첨부 파일을 바꾸려면 지정된 페이지에 대한 첨부 파일을 제거할 수 있는 권한 필요
  • keep - 같은 이름의 기존 내보내기가 없는 경우에만 새 첨부 파일을 저장. 기존 첨부 파일은 변경되거나 업데이트되지 않는다.
첨부 파일 설명없음저장된 차트 첨부 파일에 사용된 설명
썸네일false
  • true - 차트 이미지 첨부 파일이 축소판으로 표시