MicroStrategy ONE

Search for Objects dialog box: International searches

Before you begin: Primary language

An object's primary language is initially defined based on the following:

  • For objects newly created after MicroStrategy version 9.0, the object's primary language is automatically set to be the same as the metadata preference language of the user who creates the object. An object's primary language can be changed at any time.

  • For objects that existed prior to MicroStrategy version 9.0, unless a primary language is explicitly assigned to those objects manually, those objects default to using the project's language as their primary language. Any object's primary language (whether explicitly set or not) can be changed at any time.

The International tab displays a list of all languages available in the metadata, allowing you to search for objects based on their primary language or the languages in which they contain translated names and translated descriptions.

This tab is available only if the selected project includes translated objects. For more information about data internationalization, see Creating a Multilingual Environment: Internationalization in the System Administration Help.

You can also search by leaving the Language options blank; when the options are left blank, no language filtering criteria is used. The system does not distinguish between explicit and implicit primary languages: for example, an object whose primary language is set to English is not treated differently by the search than an object that has no primary language set and so the object defaults to the project's language which is English.

All search results in the Search for Objects dialog box are performed in the user's preferred metadata language, except for searches performed on this tab, which are performed in the language the user selects from the Language drop-down list. This does not mean that a search on another tab only returns objects that have translations in the user's preferred language. For example, a French user searching for objects with "sale" in the name will get French translated names that contain "sale", but they will also get objects that have no French translation but the object's default-language name contains "sale".

You can translate objects directly from this tab, once search results are returned. Steps to do this are included in the procedure below.

To search by international 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.

    • The Search for Objects dialog box opens.

  2. Click the International tab.

    The International tab is available only if the project includes translated objects.

  3. Select one of the following, depending on your search result goals:

    • To return a list of all objects whose primary language is the selected language, select an object language from the Object's primary language drop-down list.

    • See Primary language above for information on object primary languages. You can use this field in conjunction with the Language field described below to search for objects in one language but return those search results in a different language; an example is provided below.

    • Select the language in which the search will run from the Language drop-down list. If Language is left blank, the search runs based on the user's metadata language preference.

    • You can use this field in conjunction with the Object's primary language field described above to search for objects in one language but run the search in a different language. For example, a French user can select English in the Object's primary language drop-down list to search for an English report that contains "sale" in the name; the search can be run in French for this user by selecting French from the Language drop-down list. In this example, although the search locates English reports with the word "sale" in the name, the search result may not display the word "sale" because the French report name will be displayed.

  4. If you selected a language in the Languagefield, you can do either or both of the following:

    • To search for translated object names in the selected language, select the Apply to name criteria check box. Select either Objects with translations in the selected language or Objects without translations in the selected language, to search for objects with or without names in the Object's primary language.

    • To search for translated object descriptions in the selected language, select the Apply to description criteria check box. Select either Objects with translations in the selected language or Objects without translations in the selected language, to search for objects with or without descriptions in the Object's primary language.

  5. A search can contain multiple criteria. For example, you can search for objects based on their owner, 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. 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.

  8. You can:

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

    • Translate any of the objects in the results window. Select the object or group of objects that you want to translate, right-click, and select Translate.

    • 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 Save from the File menu. 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.

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

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