×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')
TrueSight Smart Reporting for Server Automation 19.01 Using

Creating reports

Use TrueSight Smart Reporting for Server Automation to create reports and change the appearance of the reports. You can also compare and analyze reports by using filters, summaries, and calculations.

The following report authoring options are available in TrueSight Smart Reporting for Server Automation:

  • Drag and drop - Drag and Drop builder allows you to use a pre-defined data view to build their reports. For information about the out-of-the-box views, see Accessing out-of-the-box views.
  • Freehand SQL - These allow you to define the query, rather than using a pre-defined view. For information about how to use the freehand SQL reports, see  Freehand SQL Reports Open link in the Yellowfin documentation. 

You can create the following type of reports:

  • Tabular report- Displays the data in the form of tables.
  • Charts - Displays the data in the form of graphics and are the graphic equivalent of tables.
  • Drill Through report - Displays the summarized and detailed information in a single table. You can click a hyperlink to another report and get a deeper insight into your data. You can create Drill Through reports by creating parent-child relationships between the reports that you want to link. You can link reports by using filters in the child reports.

This topic describes how to create different type of reports by using the drag and drop builder.

Best practices for creating reports

BMC recommends following these guidelines while creating reports to improve the reporting experience:

  • Disable the Auto Refresh option before dragging and dropping reporting columns.
  • Add the required basic filters before adding reporting columns.
  • Avoid the use of leaf level filters. For example, applying a filter on the "Patch Name" column.

  • Use out-of-the-box filters that provide better reporting performance due to indexes and statistics.

  • Set the Auto Sum parameter to none for the metrics field (where appropriate) as these metrics are specific to that hierarchy level. For example, Servers Attempted > Compliance Job Run Result

  • Important

    Use the Patch Model - Detail Information model instead of Patch Model - Summarized Information model to create custom reports for the Patch domain.

To create a tabular report

  1. Log in to TrueSight Server Automation - Data Warehouse. The TrueSight Smart Reporting - Platform Home page appears.

    1. Use the following URL to open the TrueSight Server Automation - Data Warehouse login page:
      https://<TrueSight Server Automation - Data Warehouse hostname>:<portNumber>/tssa-dw

    2. In the User Name and Password fields, enter the user credentials. By default, the password is hidden. To view the password, click .

    3. In Site, select a site. The Primary Site is the default site.
    4. In Authentication Method, select a authentication method. SRP is the default authentication method.
    5. Click LOG IN.
    6. In the Roles window, select the role you want to use and click OK. Through role-based access control (RBAC), you can be granted multiple roles, but you can use only one role at a time.

  2. Click  and click Report.
  3. Select the relevant view from the list of available views.

  4. In the view pane, expand the folders to view the fields for the report.

  5. Drag and drop the required fields in to the Columns field. If you want to filter the report after you generate it, drop the fields in the Filters section also.

    Best practice

    • Use date filters while creating reports, so that your report retrieves limited data.

    • In the Report Data area, enter a numerical value in the Preview Row Limit field to limit the number of rows visible in the report. However, be aware that this might truncate the data if the number of rows in the report exceeds the value that you specify.
    • If you are creating a report for large data, turn off the Auto Refresh feature to ensure that the report does not refresh every time you add or remove a field. You can turn off the Auto Refresh feature from the Report Data area.

  6. If you are creating reports for the Compliance domain, add the Server result site and role match with job site and role built-in filter to the report.

  7. Click Publish. In the Save Report window, do the following:

    • Enter a name and description for your report.

    • If required, use the Add tags field to add tags. Tags are useful to search for reports after you generate them.

    • In the Report Access area, select Public or Private.
      If you select Public, all users on the tenant can access the report.
      If you select Private, you can see the User Access tab. Use this tab to specify the users who will have access to the report.

    • If required, use the Distribution, Report Settings, and Refresh tabs. To know more about the tabs, see Saving a Report Open link (https://wiki.yellowfinbi.com/display/user80/Saving+a+Report).

  8. Click Save to generate and view the tabular report.

To create a chart report

  1. Log in to TrueSight Server Automation - Data Warehouse. The TrueSight Smart Reporting - Platform Home page appears.

    1. Use the following URL to open the TrueSight Server Automation - Data Warehouse login page:
      https://<TrueSight Server Automation - Data Warehouse hostname>:<portNumber>/tssa-dw

    2. In the User Name and Password fields, enter the user credentials. By default, the password is hidden. To view the password, click .

    3. In Site, select a site. The Primary Site is the default site.
    4. In Authentication Method, select a authentication method. SRP is the default authentication method.
    5. Click LOG IN.
    6. In the Roles window, select the role you want to use and click OK. Through role-based access control (RBAC), you can be granted multiple roles, but you can use only one role at a time.

  2. Click  and click Report.
  3. Select the relevant view from the list of available views.

  4. In the view pane, expand the folders to view the fields for the report.

  5. Drag and drop the required fields in to the Columns field. If you want to filter the report after you generate it, drop the required fields in the Filters section also.

    Best practice

    • Use date filters while creating reports, so that your report retrieves limited data.

    • In the Report Data area, enter a numerical value in the Preview Row Limit field to limit the number of rows visible in the report. However, be aware that this might truncate the data if the number of rows exceeds the value that you specify.
    • If you are creating a report for large data, turn off the Auto Refresh feature to ensure that the report does not refresh every time you add or remove a field. You can turn off the Auto Refresh feature from the Report Data area.

  6. If you are creating reports for the Compliance domain, add the Server result site and role match with job site and role built-in filter to the report.



  7. If you want to create reports for the Patch domain, add the Filter current user Site and Role data built-in filter to the report.



  8. If you are creating reports for the Patch domain by using the server-level attributes (for example, OS name, OS version, and Server name) and patch-level attributes (for example, Patch Name, Patch Type, and Patch Catalog Group), add the PatchServer Filter to the report.



  9. If you want to create reports for the Inventory Domain for any asset using the Server and Job attributes, use the filters that are available under the individual Asset folders.

  10. Click Charts.

  11. Click Auto Chart and then click Select Chart Type to open the Select Chart pane.
    Alternatively, click  in the upper right corner.

  12. Select a chart type to use as an output for your report and generate your report.
  13. Click Publish. In the Save Report window, do the following:

    • Enter a name and description for your report.

    • If required, use the Add tags field to add tags. Tags are useful to search for reports after you generate them.

    • In the Report Access area, select Public or Private.
      If you select Public, all users on the tenant can access the report.
      If you select Private, you can see the User Access tab. Use this tab to specify the users who will have access to the report.

    • If required, use the Distribution, Report Settings, and Refresh tabs. To know more about the tabs, see Saving a Report Open link (https://wiki.yellowfinbi.com/display/user80/Saving+a+Report).

  14. Click Save to generate and view the chart report.

To create Drill Through reports

  1. While creating a report, set the filter value to User Prompt. Do the following to set the filter value:

    1. Log in to TrueSight Server Automation - Data Warehouse. The TrueSight Smart Reporting - Platform Home page appears.

      1. Use the following URL to open the TrueSight Server Automation - Data Warehouse login page:
        https://<TrueSight Server Automation - Data Warehouse hostname>:<portNumber>/tssa-dw

      2. In the User Name and Password fields, enter the user credentials. By default, the password is hidden. To view the password, click .

      3. In Site, select a site. The Primary Site is the default site.
      4. In Authentication Method, select a authentication method. SRP is the default authentication method.
      5. Click LOG IN.
      6. In the Roles window, select the role you want to use and click OK. Through role-based access control (RBAC), you can be granted multiple roles, but you can use only one role at a time.

    2. Click  and click Report.
    3. Select one of your views.

    4. In the view pane, drag and drop a field to the Columns field.

    5. Drag and drop a field to the Filters area. Ensure that you have dropped this field in the Columns field also.

    6. Click the  icon in the field that you dropped in the Filters area.
    7. Hover over Value, and then select User Prompt.
    8. Click Publish.



  2. Create parent-child relationships between the reports that you want to link. Do the following to create parent-child relationships:
    1. Ensure the following:
      • The reports that you want to link exists. See Creating reports for instructions on creating a report.
      • You have set the filter values of the reports to User Prompt.
    2. Open the report that you want to use as the parent.
    3. Click Edit, and then click Data.
    4. On the message, click Ok.
    5. In the Analysis style area, click Drill Through. The Related Content tab appears.
    6. Click the Related Content tab.
    7. In the Drill Through area, drag and drop the report that you want to use as the child report.
    8. In the Join Type area, click Drill Through.
    9. In the Joins area, in Master Field, select the filter that will be a hyperlink to open the child report.
      Under Child Filter, you can see the filter that you created in the child report.
    10. In Hyperlink field, select the field in the parent report that will be a hyperlink to open the child report. 
    11. If you want to open the child report in a new window, click the Popup New Window option, and click Update.
    12. Publish the report. In the published report, you can see the hyperlink on the field that you selected.
    13. Click the hyperlink. You can see the child report that you joined with the parent report.

Related topics

Use case for creating a custom report

Accessing out-of-the-box views

Was this page helpful? Yes No Submitting... Thank you
Last modified by Bipin Inamdar on Nov 30, 2020

Comments

Log in or register to comment.

Customizing out-of-the-box reports
Use case for creating a custom report
© Copyright 1996-2019 BladeLogic, Inc.
© Copyright 2014-2019 BMC Software, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.