Help Centre › Building Processes
This article describes the RPA File functionality to convert a file to another format.
For a full list of available functions, please read FILE functions.
Description
The FILE Convert file format function converts a file from one format to another. It supports a wide range of conversions including spreadsheets (CSV, XLSX, JSON, XML), documents (DOCX, PDF, HTML, TXT), images (PNG, JPG, BMP, TIFF, WEBP), and specialised formats (IT3).
Setting it up
To use the FILE Convert file format function, follow these instructions:
{{popups:rpas/add:action=convert}}
Once on a process map:
- Navigate to the process where you would like to add the FILE Convert file format function
- Open the Activities sidebar panel
- Under Document Processing > Convert, drag "Convert file format" onto the canvas
- Configure the source file path and target format
Input parameters
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| File | Yes | Text | - | Path to the source file |
| Target format | Yes | Select | - | The format to convert to (xlsx, csv, json, xml, pdf, txt, html, docx, png, jpg, bmp, tiff, webp, it3) |
| Sheet | No | Text | - | Worksheet name (for xlsx source conversions) |
| Include header row | No | Switch | Off | Include header row (xlsx to csv) |
| Delimiter | No | Select | Comma | CSV delimiter character |
| Pages | No | Text | all | PDF page selection (e.g. 1, 1,3,5, all) |
| Root tag | No | Text | data | XML root element name |
| Row tag | No | Text | row | XML row element name |
| Width | No | Number | 0 | Image resize width in pixels (0 = keep original) |
| Height | No | Number | 0 | Image resize height in pixels (0 = keep original) |
| DPI | No | Number | 200 | PDF-to-image resolution |
| Person | No | Textarea | - | IT3 person header (IT3 conversion only) |
| Company | No | Textarea | - | IT3 company header (IT3 conversion only) |
Supported conversions
| Source | Target formats |
|---|---|
| .csv | xlsx, json, xml |
| .html/.htm | xlsx, pdf |
| .json | xlsx, csv, xml |
| .xlsx | csv, json, pdf, xml, it3 |
| .xls | xlsx |
| .docx | html, pdf, txt |
| csv, docx, html, xlsx, txt, png, jpg | |
| .pptx | txt |
| .txt | |
| .xml | json, xlsx |
| Images | png, jpg, bmp, tiff, webp |
Output variables
This action does not produce output variables.
Errors
| Error | Description |
|---|---|
| File not found | The source file does not exist |
| Unsupported conversion | The source format cannot be converted to the target format |
Tips
- Only provide optional parameters relevant to your conversion type
- The source format is auto-detected from the file extension
- Unsupported source/target combinations return an error