Using Workspace Files

You can control and limit projects (.gfa files) that are visible by using Workspace files in the Projects area. Workspace files are created through Developer Studio and are stored on your PC. The Projects area is populated based on projects listed in the Workspace file. This is applicable when performing local or remote project-based development and enables you to organize your projects. In remote group development, you may view only your own projects. This enhances performance upon launching Developer Studio.

The following image is an example of the Workspace file options available from the context menu.

Procedure: How to Create a Workspace File

From the Projects area in Developer Studio, select Projects on localhost.
Right-click and select New Workspace from the context menu.
The New Workspace Wizard - Page 1 of 2 opens, as shown in the following image.
Type a name for the Workspace file in the Workspace Name field or use the default Workspace name.
Note: The Workspace file has a .gfw extension.
Change the default save location by selecting Browse.
This step is optional. The default location for Workspace files is:
- On Windows 7. drive:\Users\user_ID\My Documents\Workspaces.
- On Windows XP. drive:\Documents and Settings\user_ID\My Documents\Workspaces.
Click Next.
The New Workspace Wizard - Page 2 of 2 appears where you may add or remove projects to your workspace, as shown in the following image.
Click Add to insert projects into the workspace.
Select from the list of available projects.
Note: You may add multiple projects. The available projects are shown in the following image.
Click OK to add the project.
The project name is added to the New Workspace Wizard, as shown in the following image.
Click Finish.
The Projects area refreshes, showing the selected Workspace file.

Note: When creating new projects, they are added to the active Workspace file.

Procedure: How to Save Workspace Files

From the Projects area in Developer Studio, select the Workspace project name.
Right-click and select Save Workspace As from the context menu.
Type a file name for the Workspace file.
Note: The Workspace file has a .gfw extension.
Click Save.
The Projects area shows the selected Workspace file by default.

Procedure: How to Close a Workspace File

From the Projects area in Developer Studio, select the Workspace project name.
Right-click and select Close Workspace from the context menu.
The Projects area refreshes to its original view, where all projects are visible.

Procedure: How to Load a Workspace File

From the Projects area in Developer Studio, select Projects on localhost.
Right-click and select Load Workspace from the context menu.
Navigate to the application folder location where the Workspace file is saved.
The default location for Workspace files is:
- On Windows 7. drive:\Users\user_ID\My Documents\Workspaces.
- On Windows XP. drive:\Documents and Settings\user_ID\My Documents\Workspaces.
Select the workspace (.gfw) file.
Click Open.
The Projects area refreshes, showing the selected Workspace file.

Procedure: How to Rename the Workspace File

From the Projects area in Developer Studio, select the Workspace project name.
Right-click and select Rename Workspace from the context menu.
Type a name for the Workspace file.
Press the Enter key to retain the Workspace file name.

Procedure: How to Change the WebFOCUS Environment for the Workspace File

Changing the environment is useful if the original environment description name was changed or if you want to use a different environment that has the same projects.

From the Projects area in Developer Studio, select the Workspace project name.
Right-click and select Properties from the context menu.
The Properties dialog box opens.
Select the Workspace tab to change the target environment. The Workspace tab is shown in the following image.
Click Target Environment to select the appropriate environment from the list.
Click OK.
The target environment appears as the current environment for the Workspace file.

Note: If the environment name changes and it does not contain projects that exist in the Workspace file, the projects appear as unresolved Global localhost in the Projects area.

Procedure: How to Change the Projects Assigned to the Workspace File

From the Projects area in Developer Studio, select the Workspace project name.
Right-click and select Properties from the context menu.
The Properties dialog box opens.
Select the Workspace tab to change the projects assigned to the Workspace file.
Click OK to close the Properties dialog box.

Note: You may also insert and remove projects from the Workspace file directly from the Projects area.

Reference: Properties Dialog Box of a Workspace File

The Properties dialog box has the following fields and options:

General tab: Shows name, location, and other Workspace file information.
Workspace tab: Shows the environment and projects assigned to the workspace. You can change projects assigned to the workspace and change the WebFOCUS environment.
Comment tab: Enables you to add comments for the Workspace file.

Procedure: How to Remove a Project From the Workspace File

From the Workspace file, select the project name that you are removing.
Right-click and select Remove from Workspace from the context menu.
The project is removed from the Workspace file.

Note: You may also remove a project from the Workspace file by using the Workspace tab of the Properties dialog box.

Procedure: How to Insert a Project Into the Workspace File

From the Workspace file, select the Workspace file where you are inserting the project.
Right-click and select Insert Project into Workspace from the context menu.
Select a project folder from the available project lists.
Note: You may add multiple projects.
Click OK.
The Workspace file refreshes, showing the added project name.

Note: You may also insert a project into the Workspace file by using the Workspace tab of the Properties dialog box.