Designer
SystemHelpers Methods
CheckFileExists
Checks if a file or folder exists on the SUT filesystem. To check if a folder exist pass in the folder with the path without the last "\" at the end.
If stayInCmd is true, the cmd window is left open, otherwise it will be closed again.
Syntax:
1
public bool CheckFileExists(
2
string fileWithPath,
3
bool stayInCmd = false
4
)
Copied!
Parameters:
Exceptions:
Exception
Condition
The command did not complete within 60 seconds.
CloseAllBrowsers
Closes all webbrowser windows that are not minimized. Warning for Close all tabs will be confirmed. Throws an exception if after 5 minutes not all windows could be closed.
Syntax:
1
public void CloseAllBrowsers()
Copied!
Exceptions:
Exception
Condition
Browser was still open after several retries to close it.
CopyFiles
Copies the file(s) from the source path to the destination folder path using following cmd:
xcopy /q /h /y "{source}" "{destination}".
The name of the file will remain the same.
Note: For copying folders including its subdirectories use CopyFolder instead.Syntax:
1
public void CopyFile(
2
string source,
3
string destination,
4
bool stayInCmd = false,
5
int timeoutInSeconds = 300
6
)
Copied!
Parameters:
Parameter
Description
source
The file (incl path) to be copied. Supports wildcard characters for copying multiple files in the source directory.
destination
The path of the destination folder where the file shall be copied to.
[stayInCmd]
If stayInCmd is true, the cmd window is left open, otherwise it will be closed again.
[timeoutInSeconds]
The timeout for the copying command. If the command does not complete within this time a TestStepAbortedException is thrown.
Exceptions:
Exception
Condition
Either the copying command did not complete within the timeoutInSeconds or the command completed with an error.
CopyFolder
Copies the folder (with all files and subfolders) from the source path to the destination folder path using following cmd:
xcopy /q /i /e /h /y "{source}" "{destination}"
If destination folder does not exist yet, it will be created.Syntax:
1
public void CopyFile(
2
string source,
3
string destination,
4
bool stayInCmd = false,
5
int timeoutInSeconds = 300
6
)
Copied!
Parameters:
Parameter
Description
source
The folder path to be copied.
destination
The path of the destination folder where the folder shall be copied to.
[stayInCmd]
If stayInCmd is true, the cmd window is left open, otherwise it will be closed again.
[timeoutInSeconds]
The timeout for the copying command. If the command does not complete within this time a TestStepAbortedException is thrown.
Exceptions:
Exception
Condition
Either the copying command did not complete within the timeoutInSeconds or the command completed with an error.
CreateFolderPath
Creates new folders for the specified path using
mkdir command. If a path already exists, command will return an error, but no further action is done (the outcome of the CreateFolderPath method is unaffected).Syntax:
1
public void CreateFolderPath(
2
params string[] paths
3
)
Copied!
Parameters:
Parameter
Description
paths
One or multiple path strings that should be created.
DeleteFile
Deletes a file or folder on the SUT filesystem. To delete a folder include the "\" at the end to indicate it's a folder.
If stayInCmd is true, the cmd window is left open, otherwise it will be closed again.
Syntax:
1
public void DeleteFile(
2
string fileWithPath,
3
bool stayInCmd = false
4
)
Copied!
Parameters:
Exceptions:
Exception
Condition
The command did not complete within 60 seconds.
EnvironmentReady
This method checks that the desktop of the environment is completely loaded and checks the CPU load of the SUT from the cmd window to ensure the system is responsive (CPU load below 40%).
If an installer testcase is used, this should be called from installer Precondition step, otherwise from test case Precondition step.
Syntax:
1
public bool EnvironmentReady(
2
bool checkSystemResponsive = true
3
)
Copied!
Parameters:
Parameter
Description
[checkSystemResponsive]
Return Value:
True if the system is responsive. Otherwise methods throws a SUTNotReadyException that will trigger a VM Redeployment for cloud VMs.
Exceptions:
Exception
Condition
If the system is not responsive, a SUTNotReadyException is trown that will trigger a VM Redeployment for cloud VMs.
GetCpuLoadPercentage
Determines the current CPU load percentage on the SUT by running the
wmic cpu get loadpercentage.Syntax:
1
public int GetCpuLoadPercentage()
Copied!
Return Value:
An integer value between 0 and 100 indicating the CPU load percentage on the SUT.
Exceptions:
Exception
Condition
Either the command to get the cpu load did not complete or the cpu load percentage could not be parsed from the response of the command.
GetComputerName
Gets the computer name of the SUT with the
hostname command.Syntax:
1
public string GetComputerName()
Copied!
Return Value:
The computer name as a string.
Exceptions:
Exception
Condition
The command to get the computer name did not complete or did not return anything.
GetOsBuildVersion
Gets the build version of the operating system on the SUT.
Syntax:
1
public string GetOsBuildVersion()
Copied!
Return Value:
A string with the OS build version.
KillProcess
Kills a program or process from the run menu in windows (using Win-R key-shortcut).
Syntax:
1
public void KillProcess(
2
string processName
3
)
Copied!
Parameters:
Parameter
Description
processName
The name of the process that shall be killed.
LogEnvironmentModelVersion
Logs the name and version of the environment model contained in this assembly. Should be called in setup test step of every test case using the environment model.
Syntax:
1
public void LogEnvironmentModelVersion()
Copied!
LoginRecentUser
​
OpenCommandLineWindow
Checks if a cmd window is already open on the screen, if not opens a new cmd window, if yes prepares it for new commands.
Syntax:
1
public ICommandLineWindow OpenCommandLineWindow()
Copied!
Return Value:
An instance of the ICommandLineWindow class that allows to interact with the cmd window that was just opened.
Exceptions:
Exception
Condition
When the command window cannot be opened after 3 retries.
OpenInExplorer Method
Opens a folder or file, or starts a program from the file explorer.
Syntax:
1
public void OpenInExplorer(
2
string path
3
)
Copied!
Parameters:
Parameter
Description
path
The name of the folder path, file or program that shall be opened.
OpenWebUrl Method
Runs the webpage.bat from Installer directory that will open the target webpage for the SUT.
Syntax:
1
public Browser OpenWebUrl()
Copied!
Return Value:
An instance of the Browser class that allows to interact with the browser window that was just opened.
Exceptions:
Exception
Condition
When the browser window does not open after the wait time.
RunProcess Method
Starts a program or process from the run menu in windows (using Win-R key-shortcut).
Syntax:
1
public void RunProcess(
2
string processName
3
)
Copied!
Parameters:
Parameter
Description
processName
The name of the program or process that shall be run.
SetUpRemoteDirectory Method
Overload List
Name
Description
Mounts the remote directory that is provided by the execution host. If assigned drive is already in use, it is disconnected first. Uses default drive letter R.
Mounts the remote directory that is provided by the execution host to the specified drive. If assigned drive is already in use, it is disconnected first.
SetUpRemoteDirectory()
Mounts the remote directory that is provided by the execution host. If assigned drive is already in use, it is disconnected first. Uses default drive letter R.
Syntax:
1
public void SetUpRemoteDirectory( )
Copied!
Exceptions:
Exception
Condition
Either the previous mapping could not be removed or the current remote directory could not be mapped.
SetUpRemoteDirectory(Char)
Mounts the remote directory that is provided by the execution host to the specified drive and updates ArtifactsDirectory, SupportingFilesDirectory etc accordingly.
If assigned drive is already in use, it is disconnected.
Note: The Drive Letter is not persisted from Installer to TestCase, so if you SetupRemoteDirectory in Installer, the TestCase will again default to 'R' for ArtifactsDirectory etc.
Syntax:
1
public void SetUpRemoteDirectory(
2
char driveLetter
3
)
Copied!
Parameters:
Parameter
Description
driveLetter
The drive letter to which the remote directory shall be mapped to.
Exceptions:
Exception
Condition
Either the previous mapping could not be removed or the current remote directory could not be mapped.
UnzipFile
Extracts an archive (tested with zip, but potentially other archive types work as well) to the destination folder.
Syntax:
1
public void RunProcess(
2
string pathToZipFile,
3
string destinationPath,
4
bool stayInCmd = false,
5
int timeoutInSeconds = 300
6
)
Copied!
Parameters:
Parameter
Description
pathToZipFile
The path to the zip file.
destinationPath
The path of the folder in which the zip file shall be extracted. With or without at the end. Will be created if it doesn't exist.
[stayInCmd]
If stayInCmd is true, the cmd window is left open, otherwise it will be closed again.
[timeoutInSeconds]
The timeout for the unzip command. If the command does not complete within this time a TestStepAbortedException is thrown.
Last modified 2yr ago
Copy link
Contents
CheckFileExists
CloseAllBrowsers
CopyFiles
CopyFolder
CreateFolderPath
DeleteFile
EnvironmentReady
GetCpuLoadPercentage
GetComputerName
GetOsBuildVersion
KillProcess
LogEnvironmentModelVersion
LoginRecentUser
OpenCommandLineWindow
OpenInExplorer Method
OpenWebUrl Method
RunProcess Method
SetUpRemoteDirectory Method
SetUpRemoteDirectory()
SetUpRemoteDirectory(Char)
UnzipFile