#고급 기능

#페이지 매김

#1. 페이지 번호 업데이트

#문법

Office 소프트웨어에서 간단히 삽입하시면 됩니다.

#예시

Microsoft Word에서:

• "삽입 → 페이지 번호" 기능을 사용합니다.
  LibreOffice에서:
• "삽입 → 필드 → 페이지 번호" 기능을 사용합니다.

#결과

생성된 보고서에서 각 페이지의 페이지 번호가 자동으로 업데이트됩니다.

#2. 목차 생성

#문법

Office 소프트웨어에서 간단히 삽입하시면 됩니다.

#예시

Microsoft Word에서:

• "삽입 → 색인 및 목차 → 목차" 기능을 사용합니다.
  LibreOffice에서:
• "삽입 → 목차 및 색인 → 목차, 색인 또는 참고 문헌" 기능을 사용합니다.

#결과

생성된 보고서의 목차는 문서 내용에 따라 자동으로 업데이트됩니다.

#3. 표 머리글 반복

#문법

Office 소프트웨어에서 간단히 삽입하시면 됩니다.

#예시

Microsoft Word에서:

• 표 머리글을 마우스 오른쪽 버튼으로 클릭 → 표 속성 → "각 페이지 상단에 제목 행으로 반복"을 선택합니다.
  LibreOffice에서:
• 표 머리글을 마우스 오른쪽 버튼으로 클릭 → 표 속성 → 텍스트 흐름 탭 → "제목 반복"을 선택합니다.

#결과

표가 여러 페이지에 걸쳐 있을 때, 표 머리글이 각 페이지 상단에 자동으로 반복 표시됩니다.

#국제화 (i18n)

#1. 정적 텍스트 번역

#문법

정적 텍스트를 국제화하려면 {t(텍스트)} 태그를 사용합니다:

{t(meeting)}

#예시

템플릿에서:

{t(meeting)} {t(apples)}

JSON 데이터 또는 외부 현지화 사전(예: "fr-fr"용)에서 "meeting" → "rendez-vous", "apples" → "Pommes"와 같이 해당 번역을 제공합니다.

#결과

보고서를 생성할 때, 텍스트는 대상 언어에 따라 해당 번역으로 대체됩니다.

#2. 동적 텍스트 번역

#문법

데이터 콘텐츠에는 :t 포맷터를 사용할 수 있습니다. 예를 들어:

{d.id:ifEQ(2):show({t(monday)}):elseShow({t(tuesday)})}

#예시

템플릿에서:

{d.id:ifEQ(2):show({t(monday)}):elseShow({t(tuesday)})}

JSON 데이터와 현지화 사전에서 해당 번역을 제공합니다.

#결과

조건 판단에 따라 "lundi" 또는 "mardi"(대상 언어 예시)가 출력됩니다.

#키-값 매핑

#1. 열거형 변환 (:convEnum)

#문법

{데이터:convEnum(열거형_이름)}

예를 들어:

0:convEnum('ORDER_STATUS')

#예시

API 옵션 예시에서 다음과 같이 전달됩니다:

{
  "enum": {
    "ORDER_STATUS": ["pending", "sent", "delivered"]
  }
}

템플릿에서:

0:convEnum('ORDER_STATUS')

#결과

"pending"이 출력됩니다. 만약 인덱스가 열거형 범위를 벗어나면 원본 값이 출력됩니다.

#동적 이미지

2. 이 이미지를 마우스 오른쪽 버튼으로 클릭하고 "대체 텍스트(Alt Text)"를 편집하여 삽입하려는 이미지 필드 레이블(예: {d.imageUrl})을 입력합니다:

3. 다음 예시 데이터를 사용하여 렌더링합니다:

{
  "name": "Apple",
  "imageUrl": "https://images.pexels.com/photos/206959/pexels-photo-206959.jpeg",
}

4. 렌더링 결과, 임시 이미지는 실제 이미지로 대체됩니다:

#여러 이미지 반복 대체

템플릿에 상품 목록과 같이 여러 이미지를 삽입하려면 반복 방식을 통해 구현할 수 있습니다. 구체적인 단계는 다음과 같습니다:

1. 데이터가 다음과 같다고 가정합니다:

{
  "products": [
    {
      "name": "Apple",
      "imageUrl": "https://images.pexels.com/photos/206959/pexels-photo-206959.jpeg",
    },
    {
      "name": "Banana",
      "imageUrl": "https://images.pexels.com/photos/61127/pexels-photo-61127.jpeg",
    },
  ]
}

2. DOCX 템플릿에서 반복 영역을 설정하고, 각 반복 항목에 임시 이미지를 삽입한 후 대체 텍스트를 {d.products[i].imageUrl}로 설정합니다. 아래 예시를 참고하세요:

3. 렌더링 후, 모든 임시 이미지는 각 데이터 이미지로 대체됩니다:

#XLSX 파일에 동적 이미지 삽입

Excel 템플릿(XLSX)에서의 작업 방식은 기본적으로 동일하지만, 다음 사항에 유의해야 합니다:

1. 이미지를 삽입한 후, 이미지가 셀 위에 떠 있는 것이 아니라 "셀 내의 그림"으로 선택되었는지 확인해 주세요.

2. 셀을 선택한 후 "대체 텍스트"를 클릭하여 {d.imageUrl}와 같은 필드 레이블을 입력합니다.

#바코드

#바코드 생성 (예: QR 코드)

바코드 생성 방식은 동적 이미지와 동일하며, 다음 세 단계만 필요합니다:

1. 템플릿에 바코드 위치를 표시할 임시 이미지를 삽입합니다.

2. 이미지의 "대체 텍스트"를 편집하고 바코드 형식 필드 레이블(예: {d.code:barcode(qrcode)})을 입력합니다. 여기서 qrcode는 바코드 유형입니다(아래 지원 목록 참조).

3. 렌더링 후, 이 자리 표시자 이미지는 해당 바코드 이미지로 자동으로 대체됩니다:

#지원되는 바코드 유형