Report Designer/Data Source

Report Designer/Data Source

1. Overview

The Report Designer/Data Source page allows users to.

  • view, search and select data sources to be used in a report.

  • set up and validate relationships between data sources in a report.

image-20251007-091417.png
Figure 1.1

2. View data sources

  • STEP 1: Click the New Report (+) icon on the left-hand menu and select New Report. You will be directed to the Data Source page.

  • STEP 2: Browse the visible tables, views, or stored procedures provided by Riskonnect in the Middle Panel.

  • STEP 3: Collapse or expand categories by clicking the category name to manage the view efficiently.

 

image-20251007-091621.png
Figure 2.1

Note: It is recommended to collapse the left menu to maximize screen space for report design.

image-20251007-091707.png
Figure 2.2
  • STEP 4: Use the Search box at the top to find specific data sources by typing a partial name and clicking the search icon. Matching data sources or fields will be displayed.

image-20251007-091810.png
Figure 2.3

3. Select and unselect data sources

  • STEP 1: Click the + icon next to a data source to select it. Selected data sources appear in the top section.

  • STEP 2: Existing relationships between selected data sources are automatically added to the Relationship list in the Content Panel.

image-20251007-091900.png
Figure 3.1
  • STEP 3: To remove a data source, click the bin icon next to the data source under “Selected Data Sources.” Confirm removal; relationships linked to deleted data sources will also be removed.

4. Set the report as Distinct

  • STEP 1: Tick the Distinct checkbox at the top of the Middle Panel to return only unique values in the report.

  • STEP 2: Leave it unticked to allow duplicate values in the results.

5. Set the number of preview records

Configure the amount of data shown in the preview panel by selecting from the Preview Records dropdown at the top.

6. Save the Report

  • STEP 1: Click the Save button at the top to open the Save pop-up.

  • STEP 2: If the report is already saved, choose Save As to create a new report.

 

Figure 6.1
  • STEP 3: Enter a name for the report in the Report Name box.

  • STEP 4: Select Save as Template (or Save as Report after adding at least one field).

Note: The option to save as Report is only available after at least field is added to the report from the Report Designer/Design page.

image-20251007-092031.png
Figure 6.2
  • STEP 5: Choose a Category and optionally a Sub-Category. You can create a new category or sub-category by typing the name and pressing Enter.

  • STEP 6: Click OK to save the report.

Note: The report name must be unique within the same category.

Figure 6.3

7. Add and remove relationships

  • STEP 1: Select multiple data sources to define relationships between them.

For example, you need to create a join manually in a case where you want to get the KPIs which are linked to Goals - this means that the Planning_KPILinks_STND must be joined with Planning_PlanningHierarchy_STND. This is usually not setup as a default because a KPI can link to Goal, Outcome or Strategy levels. When you wish to retrieve the KPIs linked to Goals only, you can build the following join relationship manually.

[KPILinks_STND].[GOALID] = [Planning_PlanningHierarchy_STND].[GOALID].

  • STEP 2: Click Add Relationship to insert a new row in the Relationship list.

  • STEP 3: Select values in the following order:

    • Join Type (e.g., Left)

    • Category, Data Object, Join Field

    • Category, Foreign Data Object, Field

Note: For more information about different Join Types click here.

 

Select values in Category, Data Object, Join Field, then Category, Foreign Data Object and Field in left-to-right sequence for data to populate correctly.

Select data so that the row reads: | Planning | KPILinks_STND | GOALID | = | Planning | Planning_PlanningHierarchy_STND | GOALID |

image-20251007-092122.png
Figure 7.1
  • STEP 4: Click Validate Syntax to confirm the relationship.

Figure 7.2
  • STEP 5: Copy existing relationships using the Copy icon for faster setup.

  • STEP 6: Remove unnecessary relationships using the Remove (X) icon.

 

8. Add Key Join Relationship

  • STEP 1: After creating a basic join, click Add Key Join to insert a blank row for additional columns.

  • STEP 2: Select values in the same left-to-right sequence as normal relationships.

  • STEP 3: Click Validate Syntax to confirm.

image-20251007-092156.png
Figure 8.1

Note: An example scenario that would require a Key Join is where you want to get a list of KPIs which are linked at either Goal or Outcome Levels. In this case you would use an OR for the Operator.

9. Add Join Alias

  • STEP 1: Assign a Join Alias when joining the same table multiple times to differentiate data objects.

  • STEP 2: Select Join Type, Category, Data Object, Join Field, Field Comparison, Foreign Category, Foreign Data Object, and Foreign Field.

  • STEP 3: Use meaningful aliases (e.g., Parent vs Child Project) to avoid confusion in subsequent join clauses.

For example, to get data of Parent Projects and Child Projects, the Project_ProjectDetails_STND dataset needs to be joined with itself:

Join Alias

Join Type

Category

Data Object

Join Field

Field Comparison

Category

Foreign Data Object

Join Field

Join Alias

Join Type

Category

Data Object

Join Field

Field Comparison

Category

Foreign Data Object

Join Field

Parent

Left

Project

Project_ProjectDetails_STND

PROJECTID

=(Field)

Project

Project_ProjectDetails_STND

PARENTPROJECTID

Since the Project_ProjectDetails_STND datset is used twice it should be given a meaningful alias as shown - this allows you to differentiate between say the Project Owner of a Parent Project vs the Project Owner of a Child Project.


Release Note Footer Template-20250521-120157.jpg