Automation Guide Action-based testing language The test language Functions String functions

 getsetting

getsetting

Retrieve the current value of a built-in or a user-defined setting.

Syntax

getsetting(string name, string type, string default)

Parameters

• name

  Name of an existing built-in setting or a user-defined setting.

• type

  Type of this setting.

  Allowable values:

  • built-in
  • user defined

• default

  Default value to be returned when this setting was not assigned a value.

Return Value

The value of the setting specified in name.

Notes

• default parameter: If the specified setting already has a value, this parameter has no effect. While a value is optional, you must at least specify an empty string. For example: #getsetting(“language”, “user defined”, “”)
• Alternatively, you can use get setting built-in action to achieve the same functionality.

Example

Suppose that you have a user-defined setting named language defined in the Execute Test dialog box (learn more). The language setting is used to navigate to the appropriate web site. And its default value is English.

While you are developing test procedures, you can use the getsetting function to obtain the current value of the language setting to determine which regional site to navigated to.

Test Lines

Related concepts

Startup settings