Chart to Image

Exports a chart from the worksheet to an image file (PNG format).

Common Properties

• Name - The custom name of the node.
• Color - The custom color of the node.
• Delay Before (sec) - Waits in seconds before executing the node.
• Delay After (sec) - Waits in seconds after executing the node.
• Continue On Error - Automation will continue regardless of any error. The default value is false.

info

If ContinueOnError property is true, no error is caught when the project is executed even if the Catch node is used.

Input

• File Descriptor - File descriptor of the Excel file. This is the identifier returned by the Open Excel node.
• Chart Title - Title of the chart to export. The chart must have a title for this node to find it.
• Image Path - (Optional) Full path where the image will be saved. If left empty, a temporary file is generated.

Output

• Image Path - Path to the exported image file (PNG format).

Options

This node has no additional options.

Example

Exporting a chart to a specific location:

// File Descriptor: message.excel_fd
// Chart Title: "Sales by Region"
// Image Path: "C:\\Reports\\sales_chart.png"
// Output: "C:\\Reports\\sales_chart.png"

Exporting to a temporary file:

// Chart Title: "Monthly Revenue"
// Image Path: (leave empty)
// Output: A temporary file path like "C:\\Users\\...\\tmp12345.png"

Exporting multiple charts:

// Loop through chart titles:
// Chart Title: message.chart_title
// Image Path: "C:\\Charts\\" + message.chart_title + ".png"

Using the exported image:

// 1. Chart to Image
// Output: image_path

// 2. Use the image in email or report
// Attach file: message.image_path

Tips

• The chart must have a title set in Excel for this node to find it.
• If multiple charts have the same title, the first one found is exported.
• The image is exported in PNG format with transparent background if applicable.
• Chart formatting, colors, and styles are preserved in the exported image.
• Use this for generating reports with visual data representations.
• The exported image quality is suitable for documents and presentations.

Common Errors

Error	Solution
Chart Title cannot be empty	Provide the title of the chart to export
Chart with specified title not found	Verify the chart has a title and it matches exactly
Invalid File Descriptor	Ensure the Open Excel node was executed first
Permission denied	Ensure you have write permissions for the target directory