Creating and Configuring an Export Job
This guide explains how to email a PDF version of a dashboard and verify delivery. Buttons, fields, and indicators are described in Export Jobs: Overview.
Contents
- Check Export and Email Settings
- Select a Dashboard
- Open the Creation Form
- Enter a Name and Select a Dashboard
- Configure the Email and Recipients
- Configure Report Data
- Set a Schedule
- Save the Job
- Verify Delivery
- Edit or Stop the Job
Check Export and Email Settings
Make sure PDF generation and email delivery are configured in the system. Contact your administrator if they need to be configured.
For details, see PDF Export and Job Scheduler Settings.
Select a Dashboard
Open Dashboards and find the dashboard for which you want to schedule PDF delivery by email. If there is no suitable dashboard, click Create, then add visualization panels and filters to the new dashboard.
Then open the export job creation form using one of the methods below.
Open the Creation Form
Choose one of the following methods.
- From the Dashboard List
- From the Dashboard Page
- From the Export Job List
- Open
Dashboards - Find the dashboard and open its actions menu
- Select
Create Export Job
The Job Parameters form opens with the dashboard selected.
- Open the dashboard
- Click the arrow next to
Export - Select
Create Scheduled Export
The Job Parameters form opens with the dashboard selected.
- Open the dashboard's actions menu
- Select
View All Jobs - In
Export Jobs, clickCreate
The job creation form opens. Check the selected dashboard in General.
Enter a Name and Select a Dashboard
- In
General, check the selected value ofDashboard. If needed, find and select another dashboard - Fill in the required
Job Namefield, for example, "Daily Report for the Support Team"
The job name helps you find it in the list. Set the email subject separately in the next step.
Configure the Email and Recipients
- Enter Addresses Manually
- Use a Mailing Group
- In
Recipient Settings, leaveSelect from Mailing Groupturned off - In
To, add a recipient address, for example,report@example.com. It appears as a separate item in the field - Add each additional recipient address separately, for example,
team@example.com
At least one recipient is required. Each address appears as a separate item, and you can select multiple addresses in the field.
Switching recipient selection methods clears the entered addresses or selected group. Set the recipients again after switching.
- Turn on
Select from Mailing Group - Select a group in
Recipient GroupThe group's addresses appear inTo. In this mode, the field cannot be edited manually
Set the Sender and Subject
- In
From, leaveSystemselected to use the system sender, or select a configured SMTP connection - Fill in the required
Subjectfield, for example, "Daily Support Report"
Configure Report Data
- Select a dashboard in
General. TheFilter Settingssection is hidden until a dashboard is selected - In
Filter Settings, find the required filter group. Each dashboard panel's filters are in a separate bordered block. The panel name appears in the block heading; if the name is empty, there is no heading - Set the required filter values in these blocks
The available fields depend on the filters of the selected dashboard.
If a message says there are no filters, you do not need to set any in this form. Add filters in the dashboard editor.
Set a Schedule
In Schedule, select a Schedule Type. Switching types resets the schedule fields to their default values, so fill them in after choosing a type.
- Repeat at an Interval
- Cron Expression Schedule
- Select
Interval - Set
Start Time - In
Period, enter the interval value, and inUnit, select minutes, hours, or days - For a standard schedule, leave
Offset in Secondsat0
For example, Period set to 1 and Unit set to days configure a one-day interval.
- Select
Cron Expression - Enter an expression for the required schedule
- Set
Offset in Secondsif needed
Cron expressions use the browser's time zone.
Save the Job
A new job is enabled by default: after saving, it can run on schedule. If you want to test delivery manually first, disable the job in the list immediately after creating it.
- Check the dashboard, recipients, subject, filters, and schedule
- Click
Save - If the form displays validation errors, correct them and save again
- After saving, the form closes and a job creation notification appears. Select
View All Jobsfrom the dashboard's actions menu and find the job by name - Check the schedule and job status in the list. The job must be enabled for automatic runs
You can edit a saved job. To test email delivery, run it manually.
Verify Delivery
A manual run sends an email to the specified recipients. Before testing, make sure the correct addresses are selected.
- In the job list, open the new job's actions menu
- Select
Run Job - The
Job Startednotification confirms that the job started, not that the email was delivered. Check the available information in theExecution Statisticscolumn. Indicator colors are described in the overview - Check that you received an email with the specified subject and a PDF attachment
- Open the PDF and make sure it contains the required dashboard and data with the selected filters
A successful test produces an email with the correct PDF. A gray indicator means no information is available and does not, by itself, indicate a delivery error.
If you do not receive the email:
- Check
Toor the addresses in the selected group, the sender, and the email subject - Check the spam folder
- If a red or yellow execution indicator appears, click it to read the details
- If execution fails or the email is still missing after checking the settings, contact your administrator. Provide the job name, the time of the manual run, and any available error message
Edit or Stop the Job
Edit Parameters
- Open the job's actions menu and select
Edit - Change the required parameters
- Click
Save - If you changed recipients or filters, test delivery again
Stop Scheduled Delivery
- In the job's actions menu, select
Disable - Make sure the job-status dot turns red
The job remains in the list. To resume automatic runs, select Enable; the status dot turns green.
Delete a Job
- Check the name of the selected job
- Select
Deletefrom its actions menu - Confirm the deletion in the modal dialog
- Make sure the job no longer appears in the list