Bộ chuyển Excel · JSON · CSV

data-converter

Use Excel JSON CSV Converter through the Zavilo SDK. Check input limits, parameters, output and supported modes below.

H · HeadlessE · Embedded

Tool IDdata-converter

Version1

ExecutionCLIENT

WorkloadSTANDARD

ModesHeadless, Embedded

Quick actions

Input files 0–1Output files 1

Result handling → Recipes → Integration examples → Playground →

Đầu vào

Accepted input contract for this Tool.

Kind	file-or-data
File count	0 – 1
Accepted MIME types	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel, text/csv, application/json, text/plain

Tham số

Pass these values through request.options.

Parameter	Type	Bắt buộc	Mặc định	Giá trị / Phạm vi	Mô tả
`operation`	enum	Required	—	excel-to-json \| json-to-excel \| json-to-csv \| csv-to-json	Conversion to perform. excel-to-json reads a workbook; json-to-excel creates XLSX; json-to-csv creates CSV; csv-to-json parses CSV.
`sheet`	string	Optional	—	—	Excel worksheet name for excel-to-json. If omitted, the first worksheet is used.
`headerRow`	integer	Optional	`1`	1 – 1000	1-based row containing column headers for Excel or CSV input.
`flatten`	boolean	Optional	`true`	—	Flatten nested JSON objects into dotted column paths such as user.name before tabular export.
`delimiter`	enum	Optional	`auto`	auto \| comma \| semicolon \| tab	CSV delimiter. auto detects comma, semicolon or tab from the first non-empty row.
`includeBom`	boolean	Optional	`true`	—	Prefix generated CSV with UTF-8 BOM for spreadsheet compatibility.

Đầu ra

Result contract returned after successful processing.

Type	files+data
File count	1 – 1
MIME types	application/json, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Metadata	rows, columns, sheet, delimiter
ZIP archive	No

Ví dụ cơ bản

Choose a supported integration mode and copy the generated starter code.

Headless

const result = await client.run("data-converter", {
  
  options: { operation: "excel-to-json", headerRow: 1, flatten: true }
});
console.log(result.files, result.data, result.metadata);

Embedded

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

This page is generated from the SDK Tool Definition used by the runtime.