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.
- 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:
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 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.
- 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.
A right click on a subfolder opens the contextmenu. The different options in detail:
- Create new workflow:
- This creates a new workflow in the selected subfolder.
- Create new folder:
- This creates a new subfolder within the chosen folder.
- This allows to rename a folder in the project.
- Delete folder:
- “Delete folder” removes a folder from the project.
- Open in explorer:
- This allows to open the chosen folder in Windows Explorer.
A right click on a workflow opens the contextmenu. The different options in detail:
- Delete workflow:
- This moves the chosen workflow in the trash.
- Rename workflow:
- this allows to rename the workflow safely.
- 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.
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 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¶
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.
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.
Clicking on “Add workflow to playlist” from the context menu of a workflow adds a workflow to the project playlist.
Afterwards, the selected workflow will appear as part of the playlist, immediately under the project root and will be marked with the playlist icon.