42. Creating a workspace

This section describes how to create and work within workspaces.

42.1 Creating a new workspace

1. In Foretify Manager, select a project to work in:

   • If you're on the All Projects page, click the required project.
   • If you're in a project, click the Projects dropdown list and select a project.

2. In your project, select the Analysis tab and click Create New Workspace.

3. Enter a Workspace name.

   

   The workspace name must be unique across your project.

4. (Optional) To add test suite results explicitly, click the icon next to Add Test suite results from the project list, select one or more test suite results, and click Apply.

   

   The results display under Captured test suite results at the bottom.

5. Define a capture rule.

   A capture rule is the workspace’s auto‑selection filter that defines which test suite results are included in the workspace, both now and as new results arrive. This keeps the workspace “up to date” without manual picking of runs or test suite results.

   The capture rule can combine multiple conditions (using AND/OR logic) and can include attributes including ID, Name, Creation Date, Passed, Failed, Errored, Total runs, User Name, Status, and Labels.

   a. Click + to the right of Rule 1 to add a new rule.

   b. For Rule 1, select In to include or Out to exclude the matched test suites.

   c. Select an attribute from the first list.

   d. Select an operator from the second drop-down menu.

   The operators depend on the attribute you selected in the first drop-down menu. For example, if you selected Passed, you can select Equals, Less than, Less than or equal to, Greater than, or Greater than or equal to and enter the number in the text box.

   e. In the text box, enter the string to be compared.

   f. To add another condition box, click And or Or and click the + button next to the And/Or toggle.

   g. Click Show Results to see the test suites that were selected based on your capture rule.

   

   h. (Optional) To explicitly remove test suite results that the rule would include, click the Remove icon, select one or more test suite results, and click Apply.

   

   The selected test suite results are removed from the workspace.

6. Click Create Workspace.

   The workspace opens displaying the VPlan tab.

   

42.2 Creating a workspace from existing test suite results

1. In Foretify Manager, select a project to work in:

   • If you're on the Select a Project page, click a project.
   • If you're in a project, click the Projects dropdown list and select a project.

2. From the project, click Results > Test Suite Results tab to access your test suites.

3. In the Test Suite Results tab, select one or more test suites and click Create Workspace.

   

4. Enter a Workspace name that is unique across your project.

   A capture rule preconfigures itself so the rule initially matches those chosen results. You can update the capture rule if necessary.

5. Click Create Workspace.

   The test suite results that you selected are included in the workspace.

42.3 Setting workspace user permissions

By default, all project users get Viewer access until you change it. Workspace owners you can specify access for specific users and user groups to Editors or Owners.

1. Select the Permissions sidebar tab

   

2. Set access:

   • To allow access to all users in your project, toggle Allow general access to all project users, including new users and select the role.

   • Add specific users and user groups and set their roles.

3. Click Save.

The following table shows the Foretify Manager workspace roles and their permissions:

42.3.1 Finding workspace permissions

• The workspace permissions can be found in the Analysis tab of a project.

  

  To find your permission level, in the project's main page add the permission column from the column chooser as shown in the following image.

  

  Note

  Click Show only my workspaces to filter and view only the workspaces you have created.

• The workspace permission can be found inside a workspace in the top right of the page.

  

  Hover over the permission to display the tooltip with valid operations for your permission level.

  

42.4 Open a workspace

To open the Workspace window for a previously created workspace:

1. From a project, click the Analysis tab.

   Result: A list of available workspaces are displayed. You can modify the table display.

   

   Note

   You might need to select a project to access the Workspaces tab. To do so, click the Projects dropdown list and select a project. Select Go to all to select from all the projects.

2. Click the name of the workspace you want to view.

   The commands and buttons that display in the workspace depend upon your permission level.

To get your own workspaces:

1. From a project, click the Analysis tab.

   Result: A list of available workspaces are displayed.

2. Click Show only my Workspaces.

   Result: Only your workspaces are displayed.

   

3. Click the name of the workspace you want to view.

42.5 Copy a workspace

To copy a workspace:

1. From your workspace, click Copy next to the Capture rule.

   

2. In the Save Workspace As dialog box, enter the new name and click Save.

42.6 Select a workspace test suite to review

A workspace can capture multiple test suite results. By default, the most recent test suite result calculations are displayed.

To select a test suite to view:

1. Click the dropdown list under Test suite result workspace view.

   The Change Test Suite Result dialog displays, containing a list of the test suites in the workspace.

2. Select a test suite or narrow the list first by typing the beginning of the name of the test suite you want to review and then selecting the test suite.

   Note

   Regular expressions are not allowed.

3. Click Apply.

   Note

   While you change your test suite result, you can also select the metrics model used to calculate the coverage grade. For details, see how to control the metrics model.

After selecting or modifying a capture rule and saving the workspace settings, the content of the workspaces is modified according to the capture rule. This means it will capture the test suite results that match the capture rule. However, VGrade calculation will not take place for all test suite results automatically. See Calculating VGrade for more information

42.7 Group test suite results in a workspace

Sometimes you might want to analyze multiple test results as a single test result. For example, you might want to combine test suite results when one test suite execution is a continuation of another test suite execution that failed to finish. Or you might want to merge multiple test suite configurations that were split out due to using different verification environments. In this case, you might have one test suite per simulator but you want to combine them so that they'll be considered a logical data point in the workspace.

When multiple test suites are grouped together, they can be analyzed as a single test suite, and the vGrade calculation applies to all runs in the grouped test suite.

When you create grouped test suites, other users with access to the workspace see the groups you create.

To group test suite results:

1. Click the test suite results icon in the sidebar.

   

2. Select the checkboxes of the test suites you want to group.

   

3. Click the Group icon in the upper right.

   

4. Enter a name for the group and click Group.

   

5. To keep the original test suite results after grouping, check the 'Keep original test suite results intact' checkbox.

   

   A new test suite result is created.

To ungroup a group of test suites results:

1. In the row of the test suite group, select the Grouped icon.

   

2. If original test suite results were not kept:

   1. In the Test suite result group info dialog box, click Ungroup.

      

   The test suites that comprise the group display individually. Note that if you are ungrouping a group of groups, the original groups display.

3. If the original test suite results were kept:

   1. In the Test suite result info dialog box, click Delete Group.

   2. The group will be deleted and original test suite results are preserved.

      

42.8 Delete a workspace

To delete a workspace:

1. From a project, click the Workspaces tab.

   A list of available workspaces displays.

   

2. Select one or more workspaces that you want to delete and click the Trash icon at the top right of the window.

   You can also delete a workspace by selecting the Settings (gear) icon in the left sidebar, then clicking Delete Workspace and confirming the dialog box that appears.

42.9 Updating the capture rule for a workspace

Workspace owners can modify the capture rule to define which test suites are included in the workspace.

To update the capture rule for a workspace:

1. From your workspace, select the Settings (gear) icon in the left sidebar.
2. Select the Capture Rule tab.
3. Change the settings in the rules and click Show Results to update the captured test suite results.
4. To explicitly remove test suite results, click the Remove Test Suite Results from this Workspace icon below the Capture rule section on the right, select one or more test suite results, and click Apply.
5. Click Save.