iConsole User Guide › iConsole Administration › Managing Searches, Reports, and Dashboards › Derive a New Search

Derive a New Search

A derived search is similar to a customized search in that both are variations of an existing search. But unlike normal customized searches, derived searches can be published and made available to users.

It is also possible to edit the XML definition file of a derived search, allowing you to change text labels and default parameter values. In addition, unlike normal customized searches, a derived search can be based on an unpublished existing search. This is useful, for example, if you want users to use a modified version of the default iConsole Standard Search but without the 'real' Standard Search being available to them. For full implementation details, see the iConsole Search Definition Guide; search for 'derived searches'.

To derive a new search from an existing search

1. Go to the Administration tab and click Searches.

   The Manage Stored Searches screen appears.

2. Click the check box for the search you want to use as the start point.
3. Click Actions, Edit Properties

   The Properties dialog appears.

4. Specify the search properties for the new search.

   For example, choose which columns to show in the results screen. You can also click Customize to hide or unhide available search parameters.

5. Click Save to save the customized search.
6. In the Save Search dialog, enter a name and description for the modified search.
7. Export and edit the underlying XML search definition.

More information:

Test a search

Publish or Unpublish a Search

Export a Search as XML

Export a Search as XML

Not all search modifications can be made directly in the iConsole. If you want to change the text labels for search parameters or amend other parameter attributes, export the search and edit the underlying XML in the new definition file.

To edit the XML search definition:

1. Go to the Administration tab and click Searches.

   The Manage Stored Searches screen appears.

2. Click the check box for the search you want to export.
3. Click Actions, Export.
4. Use an XML editor to modify the exported XML file.

To re-install the modified XML search definition file:

1. Return to the Administration, Manage Stored Searches screen.
2. Click the Actions link at the top left of the screen.

   The Install Searches dialog opens.

3. Specify the modified XML file in the Install Searches dialog.

   The new derived search, including the latest XML modifications, is added to the Searches folder.

4. Test the new search to confirm that it returns results as expected.
5. Publish the new search.

   When you publish a new search, it becomes available to all other iConsole users and is listed in the Review tab.