Managing Workspaces

The following information discusses how to manage workspaces in Eggplant Performance Studio. It covers the following topics:

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, both of which will likely have different injector configurations.

Creating a New Workspace

  1. To create a new workspace select File > New > New Workspace. The Add Workspace dialog box opens. It contains the following fields:

    Name: The name for the new workspace.

    Location: The desired physical location of the workspace.

  2. Enter the workspace details and click OK.

Opening an Existing Workspace

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

  1. To switch to a different workspace, select File > Switch Workspace. A list of all available workspaces is shown (excluding the current workspace).
  2. Select the new workspace and click OK.

Note: Switching to a workspace which has a workspace protection password will prompt you to enter the password before switching. For more details, see Password Protection.

Deleting a Workspace

You can also delete workspaces.

  1. To delete a workspace, select File > Delete workspace.
  2. Select the workspace to remove and click Remove.
Note: It is not possible to delete a workspace that you have open.

Adding an Existing Workspace

You can add existing workspaces in Eggplant Performance Studio.

  1. To add an existing workspace to Eggplant Performance Studio, select File > Add existing workspace.
  2. Browse to the desired workspace 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. To export a workspace and project, 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 the following extensions (Enter a comma separated list (for example, .avi, .mp4))
    Note: 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. You can specify multiple extensions by separating them with a comma.
  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 Mb 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 on the Advanced tab.
  7. Click OK on the Export dialog box to create the export file. 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.

Note: 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.
  1. To import a workspace and project, 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. Eggplant Performance Studio can import .zip and .epa (Eggplant Performance Archive) files.
    Note: 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

The archived workspace will be imported as a new workspace, and 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 desired location of the new workspace.

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.

Workspace Properties

Name: Displays the name of the current workspace (non-editable)

Location: Displays the location of the workspace (non-editable)


This topic was last updated on January 13, 2022, at 02:42:23 PM.

Eggplant icon | Documentation Home | User Forums | Support | Copyright © 2022 Eggplant