Skip to main content

튜토리얼

1. 템플릿 바인더의 동작 흐름​

1.1 템플릿 업로드​

  • 지원되는 오피스 파일(PPTX 등)을 템플릿으로 업로드합니다.
  • 템플릿에 예약어를 사용하여 데이터 바인딩 위치를 지정합니다.

1.2 데이터 바인딩​

  • 제공된 데이터에 따라 템플릿에 정보를 바인딩합니다.
  • 슬라이드 및 요소의 반복, 조건부 표시, 데이터 삽입 등을 지원합니다.

1.3 파일 생성​

  • 데이터가 바인딩된 문서를 원하는 포맷(PPTX, DOCX 등)으로 생성하여 다운로드할 수 있습니다.

2. 템플릿 예약어​

템플릿 바인더는 예약어를 통해 데이터를 동적으로 삽입하거나 조건을 지정합니다.

2.1 슬라이드​

  • {#[조건식]}: 슬라이드의 노출 조건.
    • 예: {#[isActive]} → isActive 조건이 참일 때만 슬라이드 표시.
  • {@[array]}: 슬라이드 반복.
    • 예: {@[products]} → products 배열 데이터로 슬라이드 반복 생성.

2.2 텍스트 박스​

  • {[value]}: 텍스트 출력.
    • 형식: {[value|타입|포맷|기본값]}
      • 타입: text, number, date
      • 포맷: %s, #,###.##, yyyy-MM-dd 등
      • 기본값: 값이 없을 경우 대체값 출력.
    • 예: {[price|number|#,###.##|0]} → 숫자를 포맷에 맞게 출력.
  • {$[url]}: 이미지 삽입.
    • 예: {$[imageUrl]} → URL 또는 base64 데이터를 이미지로 출력.

2.3 테이블​

  • {#[조건식]}: 특정 행(Row)의 노출 조건.
    • 예: {#[row.isVisible]}
  • {@[array]}: 테이블 행 반복.
    • 예: {@[items]} → 배열 데이터로 테이블 행 반복.
  • {=[array]}: 요약 필드 시작.
    • 예: {=[totals]}
  • {column}: 컬럼 반복.
    • 예: {column} → 테이블을 컬럼 단위로 반복.

3. 템플릿 작성 팁​

3.1 텍스트 박스 활용​

  • {[value]} 예약어를 사용하여 동적으로 텍스트를 출력하세요.
  • 기본값을 설정하여 데이터가 없을 경우를 대비할 수 있습니다.

3.2 슬라이드 조건​

  • {#[조건식]}으로 특정 슬라이드를 조건부로 표시할 수 있습니다.
  • 예를 들어, 특정 제품군에 대한 데이터를 바탕으로 슬라이드 노출을 제어합니다.

3.3 테이블 데이터 반복​

  • {@[array]}로 테이블 행을 배열 데이터 기반으로 동적으로 생성합니다.
  • 테이블 셀마다 다른 데이터를 입력하려면 {[value]} 예약어를 활용하세요.

4. 사용 예시​

4.1 슬라이드 노출 조건​

{#isPremium}
  • isPremium 값이 참일 때만 해당 슬라이드가 표시됩니다.

4.2 텍스트 출력​

{username|text|%s|Guest}
  • 사용자의 이름을 출력하며, 값이 없으면 Guest를 출력합니다.

4.3 테이블 반복​

{@products}
  • products 배열의 데이터로 테이블 행을 생성합니다.

템플릿 바인더는 데이터와 템플릿을 결합하여 맞춤형 프레젠테이션을 생성할 수 있는 강력한 도구입니다. 예약어를 활용하여 다양한 조건과 데이터를 동적으로 처리할 수 있습니다.