Ranorex Automation Helpers provide a collection of pre-made modules and user code methods to solve common automation challenges without manual coding.
For more information, see Automation Helpers Introduction.
Modules
Add these modules by dragging them from the module browser directly into your test suite.
EmailModule
This module shares test results via email.
- Sends notifications on test success, failure, or both.
- Attaches zipped reports or PDF versions to the message.
- Requires valid SMTP server settings.
For more information, see EmailModule.
ReportToPDFModule
This module automatically creates a PDF version of the standard Ranorex report.
- Saves the PDF to the output folder after the test run.
- Adds a direct link to the PDF within the original report file.
For more information, see ReportToPDFModule and Convert your Ranorex Report to PDF.
CollectRetryErrorMessagesModule
By default, if a test container fails but succeeds on a retry, the report hides the initial error messages. Add this module to containers with a Retry count greater than 0 to ensure that the report includes all error messages from every attempt.
For more information, see CollectRetryErrorMessagesModule.
User code methods
Access these methods through the User code library. Select the desired method, define the required strings, and confirm your selection.
| Library | Method | Purpose |
| DragNDropLibrary | DragAndDrop | Picks a source element, drags it to the target element, and drops it there. |
| EmailLibrary | SendEmail | Sends an e-mail using specified SMTP server settings. |
| FileLibrary | AppendStringToExistingFile | Opens an existing file and adds a new line of text at the end. |
| CheckFilesExist | Checks if specific files exist in a directory. | |
| DeleteFiles | Deletes files from a specified directory. | |
| WaitForFile | Pauses execution and waits for a file to appear in a directory. | |
| ValidateFileContainsText | Checks if a specific file contains a defined text string. | |
| ValidateFilesBinaryEqual | Performs a binary comparison between two files to ensure they are identical at the byte level. | |
| ValidateFilesTextEqual | Compares the text content of two files. | |
| WriteToFile | Creates a log file containing custom text in the output folder. | |
| PopupWatcherLibrary | StartPopupWatcher | Waits for a popup window to appear and clicks an element to close the window. |
| StopPopupWatcher | Stops and removes an active popup watcher. | |
| StopAllPopupWatchers | Stops all currently active popup watchers. | |
| PauseWhileExists | Waits for a popup window to appear and pauses test execution until the window disappears on its own. | |
| StringLibrary | ConcatStrings | Concatenates two strings and returns the new string. |
| GetRandomString | Produces a random string of the specified length and returns it. | |
| SystemLibrary | KillProcess | Terminates a specific running process. |
| StartTimer | Starts a timer to measure an interval. | |
| StopTimer | Stops a timer and logs the elapsed time. | |
| GetDateTimeAsString | Returns the current date and time as a string. | |
| ValidationLibrary | CompareValues | Performs a comparison between two specific values. |
| WebLibrary | DownloadFile | Downloads a file from a URL and stores it locally. |
| GetHttpStatusCode | Checks a specific URL and returns the HTTP status code. | |
| ReportFullPageScreenshot | Captures a screenshot of an entire webpage. |