CSV 툴킷

csv-toolkit

CSV Toolkit 기능을 Zavilo SDK에서 사용하는 방법입니다. 아래에서 입력 제한, 파라미터, 출력 형식과 지원 모드를 확인할 수 있습니다.

H · HeadlessE · Embedded

도구 IDcsv-toolkit

버전1

실행 방식CLIENT

지원 모드Headless, Embedded

빠른 이동

입력 파일 0–50출력 파일 1–100

결과 처리 가이드 → 레시피 → 연동 예제 → 플레이그라운드 →

입력

이 Tool이 허용하는 입력 형식과 파일 개수입니다.

입력 종류	file-or-data
파일 수	0 – 50
허용 MIME 형식	text/csv, text/plain

파라미터

아래 값은 request.options에 전달합니다.

파라미터	타입	필수	기본값	허용값 / 범위	설명
`operation`	enum	선택	`clean`	clean \| merge \| split	CSV workflow: clean transforms one CSV, merge combines multiple CSV files by header name, split divides one CSV into multiple files.
`delimiter`	enum	선택	`auto`	auto \| comma \| semicolon \| tab	Input delimiter. auto detects comma, semicolon or tab.
`outputDelimiter`	enum	선택	`comma`	comma \| semicolon \| tab	Delimiter used for generated CSV files.
`headerRow`	integer	선택	`1`	1 – 1000	1-based row containing column headers.
`removeDuplicates`	boolean	선택	`false`	—	Remove exact duplicate rows after parsing.
`filterColumn`	string	선택	—	—	Column used by the contains filter. Omit to disable filtering.
`filterValue`	string	선택	—	—	Case-insensitive substring required in filterColumn. Omit to disable filtering.
`sortColumn`	string	선택	—	—	Column used for sorting. Omit to preserve row order.
`sortDirection`	enum	선택	`asc`	asc \| desc	Sort direction when sortColumn is provided.
`sortMode`	enum	선택	`auto`	auto \| text \| number	Comparison mode. auto uses numeric comparison when both values are numeric, otherwise text comparison.
`columns`	string[]	선택	—	—	Ordered list of columns to keep in Clean mode. Omit to keep every column.
`rowsPerFile`	integer	선택	`5000`	1 – 1000000	Maximum data rows per generated file in Split mode.
`includeBom`	boolean	선택	`true`	—	Prefix generated CSV with UTF-8 BOM.

출력

처리가 완료되면 반환되는 결과 형식입니다.

출력 종류	files+data
파일 수	1 – 100
출력 MIME	text/csv
Metadata	rows, columns, parts, inputFiles
ZIP 묶음	지원 · threshold 2

기본 사용 예제

지원되는 연동 모드를 확인하고 생성된 시작 코드를 바로 복사할 수 있습니다.

Headless

const result = await client.run("csv-toolkit", {
  
  options: { operation: "clean", delimiter: "auto", outputDelimiter: "comma", headerRow: 1 }
});
console.log(result.files, result.data, result.metadata);

Embedded

await client.mount({ tool: "csv-toolkit", target: "#zavilo-tool", mode: "embedded" });

이 명세는 실제 SDK 런타임이 사용하는 Tool Definition을 기준으로 자동 생성됩니다.