Controlling Project Visibility in a Workspace

Design Studio solutions can contain large numbers of productized, sealed, and application-specific projects that are not directly related to your work. You control which projects appear in your workspace by creating and applying a filter, called a working set.

The projects that a working set filters out exist in the workspace and remain open but do not appear in the Studio Projects view. Also, you can define a separate working set for the Solution view to control visibility of project entities at the root level.

For example, you can facilitate design modeling and workspace navigation by creating a working set that displays only those projects related to your present design work. The working set can filter projects based on the project type and based on a tag that you associate with a project. Working set filters are limited to the workspace in which they are defined.

One working set is delivered with Design Studio and is applied to the Studio Projects view when you install Design Studio. This working set is named Exclude Base Projects, and it excludes from display all Design Studio base projects, any projects associated with the Base Project tag, and all non-Design Studio projects (such as Eclipse projects and Java projects). The Exclude Base Projects working set is not editable, but you can deactivate this working set filter. See "Deactivating a Working Set" for information about removing the filter that the Exclude Base Projects working set applies to the workspace.

Also, you can use standard Eclipse working set functionality to create a global working set that controls which menus, views, and toolbars appear in a workspace. You use these standard Eclipse working sets to control project visibility in the Package Explorer view. See the Eclipse Workbench User Guide for more information about creating and using window working sets.

Note:

You can control whether sealed projects appear in the Studio Projects view by toggling the Exclude Sealed Projects and the Include Sealed Projects icon, located in the Studio Projects view toolbar. See "Studio Projects View" for more information.

Controlling project visibility in a workspace involves the following tasks:

Creating a Working Set

You can create a working set that defines a filter to control which projects appear in the Studio Projects view. You can also create a working set that controls visibility of entities of projects (at the root level) in the Solution view. You can create one or more working sets and apply them to a workspace.

Note:

Before you create a working set, you can associate projects with system-defined tags (such as the Base Project tag) and with tags that you create, and filter the workspace to include or exclude projects associated with this tag. Also, you can create your own tags. See "Project Editor Tag Tab" and "Creating Tags" for more information.

To create a working set:

  1. From the Studio Projects or from the Solution view, click the View Menu icon in the view toolbar (the icon is an arrow).

    The context menu options appear.

  2. From the context menu list, select the Select Working Set option.

    The Select Working Set dialog box appears.

  3. Click New.

    The New Working Set dialog box appears.

  4. Select Design Studio and then click Next.

  5. In the Working Set Name field, enter a name to describe the working set.

  6. Select a working set filter option.

    • Select Include to include specific projects in the workspace.

    • Select Exclude to exclude specific projects from the workspace.

  7. In the Project Type area, select the project types that you want to include in the workspace or exclude from the workspace, depending on your selection in the previous step.

  8. In the Tag area, select one or multiple tags to include or to exclude projects associated with these tags from the workspace, depending on your selection in the previous step.

    Note:

    If your working set includes selections in the Project Type area and in the Tag area, the working set filters only those projects that meet the criteria defined in both areas. For example, if the working set is defined to exclude OSM projects (selected in the Project Type area) and base projects (selected in the Tag area), the filter hides only those projects that are OSM projects associated with the Base Project tag.

    Tags do not apply to Environment projects.

  9. Click Finish.

  10. In the Select Working Set dialog box, select the new working set and click OK.

    Design Studio applies the working set and updates the Studio Projects view or the Solution view to display only those projects and entities that meet the filter criteria defined in the applied working set.

Related Topics

Activating a Working Set

Editing a Working Set

Controlling Project Visibility in a Workspace

Activating a Working Set

You activate the working set that you want to apply to the workspace.

To activate a working set:

  1. From the Studio Projects view or from the Solution view, click the View Menu icon in the view toolbar.

    The context menu options appear.

  2. From the context menu list, select the Select Working Set option.

    The Select Working Set dialog box appears.

  3. Do one of the following:

    • Select Window Working Sets if you want to select a previously created global working set that controls project visibility in the Package Explorer view. See the Eclipse Workbench User Guide for more information about creating and using window working sets.

    • Select No Working Sets to remove any workspace filters defined by an active working set.

    • Select Selected Working Sets and then select a working set from the list to apply the filter defined by that working set to the workspace.

  4. Click OK.

    Design Studio applies the working set and updates the Studio Projects view or the Solution view to display only those projects and entities that meet the filter criteria defined in the applied working set.

Related Topics

Creating a Working Set

Editing a Working Set

Deactivating a Working Set

Controlling Project Visibility in a Workspace

Editing a Working Set

You can edit an active working set (a working set whose filter is presently applied to the workspace) to change the projects that appear in your workspace.

Note:

Before you edit a working set, you can associate projects with system-defined tags (such as the Base Project tag) and with tags that you create, and filter the workspace to include or exclude projects associated with this tag. Also, you can create your own tags. See "Project Editor Tag Tab" and "Creating Tags" for more information.

To edit a working set:

  1. From the Studio Projects view or from the Solution view, click the View Menu icon in the view toolbar.

    The context menu options appear.

  2. From the context menu list, select the Edit Active Working Set option.

    The Edit Working Set dialog box appears.

  3. In the Working Set Name field, edit the name that describes the working set.

  4. Select the working set filter option.

    • Select Include to include specific projects in the workspace.

    • Select Exclude to exclude specific projects from the workspace.

  5. In the Project Type area, select the project types that you want to include in the workspace or exclude from the workspace, depending on your selection in the previous step.

  6. In the Tag area, select one or multiple tags to include or to exclude projects associated with these tags from the workspace, depending on your selection in the previous step.

    Note:

    If your working set includes selections in the Project Type area and in the Tag area, the working set filters only those projects that meet the criteria defined in both areas. For example, if the working set is defined to exclude OSM projects (selected in the Project Type area) and base projects (selected in the Tag area), the filter hides only those projects that are OSM projects associated with the Base Project tag.

    Tags do not apply to Environment projects.

  7. Click Finish.

    Design Studio applies the working set and updates the Studio Projects view or the Solution view to display only those projects and entities that meet the filter criteria defined in the applied working set.

Related Topics

Creating a Working Set

Activating a Working Set

Deactivating a Working Set

Controlling Project Visibility in a Workspace

Deactivating a Working Set

You can deactivate a working set to remove the filter from the workspace. You can use this option only when there is an active working set applied to the workspace.

To deactivate a working set:

  1. From the Studio Projects view or from the Solution view, click the View Menu icon in the view toolbar.

    The context menu options appear.

  2. From the context menu list, select the Deselect Working Set option.

    Design Studio removes from the Studio Projects view or from the Solution view the filter defined by all previously active working sets.

Related Topics

Creating a Working Set

Activating a Working Set

Editing a Working Set

Controlling Project Visibility in a Workspace

Exporting Working Sets

You can export working sets to an external file if you want to use working sets across multiple workspaces.

To export working sets:

  1. From the File menu, select Export.

    The Export dialog box appears.

  2. Select Oracle, and then select Design Studio Working Set.

  3. Click Next.

  4. Select the working sets to export.

  5. In Select Destination, specify the path and filename for the .xml file in which to save the working sets.

    If you export to an existing file, you will overwrite any content defined in the file.

  6. Click Finish.

Importing Working Sets

You can import working sets from an external file if you want to use working sets across multiple workspaces.

  1. From the File menu, select Import.

    The Import dialog box appears.

  2. Expand the Oracle Communications Design Studio Wizards folder, and then select Design Studio Working Set.

  3. Click Next.

  4. In the Select Source field, specify the .xml file that contains the saved working sets.

    You must select a valid .xml file that contains working sets. The working sets that are saved in the file appear.

  5. Select the working sets to import.

    Working sets that exist in the workspace are not available to select.

  6. Click Finish.