Run report automations

The PPM server checks at specified times if report automations exist, whether they have been executed or are to be executed, and executes them, if required. The server checks are initiated manually using the program runppmreport.bat (e.g., in automated batch files). Each user with the Report management privilege specifies when the server is to check and run the report automations, e.g., after every data import.

Execution time

During the execution of runppmreport -triggerreportautomation all due and activated report automations of all users are run. A report automation is run if the current point in time is the same as the earliest execution time or later.

A report automation is run only once in a defined time interval even if runppmreport.bat triggerreportautomation is executed several times during this interval.

Example

For a report automation, you specify weekly execution with Tuesday as the earliest execution time. Runppmreport.bat -triggerreportautomation is executed on Mondays and Thursdays after a data import. Thus, the report definition is run on Thursdays each week.

The due report automations are run in the order of their earliest execution time.

All time information refers to the time, time zone, and calendar of the server.

Save reports

The created reports are saved in a separate folder of the PPM installation.

<PPM installation directory>\server\bin\work\data_ppm\reportautomation\<client>\<User> -<Name_Report automation>\<Name_Report>.<File format_Report>

Warning

Created reports are not archived. This means that files of a previous execution will be deleted or overwritten during the next execution and cannot be restored.

Dispatch

If e-mail addresses have been set in a report automation, the created reports are automatically sent to the specified recipients as e-mail attachments. You can specify any e-mail addresses.

The e-mail address of the user or, if this is not specified, the e-mail addresses of the users associated with the report automation is specified for the sender of the e-mails.

Logging

The report automation output is written to the log file <PPM installation directory>\server\bin\work\data_ppm\log\<client>.

The output of the report execution during report automation is also saved in this module so that you can distinguish them from executions of individual report definitions in the PPM user interface.