Running Reports (Report Generation)

The reports created in Canvas Studio will be available for use by the end users of the application. For representation purpose, the Sigma application is considered as the application. The reports created in Canvas Studio will be available in the "Information Reports" workspace in the Sigma application. To create such parent reports, refer Configuring a Simple Report.

To execute or generate the reports, perform the following steps:

Log-in to the application (e.g. Sigma) and click Information Reports workspace. In Sigma application, Information Reports workspace is displayed by default after logging in.

The Information Reports workspace opens with Available Report section on the left-hand side, which shows the list of reports created in Canvas Studio. In our example, we created the Sales Order report in Canvas Studio.
In the Available Report section, click the report name.

The Customize tab for the selected report appears on the right-hand side.
Enter a name for the report in the Report Name field. For example, Sales Order (HTML).
Choose the report format from the drop-down. For example, HTML.

The report formats in the drop-down are based on the formats chosen while creating the report in Canvas Studio. In our example, we selected and HTML and PDF formats for the Sales Order report in Canvas Studio.
Select the report size from the Select Paper Size drop-down list. By default, A4 Paper is displayed.
Select the layout for the report from the Select Layout drop-down list. By default, Landscape is displayed.
Specify the font size in the Font Size field. You can increase or decrease the font size by clicking the plus or minus respectively.
If you want to include serial number for the records in the report, toggle on the Serial No field. By default, serial number option is selected.
Click the Select Columns drop-down and select the columns that needs to be shown on the report.

The columns in the Select Columns drop-down are based on the columns chosen while creating the report in Canvas Studio.

To quickly select all the columns for the report, click the Select All () icon. To remove all the selected column, click the Remove All () icon. To select specific columns, select the checkbox adjacent to the column names as shown in the following screen shot:
Click the Group By drop-down and select the column(s) by which the report results are to be grouped.
Click the Sort By drop-down list and select the column(s) by which the report results are to be sorted.
If suppose you want to filter the report results based on some parameters, select the filter from the Select Filter drop-down list in the Filter Criteria section.

The columns in the Select Filter drop-down list is based on the configuration of Select Filterable Columns field while creating the report in Canvas Studio.
Select the filter condition from the Select Criteria drop-down, select or specify the sub-criteria and click Add.

The options in the Select Criteria drop-down list is based on the filter selected in the Select Filter drop-down list. A sample filter and criteria are shown in the following screen shot:
To specify multiple filter criteria for the report, perform steps 12 and 13.
Perform any of the following:
- To save the report, click Save.
  or
- To save and execute (generate) the report, click Save and Run.
Click OK for the confirmation message.

If you have clicked Save and Run, the generated report appears on the Generated Reports tab.
Wait till the report is generated, i.e. you must see the status as Success under the Running column. If the status is Inprogress, click the Refresh () icon to reload the generated report list. Hover on the generated report, the icons to download or execute the report appears.
To download the generated report, click the download () icon.
To execute the report again, click the execute () icon.

When you execute the report again, the report will be re-generated and the existing report file is updated.

The following screen shot shows a sample Sales Order report in HTML format:

The following screen shot shows a sample Sales Order report with group header and footer in HTML format:

The group header and group footer are displayed in the report only when Group By field is configured while saving or generating the report.

For scheduling reports in the end application, refer Scheduling Reports.