Difference between revisions of "Scheduling with the File-based Repository"

Line 56: Line 56:
{| class="wikitable"
{| class="wikitable"
! scope="col" width="100" | Code
! scope="col" width="200" | Code
! scope="col" width="100" | Description
! scope="col" width="500" | Description
Line 70: Line 70:
|Inserts the database role or roles that are being used
|Inserts the database role or roles that are being used
| -
| -

Revision as of 10:23, 23 September 2011


XLCubed Web Edition can be used to deliver reports to users automatically.

Using a schedule you can define which reports go to which users, and can optionally parameterise the results.

Scheduling maintenance is setup in the browser using the Clock run.png icon.

This article is about configuring XLCubed Scheduling, you can also find more information about Scheduling Installation.


The scheduling module is made up of a few key parts.

Smtp Servers

An Smtp server is a computer that is configured to send emails. You will need to set one up so that reports can be delivered to your users.


For the simplest cases you can enter the email addresses of your users to get reports delivered to them.

Often this list must updated, in which case it may be better to set up distribution rules.

Distribution Groups

A Distribution Group defines a set of users by their email addresses. Also associated with this is a locale for formatting the report (Numbers appear as 1,234.56 or 1.234,56) and a database role to run the report as.

For example you could define "USA Managers" to run with US formatting under the US role, and have "German Managers" run with their own settings.

Distribution Lists

A Distribution Lists is a set of Distribution Groups which are linked together so a report goes to all users in all groups at the same time.

For example you could define "Managers" as a list comprosed of the USA Managers and the German Managers, and have reports sent to all of them.


A Schedule defines:

  • Which Reports get sent
  • Who they are sent to
  • When they are sent

If you wish to have a different set reports go to different people then this would be a new schedule.

Picking Reports

When picking a Report to be added the dialog box offers some options.


Report paramaters are defined in XLCubed Excel edition. You can set fixed values, or pick one of the Placeholders to be set up when the report is generated.


Sets the role to run the report as, useful if you have cube security. This setting will override any setting made for a Distribution Group.

Attach As

Defines the format of the report to be dilivered, either Pdf or Excel file.


By entering these custom values as report parameters you can customise the file for each user.

Code Description
%date% Inserts the current date
%time% Inserts the current time - %datetime% Inserts the current date and time - %rolename% Inserts the database role or roles that are being used - %groupname% Inserts the name of the distribution group - %email% Inserts the email address of the recipient - %displayname% Inserts the display name of the recipient - %sendiftrue% Triggers sending of the report

If %sendiftrue% is used the report will be generated normally, but only sent to users it this parameter is calculated to be TRUE.

This allows exception reporting, for example you could set the formula in the parameter cell to be

=Or(Sales < 1000, Losses > 50)

if you had appropriate names defined in Excel.