RoyalWebConnection

RoyalWebConnection

Scripting > Reference > Object Properties >

Description

The RoyalWebConnection object represents a Web Page connection object in Royal TS/X.

 

Properties

Category

Name

Description

Type

Default Value

Is Secure

General

Name

The display name of the object.

string

Empty String

 

Description

The description text of the object.

string

Empty String

 

Favorite

Whether or not the object is a favorite.

bool

false

 

URI

The target URI for the connection object (computer name, URL, ...).

string

Empty String

 

Custom Fields

CustomField1

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField2

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField3

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField4

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField5

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField6

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField7

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField8

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField9

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField10

Custom fields allow you to collect additional information to the object.

string

Empty String

 

CustomField11

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField12

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField13

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField14

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField15

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField16

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField17

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField18

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField19

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

CustomField20

Custom fields allow you to collect additional information to the object. The content of this custom field will be stored encrypted in your document.

string

Empty String

Custom Properties

CustomProperties

Custom properties allow you to collect additional information for an object.

string

Empty String

Advanced

AutoFillDelay

Specify the delay in milliseconds before the auto fill is executed.

int

200

 

AutoFillMapping

Mapping configuration to automatically fill forms when connected (DEPRACTED)

string[]

new string[] { }

 

AutoRefresh

If set to true, the web page will be refreshed automatically. Requires the AutoRefreshIntervalInSeconds to be set.

bool

false

 

AutoRefreshIntervalInSeconds

The number of seconds the web page will be reloaded. Requires the AutoRefresh property set to true.

int

60

 

BrowserHeight

The height of the browser control. If height is 0, it will occupy the whole height of the parent area.

int

0

 

BrowserWidth

The width of the browser control. If width = 0, it will occupy the whole width of the parent area.

int

0

 

CookieStorageMode

0 = Use global cookie storage
1 = Use isolated cookie storage

int

0

 

CustomUserAgentString

The custom User Agent String for the browser.

string

Empty String

 

IgnoreCertificateErrors

If set to true, certificate errors are ignored.

bool

false

 

OpenLinksInBrowser

If set to true, all links will be opened in the default browser.

bool

false

 

OpenPopupsInBrowser

If set to true, all popups will be opened in the default browser.

bool

false

 

RetryAutoFillUntilSuccess

If set to true, auto fill is executed for each request until it was successful.

bool

false

 

ScriptErrorsSuppressed

If set to true, web browser dialog boxes (such as script error messages) are not displayed.

bool

false

 

ShowToolbar

If set to true, the web browser toolbar is shown.

bool

false

 

Timeout

The number of seconds after which a timeout occurs.

int

60

 

UseBasicAuth

If set to true, basic authentication is used to authenticate using the configured credential.

bool

false

 

WebKitEngineMode

0 = Legacy (WebView)
1 = Modern (WKWebView)

int

1

 

Changes

Created

The date and time the object was created.

DateTime

DateTime.Now

 

CreatedBy

The user who initially created the object.

string

Empty String

 

Modified

The last date and time the object was modified.

DateTime

DateTime.Now

 

ModifiedBy

The user who last modified the object.

string

Empty String

 

Connect Task

PreConnectTaskConditionAbort

If set to true, the connection will be closed when the task fails (exit code <> 0).

bool

false

 

PreConnectTaskConditionFirst

If set to true, the task will only be executed if it is the first connection in a folder to be connected.

bool

false

 

PreConnectTaskFromParent

Use the Connect Task values from the parent folder.

bool

false

 

PreConnectTaskId

Assign a task object to this object as connect task by specifying the task object's GUID.

Guid

Guid.Empty

 

PreConnectTaskMode

0 = Use connect task from parent folder
1 = Use an existing task
2 = Specify a task name.

int

1

 

PreConnectTaskName

Assign a task object to this object as connect task by specifying the task object's name.

string

Empty String

 

PreConnectTaskWait

If set to true, the connection will be started after the task finished.

bool

false

 

Content

UseCustomContent

If set to true, a custom content page will be loaded instead of the specified URL.

bool

false

 

Credentials

CredentialAutologon

Whether or not to automatically logon to the connection. Connections which do not support automatic logon will ignore this setting.

bool

true

 

CredentialFromParent

Use the Credential values from the parent folder.

bool

false

 

CredentialId

Assign a credential object to this object by specifying the credential object's GUID.

Guid

Guid.Empty

 

CredentialKeyContent

Assign a key file to the object by embedding the key file's content.

byte[]

new byte[] { }

 

CredentialKeyFile

Assign a key file to the object by specifying the key file's full path.

string

Empty String

 

CredentialKeyMode

0 = Path to file
1 = Embedded

int

0

 

CredentialMode

0 = Do not use any credentials
1 = Use credentials from the parent folder
2 = Specify username and password
3 = Use an existing credential
4 = Specify a credential name
5 = Use credential from context connection (only for Connection Templates)

int

0

 

CredentialName

Assign a credential object to this object by specifying the credential object's name.

string

Empty String

 

CredentialOmitDomain

Whether or not to omit the domain portion of the username.

bool

false

 

CredentialPassphrase

Assign a key file passphrase to the object.

string

Empty String

CredentialPassword

Assign a password to the object.

string

Empty String

CredentialUsername

Assign a username to the object.

string

Empty String

 

Custom Fields

CustomField10FromParent

Use the CustomField10 value from the parent folder.

bool

false

 

CustomField11FromParent

Use the CustomField11 value from the parent folder.

bool

false

 

CustomField12FromParent

Use the CustomField12 value from the parent folder.

bool

false

 

CustomField13FromParent

Use the CustomField13 value from the parent folder.

bool

false

 

CustomField14FromParent

Use the CustomField14 value from the parent folder.

bool

false

 

CustomField15FromParent

Use the CustomField15 value from the parent folder.

bool

false

 

CustomField16FromParent

Use the CustomField16 value from the parent folder.

bool

false

 

CustomField17FromParent

Use the CustomField17 value from the parent folder.

bool

false

 

CustomField18FromParent

Use the CustomField18 value from the parent folder.

bool

false

 

CustomField19FromParent

Use the CustomField19 value from the parent folder.

bool

false

 

CustomField1FromParent

Use the CustomField1 value from the parent folder.

bool

false

 

CustomField20FromParent

Use the CustomField20 value from the parent folder.

bool

false

 

CustomField2FromParent

Use the CustomField2 value from the parent folder.

bool

false

 

CustomField3FromParent

Use the CustomField3 value from the parent folder.

bool

false

 

CustomField4FromParent

Use the CustomField4 value from the parent folder.

bool

false

 

CustomField5FromParent

Use the CustomField5 value from the parent folder.

bool

false

 

CustomField6FromParent

Use the CustomField6 value from the parent folder.

bool

false

 

CustomField7FromParent

Use the CustomField7 value from the parent folder.

bool

false

 

CustomField8FromParent

Use the CustomField8 value from the parent folder.

bool

false

 

CustomField9FromParent

Use the CustomField9 value from the parent folder.

bool

false

 

Custom Properties

CustomPropertiesFromParent

Use the Custom Properties from the parent folder.

bool

false

 

Dashboard

DashboardShowPage

If set to true, the dashboard will load the web page of the configured URL.

bool

true

 

DashboardUseAppSettings

If set to true, the plugin default settings for the dashboard are used.

bool

true

 

Disconnect Task

PostDisconnectTaskConditionLast

If set to true, the task will only be executed if it is the last active connection in a folder.

bool

false

 

PostDisconnectTaskFromParent

Use the Disconnect Task values from the parent folder.

bool

false

 

PostDisconnectTaskId

Assign a task object to this object as disconnect task by specifying the task object's GUID.

Guid

Guid.Empty

 

PostDisconnectTaskMode

0 = Use disconnect task from parent folder
1 = Use an existing task
2 = Specify a task name.

int

1

 

PostDisconnectTaskName

Assign a task object to this object as disconnect task by specifying the task object's name.

string

Empty String

 

PostDisconnectTaskWait

If set to true, the connection will be closed after the task finished.

bool

false

 

Engine

AdditionalPluginDirs

Specify additional plugin directories (in each line) to search for additional plugins.

string[]

new string[] { }

 

AllowClipboardAccess

If enabled, the Clipboard can be accessed using JavaScript.

bool

true

 

AllowCloseWindow

If enabled, a new Window can be closed using JavaScript.

bool

true

 

AllowJavaScript

If enabled, JavaScript is allowed in the browser.

bool

true

 

AllowOpenWindow

If enabled, a new Window can be created using JavaScript.

bool

true

 

AllowPlugins

If enabled, plugins can be loaded.

bool

true

 

AllowZooming

If enabled, the zoom factor can be changed in the browser.

bool

true

 

CachePath

Specify a custom path to cache browser files and cookies.

string

 

 

CustomCSS

Specify one or more style rules which should be applied to the document.

string

 

 

DisableBuiltInPlugins

If enabled, built-in plugins (such as the built-in PDF plugin) will be disabled.

bool

false

 

DisableGPU

Disables the GPU when the browser renders a page.

bool

false

 

DisableSpellChecker

Disables the browser built-in spell checker.

bool

false

 

DisableWebSecurity

Disables same-origin policy enforcement.

bool

false

 

DisableXSSAuditor

Disables same-origin policy enforcement.

bool

false

 

LoadImages

If enabled, images are automatically loaded.

bool

true

 

PreventCrossSiteTracking

Prevents cross-site tracking.

bool

true

 

ProxyBypass

The proxy bypass host list.

string

Empty String

ProxyCredentialID

Assign a credential object as proxy server credential by specifying the credential object's GUID.

Guid

Guid.Empty

 

ProxyCredentialMode

0 = Do not use a credential
1 = Use from this connection
2 = Specify username and password
3 = Use an existing credential
4 = Specify a credential name

int

0

 

ProxyCredentialName

Assign a credential object as proxy server credential by specifying the credential object's name.

string

Empty String

 

ProxyDirectMode

Ignores the proxy settings of system.

bool

false

 

ProxyHostname

Specifies the host name of the proxy server.

string

Empty String

 

ProxyMode

0 = Do not use a proxy server
1 = HTTP
2 = Socks4
3 = Socks4A
4 = Socks5
5 = Use Secure Gateway as Proxy

int

0

 

ProxyPassword

The password for the proxy server.

string

Empty String

ProxyPort

Specifies the proxy port to be used.

int

8080

 

ProxyUserName

The username for the proxy server.

string

Empty String

 

ScanCommonPlugins

If enabled, commonly used plugins (QuickTime, Media Player, Acrobat, etc.) will be searched on the system and loaded.

bool

true

 

UseDedicatedEngine

If enabled, a new web browser engine will be created for isolation.

bool

false

 

General

Color

Assign a custom color as hex string to the object (#FF0000 for red). Empty string is the default color value (no custom color assigned).

string

Empty String

 

ColorFromParent

Use the Color value from the parent folder.

bool

false

 

ExternalID

The external unique object identifier (GUID) of the object.

string

Empty String

 

ID

The unique object identifier (GUID) of the object.

Guid

Guid.Empty

 

IsConnectionTemplate

If set to true, the connection object is a template.

bool

false

 

Key Sequence

KeySequence

The key sequence to be executed after the connection was successfully established.

string

Empty String

 

KeySequenceEnabled

If set to true, the configured key sequence will be executed after the connection was successfully established.

bool

false

 

KeySequenceFromParent

Use the Key Sequence values from the parent folder.

bool

false

 

KeySequenceId

Assign a key sequence task object to this connection by specifying the task object's GUID.

Guid

Guid.Empty

 

KeySequenceMode

0 = Specify a key sequence
1 = An existing key sequence task is assigned using the task's GUID
2 = Specify a key sequence task by name
3 = Use key sequence from parent.

int

0

 

KeySequenceName

Assign a key sequence task object to this object by specifying the key sequence task object's name.

string

Empty String

 

Notes

NotesFromParent

Use the Notes value from the parent folder.

bool

false

 

Plugin for macOS

PlugInOSX

The plug in ID used for this connection for macOS.

string

Empty String

 

UseGlobalPlugInOSX

If set to true, the connection will use the application default plug in for the connection type on macOS.

bool

true

 

Plugin for Windows

PlugInWin

The plug in ID used for this connection for Windows.

string

Empty String

 

UseGlobalPlugInWin

If set to true, the connection will use the application default plug in for the connection type on Windows.

bool

true

 

Remote Desktop Gateway

RDSGatewayFromParent

Use the Remote Desktop Gateway values from the parent folder.

bool

false

 

RDSGatewayID

Assign a Remote Desktop Gateway object to this object by specifying the Remote Desktop Gateway object's GUID.

Guid

Guid.Empty

 

RDSGatewayName

Assign a Remote Desktop Gateway object to this object by specifying the Remote Desktop Gateway object's name.

string

Empty String

 

RDSGatewayUsageMode

0 = Never
1 = Always
2 = On Demand

int

0

 

Royal Server

ManagementEndpointFromParent

Use the Royal Server values from the parent folder.

bool

false

 

ManagementEndpointID

Assign a Royal Server object to this object by specifying the Royal Server object's GUID.

Guid

Guid.Empty

 

ManagementEndpointName

Assign a Royal Server object to this object by specifying the Royal Server object's name.

string

Empty String

 

Secure Gateway

SecureGatewayFromParent

Use the Secure Gateway values from the parent folder.

bool

false

 

SecureGatewayID

Assign a Secure Gateway or Royal Server object to this object by specifying the Secure Gateway or Royal Server object's GUID.

Guid

Guid.Empty

 

SecureGatewayName

Assign a Secure Gateway or Royal Server object to this object by specifying the secure gateway or Royal Server object's name.

string

Empty String

 

SecureGatewayUsageMode

0 = Never
1 = Always

int

0

 

Window Mode

DisplayMode

0 = Embedded (Tabbed)
1 = External Window
2 = Full Screen (where supported).

int

0

 

ExternalHeight

Specifies the last known height of the external window.

int

0

 

ExternalLeft

Specifies the last known position (left) of the external window.

int

0

 

ExternalPositionMode

0 = Remember position
1 = Custom left and right coordinates

int

0

 

ExternalScreen

Specifies on which Screen the External Window will be shown (Windows).

int

0

 

ExternalScreenMode

0 = Remember Screen
Any other number indicates the display number.

int

0

 

ExternalScreenOSX

Specifies on which Screen the External Window will be shown (macOS).

int

0

 

ExternalSizeMode

0 = Remember Size
1 = Custom width and height
2 = Maximize

int

0

 

ExternalTop

Specifies the last known position (top) of the external window.

int

0

 

ExternalWidth

Specifies the last known width of the external window.

int

0

 

FixedSize

Specifies whether or not the control or form should be expanded automatically to fill the container or maximized form

bool

false

 

MinimizeMainWindow

If set to true, the main window will be minimized after the connection was established.

bool

false