Skip to main content

Create a custom analytics report

This use case demonstrates how to create a new category, to create a paginated report and add that report to the newly created category. In short, to create a custom analytics category and report you must:

  1. Create a category for the Analytics app

  2. Build the report dataset using Microsoft’s Report Builder.

  3. Design the report appearance.

  4. Check that the report appears in the Analytics app.

See below for detailed steps.

Create a category for the Analytics app

To create a report category:

  1. Click Manage the system > Maintenance > System variables.

  2. Add a new category to CUSTOM ANALYTIC CATEGORIES.

    analytics-variable-example
  3. Click Update.

  4. Navigate to the <instance>\ReportItems folder and create a folder with the same name as the new category.

  5. Sign into the report server portal.

    The URL is in the following format:

    http://<servername><port>/Reports/browse/<report_folder_id>

    analytics-portal-example
  6. Open the ReportItems folder.

  7. Click New > Folder.

  8. Name the folder the same name as the new category.

Build the report on the report server
  1. From the report server portal, click New > Paginated Report.

    analytics-new-report

    If Report Builder is not installed yet, download and install it.

  2. Click Open Microsoft Report Builder.

  3. Click Blank Report.

  4. Right mouse click on Data Sources and click Add Data Source....

    analytics-data-sources
  5. Use the default name DataSource1 or change it to a different name.

    analytics-data-sources-name
  6. Click Browse and open the <report_folder_id>.

  7. Open the DataSources folder.

  8. Double click idmsuite.

  9. Click Test Connection to ensure the connection is successful.

    analytics-data-sources-success
  10. Click OK to close the window.

  11. Click OK again.

  12. Right mouse click on Datasets and select Add Dataset... .

    analytics-data-set-new
  13. Use the default name or change it to a different name.

  14. Select the radio button Use a dataset embedded in my report.

  15. Select the data source you previously added from the drop down menu in Data source.

    analytics-data-set-source
  16. Click Query Designer....

  17. Enter the report database user’s password.

  18. Click OK.

  19. Expand the database view in the left column to open Views.

  20. Select account.

    analytics-data-set-account
  21. Click OK.

  22. Click OK again.

    The dataset is created.

Design the report

To finalize the design of the port using Report Builder:

  1. Click Insert > Insert Table.

    analytics-report-insert-table
  2. Click anywhere in the blank report to add the table.

    A default table of three rows and three columns is inserted into the blank report.

  3. Move the cursor to the right edge of the rectangle box in the third row, first column.

    A drop-down list is displayed.

  4. Select accountname.

  5. Move to the next cell and select hostid.

  6. Select fullname in the last cell.

  7. Give the report a title.

    analytics-report-example
  8. Click File > Save.

  9. Save the report under the report folder ReportItems\Example on the report server.

  10. Click Run to see the rendered report.

    The report is rendered and displayed:

    analytics-report-example-rendered
  11. Click Design to go back to edit mode.

Check the Analytics app

To check that the report appears correctly in the Analytics app:

  1. Log in to Front-end (PSF).

  2. Click Analytics.

  3. View the new report in the Analytics app.

    analytics-report-example-rendered