Skip to main content

Managing Workspaces

The following information discusses how to manage workspaces in Eggplant Performance Studio.

Purpose of a Workspace

In Eggplant Performance Studio a workspace is a framework that holds one or more projects. Projects are created within the context of a workspace. The workspace contains all environment-specific data such as injector details, default editors, compiler locations, and custom virtual user types.

A workspace allows you to switch between different environments easily, for example switching between a test and a LIVE environment, which are likely to have different injector configurations.

Creating a New Workspace

To create a new workspace:

  1. Select File > New > New Workspace. The Add Workspace dialog box opens.

  2. Enter the following workspace details:

    • Name: The name for the new workspace.
    • Location: The folder in which workspace files will be stored.
  3. Click OK.

Opening an Existing Workspace

If you have a workspace open and want to use a different workspace, you can switch workspaces.

  1. Select File > Switch Workspace. A list of all available workspaces is shown, excluding the current workspace.
  2. Select the workspace you want to switch to and click OK.

If you switch to a workspace that has a workspace protection password, you'll need to enter the password for that workspace. For more details, see Password Protection.

Deleting a Workspace

You can also delete workspaces.

  1. Select File > Delete workspace.
  2. Select the workspace to remove and click Remove.

It is not possible to delete the workspace which is currently open. Switch to a different workspace first.

Adding an Existing Workspace

You can add existing workspaces in Eggplant Performance Studio.

  1. Select File > Add existing workspace.
  2. Browse to the workspace folder and press OK.

Exporting a Workspace/Project

You can export workspaces and projects from Eggplant Performance Studio to an Eggplant Performance Archive (.epa) file. For information about .epa files, see Eggplant Performance Archive Files.

  1. Select File > Export Workspace/Projects. The Export Project to an Archive file panel opens. It lets you browse to the location where you want to save the archive.

  2. Select the location where you want to save the exported workspace/project, specify a name for it, and click Save. We recommend naming the archive file so that you can tell it contains a workspace or project. The Export to <export file name> dialog box lets you select which project, if any, you would like to export.

  3. To export all the contents of the workspace and its projects, click Select All . If you just want to export the workspace, click Select None.

  4. Click Advanced to display the Advanced tab. This tab allows you to exclude certain files from the export, including the following:

    • Data Files, e.g. data tables, dictionaries, etc
    • Analyzed test run results
    • Test run results data
    • Recordings files
    • Intermediate build files, e.g. *.vcproj, *.obj
    • Exclude files with certain extensions.

    The last option is an input field in which you can specify any file extension you want to exclude. For example, you can exclude video files here. Specify multiple extensions by separating them with a comma. For example, .avi,.mp4.

  5. You might want to deselect some or all of these options depending on the size of the projects and hardware disk limits. Analyzed test run results can be many megabytes in size depending on the number of test runs analyzed and how many timings, transactions, or virtual users were in those tests.

  6. Click OK to save your selections.

  7. Click OK on the Export dialog box to create the export file.

  8. When the export is complete, click Close to close the dialog box. The archive contains most of the files from the workspace, excluding any that were deselected on the Advanced tab. It also includes any projects that you selected on the Export dialog box.

Importing a Workspace/Project

You can import a workspace or project into Eggplant Performance Studio from either a .zip or Eggplant Performance Archive (.epa) file.


Even though this file is called a "project archive", you cannot import a single project from it. You must import the whole workspace that was exported to the archive.

To import a workspace and project:

  1. Select File > Import Workspace/Projects. The Import a project archive panel opens. It lets you browse to the location of the archive you want to import and select it.


    You can only import .epa archives here that were created from the export of a workspace and/or project file. You cannot import .epa files that were exported from a script or virtual user.

  2. Select a previously exported workspace/project and click OK.

The following options are available on the import dialog boxes:

  • Import from Workspace: Imports the archived workspace as a new workspace. You will be given the option to switch from the current workspace to the imported workspace.

    • Name: The name of the new workspace. It must not be the same as another existing workspace.
    • Location: The folder in which workspace files will be stored.
  • Import from Projects: Similar to the Export dialog box, here you can select which specific projects you wish to import from the archive, and which files you wish to include or exclude.