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 sub-folders 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.
- About the 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 “ExampleProject6” in the default location:
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.
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¶
A brief overview showing the most important aspects of the Project Explorer:
- These four buttons allow the administration of a Test Workflow Project.
- “New Workflow”: This button creates a new workflow. In case a sub-folder 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 Folder”: This button creates a new folder. In case a sub-folder of the project is selected, the new folder will be created there. Otherwise, the new folder will be created in the root-folder of the project.
- “Collapse-All”: This button usefull when user wants to collapse all the folders and sub-folders in project explorer.
- “Refresh”: This button refreshes the Project Explorer.
- This shows the structure of an example project. Below the root-folder of the project, the playlist is shown, followed by the different sub-folders and workflows.
A right-click on a sub-folder opens the context menu.
The different options in detail:
- Create new workflow:
- This creates a new workflow in the selected sub-folder.
- Create new folder:
- This creates a new sub-folder within the chosen folder.
- This allows renaming a folder in the project.
- Delete folder:
- “Delete folder” removes a folder from the project.
- Open in explorer:
- This allows opening the chosen folder in Windows Explorer.
A right-click on a workflow opens the context menu. The different options in detail:
- Delete workflow:
- This moves the chosen workflow in the trash.
- Rename workflow:
- this allows renaming the workflow safely.
- Add workflow to playlist:
- This adds the selected workflow to the project’s 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.
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.
Once the project file and project folder are created, the Project Explorer 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¶
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 Project Explorer.
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 cancelled 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.
Clicking on “Add workflow to playlist” from the context menu of a workflow adds workflow to the project playlist.
Afterward, the selected workflow will appear as part of the playlist, immediately under the project root and will be marked with the playlist icon.