Using Workspace Files

How to:

Reference:

You can control and limit projects (.GFA files) that are visible 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 case of remote group development, you may view only your own projects. This enhances performance upon launching Developer Studio.

When using Workspace files, you may:

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

Workspace file option diagram

Note: You may also select these options from the File menu.


Top of page

x
Procedure: How to Create a Workspace File
  1. From the Projects area in Developer Studio, select Projects on localhost.
  2. Right-click and select New Workspace from the context menu.

    The New Workspace Wizard- Page 1 of 2 opens.

    New Workspace Wizard diagram

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

  4. Change the default save location by selecting Browse.

    Note: This step is optional. The default location for Workspace files is drive:\Documents and Settings\user_ID\My Documents\Workspaces\.

  5. Click Next.

    The New Workspace Wizard-Page 2 or 2 appears where you may add or remove projects to your workspace.

    New Workspace Wizard diagram

  6. Click Add to insert projects into the workspace.
  7. Select from the list of available projects.

    Note: You may add multiple projects.

    Insert Porject diagram

  8. Click OK to add the project.

    The project name is added to the New Workspace Wizard.

    New Workspace Wizard diagram

  9. Click Finish.

    The Projects area refreshes, showing the selected Workspace file.

    Note: New projects are added and created in the Workspace file.


Top of page

x
Procedure: How to Save Workspace Files
  1. From the Projects area in Developer Studio, select the Workspace project name.
  2. Right-click and select Save Workspace As from the context menu.
  3. Type a file name for the Workspace file.

    Note: The Workspace file has a .GFW extension.

  4. Click Save.

    The Projects area shows the selected Workspace file by default.


Top of page

x
Procedure: How to Close a Workspace File
  1. From the Projects area in Developer Studio, select the Workspace project name.
  2. Right-click and select Close Workspace from the context menu.

    The Projects area refreshes to its original view, where all projects are visible.


Top of page

x
Procedure: How to Load a Workspace File
  1. From the Projects area in Developer Studio, select Projects on localhost.
  2. Right-click and select Load Workspace from the context menu.
  3. Navigate to the application folder location where the Workspace file is saved.

    Note: The default location for Workspace files is drive:\Documents and Settings\user_ID\My Documents\Workspaces\.

  4. Select the workspace (.GFW) file.
  5. Click Open.

    The Projects area refreshes, showing the selected Workspace file.


Top of page

x
Procedure: How to Rename the Workspace File
  1. From the Projects area in Developer Studio, select the Workspace project name.
  2. Right-click and select Rename Workspace from the context menu.
  3. Type in a name for the Workspace file.
  4. Click the Enter key (on your keyboard) to retain the Workspace file name.

Top of page

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

  1. From the Projects area in Developer Studio, select the Workspace project name.
  2. Right-click and select Properties from the context menu.

    The Properties dialog box opens.

  3. Select the Workspace tab to change the target environment.

    Workspace dialog box

  4. Click Target Environment to select the appropriate environment from the list.
  5. 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.


Top of page

x
Procedure: How to Change the Projects Assigned to the Workspace File
  1. From the Projects area in Developer Studio, select the Workspace project name.
  2. Right-click and select Properties from the context menu.

    The Properties dialog box opens.

  3. Select the Workspace tab to change the projects assigned to the Workspace file.
  4. 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.


Top of page

x
Reference: Properties Dialog Box of a Workspace File

The Properties dialog box has the following fields/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.


Top of page

x
Procedure: How to Remove a Project From the Workspace File
  1. From the Workspace file, select the project name that you are removing.
  2. 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.


Top of page

x
Procedure: How to Insert a Project into the Workspace File
  1. From the Workspace file, select the Workspace file where you are inserting the project.
  2. Right-click and select Insert Project into Workspace from the context menu.
  3. Select a project folder from the available project lists.

    Note: You may add multiple projects.

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


WebFOCUS