Creating New Advanced Reports
- Enterprise IT
What are Advanced Reports?
The Administrators can create Advanced Reports as per the specific requirements of the organization using the Advanced Reports option available in the SummitAI application. Many Advanced Reports are available in the Application by default. For more information about list of Advanced Reports, see List of Advanced Reports.
Caution:
The advanced BI reports are not supported on the older versions of SummitAI for SaaS-enabled database. The Administrators on SaaS-enabled database are advised to create advanced BI reports only if the version of the SummitAI application is Sierra SP1 HF02 or later.
Note:
SaaS-enabled database stores user list of all the Advanced BI reports that belong to multiple Tenants. Also, while logging in, the SaaS-enabled DB validates the user and connects with an appropriate Tenant. For more information on saaS enabled DB for multi-tenant in advance BI reports, see SaaS Enabled DB for Multi-Tenant in Advance BI Reports.
Note:
To view Advanced Reports tile on the Reports page:
- Select Admin> Basic > Users > Role Template. The ROLE TEMPLATE page is displayed.
- Click Filters on the ACTIONS panel. The FILTERS pop-up page is displayed.
- Select the Domain from the drop-down list and click SUBMIT. A list of configured Role Templates for the selected Domain is displayed.
- Select the required ROLE TEMPLATE from the LIST. The ROLE TEMPLATE - MENU CONFIGURATION page is displayed.
- Click REPORTS from under the MODULES section.
Under the Admin menu, select the Edit and View check boxes of Advanced Reports to provide the edit and view access.
See Screenshot
Figure: ROLE TEMPLATE - MENU CONFIGURATION page
Advanced Reports - Various Menus
The users can create new advanced reports using the following menus:
- Data Source: This menu allows the user to perform the following:
- View, search, and select data sources to be used in a report
- Set up and validate relationships between data sources in a report
- Design: This menu allows the users to perform the following:
- View data source fields’ properties
- Add report-level calculated fields
- Define report filters based on data source fields
- Add report parts to report body
- Add data source fields to report
- Configure formatting and calculation properties for data source fields in report
- Format: This menu allows the users to perform the following:
- Layout and format report header and footer
- Enter report title and description
For more information, see Formatting Reports section.
- Exporting: This menu allows the users to perform the following:
- Make changes to report layout for exporting
- Report preview
For more information, see Exporting Reports section.
- Schedule: This menu allows the users to perform the following:
- Add, copy, and remove schedules
- View scheduled deliveries
For more information, see Scheduling Reports section.
- Access: This menu allows the users to perform the following:
- View and change report owner
- View list of sharing
- Add and remove sharing
For more information, see Report Access Permissions.
Note:
As an in-built feature of the BI reports for Alps release, the users can deactivate the unused BI reports from the front end.
Creating Advanced Reports
To create new Advanced Reports:
- Click Reports menu. The following page is displayed:
- Click Advanced Reports tile. The following page is displayed:
Figure: Reports Dashboard - To create a new report, click the add icon besides the Reports tab.
- The Data Source list is displayed.
- Search and select the Data Sources to be used in a report from the Data Sources panel.
Figure: Data Sources Selection - Enter the Report Name.
Figure: Report Name - Click Design in the left menu to add report parts, add filters, and use the fields to create the report body.
Figure: Report Design Report Design: The Report Design includes following two sections:
Adding FiltersFrom the data sources, users can add report filters to select only the rows that they need.
- Click the Add Filter button and select the filter field from drop-down list.
- With the filter selected, the Filter Properties Panel is enabled.
- Users can configure the properties in Filter Properties and see the changes in the Preview pane.
Figure: Report Design: Filter Selection
Adding ReportThere are many ways to display data in a report. The built-in report parts include the following:
- Chart (Bar Chart, Line Chart, Pie Chart, etc.)
Chart is a built-in type of report part that displays data using graphical symbols, such as bars in a bar chart, lines in a line chart, or slices in a pie chart.
- Form
Form is a built-in type of report part that allows WYSIWYG editing in HTML.
- Gauge
Gauge is a built-in type of report part that displays data using a speedometer.
- Grid (Horizontal, Vertical, Pivot)
Grid is a built-in type of report part that displays data in a tabular format. It currently supports four different grid styles: Vertical, Horizontal, Pivot and Drill-down.
- Map
Map is a built-in type of report part that displays data on geographic maps, ranging from world map to continent and country maps.
For more information about the various types of Reports, see Report Types.
- Select Grid as the Report Part Type.
- Once you select your report part type, you are redirected to the Configuration Mode.
Figure: Report Design: Filter and Report Part Selection - Type in the Title and Description for the report.
Click the Add a field icon, the Field Selection window is displayed.
Figure: Report Design: Field Selection
Add the required data source fields to the Columns and Separators field.
- Click the Save button at the top-right of the page, the Save window is displayed.
Select the Category and Sub-category from drop-down list, and then click OK to save the report.
Note:
- Click the Delete icon in the configuration header to remove the report part.
- Click the Switch to Preview Mode icon in the configuration header to switch to preview mode.
Formatting Reports
The Format menu allows the users to add Report Header, Footer, Title, and Description.
To add Report Header and Footer:
- Click Format in the left menu. The following page is displayed.
Figure: Report Formatting: Report Header & Footer - Select Report Header & Footer check-box to display Report Header and Report Footer sections.
- Click Add Item, the Add Item pop-up is displayed.
Figure: Add Item - Select an item type from the drop-down list and click OK to close it.
Items properties are grouped in the following sections:
General InfoFor an Image:
- Type in the Item Name.
- Type in the Image URL.
For a Text item:
- Type in the Item Name.
- Type in the Item Value.
For a Date Time, Page Number, Horizontal Rule, and Vertical Rule item:
- Type in the Item Name.
Item FormattingFor Date Time and Page Number:
- Choose a display Format
For Text, Date Time and Page Number:
- Choose a Font and Font Size.
- Choose text effects bold, italic and underlined.
- Set text color and cell color.
- Choose text alignment left, center, right or justify.
For Horizontal Rule and Vertical Rule:
- Select a line pattern: Solid (default), Dot or Dash.
- Select a line color.
- Select the line thickness (in pixels).
- Click Save at the top.
To add Report Title and Description:
- Click Format in the left menu. The following page is displayed.
- Select Report Title & Description check-box to display Report Title and Description sections.
Figure: Report Formatting: Report Title & Description - Type in the Title and Description in the respective text boxes.
Click on icon to open Format Properties box.
Configure the properties in Item Formatting group:
- Choose a font face and font size.
- Choose text effects bold, italic and underlined.
- Set text color and cell color.
- Choose text alignment left, center, right, or justify.
- Click Save.
Exporting Reports
On this page you can preview the report that you designed and make changes to the report layout for exporting. The following table describes the fields on the Exporting page:
Field | Description |
---|---|
Orientation | Select the Orientation for the report from the drop-down list. |
Margins | Select the Margin from the drop-down list. Note: Select Custom to type in the customized margin values. |
Center on page | Select the Horizontally check box if you want the information centered left-to-right between the margins of the page. Select the Vertically check box if you want the information centered top-to-bottom between the margins of the page |
Page Break After Report Part | Select the check box to add Page Break after report part |
Export | Click Export to export into |
Save | Click Save to save the changes. |
Cancel | Click Cancel to discard all the changes |
Report Viewer | Click Report Viewer to preview the report |
Scheduling Reports
The Schedule menu allows the users to add, copy, remove, and view schedules.
To add a Schedule:
- Click Schedule in the left menu. The following page is displayed.
Figure: Report Schedule - Click the Add Schedule to open the Add Schedule pop-up.
Figure: Add Schedule pop-up - Type in the Instance Name for this schedule.
- In Schedule tab:
Select Scheduling Type:
Scheduled Alert: delivered only if report has data at scheduled time.
Scheduled Reporting Item: delivered regardless whether it has data or not at scheduled time.
- Select desired Time Zone.
- Select a Start Date.
- Select the Start Time (some common values can be quickly selected from the predefined list).
- Select a common Recurrence period from the list or select Custom Recurrence to define a different one.
- In Delivery tab: Under the Delivery Type drop-down list, there are two types of delivery type is available:
- Email: to send the report to the email address of selected users.
- File Location: save the report as a file
If Delivery Type is selected as Email
Select Delivery Method: The available Delivery Methods are:
Link: email a Link
Attachment: email an Attachment
Embedded HTML: email an Embedded HTML.
Click Add icon to Add Recipient(s).
Re-select values for report filters.
Figure: Add Schedule: Delivery Type: Email
If Delivery Type is selected as File Location
- Select Delivery Method as Send to disk.
- Select the Export File Type: PDF, Word, Excel, CSV, XML, or JSON from drop-down list.
- Re-select values for report filters.
Figure: Add Schedule: Delivery Type: File Location
- Click OK to close Add Schedule pop-up.
- Click Save at the top to add a schedule.
Figure: Schedule List
Note:
- Click Edit icon to edit the created schedule.
- Click Copy icon to create copy of selected schedule.
- Click Delete icon to delete the selected schedule.
Report Access Permissions
The Access menu allows the user to add and remove sharing, view and change report owner, and view list of sharing
To add sharing:
- Click Access in the left menu. The following page is displayed.
Figure: Access: Add Sharing - Click Add Sharing to add a new row in the list.
- Select the type of people to share with: Everyone, Role or User.
- For Role, click Select User icon, the All Roles pop-up window is displayed.
- Select the roles from the drop-down list and click OK to close Add Roles pop-up.
Figure: All Roles - For User, click Select User icon, the All Users pop-up window is displayed.
Figure: All Users - Select either User Name, Email Address or Role to search for. Select All to search for all fields.
- Type a partial name into the search box and click the search icon ().
- Only matching users will be displayed.
- Select one or more users then click OK to close the pop-up.
- Select an Access Right from the drop-down list.
Click Save button at the top to save the access permissions.
Note:
The following guidelines should be followed while providing 'View Only' access to an individual report:
- When ‘View Only’ access is given for an individual report, the same report cannot be viewed by an end user/logged-in user.
- To give ‘View Only’ access to an individual report, it is mandatory for an end user/logged-in user to have access to the Parent Folder (Category and Sub-category)
- Whenever ‘View Only’ access is given to an individual report, Parent Folder (Category and Sub-category) access will not be provided by default. Parent Folder (Category and Sub-category) access has to be given manually.
- If ‘Full Access’ is given to an individual report then by default the Parent Folder (Category and Sub-category) access will be added to an end user/logged-in user. No manually access is required to be given.
View and Change Report Owner
The Report Owner is displayed next to the report name.
To change Report Owner:
- Click the Select User icon to open All Users pop-up.
Figure: All Users - Select either User Name, Email Address or Role to search for. Select All to search for all fields.
- Type a partial name into the search box and click the search icon ().
- Only matching users will be displayed.
- Select the user then click OK to close the pop-up.
- Click Save button at the top to save the report together with the owner.
Different Types of Reports
Grid is a built-in type of report part that displays data in a tabular format. It currently supports 4 different vertical, horizontal, pivot and drill-down styles.
Configure Report Part Properties for Grid:
- Select the Grid in Report Body.
- Click the expand icon (<) on the right to open the Properties boxes.
- Select the Report Part Properties box.
- Grid properties are grouped in the following seven sections.
- General Info
- Table
- Columns
- Headers
- Grouping
- View
- Printing
- User can define the properties and see changes reflected in Preview pane.
Figure : Report Part Properties: Grid
Chart is a built-in type of report part that displays data using graphical symbols, such as bars in a bar chart, lines in a line chart, or slices in a pie chart.
Configure Report Part Properties for Chart
- Select the chart in Report Body.
- Click the expand icon (<) on the right to open the Properties boxes.
- Select the Report Part Properties box.
- Chart properties are grouped in the following seven sections:
- General Info
- Chart
- Labels
- Legends
- Grouping
- Data
- View
- User can configure the properties and see changes reflected in Preview pane.
Figure: Report Part Properties: Chart
Gauge is a built-in type of report part that displays data using a speedometer.
Configure Report Part Properties for Gauge
- Select the Gauge in Report Body.
- Click the expand icon (<) on the right to open the Properties boxes.
- Select the Report Part Properties box.
- Gauge properties are grouped in the following seven sections:
- General Info
- Gauge
- Grouping
- View
- Printing
- User can configure the properties and see changes reflected in Preview pane.
Figure: Report Part Properties: Gauge
Map is a built-in type of report part that displays data on geographic maps, ranging from world map to continent and country maps.
Configure Report Part Properties for Map
- Select the Map in Report Body.
- Click the expand icon (<) on the right to open the Properties boxes.
- Select the Report Part Properties box.
- Map properties are grouped in the following seven sections:
- General Info
- Map
- Labels
- Legends
- Data
- View
- User can configure the properties and see changes reflected in Preview pane.
Figure: Report Part Properties: Map
Form is a built-in type of report part that allows WYSIWYG editing in HTML. Users can do the following:
Configure Report Part Properties for Form
- Select the Form in Report Body.
- Click the expand icon (<) on the right to open the Properties boxes.
- Select the Report Part Properties box.
- From properties are grouped in the following seven sections.
- Form
- Edit
- Tool
- View
- User can configure the properties and see changes reflected in Preview pane.
Figure: Report Part Properties: Form
Creating BI Dashboards
The Administrators can configure a dashboard to display the module-based tab-wise BI reports. The configured dashboard can be accessed from the Dashboard menu of the End User Dashboard page. You can create BI Dashboards by using the Dashboards tab on the Advanced Reports page. However, we recommend using the BI DASHBOARD CONFIGURATION page for better user experience. For more information about creating BI Dashboards, see Configuring Dashboards.
Confluence Cloud Migration Alert: Please refer to known issues you may encounter in Confluence Cloud: https://eitdocs.atlassian.net/wiki/x/wDGwAQ