MicroStrategy ONE

Search for Objects dialog box: Name & Location searches

The Name & Location tab allows you to search objects by their name, description, and/or location. Use this tab to search for objects when you know their identity.

If you are doing a configuration object search as an administrator (that is, you accessed this dialog box from the Search for Configuration Items menu option, or from the Find and Replace Privileges dialog box), you can search users by login instead of user name, by selecting theSearch only user logincheck box. Only users and groups are included in the search.

To search by Name & Location criteria

  1. Do one of the following:

    • To search either application objects or public objects, from the Tools menu, choose Search for Objects.

    • To search for configuration objects, from the Administration menu, select Search for Configuration Objects.

    • To search for users, groups, and security roles to find and replace privileges, from the MicroStrategy Developer folder list, expand Administration. Right-click the User Manager folder and select Find and Replace Privileges. Select Use the results of a search and click New. (This type of search is a specific kind of configuration object search.)

    • The Search for Objects dialog box opens.

  2. By default, shortcuts are resolved to their target objects, that is, search criteria is applied to the target of a shortcut, rather than to the shortcut directly. To treat shortcuts as independent objects and apply the search criteria to the shortcut directly, follow the steps below. For a more detailed description of how searching shortcuts works, including examples, see Searching shortcuts.

    If you select the Exclude Folders check box (described below), shortcuts are not resolved to their target objects, regardless of the Resolve shortcuts to target objects setting.

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

    2. Clear the Resolve shortcuts to target objects check box.

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

  3. Click the Name & Location tab.

  4. You can use a single search criterion or a combination of them. However, single-criterion searches can impact performance, as the search can be extensive.

    • To search by name, type the name in the Named field.

    • To search for the exact name, rather than names that include the specified text, select the Match Exact Name check box

    • If you are searching configuration objects, you can search users by login instead of by user name, by selecting theSearch only user logincheck box. Only users and groups are included in the search.

    • To search by description, type the description in the Description field.

    • To search for the exact description, rather than descriptions that include the specified text, select the Match Exact Description check box.

    • To search by location, type the path and folder name in the Look In field, or click ... (the browse button) to browse for the folder to search in. For application or public object searches, select one of the following:

    • To search folders beneath the selected folder, select the Include Subfolders check box.

      • If you select Include Subfolders, the Exclude Folders check box becomes available. To exclude specific folders and their subfolders from the search:

      1. Select the Exclude Folders check box.

      2. To specify a folder to exclude, click Add, which opens the Browse for Folder dialog box. Navigate to and select the folder, then click OK. The folder is displayed to the list. Add any other folders that you want to exclude.

        If you select Exclude Folders, shortcuts are not resolved to their target objects, regardless of the Resolve shortcuts to target objects setting. This means that the search criteria is applied to the shortcut directly, not to the target. For a more detailed description of how searching shortcuts works, including examples, see Searching shortcuts.

    • To search only the indicated folder, clear the Include Subfolders check box.

      You can use wildcard characters, such as an asterisk (*) or a question mark (?) to represent one or more real characters in the Named and Description fields. Wildcard characters are often used in place of one or more characters when you do not know what the real character is or you do not want to type the entire name.

    • Use the asterisk to substitute for one or more characters. For example, sales* in the Named field finds all objects with sales in the title. The location of the asterisk is important: sales* finds salesman and sales tax, but it does not find dollar sales. To find dollar sales, type * sales.

    • Use the question mark to replace one character. For example, sal? in the Named field finds all objects named sale or sal1. It does not find objects named sales, since there are two characters missing from that name. To find sales, type sal*.

  5. A search can contain multiple criteria. For example, you can search for objects based on their name, type, last modification date, and primary language. 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:

  6. 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.

  7. If you are searching users, groups, and security roles to find and replace privileges, click OK to return to the Find and Replace Privileges dialog box. Because the aim of this type of search is to provide results to the find and replace process, none of the options described below are available.

  8. 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.

    Customizing the results window is not available for configuration object searches.

  9. 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. You can save the search as an object for application and public object searches only.

    • 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. Project documentation is available for application and public object searches only.

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

  10. 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.

  11. 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