템플릿 변수 문법 알아보기

템플릿 파일(docx, pptx, hwpx) 안에 값이 채워질 자리를 아래 문법으로 표시해 두면, 파일을 업로드할 때 자동으로 변수로 인식됩니다.

지원하는 변수 문법

템플릿마다 아래 세 가지 문법 중 편한 것을 골라 쓸 수 있습니다. 한 템플릿 안에 섞어 써도 됩니다.

변수명은 영문일 필요가 없습니다. 한글, 공백이 포함된 자유로운 텍스트를 그대로 변수명으로 쓸 수 있습니다. {견적 유효기간} 처럼 공백이 들어간 변수명도 문제 없이 인식됩니다.

반복되는 항목 표시하기 (하위 데이터셋)

견적서의 품목 처럼 한 문서 안에서 여러 번 반복되는 항목이 있다면, 그 항목을 아래처럼 {#그룹명} 처럼 묶어서 표시합니다. 아래는 그룹명이 품목 인 경우의 예시입니다.

{#품목}
{품목명} - {수량}개 - {단가}원
{/}

닫는 태그는 {/} 처럼 그룹명 없이 써도 되고, {/품목} 처럼 그룹명을 다시 반복해서 써도 됩니다. 둘 다 동일하게 인식됩니다.

이렇게 표시한 반복 구간은 "데이터셋으로 대량 생성" 모드에서 하위 데이터셋과 연결해 사용합니다. 자세한 연결 방법은 데이터셋으로 대량 생성하기를 참고하세요.

변수명을 정할 때 참고할 점

• 그룹핑이나 접두어 규칙을 따로 정해둘 필요가 없습니다. 변수 목록은 그룹 없이 평평하게(flat) 표시되며, 라벨도 입력한 변수명 그대로 보여집니다.
• 같은 이름의 변수를 여러 번 써도(예: 서명란이 여러 곳인 경우) 하나의 변수로 인식되어, 값을 한 번만 입력하면 문서의 모든 자리에 동일하게 채워집니다.
• 나중에 템플릿 파일을 수정해서 변수를 추가하거나 이름을 바꿔야 한다면, 새 파일을 다시 업로드하는 대신 템플릿 파일 변경 기능을 사용하는 것을 권장합니다. 기존에 설정해 둔 값이나 저장 이력을 최대한 보존할 수 있습니다.