How to manage projects in ScenarioBuilder?

When ScenarioBuilder launches for the first time, it will ask you to create a new project. Upon installation, ScenarioBuilder creates the “Default Project” folder in your user’s Documents/ScenarioBuilder folder, where scenarios will be stored. Additional project folders can be created from ScenarioBuilder.

The Project will have five folders: Documents, Scenarios, Components, Images, and Variables folders.

  • Save your douments in the Documents folder
  • Save your Scenarios in the Scenarios folder
  • Save your Components in the Components folder
  • Save your Images in the Images folder
  • Save your CSV files in the Variables folder

Manage Projects from ScenarioBuilder Splash Screen

Each time ScenarioBuilder is launched, it opens to the Splash Screen (unless you have disabled via the “Do not show this in the future” box at the bottom of the Splash Screen or via the “Splash Screen Settings” in the ScenarioBuilder “Options” menu). The Splash Screen displays the current project, and recent scenarios from that project:

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_998_Apr

Note: You can also open your previous project folder by clicking on the “Select an Existing Projects Base Folder” button.

Open Project

Click the “Open Project” drop down box to display all of the Projects from the current “Base Folder for all Projects”;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_999_Apr

Select a Project;

The Splash Screen refreshes to display scenarios available from the newly selected Project;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1001_Apr


Create New Project

Click on New Project, Create Project form opens;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1003_Apr

Project name: Enter a meaningful name for your project.

Description: Enter an optional description to help identify this project.

Click “Create” to submit the project. Confirmation pop-up opens;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1004_Apr

Click “OK” to complete the process. The Splash Screen updates to reflect the new project;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1005_Apr

Manage Projects from ScenarioBuilder

From the ScenarioBuilder “File” menu, select “Project Manager”;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1006_Apr

The “Project Manager” pop-up window opens displaying all of the projects from the current “Base Folder for all Projects”;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1010_Apr

Create New Project

Click on “New” button;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1012_Apr

Fill out the following fields for the new project and click on “OK” button.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1013_Apr

The new project will be added to the projects list.

Note: You may want to create and share a project with multiple users on the same network in order to work collaboratively on the same project. 

To do this, you just need to create a project in a location accessible to all the users you wish to be able to access the project, and select the shared folder as your ScenarioBuilder base folder.

To change the base folder, click on “Options” to view the project preferences.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1041_Apr

Click the ellipses  button in the “Project Preferences” pane to change the Project Base Folder;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1042_Apr

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1020_Apr

Tip: We recommend mapping the shared network folder instead of putting the UNC path.

How to manage projects in ScenarioBuilder_ (115005396488)_Screenshot_50

"\\host-name or IP address\ share-name"

For example:

X:\N_drive\SB Testing Project 2018

OR

\\10.0.0.201\SB Testing Project 2018

Switch Project

Click the desired project to select it and click on “Switch” button. 

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1016_Apr

Confirmation pop-up opens; Click “OK” to complete the process.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1018_Apr

If desired project resides in another “Base Folder”, click on “Options” button to change the location of the “Base Folder”;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1020_Apr

Move Project

Creating a zip file from the ScenarioBuilder base folder, copying and pasting it to desired location, is the easiest way to move your ScenarioBuilder project folder from one location to another location.

Copy Project To

Click on desired project to select it and then click on “Copy To” to copy the project to a new Base folder.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1021_Apr

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1022_Apr

Confirmation pop-up opens; Click “OK” to complete the process.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1023_Apr

Delete Project

Click on desired project to select it and click on “Delete” to delete it.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1024_Apr

Confirmation pop-up opens; Click “OK” button to finalize the deletion of the project.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1025_Apr

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1026_Apr

Important: Project deletion results in the deletion of all scenarios, Components, image files, variables files and documents contained in that project. Use extreme care when deleting projects

Project Properties

Click on desired project to select it and then click on “Properties” to view Project properties.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1027_Apr

Here you can modify the fields.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1028_Apr

Export Project

Click on desired project to select it and then click on “Export” to export the whole project to a zip file.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1029_Apr

Navigate to an existing directory or create a new folder for your export destination.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1030_Apr

Enter a name for exported file and click on “Save” button.

Your exported project(s) will be saved as a .zip or .rar folder in the folder you selected;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1031_Apr

Import Project

Click on “Import” to import a project to the projects list.

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1032_Apr

Browse to the folder containing the project file;

How to manage projects in ScenarioBuilder_ (115005396488)_ScreenHunter_1036_Apr

Double-click the desired .zip file. ScenarioBuilder will acknowledge the import;

Imported project will appear in the projects list.