템플릿 내보내기¶

템플릿 내보내기 스킬은 미리 만든 Excel 템플릿에 데이터를 매핑하여 서식이 적용된 문서를 생성합니다. 기존 스타일, 서식, 수식이 보존됩니다.

설정 방법¶

1. 스킬 노드 추가 및 선택¶

스킬 노드를 추가하고 우측 패널에서 템플릿 내보내기를 선택합니다.

2. 파라미터 입력¶

설정 탭에서 템플릿 파일 경로, 데이터 매핑 규칙, 출력 파일명을 설정합니다.

파라미터¶

파라미터	필수	설명
data	O	테이블 데이터
template_path	O	템플릿 파일 (경로, URL, 또는 base64)
mappings	O	데이터 매핑 규칙 (아래 참조)
output_filename	O	출력 파일명
sheet_name		대상 시트명

매핑 타입¶

셀 매핑 (`cell`)¶

특정 셀에 값을 삽입합니다.

{
  "type": "cell",
  "target_cell": "B2",
  "value": "{{ $('trigger').data_content.company_name }}"
}

컬럼 매핑 (`column`)¶

데이터의 한 컬럼을 템플릿의 특정 열에 채웁니다.

{
  "type": "column",
  "source_column": "상품명",
  "target_column": "A",
  "target_start_row": 5
}

범위 매핑 (`range`)¶

전체 데이터를 지정 위치부터 채웁니다.

{
  "type": "range",
  "target_start_cell": "A5",
  "include_header": true,
  "columns": ["상품명", "수량", "단가"]
}

출력¶

{
  "success": true,
  "data": {
    "file_path": "storage://s3/workflow_outputs/run_abc/invoice.xlsx",
    "filename": "invoice.xlsx",
    "file_size": 8192,
    "sheet_name": "Invoice",
    "mappings_applied": 3,
    "rows_written": 50
  }
}

사용 예시¶

청구서 자동 생성¶

참고¶

템플릿의 서식(글꼴, 색상, 테두리), 수식이 모두 보존됩니다.
간단한 변환 수식 지원: value * 1.1 (부가세 포함 등).
생성된 파일은 S3에 자동 업로드됩니다.