This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

Creating queries with folding rules in BMC Atrium Explorer

When you run a query in BMC Atrium Explorer — for example, you expand a business service — too much data can clutter your view. You might want to see only the direct links between servers and not the IP Endpoint configuration items (CIs). To hide CIs returned from a query, you can create a query that uses "folding" rules to hide instances that are currently visible.

Query view that uses folding rules


When you run the query that uses folding rules, the Query view displays the graphical results in BMC Atrium Explorer. The Query view is a restricted view of the CIs, limited to the data returned from the query. The CIs returned in the Query view are a static snapshot of the data. As a result, the types of operations that you are allowed to perform are limited:

  • You can expand the parents and children of a CI, but the data is always displayed in a popup. You cannot add parent or children CIs back to the Query view.
  • If you are querying any dataset other than the BMC Asset dataset, you can edit the CIs returned. However, you cannot create or delete CIs or relationships in the Query view.
  • You cannot save a Query view.

The following example shows how to create a query that displays Calbro Computer CIs that are related to operating system CIs in the Query view but folds the CD ROM and Disk Drive CIs.

Before you begin

As test data, create the following CIs:

  • Calbro_CDROMDrive_1
  • Calbro_OperatingSystem_1

Create Component relationships with the Calbro Computer System CI that you earlier related to the Calbro_DiskDrive_1 CI. When you are finished, promote your changes to the BMC Asset dataset.

To create queries with folding rules

  1. Edit the advanced query that you created previously.
    (optional ) In the General Information tab, change the name of the query to Folded CIs.
  2. Click the Editor tab.
  3. Drag the CDROM Drive and Operating System classes into the lane next to the Disk Drive class in the query.
  4. Create Component relationships with the Calbro Computer System CI.
  5. Click the Viewing Options tab to select the CI attributes for display in the query output table.
  6. Click the Folding tab.
    The following figure displays a preview of your query. If you run this query without modification and you opened the Computer System CI inside the Query view, all three related CIs are displayed.

    Query Preview
  7. In the left pane, click the Computer System class.
    The Computer System icon now displays a folder that indicates the three related classes have been folded in the query. The Query Preview pane shows that your query, if unmodified, displays only Computer System CIs. The other related CIs are not displayed in the Query view.
  8. In the left pane, click the Operating System class.
    As shown in the following figure, the Query Preview pane now shows that your query displays Computer System CIs that are related to Operating System CIs. The other CIs are folded into the Computer System CI.

    Creating query with folding rules
  9. Click Save to close the Query dialog box.

To test the results of your folded query

  1. Under the Calbro Services category, select the modified Folded CIs query.
  2. Click Search.
  3. Drag the CI into the display pane.
    The CI automatically expands and you see that the Computer System CI is related to the other three CIs.
  4. To test the folded query, click Show Results as Query View.
  5. Click Search.
    The results are returned in the Query view (as shown in the following figure). Query view is a split-pane view with result rows listed on the left and a topology canvas on the right. You select rows in the list to show their graphs on the canvas.
  6. (optional ) Use the accordion slider bar to resize the results list and the Query view.
  7. Click the Computer System CI in the results list.
    Only the Computer System CI and the Operating System CI are displayed in the Query view. The yellow folder icon is a visual indication that one or more CIs have been folded into the Computer System CI. If needed, you can switch between multiple views.

    Folded query displayed in the Query view
  8. In the Query view, perform one of the following actions:

    Action

    Step

    Select one or more CIs from the results list

    • Click Select All to display all the CIs from the list.
    • Press the Ctrl key and then click another CI in the results list to display it.

    Unfold or fold the hidden CIs

    1. Select the CI.
    2. Click the down arrow.
    3. Select Unfold. The hidden CIs are displayed.
    4. Click the down arrow on the original CI and then select Fold to hide the CIs. The hidden CIs are no longer displayed.

    Edit CIs from the Query view

    1. Set the query options to the Sandbox or BMC Sample dataset.
    2. Search for the CI.
    3. Select a row to display the CI in the Query view.
    4. Select the CI.
    5. Click the down arrow.
    6. Select Edit or QuickEdit.

    View the children and parents of a CI in a display-only popup

    1. Double-click the CI. The children and parent CIs are displayed according to their relative layer in a popup. You can also click the down arrow on the CI and then select one of the Expand options (for example, Expand Both).
    2. Click the close icon to close the popup. Because the CI data that is returned is static, you cannot add the CIs back into the Query view.

Creating a query with nested folding rules

Your query can include nested folds. You can nest folded CIs inside other folded CIs. For example, the sample query that follows folds the Computer System and Software Server classes inside the query. The benefit is that the returned items are hidden if they are folded, and you have a more focused view with which to view the returned results.

Before you begin

Create a sample service model (for example, select Business Service > Application > Application Infrastructure > Software Server > Computer System ). When you are finished, promote your changes to the BMC Asset dataset.

To create a query with nested folding rules

  1. Create a new query.
  2. Click the Editor tab and drag the CI classes into their appropriate lanes.

    Adding classes to the query
  3. Create relationships between the CI classes (for example, Has Impact).
  4. Click the Viewing Options tab.
  5. Click the Folding tab.
  6. Build the nested folds:
    1. Create the inner fold by clicking a class (for example, Software Server).
      This action folds the Computer System class (indicated by the light blue box) under the Software Server class (indicated by the folder in the dark blue box). If you ran this query without further modifications, Computer System CIs are not displayed because they are folded (as shown in the Query Preview pane).
    2. Click outside the object tree.
    3. Create the outer fold by clicking another class (for example, Application Infrastructure).
      The left pane shows that you nested a fold inside a fold:
      • Software Server is folded under Application Infrastructure
      • Computer System is folded under Application
        The Query Preview pane shows that your query displays only Business Service, Application, and Application Infrastructure CIs.

        Building the nested fold
  7. Click Save to close the Query dialog box.

To test the results of your nested folding query

  1. Select the nested folding query.
  2. Click Show Results as Query View.
  3. Click Search.
    The results are returned in the Query view.
  4. Click the CI in the results list.
    The Business Service, Application, and Application Infrastructure CIs are displayed in the Query view. The yellow folder icon on the Application Infrastructure CI is a visual indication that one or more CIs are included in the folds.
  5. Click the Application Infrastructure CI and then select Unfold.
    The Software Server CI is displayed. It also displays a yellow folder icon.
  6. Click the Software Server CI and then select Unfold.
    The Computer System CI is displayed.

    Query with a nested fold

    Note

    You cannot save a Query view. The main value of a Query view is that it is a restricted view of the CIs, a static snapshot limited to the data returned from the query.

Was this page helpful? Yes No Submitting... Thank you

Comments