Object Model Reference for GUI Testing > Utility Objects > Connect Method

Remote Connection Object

Description

Enables you to manage UFT’s connection to a remote Mac computer, and to run the Apple Safari browser on that computer.

This enables UFT to test Web applications running on Safari. For details on testing Web applications on the Apple Safari browser, see the Web Add-in Quick Reference section of the HPE Unified Functional Testing Add-ins Guide.

Methods and Properties

Method Connect Connects UFT to the specified Mac computer.
Method Disconnect Disconnects UFT from the remote computer.
Run Runs an application on a remote computer.
IsConnected Checks whether UFT is connected to a remote computer.

Back to top

Connect Method

Description

Connects UFT to the specified Mac computer.

Syntax

RemoteConnection.ConnectHostname, [useSSL]

Argument

Type

Description

Hostname

String

The name or IP address of the Mac computer.

By default, the connection uses port 8822.

To use a different port, enter :<port number> after the name or address in this argument.

Make sure that the same port number is defined in the UFT port option in the UFT Connection Agent preferences on the Mac computer. For details, see the section on How to Install and Configure the UFT Connection Agent in the UFT Help.

useSSL Boolean

Optional. Specifies whether to connect to the Mac computer using an SSL connection. (Default: false)

If you specify true, make sure that:

  • The UFT Connection Agent settings on the Mac are also set to require an SSL connection.
  • SSL certificates and keys are defined in the Options dialog box in UFT(Tools > Options >GUI Testing > Remote Connection) and in the UFT Connection Agent preferences on the Mac. For details, see the section on Securing the Communication With the Remote Mac Computer in the UFT Help.

IMPORTANT


Back to top

Disconnect Method

Description

Disconnects UFT from the remote computer.

Syntax

RemoteConnection.Disconnect

IMPORTANT

This refers to a connection initiated by UFT to a Mac computer, and used to test Web applications running on the Apple Safari browser.

For details on testing Web applications on the Apple Safari browser, see the Web Add-in Quick Reference section of the HPE Unified Functional Testing Add-ins Guide.


Back to top

Run Method

Description

Runs an application on a remote computer. Currently, this method can be used only to run the Safari browser on a remote Mac computer.

Syntax

RemoteConnection.RunApplication, Parameters

Argument

Type

Description

Application

String

The name of the application to run. Currently only Safari is supported.

Parameters String Optional. The parameters for the application. For Safari,the URL to open in the browser.

IMPORTANT

This enables UFT to test Web applications running on Safari.

For details on testing Web applications on the Apple Safari browser, see the Web Add-in Quick Reference section of the HPE Unified Functional Testing Add-ins Guide.


Back to top

IsConnected Property

Description

Checks whether UFT is connected to a remote computer.

Syntax

RemoteConnection.IsConnected

IMPORTANT

This refers to a connection initiated by UFT to a Mac computer, and used to test Web applications running on the Apple Safari browser.

For details on testing Web applications on the Apple Safari browser, see the Web Add-in Quick Reference section of the HPE Unified Functional Testing Add-ins Guide.

Return Value

Boolean. True, if connected. Otherwise False.

Back to top

See also: