Navigating from Charts

About Configuring Drill-Downs using URLs

Note: This feature is not available in Legacy Predix APM.

You can use APM URLs to configure drill-downs for a visual element (for example, bar) of a chart for accessing data associated with the visual element in the corresponding module. For more information on the APM URLs and URL syntax, refer to the URLs help.

When configuring drill-downs, you can create the following types of URLs that are used to navigate to the specific pages or features of the corresponding module:

  • URL with parameters: If the URL associated with the module contains a parameter, you must create a URL with the parameter to pass the parameter value from the chart to the corresponding module for accessing the associated data. If the URL uses dynamic parameters (for example, prompts), parameters with the same name are automatically created to pass the value when you select the visual element in the chart. Thus, you are navigated to the target page or feature of the module.
  • URL without parameters: If a URL associated with the module does not contain a parameter, you must create a URL without any parameter value.

Configure a Drill-Down for a Chart to Access Data in the Corresponding Module

Note: This feature is not available in Legacy Predix APM.

Before You Begin

About This Task

This task describes how to configure a drill-down for a chart using a URL and navigate to the corresponding module within APM to access the associated data. For more information on different types of drill-downs and how to configure drill-downs for the charts and reports, refer to the help integrated with Advanced Visualization.

Procedure

  1. Access the Advanced Visualization page.
  2. Access the chart for which you want to configure the drill-down.
  3. Right-click the chart, and then select Edit.
    The Advanced Visualization Designer page appears, displaying the chart in the designer canvas.
  4. In the Settings section, in the Vertical box, right-click the field for which you want to configure a drill-down, and then select Configure drill downs.
    The Configure Drill Downs for <Field Name> window appears.
  5. In the Configure Drill Downs for <Field Name> window, perform the following steps to configure the drill-down:
    1. In the Type section, select the URL option.
    2. In the URL box, enter the URL for the page that you want to access when you select the visual element of the chart.
      Tip: For more information on the URLs associated with a specific APM module, access the help documentation for the module, and then refer to the <Module Name> URLs topic.
      • If the URL does not contain any parameter, select Apply.
      • If the URL contains parameters (for example, {entitykey} and {sectionname} in the URL health/asset/{entitykey}/{sectionname}), perform the following steps:
        1. In the Parameters section, select the Add all target filters button.

          A table appears, displaying the following columns:

          • Parameter Name
          • Type
          • Field/Value
        2. In the table, enter the values as follows:
          • In the Parameter Name box, enter the name of the parameter.
          • In the Type box, select Field.
          • In the Field/Value box, select a field value based on the parameter that you specified in the Parameter Name box.
        3. Select Apply.
  6. Select the Save button to save the chart in your preferred workspace.
    The drill-down for the chart is configured.

Example: Access the Number of Health Indicators for an Asset from the Health Indicator Status by Asset Chart

This example provides the steps to configure drill-downs in the Health Indicator Status by Asset chart and view the number of health indicators in the Health Summary page.

  1. Access the Advanced Visualization page.
  2. Select Visualize Data.

    The Advanced Visualization Designer page appears, displaying a designer canvas to create the chart.

  3. Select the Add Data button.

    The Select Data Source window appears, displaying the available data sources.

  4. Navigate to the ahi folder, and then select the health_overview_status_by_asset data source.

    The Dimensions and Variables associated with the data source appear in the Advanced Visualization Designer page.

  5. In the Advanced Visualization Designer page, perform the following:
    1. From the Measures section, drag the following measures to the Vertical box of the Display section:
      • Alert
      • No Status
      • Normal
      • Warning
      • Asset Key
        Note: To hide the asset key, right-click the asset key and select Hide.
    2. From the Dimensions section, drag the following Asset ID measure to the Horizontal box of the Display section.
  6. In the Settings section, in the Vertical box, right-click an indicator status, and then select Configure drill downs.

    The Configure Drill Downs for <Health Indicator Status> window appears.

  7. In the Configure Drill Downs for <Health Indicator Status> window, perform the following steps to configure the drill-down for the health indicator status:
    1. In the Type section, select the URL option.
    2. In the URL box, enter the URL in the following format:

      health/asset/{entitykey}/indicator, where {entitykey} denotes the asset in the asset hierarchy for which you want to view the health indicators.

      Note: For more information on how to construct the URLs associated with Asset Health Manager, refer to AHM URLs.
    3. In the Parameters section, select the Add all target filters button.

      A table appears, displaying the following columns:

      • Parameter Name
      • Type
      • Field/Value
    4. In the table, enter the values as follows:
      • In the Parameter Name box, specify entitykey.
      • In the Type box, select Field.
      • In the Field/Value box, select HEALTH_OVERVIEW__STATUS_BY_ASSET.ROWS.ASSET_KEY.
        Note: You must select the field value based on the parameter that you specified in the Parameter Name box.
    5. Select Apply.
  8. Select the Save button to save the chart in your preferred workspace.

    The Health Indicator Status by Asset chart is created and saved in the workspace.

  9. Access the Health Indicator Status by Asset chart.
  10. Right-click the chart, select Run..., and then select Run in new window.

    The new tab appears, displaying the chart.

  11. Select the visual element (for example, bar) associated with the asset for which you want to view the number of health indicators.

    A new tab appears, displaying the number of health indicators for the selected asset in the Health Summary page.