ISystemHelpers

Description

Various methods to interact with the operating system.

You can access the SystemHelpers through the generated App class from your test case:

App.SystemHelpers.CreateFolderPath(@"C:\Temp");

Or from a screen through the IAppBasics Interface:

AppBasics.SystemHelpers.DeleteFile(@"C:\Temp\Dummy.txt");

ISystemHelpers Interface

Namespace: Progile.TRIO.BaseModel Assembly: Progile.TRIO.BaseModel (in Progile.TRIO.BaseModel.dll)

Methods

Name	Description
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.
CloseAllBrowsers	Closes all instances of the webbrowser. Warning for Close all tabs will be confirmed. Throws an exception if after 5 minutes not all windows could be closed.
CopyFiles	Copies the file(s) from the source path to the destination folder path. The name of the file will remain the same. Note: For copying of whole folders use CopyFolder instead.
CopyFolder	Copies the folder (with all files and subfolders) from the source path to the destination folder path. If destination folder doesn not exist yet, it will be created.
CreateFolderPath	Creates new folders for the specified path using mkdir command. If path already exists, command will return an error, but no further action is done (the outcome of the CreateFolderPath method is unaffected).
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.
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.
GetCpuLoadPercentage	Determines the current CPU load percentage on the SUT.
GetComputerName	Gets the computer name of the SUT.
GetOsBuildVersion	Gets the build version of the operating system on the SUT.
KillProcess	Kills a program or process from the run menu in windows (using Win-R key-shortcut).
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.
LoginRecentUser	Logs in the most recent user to the operating system from the welcome or lock screen if required. If login failed a TestStepAbortedException is thrown.
OpenCommandLineWindow	Checks if a command line window is already open on the screen, if not opens a new command line window, if yes prepares it for new commands.
OpenWebUrl	Runs the webpage.bat from Installer directory that will open the target webpage for the SUT.
RunProcess	Starts a program or process from the run menu in windows (using Win-R key-shortcut).
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.
UnzipFile	Extracts an archive to the destination folder.

Properties

Name	Description
ArtifactsDirectory	The path to the artifacts directory that is mapped on the SUT. The content of the artifacts directory will be provided for download in artifacts folder for the report in the TestResults.io portal. By default: "R:\"
InstallerDirectory	The path to the directory where the installer files are mapped on the SUT. By default: "R:\RequestedContent\SoftwareExecutable\"
OsType	The Type of the SUT OS, e.g. Windows or MacOSX.
SupportingFilesDirectory	The path to the directory where the supporting files are mapped on the SUT. Default: "R:\SupportingFiles\"
SystemInteractions	Gives access to the system interactions implementation that provides basic interactions such as keyboard shortcuts for the target operating system.
TempFolderOnSut	The path to a temporary folder that is unique to the currently running tc. Default: "C:\Temp\{reportId}\"
UsableScreen	The rectangle of the SUT screen that can be used by a windowed application. In particular for Windows it subtracts the taskbar height from the fullscreen.