File Utilities

Guide

Text Reader

The Text Reader method reads the contents of a local file line by line and stores the resulting array of strings in the Execution State. It is useful for processing text-based files such as logs, CSVs, or configuration data directly within a workflow.

Input Parameters:

Name Description
File ID A unique file identifier obtained from the File Store or HTTP Request Event
Start Line The first line to read from the file (default is 0)
Limit The maximum number of lines to read (default is 0)

Result Mapping

Use a JSON Path expression to specify where the resulting list of lines should be placed in the Execution State.

* * *

Text Writer

The Text Writer method writes text content or a list of strings into a local file, using its file handler ID as a reference. It can either append new content to the file or overwrite the existing content, depending on the selected mode.

Input Parameters:

Name Description
File ID A unique file identifier obtained from the File Store or HTTP Request Event
Input Lines The text content or array of strings to write into the file
Mode Defines how the content should be written:
  • append (default) — adds the new content to the end of the file
  • overwrite — replaces the entire file content
If mode is provided dynamically, use the string values "append" or "overwrite".
* * *

CSV Reader

The CSV Reader method parses a local CSV file and converts it into an array of objects, where the first row (header) is used as property names for each object. This makes it easy to work with tabular data directly inside your workflows — perfect for processing uploaded spreadsheets, reports, imports, or any comma-separated (or custom-separated) data.

Input Parameters:

Name Description
File ID Unique identifier of the file, obtained from the File Store or from an HTTP Request Event when a file was uploaded.
Start Line The first data row to read (after the header). Default is 0 (starts right after the header row).
Limit Maximum number of data rows to read. Default is 0.
Separator Character used to separate columns. Default is , (comma), but you can use ;, |, etc.

Result Mapping

Use a JSON Path expression to specify where the resulting array of objects should be stored in the Execution State.

* * *

Read File as Base64

The Read File as Base64 method reads the entire content of a local file and converts it into a Base64-encoded string. This is especially useful when you need to embed binary or text files (such as images, PDFs, certificates, or small archives) directly into JSON structures, API calls, or subsequent workflow steps.

To ensure optimal performance and safety, the method only processes files smaller than 1 MB.

Input Parameters:

Name Description
File ID Unique identifier of the file, obtained from the File Store or from an HTTP Request Event when a file was uploaded.

Result Mapping

Specify a JSON Path expression to indicate where the resulting Base64 string should be stored in the Execution State.

Example: $.fileBase64

* * *

Delete Local File

Deletes a temporary local file using its unique file identifier (handler ID). Uploaded files consume account storage quota, so it is recommended (and in some cases required) to delete them after processing to avoid hitting storage limits.

Input Parameters:

Name Description
File ID A unique file identifier obtained from the File Store or HTTP Request Event