MicroStrategy ONE

Search for Objects dialog box: Contained By searches

The Contained By tab allows you to search for:

  • Objects that are used by other objects of a certain type

  • Objects that are used by one or more items in a list of objects

The Contained By tab is not available if either of the following is true:

  • If you are searching for either application objects or public objects and the Contained By tab has been disabled. To enable it, from the Tools menu, choose Options. Select the Show 'Contains' and 'Contained by' tabs check box, and click OK.

  •  If you are searching for configuration objects by accessing the Search for Objects dialog box from the Search for Configuration Objects option in the Administration menu.

To search by Contained By criteria

  1. From the Tools menu, choose Search for Objects. The Search for Objects dialog box opens.

  2.  If the Contained By tab is not visible, and you are searching for either application objects or public objects:

    1. From the Tools menu, choose Options. The Search Options dialog box opens.

    2. Select the Show 'Contains' and 'Contained by' tabs check box.

    3. Click OK to return to the Search for Objects dialog box.

    The Contained By tab is not available if you are searching for configuration objects by accessing the Search for Objects dialog box from the Search for Configuration Objects option in the Administration menu.

  3. Click the Contained By tab.

  4. To search for objects which are contained by a specific object type, select the object type from the Contained by any object of this type drop-down list.

  5. To search for objects which are not contained by a specific object type, select the object type from the Not contained by any object of this type drop-down list.

    Contained by any object of this type and Not contained by any object of this type are not mutually exclusive; you can use them simultaneously as search criteria.

  6. To search for objects that are contained by specific objects:

      1. Select either All of the selected objects or At least one of the selected objects.

      2. Click Add. The Select Objects dialog box opens.

      3. In the list of Available objects, locate and select the object or objects that you want to use to restrict the search.

      4. Click > to add the objects to the list of Selected objects.

      5. Click OK to return to the Search for Objects dialog box.

      6. If you want to make changes to the selected objects, click Modify. The Select Objects dialog box opens. Make the changes, and click OK.

      7. To remove all the selected objects, click Clear.

      8. To search for the selected objects recursively, select the Search for "contained by" objects recursivelycheck box.

  7. A search can contain multiple criteria. For example, you can search for objects based on their owner, type, last modification date, and the object types that they are contain by. Using more criteria in your search can help restrict the number of results that are returned. For instructions to add other criteria to your search, see:

  8. Click Find Now to execute the search based on the parameters that you have entered. The search results are listed at the bottom of the dialog box.

  9. You can customize the results window by selecting which columns are displayed in the results window, whether or not to display hidden objects, whether or not to display managed objects, and whether or not to resolve shortcuts to their target objects. For instructions, see Search for Objects dialog box: Search Options.

  10. You can:

    • Right-click any of the objects in the results window and, depending upon the object, you can choose to edit, rename, delete, or translate the object. You may also be able to search for dependents, search for components, or view the properties of the object.

    • Save the search results as a MicroStrategy object, which allows you to use the search results in creating prompts and other objects.

      To do this, select Savefrom theFilemenu.

    • Save the search results to a text file, which is one way to keep track of changes to a project. For details about the information that is saved in the text file, see Saving a search to a text file.

      To do this, select Export to Text from the Tools menu. The text file is saved by default to C:\Program Files\MicroStrategy\Desktop\SearchResult_<date and timestamp>.txt, where <date and timestamp> is the day and time when the search was saved. For example, SearchResult_022624152554.txt was saved on February 26, 2024, at 15:25:54, or 3:35 PM.

    • Create and print HTML pages containing information such as properties and definitions about the selected objects.

      • To do this, select Project Documentation from the Tools menu.

  11. You can clear all fields from all search tabs, which allows you to begin creating another search. To do this, click New Search, and then click OK at the prompt.

  12. To exit the Search for Objects dialog box, select Close from the File menu. If you have not saved the search results, you are prompted to do so.

Related topics