PDF4me icon

PDF4me

Comprehensive PDF and document processing: generate barcodes, convert files, extract data, manipulate images, and automate workflows with the PDF4ME API

Actions80

Overview

This node operation converts Microsoft Visio files into various output formats such as PDF, JPG, PNG, or TIFF. It supports multiple input methods for the Visio file: binary data from a previous node, base64 encoded content, or a URL pointing to the Visio file. The conversion process includes options to specify pages to convert, whether to include hidden pages, and how to handle visual elements like foreground pages and toolbars. This node is useful in workflows where Visio diagrams need to be converted into more widely accessible formats for sharing, archiving, or further processing.

Practical examples:

  • Automatically converting uploaded Visio diagrams into PDFs for distribution.
  • Converting Visio files hosted on a web server (via URL) into images for embedding in reports.
  • Processing base64 encoded Visio content received from an API and converting it to TIFF format for archival.

Properties

Name Meaning
Input Data Type How the input Visio file is provided. Options: Binary Data (from previous node), Base64 String (encoded content), URL (link to the Visio file).
Binary Property Name of the binary property containing the Visio file to convert (used when Input Data Type is Binary Data).
Input File Name Name of the input Visio file including extension. If not provided with binary data, filename from binary data will be used. Required for Base64 and URL input types.
Base64 Content Base64 encoded content of the Visio file to convert (required if Input Data Type is Base64 String).
File URL URL of the Visio file to convert (required if Input Data Type is URL).
Output File Name Desired name for the output file after conversion (e.g., "converted_diagram.pdf"). Defaults to "output.pdf".
Output Format Desired output format. Options: PDF, JPG, PNG, TIFF.
Is PDF Compliant Whether to make the output PDF compliant with standards (true/false). Applies only if output format is PDF.
Page Index Zero-based index of the first page to start conversion from.
Page Count Number of pages to convert starting from Page Index. Range: 1 to 100.
Include Hidden Pages Whether to include hidden pages in the conversion (true/false).
Save Foreground Page Whether to save foreground elements during conversion (true/false).
Save Tool Bar Whether to include the toolbar in the output (true/false).
Auto Fit Whether to auto-fit content to the page size (true/false).
Async Enable asynchronous processing (true/false).
Advanced Options Collection of advanced/custom options, e.g., custom JSON profiles to adjust properties for the conversion API.
Binary Data Output Name Custom name for the binary data property in the node's output. Defaults to "data".

Output

The node outputs the converted file as binary data under the specified binary data output name (default "data"). The binary data contains the converted document/image in the selected output format (PDF, JPG, PNG, or TIFF). The output also includes a JSON object with metadata about the conversion result.

If the output is a PDF, it can optionally be compliant with PDF standards depending on the input parameter.

Dependencies

  • Requires access to an external Visio conversion service or API capable of handling Visio file formats and converting them to the desired output formats.
  • Requires proper authentication credentials (such as an API key or token) configured in n8n to authorize requests to the conversion service.
  • Network access to URLs if using the URL input method.

Troubleshooting

  • Common issues:

    • Providing an incorrect or missing input file name when using base64 or URL input types may cause conversion failures.
    • Invalid or inaccessible URLs will result in errors fetching the Visio file.
    • Unsupported Visio file versions or corrupted files may cause conversion errors.
    • Exceeding page count limits or invalid page indices may cause errors or unexpected results.
    • Missing or invalid API credentials will prevent successful conversion.

  • Error messages and resolutions:

    • "Input file name is required" — Ensure the input file name is provided when using base64 or URL input types.
    • "Failed to fetch file from URL" — Verify the URL is correct, accessible, and publicly reachable.
    • "Conversion failed due to unsupported file format" — Confirm the input file is a valid Visio file (.vsd, .vsdx).
    • "Authentication error" — Check that the API key or authentication token is correctly configured in n8n credentials.
    • "Page index/count out of range" — Adjust the page index and count parameters within allowed ranges.

Links and References

Discussion