Scheduled jobs - overview

While the Export options are ideal for manual ad-hoc exports, the Scheduled jobs can do essentially the same things – according to a fixed scheme, and without human interaction.

To set up a scheduled job for a document, first you will need to save it as a document. If the document is saved and open, you can go to the File menu to Schedule the document.

This will open a new tab in the Designer client with all the Scheduled Job's properties.

Click the 'Edit' (Pencil) button of a property to edit the property.

One of the central properties of a Scheduled job is the Schedule property. Here, you can set up when and how often a document should be distributed.

• By time (cube process optional). This is the default setting by which you simply specify when and how often you want this job to run.
• On cube process. Choosing this option, you will also need to select at least one cube that needs to be processed before the job will run. Click the text line “(no cubes selected)” to select one or more cubes. The job will run every time the cube is processed.
• Combination. You can also select the “By time” option and the “Only run when All of selected cubes have been processed”. In this way, you can prevent a scheduled job from sending out a report if the cube hasn’t been processed (i.e. data hasn’t been updated) since last time the scheduled job was run.

The Timeout option lets you configure a custom timeout for your scheduled job. This can be useful to prevent a failing scheduled job from taking up system resources any more time than necessary. If set to '0', the default timeout is 12 hours. The default timeout can be changed in the Settings. xml file, see this article: Scheduled jobs - timeout options

With the Source property you can change the source document if needed. You can even select multiple documents to be handled by this single scheduled job.

In the Source property you also have an option to change the export filename.

Notice the “Use variables” option that will add variables such as dates and timestamps to your file names, if needed.

The Format property lets you decide the format of the scheduled job’s output. For dashboards it will typically be an image format, but you may also choose HTML and PDF.

On the delivery property, the most commonly used option will probably be to send things by Email. You can add multiple email addresses in the “To” field – just separate addresses with a semicolon. The “From” field is only necessary if you want the mail to appear coming from a specific address – otherwise, it will appear coming from the TARGIT server.

One of the other delivery options, the Folder option, is a way to update or archive a document on a physical hard drive rather than sending it by email.

The “Default” option you may see there will likely point to the C:\ProgramData\TARGIT\ANTServer\Exported Reports location on the server where your TARGIT Server is installed.

If you click 'Export' in the path, you also have options for assigning any of your Shared folders (i.e. Shared folders in the TARGIT client) as your output destination.

The list of scheduled jobs is available from the Start menu:

From the list, you can see job status and you can edit jobs etc. Furthermore, right click a job to run it immediately:

The output, if exported to the Default folder, can be found here: