AutoLoader Project Provider Console
You can use the AutoLoader Project Provider Console (AL Project Provider Console) to convert a Tricentis TDM Studio project to an AL project via the command line (cmd). This means that even when Tricentis TDM Studio is integrated in test suites or used in a script-based environment, Tricentis TDM Studio projects can be converted to AL projects without user intervention.
The functionality of the console is identical to that of the AL Project Provider (see chapter "AutoLoader Project Provider"). All parameters that can be set in the Project Provider dialog can also be set using the Project Provider Console.
The console is included in the Tricentis TDM Studio installation. It is a standard Windows application and it has the same system requirements as Tricentis TDM Studio.
The console application is located in the Tricentis TDM Studio folder bin and its executable is ToscaTDM.ALPPCommand.exe.
Switches and returned values
Call syntax:
ToscaTDM.ALPPCommand.exe "[Path]File name" [Switches]
An error message and the help is output in the console on invalid command lines.
The following table lists all mandatory switches for AutoLoader Project Provider Console:
|
Mandatory switches/entries |
Description |
Default value |
|---|---|---|
|
[Path]File name |
The name of the Tricentis TDM Studio project file with optional path. Example: Test\project.ttsprj |
- |
|
/A "[Path]File name" /A:"[Path]File name" |
File name with optional path of the AutoLoader project to create. Example: "Test\project.tdm" /a "AL\test.ttsal" |
- |
The following table lists all optional switches for AutoLoader Project Provider Console:
|
Optional switches |
Description |
Default value |
|---|---|---|
|
/D |
Description of the AL project. You can add additional information about the project here, for instance for documentation purposes. |
- |
|
/S "de-DE|en-US" /S:"de-DE|en-US" |
The language to set (de-DE or en-US). The language setting controls the language for the Data Generation window and the rules for decimal separators, date and time settings and number formats. The following languages are available: en-US or de-DE. |
Language setting from the registry |
|
/L:["Path"] |
This sets the directory in which the log files for the AL project will be saved. The switch can also be entered without a log file path, in which case the setting from the Tricentis TDM Studio project will be used. |
No logging |
|
/R 2|3|4|5|6|7 /R:2|3|4|5|6|7 |
Determines the trace level for logging the data generation. The value must be between 2 and 7. (2 = Error, 3 = Warning, 4= Information, 5 = Debug (low), 6 = Debug, 7 = Debug (high)). If an incorrect value is passed, an error message is displayed. |
4 = Information |
|
/O "Path" /O:"Path" |
Overrides the output directory settings of the Tricentis TDM Studio project. |
TDM project output directory |
|
/T "Task list" /T:"Task list" |
List of tasks to be included in the AL project in the format "task name [ | output path ] [ , … ]" Possible separators are commas or semicolons. Example: /t "A1,A2|c:\log,A3" |
All tasks. If the output path is not passed, the output path from the Tricentis TDM Studio task is used. |
|
/X |
Generates an AL project that runs in a Linux environment. If this is specified, the path given to /L must be in Linux style. |
The AL project is created for a Windows environment. |
|
/Y |
Allows overwriting, if the AL project already exists in the output directory. |
Existing AL project file is not overwritten. |
|
/C |
Copies the AutoLoader files to the AL project directory that are required to run AutoLoader (.exe and .dll). |
No AutoLoader files are copied. |
|
/U |
Generates the log file name with the current date and time. |
Log file name is generated without timestamp |
|
/? |
Shows the help screen (no AutoLoader project is created). |
- |
The AutoLoader Project Provider Console shows the following return values:
|
Returned errorlevel |
Description |
|---|---|
|
0 |
The application returns the value 0, if the processing was successful, i.e. an AL project was generated. ERRORLEVEL == 0 |
|
1 |
If an error has occurred, the application returns the value 1. No AL project was generated. ERRORLEVEL == 1 In addition, an error message displays in the console window. |
The console is run in the language of the Tricentis TDM Studio installation (English or German).