ATS : ATS libraries configuration

Introduction


This page lists many options which are used for changing the ATS framework behavior.

All options have default values, but sometimes you need to change some of them.

 


Common configuration

  • TestBox

    Property

    Description

    Valid values

    Default value

    Unit

    common.testboxes.server.adminPassword

    The administrator's password

    String

    x

    x

    common.testboxes.server.adminUser

    The administrator's user name

    String

    x

    x

    common.testboxes.server.host

    The hostname of the test box

    String

    x

    x

    common.testboxes.server.dbname

    The database name

    String

    x

    x

    common.testboxes.server.dbpass

    The database password

    String

    x

    x

    common.testboxes.server.dbuser

    The database user

    String

    x

    x

    common.testboxes.server.dbtype

    The database type

    MYSQL, MSSQL,

    ORACLE, Cassandra

    x

    x

    common.testboxes.server.dbport

    The database port

    Integer between 0 and 65536

    default port for the DB

    x

    common.testboxes.server.dbsid

    The SID of ORACLE database

    String

    ORCL

    x

    common.testboxes.server.dbserviceName

    The Service name of ORACLE database

    String

    x

    x

  • MessageBox

    Property

    Description

    Valid values

    Default value

    Unit

    common.messageboxes.mailhero.dbname

    The name of the database to use

    String

    x

    x

    common.messageboxes.mailhero.dbpass

    The database password

    String

    x

    x

    common.messageboxes.mailhero.dbuser

    The database user

    String

    x

    x

    common.messageboxes.mailhero.host

    The host name of the message box

    String

    x

    x

    common.messageboxes.mailhero.dbtable

    The table to use

    String

    x

    x

  • MailServer

    Property

    Description

    Valid values

    Default value

    Unit

    common.mailservers.exchange.defaultPass

    The default password of the mailserver

    String

    x

    x

    common.mailservers.exchange.host

    The host name of the mail server

    String

    x

    x

The name of the testbox / mailserver / messagebox is the last value before the property, in other words by setting the property common.testboxes.server... you create a test box called server

 

Runtime these settings are available by the CommonConfigurator:

Method

Action

getMailbox(String name)

Provided by a box name returns an object with it's properties

getMessageBox(String name)

Provided by a box name returns an object with it's properties

getTestBox(String name)

Provided by a box name returns an object with it's properties

 


TestHarness configuration

Property

Description

Valid values

Default value

harness.dataprovider.type

The type of provider that reads the data source

EXCEL (only)

EXCEL

harness.dataprovider.testcasesroot

The root directory to search the data files in

Any valid absolute path

 

harness.testng.customtestlisteners

Custom TestNG test listeners

Comma separated list of TestNG test listeners

 

harness.testng.customsuitelisteners

Custom TestNG suite listeners

Comma separated list of TestNG suite listeners

 

Some of these settings are available by the TestHarnessConfigurator :

Method

Action

getSuitesRootDirectory()

Returns the root directory for all suite test data

 


RBV Configuration

Property

Description

Valid values

Default value

Unit

rbv.polling.initialdelay

How long should the RBV stall before it starts to poll for new data

Positive integer

0

milliseconds

rbv.polling.attempts

How many attempts RBV will make to pool the data before giving up

Positive integer

3

x

rbv.polling.interval

The polling interval between two attempts

Positive integer

1000

milliseconds

Runtime these settings are available by the RBVConfigurator :

Method

Action

getPollingInitialDelay()

Returns value of the rbv.polling.initialdelay property

getPollingAttempts()

Returns the value of the rbv.polling.attempts property

getPollingInterval()

Returns the value of the rbv.polling.interval property

 


Action Library Configuration

Property

Description

Valid values

Default value

Unit

actionlibrary.packageloader.defaultbox

The name of the default message box

String

messagesbox

x

actionlibrary.filetransfer.https.default.encryption.protocols

Default encryption protocols for HTTPS transfers(comma is the separator) String

 

x

actionlibrary.filetransfer.https.default.cipher.suites

Default ciphers for HTTPS transfers(comma is the separator) String

 

x

actionlibrary.filesystem.copyfile.start.port

Min port number for remote file copy operations Positive integer

 

x

actionlibrary.filesystem.copyfile.end.port

Max port number for remote file copy operations Positive integer

 

x

actionlibrary.mail.host

The default SMTP server we send SMTP packages to

SMTP host string

please.specify.some.real.smtp.host.at.tumbleweed.com

x

actionlibrary.mail.port

The default SMTP port

Positive integer

25

x

actionlibrary.mail.timeout

How long would we wait for SMTP send operation before giving up

Positive integer

10000

milliseconds

actionlibrary.mail.session.debug

Debug mode for the mail session

Boolean

false

x

actionlibrary.mimepackage.maxnestedlevel

The level of nested packages we parse when loading a MIME package

Positive integer

10

x

actionlibrary.filesnapshot.check.modificationtime

Whether files' modification time should be taken into consideration for file snapshots

Boolean

true

x

actionlibrary.filesnapshot.check.size

Whether files' size be checked for file snapshots

Boolean

true

x

actionlibrary.filesnapshot.check.md5

Whether files' MD5 sum be checked for file snapshots

Boolean

true

x

actionlibrary.filesnapshot.support.hidden

Whether hidden files and directories will be included into file snapshots

Boolean

true

x

actionlibrary.rest.default.request.media.type

Default REST request media type

 

text/plain

x

actionlibrary.rest.default.request.media.charset

Default REST request media charset

 

UTF-8 

x

actionlibrary.rest.default.response.media.type

Default REST response media type

 

text/plain

x

actionlibrary.rest.default.response.media.charset

Default REST response media charset

 

UTF-8

x

Runtime these settings are available by the  ActionLibraryConfigurator :

Method

Action

getDefaultMessagesBox()

Returns value of the actionlibrary.packageloader.defaultbox property

getFileTransferDefaultHttpsEncryptionProtocols()

Returns value of the actionlibrary.filetransfer.https.default.encryption.protocol property

getFileTransferDefaultHttpsCipherSuites()

Returns value of the actionlibrary.filetransfer.https.default.cipher.suites property

getCopyFileStartPort()

Returns value of the actionlibrary.filesystem.copyfile.start.port property

getCopyFileEndPort()

Returns value of the actionlibrary.filesystem.copyfile.end.port property

getSmtpHost()

Returns value of the actionlibrary.smtp.host property

getSmtpPort()

Returns value of the actionlibrary.smtp.port property

getSmtpTimeout()

Returns value of the actionlibrary.smtp.timeout property

getMailSessionDebugMode()

Returns value of the actionlibrary.mail.session.debug property

getMimePackageMaxNestedLevel()

Returns value of the actionlibrary.mimepackage.maxnestedlevel property

getFileSnapshotCheckModificationTime()

Returns value of the actionlibrary.filesnapshot.check.modificationtime property

getFileSnapshotCheckFileSize()

Returns value of the actionlibrary.filesnapshot.check.size property

getFileSnapshotCheckFileMd5()

Return value of actionlibrary.filesnapshot.check.md5 property

getFileSnapshotSupportHiddenFiles()

Returns value of the actionlibrary.filesnapshot.support.hidden property

 


UI Engine configuration

Property

Description

Valid values

Default value

Unit

uiengine.mapFilesBaseDir

The base directory where all map files are searched in

System folder

resources/maps

x

uiengine.commandDelay

Artificial delay after some UI element commands

integer

100

milliseconds

uiengine.elementStateChangeDelay

Time to wait for change in an element's state

Positive integer

10000

milliseconds

uiengine.highlightElements

Whether will try to highlight an elements

true / false

true

x

browser.download.dir

The browser download directory (absolute path). As all properties files in Java backslashes ("\") should be doubled (Windows case)

System folder

System temp directory

x

browser.download.mimeTypes

File MIME types which will be saved in the download dir automatically (without user prompt)

MIME types (comma separated)

application/octet-stream, application/zip, application/x-rar-compressed, application/x-zip-compressed, application/binary

x

Runtime these settings are available by the UiEngineConfigurator :

Method

Action

getMapFilesBaseDir()

Returns the value of the uiengine.mapFilesBaseDir property

getCommandDelay()

Returns the value of the uiengine.commandDelay property

getElementStateChangeDelay()

Returns the value of the uiengine.elementStateChangeDelay property

getHighlightElements()

Returns the value of the uiengine.highlightElements property

getBrowserDownloadDir()

Returns the value of the browser.download.dir property

getBrowserDownloadMimeTypes()

Returns the value of the browser.download.mimeTypes property

 


Log report Configuration

 

Property

Description

Valid values

Optional

log.mailreport.smtpserver.name

The SMTP server

String

NO

log.mailreport.smtpserver.port

The SMTP server port

Positive integer

NO

log.mailreport.addresses.from

The mail sender

Valid email address

NO

log.mailreport.addresses.to

TO recipients

Comma separated list of valid email addresses

NO

log.mailreport.addresses.cc

CC recipients

Comma separated list of valid email addresses

YES

log.mailreport.addresses.bcc

BCC recipients

Comma separated list of valid email addresses

YES

log.mailreport.testexplorer.webpath

Test Explorer instance name

The Test Explorer web application path, eg. TestExplorer or TestExplorer-3.4.0

YES

log.mailreport.testexplorer.webport

Test Explorer HTTP port

The Test Explorer port number. The default value is 80

YES

Runtime these settings are available by the ReportConfigurator :

Method

Action

getSmtpServerName ()

Returns value of the log.mailreport.smtpserver.name property

getSmtpServerPort ()

Returns the value of the log.mailreport.smtpserver.port property

getAddressFrom ()

Returns the value of the log.mailreport.addresses.from property

getAddressesTo ()

Returns the value of the log.mailreport.addresses.to property as a list of addresses

getAddressesCc ()

Returns the value of the log.mailreport.addresses.cc property as a list of addresses

getAddressesBcc ()

Returns the value of the log.mailreport.addresses.bcc property as a list of addresses

getTestExplorerWebPath ()

Returns the value of the log.mailreport.testexplorer.webpath property

getTestExplorerWebPort ()

Returns the value of the log.mailreport.testexplorer.webport property

 


Back to parent page

Go to Table of Contents