MicroStrategy ONE
Inserting a list of objects into a script
Sometimes you need to execute a script on a specific object, and cannot remember the precise name or location of the object. The Search for Objects feature can help you find the object and insert it into your script.
You specify the project (or no project, if you want to search for configuration objects such as users or security filters) and part or all of the name of the object, and the Search for Objects feature returns a list of objects. You can insert objects from the list into your script. You can also export the list to an XML or CSV file.
You can only retrieve a list of objects if you are connected to a project source. You cannot search for objects if you are connected to a Narrowcast Server, or if you are working with a project source in connection-less mode.
To insert a list of objects into a script
- Select the script's tab in its Script window, and position the cursor in the script where you want the list of objects to be inserted.
- On the Edit menu, point to Insert / Search Objects, and choose Search for Objects. The Search for Objects dialog box opens.
- In the Search For field, type all or part of the name of the object you're searching for, or leave the field blank.
- From the Domain drop-down list, select the project containing the object. To search for configuration objects, such as users or security filters, select Configuration Objects.
- From the Object Types checklist, select the types of objects to search for.
- Click Find Now. A list of objects matching your criteria is shown in the Search Results pane.
- From the list, select an object to insert.
- Click Insert. The selected object is inserted into the script.
- To export the list to a file, right-click in the Search Results pane, point to Export, and select either To CSV or To XML. Specify a file name and location, and click Save. The list of objects is saved.
- When you are finished inserting objects, click Cancel. The Search Objects dialog box closes.