Remote Connection Object

Description

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

This enables OpenText Functional Testing 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 OpenText Functional Testing Help Center.

Methods and Properties

Method ConnectConnects OpenText Functional Testing to the specified Mac computer.
Method DisconnectDisconnects OpenText Functional Testing from the remote computer.
RunRuns an application on a remote computer.
IsConnectedChecks whether OpenText Functional Testing is connected to a remote computer.

Back to top

Connect Method

Description

Connects OpenText Functional Testing 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 OpenText Functional Testing port option in the OpenText Functional Testing Connection Agent preferences on the Mac computer. For details, see the section on How to Install and Configure the OpenText Functional Testing Connection Agent in the OpenText Functional Testing Help.

useSSLBoolean

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

If you specify true, make sure that:

  • The OpenText Functional Testing 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 OpenText Functional Testing(Tools > Options >GUI Testing > Remote Connection) and in the OpenText Functional Testing Connection Agent preferences on the Mac. For details, see the section on Securing the Communication With the Remote Mac Computer in the OpenText Functional Testing Help.

IMPORTANT

  • OpenText Functional Testing can use this connection only to test Web applications on the Apple Safari Browser.

  • The connection remains until it is disconnected in one of the following ways:

    • You call the Disconnect Method in the test or component.

    • You use the Disconnect button in the Remote Connection dialog box in OpenText Functional Testing.

    • The When run session ends: Disconnect option in the Record and Run Settings dialog box is selected.

  • While one connection exists, you cannot create another, except in one case:
    If the existing connection did not use SSL, and OpenText Functional Testing initiates an SSL-connection (based on the Record and Run settings), the existing connection is closed, and a new connection is initiated.

    For details on how OpenText Functional Testing handles connection attempts when a previous connection exists, see the section on Working With Apple Safari on a Remote Mac Computer in the OpenText Functional Testing Help.

The following example connects OpenText Functional Testing to a Mac without SSL, using a non-default port (after making sure to clear any previous connections).

It then opens the Safari browser, logs in to the Newtours site, confirms a flight order, and closes the connection to the Mac.

Example: If RemoteConnection.IsConnected Then
   RemoteConnection.Disconnect
End If


RemoteConnection.Connect "33.58.166.132:4567"
RemoteConnection.Run "safari", "https://advantageonlineshopping.com/#/"

Browser("Advantage Shopping").Page("Advantage Shopping").Link("UserMenu").Click
Browser("Advantage Shopping").Page("Advantage Shopping").WebEdit("username").Set "tutorial"
Browser("Advantage Shopping").Page("Advantage Shopping").WebEdit("password").SetSecure "5fa0c7324efd369ed5a1cb015311eb47"
Browser("Advantage Shopping").Page("Advantage Shopping").WebButton("sign_in_btnundefined").Click

RemoteConnection.Disconnect

Back to top

Disconnect Method

Description

Disconnects OpenText Functional Testing from the remote computer.

Syntax

RemoteConnection.Disconnect

IMPORTANT

This refers to a connection initiated by OpenText Functional Testing 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 OpenText Functional Testing Help Center.

The following example connects OpenText Functional Testing to a Mac without SSL, using a non-default port (after making sure to clear any previous connections).

It then opens the Safari browser, logs in to the Newtours site, confirms a flight order, and closes the connection to the Mac.

Example: If RemoteConnection.IsConnected Then
   RemoteConnection.Disconnect
End If


RemoteConnection.Connect "33.58.166.132:4567"
RemoteConnection.Run "safari", "https://advantageonlineshopping.com/#/"

Browser("Advantage Shopping").Page("Advantage Shopping").Link("UserMenu").Click
Browser("Advantage Shopping").Page("Advantage Shopping").WebEdit("username").Set "tutorial"
Browser("Advantage Shopping").Page("Advantage Shopping").WebEdit("password").SetSecure "5fa0c7324efd369ed5a1cb015311eb47"
Browser("Advantage Shopping").Page("Advantage Shopping").WebButton("sign_in_btnundefined").Click

RemoteConnection.Disconnect

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.

ParametersStringOptional. The parameters for the application. For Safari,the URL to open in the browser.

IMPORTANT

This enables OpenText Functional Testing 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 OpenText Functional Testing Help Center.

The following example connects OpenText Functional Testing to a Mac without SSL, using a non-default port (after making sure to clear any previous connections).

It then opens the Safari browser, logs in to the Newtours site, confirms a flight order, and closes the connection to the Mac.

Example: If RemoteConnection.IsConnected Then
   RemoteConnection.Disconnect
End If


RemoteConnection.Connect "33.58.166.132:4567"
RemoteConnection.Run "safari", "https://advantageonlineshopping.com/#/"

Browser("Advantage Shopping").Page("Advantage Shopping").Link("UserMenu").Click
Browser("Advantage Shopping").Page("Advantage Shopping").WebEdit("username").Set "tutorial"
Browser("Advantage Shopping").Page("Advantage Shopping").WebEdit("password").SetSecure "5fa0c7324efd369ed5a1cb015311eb47"
Browser("Advantage Shopping").Page("Advantage Shopping").WebButton("sign_in_btnundefined").Click

RemoteConnection.Disconnect

Back to top

IsConnected Property

Description

Checks whether OpenText Functional Testing is connected to a remote computer.

Syntax

RemoteConnection.IsConnected

IMPORTANT

This refers to a connection initiated by OpenText Functional Testing 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 OpenText Functional Testing Help Center.

Return Value

Boolean. True, if connected. Otherwise False.

The following example connects OpenText Functional Testing to a Mac without SSL, using a non-default port (after making sure to clear any previous connections).

It then opens the Safari browser, logs in to the Newtours site, confirms a flight order, and closes the connection to the Mac.

Example: If RemoteConnection.IsConnected Then
   RemoteConnection.Disconnect
End If


RemoteConnection.Connect "33.58.166.132:4567"
RemoteConnection.Run "safari", "https://advantageonlineshopping.com/#/"

Browser("Advantage Shopping").Page("Advantage Shopping").Link("UserMenu").Click
Browser("Advantage Shopping").Page("Advantage Shopping").WebEdit("username").Set "tutorial"
Browser("Advantage Shopping").Page("Advantage Shopping").WebEdit("password").SetSecure "5fa0c7324efd369ed5a1cb015311eb47"
Browser("Advantage Shopping").Page("Advantage Shopping").WebButton("sign_in_btnundefined").Click

RemoteConnection.Disconnect

See also: