Find and Replace: Object Dependencies

Find and replace object dependencies allows you to replace an object in all the objects that depend on it. For example, you can replace a filter in all reports, templates, and metrics that use that filter.

The Object dependencies option is available only if you have enabled it in the Project Configuration Editor. The procedure below includes instructions to enable it.

You can select any of the following object types to replace:

• Attribute

• Custom group

• Filter

• Metric

• Report

• Template

Replacing objects on reports invalidates the report caches. A new cache is created when the report is run for the first time after the replacement.

To find and replace object dependencies

1. In MicroStrategy Developer, right-click the project that you want to work with and select Project Configuration. The Project Configuration Editor opens.

2. Expand the Project definition category, and select the Advanced subcategory.

3. In the Dependent Object Options area, select the Enable Find and Replace Object Dependencies check box.

4. Click OK to save your changes and return to MicroStrategy Developer.

5. Select Find and Replace from the Tools menu of MicroStrategy Developer. The Find and Replace dialog box opens.

   You must be logged in to a project before you access the Find and Replace dialog box.

6. Select Object DependYou must be logged in to a project before you access the Find and Replace dialog box.encies in the categories drop-down list in the Select area.

   If Object Dependencies is not available, you must enable find and replace for object dependencies.

7. Select the object to be replaced (the dependee or target object) by following the steps below:

   1. Click ... (the browse button) next to the Choose a dependee object to be replaced field. The Choose a dependee object to be replaced dialog box opens.

   2. From the Objects of type drop-down list, select the object type to view. To view all object types, select All valid types.

   3. Navigate to and select the object to be replaced.

   4. Click Opento return to the Find and Replace dialog box.

8. In the Find area, select how to find the objects to be updated. For instructions, see Find and Replace: Find.

9. In the Replace With area, select the object which will replace the target object. Click ... (the browse button) to navigate to and select the replacement object. You can select a particular object type to view in the Objects of typedrop-down list, or selectAll valid typesto view all object types.

10. Review the list of dependent objects in the Summary pane, ensuring that you want to replace the target object on all of them.

    • If you find any that you do not want to change, clear the check box in front of them.

      When a dependent object is no longer selected, it still appears in the list unless the Show only selected objectscheck box is selected.

    • To re-select an unselected dependent object, select its check box.

    • If more than 300 dependent objects are found, use the Previous 300 and Next 300 to view them.

    • By default, all dependent objects selected in the find process are displayed in the Summary pane, even if they are no longer selected.

    • To show only the selected dependent objects, select the Show only selected objects check box.

    • To display those unselected dependent objects again, clear the Show only selected objects check box.

11. By default, the Select All, Clear All, and Replace processes apply to all the dependent objects selected in the find process. To apply the process only to the dependent objects displayed in the Summary pane, select Apply only to displayed objects.

    This setting works only if more than 300 reports and templates are found, because 300 objects is the maximum that can be displayed in the Summary pane at one time.

12. To clear all dependent objects, select Clear All. If more than 300 dependent objects were found and Apply only to displayed objects is selected, only the set of 300 dependent objects that is currently displayed in the Summary pane is cleared.

    The dependent objects still appear in the list unless the Show only selected objects check box is selected.

13. To re-select all unselected dependent objects, select Select All. If more than 300 dependent objects were found and Apply only to displayed objects is selected, only the set of 300 dependent objects currently displayed is selected.

14. To show the path for each dependent object in the Summary pane, select the Show folder path for objects check box.

15. Before you replace the target object, you can specify:

    • The location and behavior of the log file

    • Whether to show a status message after the update

    • How to save reports containing shortcuts to stand-alone templates

    • For instructions to specify these options, see Find and Replace Options dialog box.

16. You can edit an individual dependent object by right-clicking it in the Summary pane and selecting Edit. The editor for that object type opens. After you make your changes, click Save and Close to save the object and return to the Find and Replace dialog box.

17. After you have reviewed and updated the list of dependent objects, replace the target object on the selected dependent objects by clicking Replace.

    If the Replace button is grayed out, you delayed running a search in the find step above. Click Update Summary to create the list of dependent objects to be updated.

    If Apply only to displayed objects is selected, the target object is replaced in only the dependent objects displayed in the Summary pane, rather than all the dependent objects selected in the find process.

18. When you are done, click Close to return to MicroStrategy Developer.

Related Topics

• Find and Replace: Find

• Find and Replace dialog box