Step-by-step guide
1. Enable report for Report Generation and Subscription
When creating or editing the original report in Report Design:
- Go to the Report Settings section.
- Report Group: Report Group code this report belongs to for the purpose of Report Generator. This can be a Role or any meaningful word that makes sense for the reports assigned to it.
- Is Active: 'Yes' flags the report as in current use. NOTE - 'inactive' reports in a Report Group can still be found and used in Report Generator. TIP - To make an inactive report inaccessible to a Report Group, remove it from a Role or Report Group that cannot access Report Generator.
- Available to Subscribe: (optional) 'Yes' enables Report Subscription. This lets users add subscribers to their generated reports.
- Report Description: meaningful description of the report (e.g., use, purpose and content). This is displayed on the Report Generator screen to give users a summary of the report.
- PDF Output Template: (optional) Name of prepared PDF template for the generated reports. The template must have been created and available for use. If this field is left blank, generated reports will be CSV files.
- Email Subject: Subject heading for email sent with attached report (if Subscription is enabled).
2. Enable and configure Scheduled Reporting settings
Report Generator with or without Report Subscription can be enabled for all users (not recommended) or restricted to specific Roles with the Override feature. When a user is given general access to either sub-feature, it will appear on their Dashboard menu.
To enable Report Generator:
- In the CMS, go to Settings → Settings → Feature Management → System.
- Click Configure.
- Enable Report Generator toggle:
- Leave it OFF (set global to disabled for users) and use Overrides to set for selected Roles. NOTE - Toggling ON will allow all users access by default.
- Click Overrides.
- Click the Add An Override button.
- In Role, select the role you want to add.
- To switch on the Override, toggle on Override Value.
- Click Confirm.
- To add any other Role Override required, perform steps b-e.
- Once you have exited the Overrides screen, in the main screen, click Save or Save & Exit.
(Optional - only if Subscription is to be used on your site) Enable Report Subscription toggle:
- The Report Subscription sub-feature can only be used with Report Generator.
- For a generated report to be subscribable, the original report must have been flagged as subscribable in Report Design.
When configuring Report Subscriptions, decide:
which group(s) of Users (all or by Role) have access to Report Subscription. Permissions for Roles should be coordinated with those in Report Generator.
Leave toggle OFF so Subsciption is not enabled for all users.
Click Overrides to make it available for selected Roles.
- Click the Add An Override button.
- In Role, select the role you want to add.
- To switch on the Override, toggle on Override Value.
- Click Confirm.
- To add any other Role Override required, perform steps b-e.
- Once you have exited the Overrides screen, on the main page, click Save or Save & Exit.
Report Generator and Subscription Groups: Add all report groups (Roles) that can access Report Generator/Subscription features. Separate each one with a comma or semi-colon. TIP - Report groups out-of-the-box are Roles. Remember that an original report is only available to Report Group(s) specified for it in Report Design.
Multiple report groups added in the main input field will give all users of these Roles global access to all reports. (except where prevented by any Role Overrides).
To avoid global access to report groups, leave the main field blank and use the Override feature to add Report Groups by Role
- To save your settings, click Save or Save & Exit.
3. Test Settings (optional)
Test your settings
Since reports may contain confidential data, it is strongly suggested that Report Generator, Subscription and Report Group configurations are tested in Stage before sending it to 'Live'.
4. Configure Report Generator widget (optional)
The Report Generator widget lets you customise labels and text displayed on the Report Generator page.
- In the CMS, go to Content → Content → Pages & Templates and search for the Report Generator template.
- Go to the Report Generator widget and click Edit.
- Edit the fields as needed. For a guide, see Report Generator Widget.
5. Configure Report Subscription widget (optional)
Customise labels and text displayed on the Report Subscription page.
- In the CMS, go to Content → Content → Pages & Templates and search for the Report Subscription template.
- Go to the Report Subscription widget and click Edit.
- Edit the fields as needed. For a guide, see Report Subscription Widget.
Related Resources