Skip to main content

Export Chart Canvas Charts

  • Updated

Export Chart Canvas Charts

Chart Canvas Charts can be exported in several ways.

Exporting to .PDF Document

If you choose to export Chart Canvas charts as part of a complete report page, using Action.Export PDF and Target.PDF elements, the charts are exported as SVG objects rather than as images. This results in Chart Canvas charts exported to a PDF document having extremely high resolution - they can be zoomed or printed with high-quality at any resolution.

When exporting Chart Canvas charts to PDF, the Chart Canvas element must have Height and Width attribute values set.

The attributes of the Action and Target elements can be configured to specify a variety of things that relate mostly to the overall report rather than to any charts they contain. During the process, however, a "hidden" copy of the report page is generated and used as the source for the PDF export engine. Ensure that this copy receives all of the parameters used to generate the visible page by using a Link Parameters element, a child of the Action element, and passing necessary values.

Exporting to .PNG Image

Chart Canvas charts can be configured to include an "export to .PNG image" feature.

This is done by adding either a Chart Export element as a child of a specific Chart Canvas Chart element, as shown above left, or by adding a Global Chart Export element as a child of the General element in the _Settings definition, as shown above right. Adding either Chart Export element enables the feature in the chart:

When enabled, hovering your mouse cursor over the upper right-hand corner of the chart will cause the Get Image button to appear. Click it to proceed.

You're essentially downloading the image, so the browser will behave in whatever manner it's been configured for when handling downloads. It may automatically save the image to its Downloads folder or, as shown above, you may be prompted to open (view) the image or select a location for saving it.

Attributes

Both of the Chart Export and Global Chart Export elements have an optional Export Filename attribute that allows you to specify a name for the downloaded .PNG image file and it accept tokens, so you can dynamically include time stamps, user names, etc. in it. If not specified, then the file is simply downloaded as "chart.png". The Chart Export element also allows you to optionally specify an ID and a Security Right ID. When using Logi Security, the latter allows you to control who can export a chart image.

Child Elements

Two child element are available that let you style the Get Image button. The Chart Export Button Style element lets you position, style, and customize the button, and the Chart Export Button Hover Style element lets you control the appearance of the button when the mouse cursor is hovered over it.

Related articles