Working with projects

By using projects, it is possible to coordinate one’s work more efficiently than would be possible with many individual workflows - you can easily assign items contained in a project to a specific task. Projects contain references to existing workflows within a so-called “playlist”. Within this project structure further subfolders can also be created, so that you can arrange the project as clearly as possible.

The TWS offers you several options for creating and managing these projects.


Create projects

  • About homepage: With the “New Project” button you can create a new project.
  • About the toolbar in the studio: If no project is open, a new project can be created with the “New” button.
  • About the Project Explorer: With the “New Project” button in the toolbox a new project can be created.

Create new project

There are several ways to create a new project, as described above. In the following, the way via the “New Project” button on the start page is briefly outlined. If you use one of the above options to create a new project, a dialog will open where you can specify the location and name of the project. For testing purposes, we will create a project called “Beispielprojekt2” in the default location:

_images/ProjektAnlegenDialog.png

After clicking on the “New Project” button, a dialog opens in which the desired path for the new project can be selected and a name for the project can be entered. The project folder and a project file (project name.twp) will then be created at the selected location.

_images/4_projectExp.PNG

If the project folder and project file have been created, the Project Explorer shows the path of the newly created project and the root folder. This folder currently only contains the playlist of the project.

The Project Explorer

_images/OverviewProjectexplorer.png

A brief overview showing the most important aspects of the Project Explorer:

  1. These four buttons allow the administration of a Test Workflow Project.
    • “New Workflow”: This button creates a new workflow. In case a subfolder of the project is selected, the new workflow will be created there. Otherwise the new workflow will be created in the root-folder of the project.
    • “New Project”: This button opens a dialog window with which a new Test Workflow Project can be created.
    • “Open Project”: This button opens a dialog window with which an existing Test Workflow Project can be opened. Already loaded projects will be unloaded.
    • “Refresh”: This button refreshes the Project Explorer.
  2. This shows the structure of an example project. Below the root-folder of the project, the playlist is shown, followed by the differend subfolders and workflows.

Managing subfolders

_images/Contextmenu_Folder.png

A right click on a subfolder opens the contextmenu. The different options in detail:

  1. Create new workflow:
    • This creates a new workflow in the selected subfolder.
  2. Create new folder:
    • This creates a new subfolder within the chosen folder.
  3. Rename:
    • This allows to rename a folder in the project.
  4. Delete folder:
    • “Delete folder” removes a folder from the project.
  5. Open in explorer:
    • This allows to open the chosen folder in Windows Explorer.

Managing workflows

_images/ContextMenu_Workflow.png

A right click on a workflow opens the contextmenu. The different options in detail:

  1. Delete workflow:
    • This moves the chosen workflow in the trash.
  2. Rename workflow:
    • this allows to rename the workflow safely.
  3. Add workflow to playlist:
    • This adds the selected workflow to the projects playlist.

Create a new project

As mentioned above, there are multiple ways to create a new project. Hereafter we will show how using the “New project” button on the start page.

_images/NewProject01.PNG

Clicking on the “New project” button opens a dialog, in which the user can select a path and enter a name for the new project. In the chosen directory, a project folder containing a project file (project_name.twp) will be created.

_images/NewProject02.PNG

Once project file and project folder are created, the Projectexplorer shows the path of the newly created project and the root-folder. At this point, the root folder only contains the Project Playlist.

Create a new workflow

_images/NewWorkflow01.PNG

As mentioned above, there are multiple ways to create a new workflow in a Test Workflow Project. Hereafter we will show how using the “New workflow” button in the Projectexplorer.

_images/NewWorkflow02.PNG

After being created, every workflow gets a default name by Test Workflow Studio, which can be changed immediately by the user.

The naming or renaming of any workflow can be approved by the return key or canceled by the escape key.

Once the workflow is named, it will immediately open in the designer. Now everything is ready to either record or create a workflow.

The Project playlist

Every Test Workflow Project contains a Playlist, to which workflows can be added to be run in bulk later.

_images/AddWorkflowToPlaylist01.PNG

Clicking on “Add workflow to playlist” from the context menu of a workflow adds a workflow to the project playlist.

_images/AddWorkflowToPlaylist02.PNG

Afterwards, the selected workflow will appear as part of the playlist, immediately under the project root and will be marked with the playlist icon.

Shared work on projects

When using projects, the TWS also offers users the possibility to work on a project in teams or groups. You can share your test cases with a single project folder with your team without creating a separate project for each user.

Prerequisites

  • A created project
  • Access for each user to the path where the project resides

You can find the guide to creating a project file here: Creating a project

Important: When creating the project, you must make sure to create the project in a public path (e.g. in your network), so that other users can integrate it in their own studio!

You can either save the project directly at the desired path via the studio or copy the already created project folder via the Windows Explorer.

Other users can now open this project in their studio using the Studio function “Open project” and work with or on it.

Important: Remember that working with multiple people on a project can lead to conflicts - your saved work on a workflow can be overwritten by someone else. So be sure to coordinate your work with others in advance!