파일 쓰기¶

파일 쓰기 스킬은 테이블 데이터(TabularData)를 Excel, CSV, JSON 파일로 생성하고 S3에 업로드합니다.

설정 방법¶

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

스킬 노드를 추가하고 우측 패널에서 파일 쓰기를 선택합니다.

2. 파라미터 입력¶

설정 탭에서 데이터 소스(이전 노드의 테이블 데이터), 파일명, 파일 타입을 입력합니다.

파라미터¶

파라미터	필수	설명
data	O	테이블 데이터 (rows, columns, row_count)
filename	O	출력 파일명
file_type		파일 타입 (`xlsx`, `csv`, `json`) — 기본: xlsx
encoding		CSV 인코딩 (기본: utf-8)
pretty		JSON 들여쓰기 (기본: true)

출력¶

{
  "success": true,
  "data": {
    "file_path": "storage://s3/workflow_outputs/run_abc/report.xlsx",
    "filename": "report.xlsx",
    "file_size": 10240,
    "file_type": "xlsx",
    "row_count": 100
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.file_path }}   → 파일 S3 경로 (다른 스킬에서 참조)
{{ $('skill_1').data_content.result.filename }}     → 파일명
{{ $('skill_1').data_content.result.file_size }}    → 파일 크기 (바이트)

사용 예시¶

DB 데이터 → Excel 파일 → 이메일 전송¶

스킬	파라미터	값
파일 쓰기	data	`{{ $('skill_db').data_content.result }}`
파일 쓰기	filename	`매출보고서_2026.xlsx`
이메일 전송	attachments	`{{ $('skill_file').data_content.result.file_path }}`

참고¶

생성된 파일은 S3에 자동 업로드되며, storage:// 경로로 참조할 수 있습니다.
Excel 파일은 컬럼 너비 자동 조정, 헤더 굵은체가 적용됩니다.
S3 업로드 실패 시 로컬 파일 경로가 반환됩니다.