Example - creating a simple report

This example demonstrates how to create a report that displays a table, graph and value, and uses a reporting parameter:

Creating a report category

1. Open the Reporting application.
2. Select the root of the reporting tree (the All reports category by default).
3. Click ... next to the New report button and select New category.
4. Type User reports as the Category display name.
5. You can leave the code name as (automatic).
6. Click Save.

Creating a new report

1. In the Reporting application, click New report.

2. Type Pages by page template as the Report display name.

3. Click Save.

   • Now you can edit the layout of the report and insert tables, graphs and values.
   • The General tab of the report editing interface opens.

4. Type Pages by page template into the Layout text area.

5. Select the text and use the editor to set the Format to Heading 1.

6. Click Save.

Creating a new table

1. On the report's General tab, click New in the Tables section below the layout editor.
2. Enter the following values:

   • Display name: Pages by Page Template

   • Query:

     SQL

     Copy

     SELECT PageTemplateDisplayName AS [Template Name], DocumentNamePath AS [Page]
      FROM View_CMS_Tree_Joined
      LEFT JOIN CMS_PageTemplate 
      ON CMS_PageTemplate.PageTemplateID = View_CMS_Tree_Joined.DocumentPageTemplateID
      WHERE PageTemplateDisplayName IS NOT NULL AND PageTemplateIsReusable = 1 
      ORDER BY PageTemplateDisplayName

Switch to the View tab to see the report table.

Creating a new graph

1. Switch back to the report's General tab.
2. Click New in the Graphs section below the layout editor.
3. Enter the following values:

   • Display name: Favorite Page Templates

   • Query:

     SQL

     Copy

     SELECT TOP 5 PageTemplateDisplayName AS [Template Name], COUNT(PageTemplateDisplayName) AS [Usage]
      FROM View_CMS_Tree_Joined
      LEFT JOIN CMS_PageTemplate 
      ON CMS_PageTemplate.PageTemplateID = View_CMS_Tree_Joined.DocumentPageTemplateID
      WHERE PageTemplateDisplayName IS NOT NULL AND PageTemplateIsReusable = 1
      GROUP BY PageTemplateDisplayName
      ORDER BY COUNT(PageTemplateDisplayName) DESC

 If you now switch to the View tab, you can see the report graph.

Creating new values

1. Switch back to the report's General tab.
2. Click New in the Values section below the layout editor.
3. Enter the following values:

   • Display name: Number of pages with page template

   • Query:

     SQL

     Copy

     SELECT COUNT(DocumentID)
      FROM View_CMS_Tree_Joined
      WHERE DocumentPageTemplateID IS NOT NULL

   • Is stored procedure: no

   • Formatting string: Pages with template: {0}

4. Click Save & Close.
5. Place the cursor in the layout editor under the graph.
6. Select the new value from the list in the Values section.
7. Click Insert.
   • The system adds a string like %%control:ReportValue?PagesByPageTemplate.NumberOfPagesWithPageTemplate%% into the text area.
8. Click Save.

 If you switch to the View tab, you can see the text of the value.

Defining report parameters

1. Switch to the Parameters tab.
2. Click New field and enter the following values:
   • Field name: UserID
   • Field type: Integer number
   • Default value: 53
   • Field caption: Created by user
   • Form control: User selector
3. Click Save.

Now you need to add the parameter to your queries. For the purposes of this example, modify only the table query.

1. Switch to the General tab.

2. Select Pages by page template in the Table list.

3. Click ... next to the New button and select Edit.

4. Modify the table SQL query like this:

   SQL

   Copy

   SELECT PageTemplateDisplayName AS [Template Name], DocumentNamePath AS [Page]
    FROM View_CMS_Tree_Joined
    LEFT JOIN CMS_PageTemplate
    ON CMS_PageTemplate.PageTemplateID = View_CMS_Tree_Joined.DocumentPageTemplateID
    WHERE PageTemplateDisplayName IS NOT NULL AND DocumentCreatedByUserID = @UserID
    ORDER BY PageTemplateDisplayName

Now switch to the View tab. You can see that the report has a filter:

The table now only displays template names of pages that were created by the user specified in the filter.