TestResults.io
  • What is TestResults.io
  • System Architecture
  • Regulated Markets
    • Health Care Industry
    • Financial Services Industry
  • What's new?
    • Update Instruction
      • Update of the Designer extension in Visual Studio
      • Update the Execution Engine
      • Update the Base- and Environment Models
    • Migration to new project file
  • Designer
    • Overview
    • First Steps
    • Installation
    • TestResults.io solution
    • The development environment
      • Tool Window Overview
        • Test Environments
          • Steps to configure a SUT VM
          • How to access files on the system under test
        • Remote Viewer
          • Control Mode
          • Capture Mode
          • Screen Editor
          • Capture Single Image
        • Screen Explorer
        • Test Case Designer
        • Image Explorer
        • API Testing
        • TestResults.io options
          • Engines
          • Servers
    • Test Cases
      • Adding Test Cases
      • Test Case structure
      • Simple Test Case (Example)
      • Executing your Test Case
      • Generating Test Containers
      • Publishing Test Cases
      • Execution Variables
    • Software Models
      • Adding SW Models
      • Referencing the Model in the Test Case
      • Generating Test Containers
      • Publishing SW Models
      • Screens and Screen Elements
        • Tables
        • Visual Sense
        • Custom Screen Elements
    • Installers
      • Adding Installers
      • Generating Test Containers
      • Publishing Installers
    • Automation Framework Reference
      • Attributes
      • Enumerations
      • Filters
        • IImageFilter Interface
        • Select
        • Resize
      • GlobalEngineParameters
      • ImageDetectionParameters
      • ImageReference
      • Interfaces
        • ITester Interface
          • ITester Methods
          • ITester Properties
        • ITestee Interface
          • ITestee Methods
        • IConnections Interface
          • IConnections Methods
          • IConnections Properties
        • IDebug Interface
        • IEngineResult
        • IHelpers Interface
        • IImageHelper Interface
          • IImageHelper Methods
        • IKeyboard Interface
          • IKeyboard Methods
        • IMouse Interface
          • IMouse Methods
          • IMouse Properties
        • IReport Interface
          • IReport Methods
        • ISUTConnection Interface
      • OcrEngineParameters
        • Best practise
        • IronOcrEngineParameters
        • LEADOcrEngineParameters
        • OcrEngineRelatedCharacters
        • OcrPreprocessingParameters
      • ResultRectangle
      • SutNotReadyException
      • TestStepAbortedException
    • FAQ
      • Two-factor authentication (2FA) and One Time Passwords (OTP)
      • Receive and verify Emails
      • Using Excel as test data source
      • Verify PDF Content
  • Portal
    • Overview
    • First Steps
    • User's Guide
      • Login
      • Projects
      • Dashboard
      • Test Cases
      • Software & Environments
      • Test Sets
      • Job Queue
      • Management
      • Notifications Summary
    • Automation Engineer's Guide
      • Test Automation Workflow
      • Automating a test case
      • Enabling Software & Environments
    • REST API Reference
      • Authentication
      • Projects
      • Test Sets
      • Test Cases
      • Test Plans
      • Test Reports
      • Files
      • Software
      • Environments
      • Untitled
      • Executions
      • Favorites
      • Statistics
      • User Management
      • Customer Management
      • Notifications
      • Configurations
      • Invoicing
  • Models
    • Overview
    • Base Model
      • BaseScreen
        • BaseScreen Properties
        • BaseScreen Methods
      • OnScreenElement
        • OnScreenElement Methods
        • OnScreenElement Properties
      • Primitives
        • Button
          • Button Methods
          • Button Properties
        • Checkbox
          • Checkbox Methods
        • ContextMenu
          • ContextMenu Methods
          • ContextMenu Properties
        • Dropdown
          • Dropdown Methods
          • Dropdown Properties
        • DropdownMenu
          • DropdownMenu Methods
          • DropdownMenu Properties
        • GenericScroller
          • GenericScroller Methods
          • GenericScroller Properties
        • HorizontalScroller
        • IconButton
          • IconButton Properties
        • Label
        • LabelWithButton
          • LabelWithButton Properties
        • LabelWithCheckbox
          • LabelWithCheckbox Properties
        • LabelWithValue
          • LabelWithValue Methods
          • LabelWithValue Properties
        • PwTextBox
          • PwTextBox Methods
        • TextBox
          • TextBox Methods
          • TextBox Properties
        • Tables and lists
          • Column
            • Column Methods
            • Column Properties
          • ItemList
            • ItemList Methods
            • ItemList Properties
          • Row
            • Row Methods
            • Row Properties
          • TableBase
            • TableBase Methods
            • TableBase Properties
        • LabelWithElementBase
          • LabelWithElementBase Properties
      • Enumerations
      • Extensions
        • EngineResultExtensions Methods
        • EnumExtensions Methods
        • ReportExtensions Methods
        • StringExtensions Methods
        • TesterConnectionExtensions Methods
        • TesterDebugExtensions Methods
        • TesterHelperExtensions Methods
        • TesterMouseExtensions Methods
        • TesterOnScreenElementExtensions
        • TesterSelectExtensions Methods
      • Helper Classes
        • BaseModelHelpers
          • BaseModelHelpers Methods
          • BaseModelHelpers Properties
        • Attributes for Designer
        • ListHelpers
      • Exceptions
        • ElementNotFoundException
        • InteractionFailedException
        • ScreenNotFoundException
      • Interfaces
        • IAppBasics Interface
          • IAppBasics Methods
          • IAppBasics Properties
        • IBrowser
        • ICommandLineWindow
        • IScroller Interface
          • IScroller Methods
          • IScroller Properties
        • ISutLocale Interface
          • ISutLocale Methods
          • ISutLocale Properties
        • ISystemHelpers
        • ISystemInteractions
        • IWindow
    • Environment Model
      • Windows
        • Screens
          • CmdWindow
            • CmdWindow Methods
            • CmdWindow Properties
          • FileDialog
            • FileDialog Methods
            • FileDialog Properties
          • FileExplorer
            • FileExplorer Properties
          • RunWindow
            • RunWindow Methods
            • RunWindow Properties
          • Window
            • Window Methods
            • Window Properties
        • SutLocale
          • SutLocale Methods
          • SutLocale Properties
        • SystemHelpers
          • SystemHelpers Methods
          • SystemHelpers Properties
        • SystemInteractions
        • WebBrowser
          • Browser
            • Browser Methods
            • Browser Properties
          • BrowserScroller
            • BrowserScroller Methods
            • BrowserScroller Properties
          • AuthenticationDialog
            • AuthenticationDialog Methods
            • AuthenticationDialog Properties
          • DownloadDialog
            • DownloadDialog Methods
            • DownloadDialog Properties
        • EnvironmentModel Enumerations
        • Interfaces
          • IWebAppBasics
            • IWebAppBasics Property
Powered by GitBook
On this page
  • AutoNumberPattern
  • ClipboardTimeOut
  • DefaultImageEngine
  • DefaultOcrEngine
  • ForceScreenRefreshAfterInteraction
  • ForceScreenRefreshAlways
  • ForceScreenRefreshBeforeStep
  • GeneralInteractionWaitTime
  • ImageDetectionPrecision
  • KeyDownDelay
  • KeyNextDelay
  • MouseClickApproachOffset
  • MouseClickDelay
  • MouseMoveOutOffset
  • MouseMoveOutOfScreen
  • PreconditionStepName
  • RapidInteractionWaitTime
  • ResultLogAbortedTemplate
  • ResultLogFailedTemplate
  • ResultLogPassedTemplate
  • ScreenshotAbortedStepName
  • ScreenshotExecutionAbortedName
  • ScreenshotFailedStepName
  • ScreenshotNaming
  • ScreenshotPassedStepName
  • ScreenRefreshWait
  • ScreenRefreshWaitTimeout
  • SearchDuration
  • SearchRetryWaitTimeInMs
  • TextDetectionAccuracy
  • TextDetectionLanguagesToUse
  • TextDetectionRelatedCharacters
  • TextSearchLevel
  • UpdateCheckerRefreshTimeOut
  • UseImagePositionCache

Was this helpful?

  1. Designer
  2. Automation Framework Reference

GlobalEngineParameters

PreviousResizeNextImageDetectionParameters

Last updated 1 year ago

Was this helpful?

These are global settings for the execution engine that control different aspects of the interactions with the Testee, execution flow and reporting. The settings are accessible through .

AutoNumberPattern

Pattern used for screenshot number generation Default: "000", numbers are padded with zeros to its left to have at least 3 digits (e.g. 001, 002, etc).

Syntax: public string AutoNumberPattern { get; set; }

ClipboardTimeOut

Defines the amount of milliseconds the engine should wait for new clipboard content until it returns the previous content of the clipboard. Default: 10000 (10 seconds)

Syntax: public int ClipboardTimeOut { get; set; }

DefaultImageEngine

Defines the default image detection engine used for image recognition. Can be either ImageEngines.Precise (Uses an image engine that is pixel precise (with the option to define a color tolerance)) or ImageEngines.Template (Uses an image engine that is template matching based). Default: ImageEngines.Template

Syntax: public ImageEngines DefaultImageEngine { get; set; }

DefaultOcrEngine

Defines the default ocr engine used for text recognition. Can be either OcrEngines.LEADEngine (Offers 2nd and 3rd guesses for every character, which allows for better recognition of the search text when detection is not perfect) or OcrEngines.Template (Based on Tesseract; Performs better than LEAD on small text due to inbuilt image preprocessing). Default: OcrEngines.LEADEngine

Syntax: public OcrEngines DefaultOcrEngine { get; set; }

ForceScreenRefreshAfterInteraction

Syntax: public bool ForceScreenRefreshAfterInteraction { get; set; }

ForceScreenRefreshAlways

Syntax: public bool ForceScreenRefreshAlways{ get; set; }

ForceScreenRefreshBeforeStep

Syntax: public bool ForceScreenRefreshBeforeStep{ get; set; }

GeneralInteractionWaitTime

Amount of milliseconds the engine waits between every high-level interaction before it continues. This gives the SUT time to process the previous action. Increase this time if for example the first characters of a text entered in a Textbox after focusing it are lost. Default: 200

Syntax: public int GeneralInteractionWaitTime { get; set; }

ImageDetectionPrecision

Global precision used for image detection if no other parameter overwrites this. 1 = perfect match, 0 = everything. Default: 0.9

Syntax: public double ImageDetectionPrecision { get; set; }

KeyDownDelay

Amount of milliseconds the engine waits between the KeyDown and KeyUp event for a KeyPress. Default: 10

Syntax: public int KeyDownDelay { get; set; }

KeyNextDelay

Amount of milliseconds the engine waits between typing characters. Default: 1

Syntax: public int KeyNextDelay { get; set; }

MouseClickApproachOffset

Defines a delta from the target position of an interaction. The mouse move to this delta position is fast and from the delta position to the final position the move will be moved pixel by pixel. Default: new Point(10, 15)

MouseClickDelay

Amount of milliseconds the engine waits between the MouseDown and MouseUp event for a MouseClick. Default: 50

Syntax: public int MouseClickDelay { get; set; }

MouseMoveOutOffset

MouseMoveOutOfScreen

If enabled moves the mouse cursor out of screen before searching for an image or text. Default: false

Syntax: public bool MouseMoveOutOfScreen { get; set; }

PreconditionStepName

Used to name the precondition step. Mainly used for automatic screenshot generation. Default: "PRECONDITION"

Syntax: public string PreconditionStepName { get; set; }

RapidInteractionWaitTime

Amount of milliseconds the engine waits between every SUT interaction before it continues. This is the minimum amout of time. You should not need to change it. Default: 10

Syntax: public int RapidInteractionWaitTime { get; set; }

ResultLogAbortedTemplate

Indicator string used to start an entry in the results log for aborted steps. Available variables are: %CONTENT%: Content of the test log entry

Default: "Aborted: %CONTENT%+Environment.NewLine"

Syntax: public string ResultLogAbortedTemplate { get; set; }

ResultLogFailedTemplate

Indicator string used to start an entry in the results log for failed steps. Available variables are: %CONTENT%: Content of the test log entry

Default: "Failed: %CONTENT%"+Environment.NewLine"

Syntax: public string ResultLogAbortedTemplate { get; set; }

ResultLogPassedTemplate

Indicator string used to start an entry in the results log for failed steps. Available variables are: %CONTENT%: Content of the test log entry

Default: "%CONTENT%"+Environment.NewLine"

Syntax: public string ResultLogAbortedTemplate { get; set; }

ScreenshotAbortedStepName

Indicator string used to name automatically generated screenshots for aborted steps. Default: "ABORTED"

Syntax: public string ScreenshotAbortedStepName { get; set; }

ScreenshotExecutionAbortedName

Indicator string used to name automatically generated screenshots for steps that completely aborted the test case execution Default: "ExecutionAborted"

Syntax: public string ScreenshotExecutionAbortedName { get; set; }

ScreenshotFailedStepName

Indicator string used to name automatically generated screenshots for failed steps Default: "FAILED"

Syntax: public string ScreenshotFailedStepName { get; set; }

ScreenshotNaming

Default: "%TCNAME%_%COND%STEP%TCSTEP%_%SHOTNR%_%NAME%"

Syntax: public string ScreenshotNaming { get; set; }

ScreenshotPassedStepName

Indicator string used to name automatically generated screenshots for passed steps Default: "PASSED"

Syntax: public string ScreenshotPassedStepName { get; set; }

ScreenRefreshWait

Defines that the execution should wait in case a screen fresh is requested until a refresh remote screen was received by the test engine Default: true

Syntax: public bool ScreenRefreshWait { get; set; }

ScreenRefreshWaitTimeout

Defines the maximum amount of milliseconds the test engine should block the execution while waiting for a screen refresh Default: 1000

Syntax: public int ScreenRefreshWaitTimeout { get; set; }

SearchDuration

Defines how long an on-screen search should be retried when no result was found, if the searchDuration parameter in the search method is not set. Default: 5 seconds

SearchRetryWaitTimeInMs

Defines how long the search should wait before a retry is started. Default: 300

Syntax: public int SearchRetryWaitTimeInMs { get; set; }

TextDetectionAccuracy

Defines the accurary of the text search with the following meaning (Default: 1.9): 0.0 perfect match, 0.1 one white space difference, 0.3 one character matched the second or third guess, 0.4 one related character difference, 0.5 one related character difference based on the second or third guess, 0.6 one related character group replaced, 0.8 one character with incorrect capitalization (e.g. Z instead of z), 1.0 one unrelated character difference, 1.1 start or end anchor missing

Syntax: public double TextDetectionAccuracy { get; set; }

TextDetectionLanguagesToUse

Defines the set of languages used for recognizing text (sequence does not define priority) Default: OcrLanguages.English

Syntax: public OcrLanguagesToUse TextDetectionLanguages { get; set; }

TextDetectionRelatedCharacters

Allows to adjust the default related characters matrix for text recognition.

TextSearchLevel

Defines the search level of the text recognition, i.e. what is recognized as a combination. Default: StringComparison

Syntax: public SearchLevel TextSearchLevel { get; set; }

UpdateCheckerRefreshTimeOut

Syntax: public int UpdateCheckerRefreshTimeOut { get; set; }

UseImagePositionCache

Enabled image position cache. If enabled the position of every image is cached once it was found. In subsequent searches the image is first look for at the last successful coordinates if not found the image is looked for on the complete screen. Default: true

Syntax: public bool UseImagePositionCache { get; set; }

Requests a of the subject under test before every action that accesses the remote screen if there was an interaction after the last access. Default: false

Requests a of the subject under test before every action that accesses the remote screen. Default: false

Requests a of the subject under test before a step is started. Default: false

Syntax: publicMouseClickApproachOffset { get; set; }

Defines the delta by which the mouse should moved if the engine requested the . Default: Empty

Syntax: publicMouseMoveOutOffset{ get; set; }

Defines the naming template for screenshots. Available variables are: %TCNAME%: Testcase name %COND%: Contains the value of if it is the precondition step. Is empty otherwise %TCSTEP%: Step number %SHOTNR%: Screenshot run number of current step %NAME%: Name of the screenshot

Syntax: public SearchDuration { get; set; }

Syntax: public TextDetectionRelatedCharacters { get; }

Defines the amount of milliseconds the engine should wait before it checks for a new screen update (only used if you call ) Default: 500

Point
Point
TimeSpan
OcrEngineRelatedCharacters
PreconditionStepName
move the mouse out of the screen
remote full screen refresh
remote full screen refresh
remote full screen refresh
RegisterForUpdateCheck()
t.Properties