MCConnection Object

Determines property values for connecting to Mobile Center / UFT Mobile from UFT One or to a local mobile device.

For more details, see Connect to UFT Mobile or local mobile devices.

Version support

The following table described the version-specific information related to this object:

FeatureSupported in UFT One versions
The MCConnection object14.51 and later
Proxy definitions14.52 and later
Local device configuration options14.53 and later
Connect to Mobile Center / UFT Mobile using access keys14.53 patch 1 and later

Rebrand Mobile Center to UFT Mobile

In the rest of this topic, references to UFT Mobile can be substituted with Mobile Center if you are working with an earlier version of UFT One and with Mobile Center.

15.0 and later

 

IMPORTANT

Changes made to the MCConnection properties take effect only in the next test run.

Therefore, if you use the Automation Object Model to change these properties during a UFT One test, subsequent mobile steps may behave unexpectedly.

Workaround:

Change the MCConnection properties in an external script that runs UFT One tests and not inside of a UFT One test.

Alternatively, if you run a test that changes the MCConnection properties, run the test again to use the new connection settings.

Back to top

Public Properties

Public Property AccessKeyThe access key used to connect to UFT Mobile.
Public Property AuthTypeIndicates whether to use access keys or user name and password for authentication when connecting to UFT Mobile.
Public Property LocalPortThe port used to connect to local devices.
Public Property PasswordThe password used to connect to UFT Mobile.
Public Property PortThe port for the UFT Mobile server you want to connect to.
Public Property ProxyAddress

The proxy server address that is used to connect to UFT Mobile.

Public Property ProxyPort

The proxy server port that is used to connect to UFT Mobile.

Public Property ProxyType

Determines the proxy type that is used to connect to UFT Mobile.

Public Property ProxyUserName

The proxy username that is used to connect to UFT Mobile.

Public Property ProxyPassword

The proxy password that is used to connect to UFT Mobile.

Public Property Server

The UFT Mobile server you want to connect to.

Public Property SharedSpaceDetermines the UFT Mobile shared space to connect to.
Public Property ShowRemoteWndOnRunIndicates whether the remote access window is displayed during the test run.
Public Property SpecifyAuthentication

Indicates whether proxy authentication is used for connecting to UFT Mobile.

Public Property TypeIndicates whether to connect to UFT Mobile or local devices.
Public Property UseProxySettings

Indicates whether a proxy is used for connecting to UFT Mobile.

In UFT 14.52, the property name is UsePorxySettings.

Public Property UsernameThe username used to connect to UFT Mobile.
Public Property UseSSLIndicates whether SSL is used when connecting to UFT Mobile.
Public Property WorkSpaceThe UFT Mobile workspace to connect to.

Back to top

AccessKey property

Supported in UFT One versions 14.53 patch 1 and later.

The access key used to connect to UFT Mobile.

Generate your access keys in the UFT Mobile Lab, as described in the UFT Mobile Help Center.

Read-write property.

Syntax

Public Property AccessKey As String

Back to top

AuthType property

Supported in UFT One versions 14.53 patch 1 and later.

Indicates whether to use access keys or user name and password for authentication when connecting to UFT Mobile.

Read-write property.

Possible string values: 

  • "Username Password" (default)

  • "Access Key"

Syntax

Public Property AuthType As String

Back to top

LocalPort property

Supported in UFT versions 14.53 and later.

The port used to connect to local devices.

Read-write property.

Syntax

Public Property LocalPort As String

Back to top

Password property

The password used to connect to UFT Mobile.

Read-write property.

Syntax

Public Property Password As String

Back to top

Port property

The port for the UFT Mobile server you want to connect to.

Read-write property.

Syntax

Public Property Port As String

Back to top

ProxyAddress property

Supported in UFT versions 14.52 and later.

The proxy server address that is used to connect to UFT Mobile.

Read-write property.

Syntax

Public Property ProxyAddress As String

Back to top

ProxyPort property

Supported in UFT versions 14.52 and later.

The proxy server port that is used to connect to UFT Mobile.

Read-write property.

Syntax

Public Property ProxyPort As String

Back to top

ProxyType property

Supported in UFT versions 14.52 and later.

The proxy type that is used to connect to UFT Mobile.

Read-write property.

Syntax

Public Property ProxyType As String

Back to top

ProxyUserName property

Supported in UFT versions 14.52 and later.

The proxy username that is used to connect to UFT Mobile.

Read-write property.

Syntax

Public Property ProxyUserName As String

Back to top

ProxyPassword property

Supported in UFT versions 14.52 and later.

The proxy password that is used to connect to UFT Mobile.

Read-write property.

Syntax

Public Property ProxyPassword As String

Back to top

Server property

The UFT Mobile server you want to connect to.

Read-write property.

Syntax

Public Property Server As String

Back to top

SharedSpace Property

The UFT Mobile shared space that you want to connect to.

This option is not relevant when using access keys to authenticate the connection to UFT Mobile.

Read-write property.

Syntax

Public Property SharedSpace As String

Back to top

ShowRemoteWndOnRun Property

Indicates whether the remote access window is displayed during mobile test runs.

Read-write property.

Syntax

Public Property ShowRemoteWndOnRun As Bool

Back to top

SpecifyAuthentication property

Supported in UFT versions 14.52 and later.

Indicates whether proxy authentication is used for connecting to UFT Mobile.

Read-write property.

Syntax

Public Property SpecifyAuthentication As Bool

Back to top

Type property

Supported in UFT versions 14.53 and later.

Indicates whether to connect to UFT Mobile or local devices.

Possible string values: 

"0" - Connect to UFT Mobile (Default).

"1" - Connect to local mobile devices.

Read-write property.

Syntax

Public Property Type As String

Back to top

UseProxySettings property

Supported in UFT versions 14.52 and later.

Indicates whether a proxy is used for connecting to UFT Mobile.

Note: In UFT 14.52, the property name is UsePorxySettings.

Read-write property.

Syntax

Public Property UseProxySettings As Bool

Back to top

Username property

The username used to connect to UFT Mobile.

Read-write property.

Syntax

Public Property Username As String

Back to top

UseSSL property

Determines whether SSL is used when connecting to UFT Mobile.

Read-write property.

Syntax

Public Property WorkSpace As Bool

Back to top

WorkSpace Property

The UFT Mobile workspace that you want to connect to.

Read-write property.

Note: When using access keys to connect to UFT Mobile, you cannot select a shared workspace as the access key string includes a specific tenant ID.

Syntax

Public Property WorkSpace As String

Back to top

MCConnectionOptions object examples

Back to top