Connect to Network Action

Declaration

<AMDIALUP ACTION="connect_manual" NUMBER="text" USERNAME="text" PASSWORD="AM1Gu54aejKQaI=aME" REDIAL="3" REDIALTIME="30" />

See Also

Open Web Page,

Description

Establishes a connection to another network using a VPN (Virtual Private Network) or dial-up. This action can also be used to disconnect a specific VPN or dial-up connection or all currently established connections.

Note: This does not take on the redial properties that are specified in the phone book entry.

Practical Usage

Used to connect to the Internet with a modem or other network device if needed before executing Internet actions.

Parameters

General Tab

This action allows one of three alternatives to take place. The available options are:

Connections

Text, Optional
MARKUP: ENTRY="theConnection"

Allows the selection of an existing dial-up connection as specified in the Windows phonebook.

Use manual settings

Yes, No, - Default (No)
MARKUP: ACTION="connect_manual"

When set to YES, allows the manual entry of a dial-up number, user name and password in which to establish a connection with, bypassing the Windows phonebook. The connection will be established based on the information in the Phone Number, User name and Password fields.

Phone Number

Number, Optional - Default (none)
MARKUP: NUMBER="555-555-5555"

Specifies the phone number that should be dialed. This option is only valid when the Use manual settings is selected in conjunction with the Establish a connection parameter.

Username

Text, Optional - Default NONE
MARKUP: USERNAME="joe"

Specifies the username to use when logging on to the remote connection. This option is only valid when the Use manual settings is selected in conjunction with the Establish a connection parameter.

Password

Text, Optional - Default NONE
MARKUP: PASSWORD="joe"

Specifies the password to use when logging on to the remote connection. This option is only valid when the Use manual settings is selected in conjunction with the Establish a connection parameter. When adding this step using visual mode, the value is automatically encrypted and decrypted at runtime.

Action

Text [options], Optional - Default "connect_phone_book"
MARKUP: ACTION="connect_manual"

Specifies the action that should take place on the connection.

The available options are:

Redial Settings

When set to YES, allows redial settings to take place as specified under the Redial Attempts and Time Between Attempts parameters.

Redial Attempts

Number, Optional - Default 0
MARKUP: REDIAL="3"

If the connection does not succeed, specifies the amount of times that the connection should be re-dialed before an error is generated. This option is only valid if action is set to Establish a connection.

Time Between Attempts

Text, Optional - Default NONE
MARKUP: REDIALTIME="30"

Specifies the amount of time to wait for before attempting to redial the connection. The Wait Type [WAITTYPE] parameter specifies whether this value is referring to seconds or minutes. This option is only valid if action is set to Establish a connection.

Wait Type

Text [options], Optional - Default seconds
MARKUP: WAITTYPE="minutes"

Specifies whether the number specified in Time Between Attempts is in seconds or minutes. This option is only valid if action is set to Establish a connection.

The available options are:

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMDIALUP ENTRY="Connection1" REDIAL="3" REDIALTIME="30" />