Connect to Network

Declaration

<AMDIALUP ACTION="connect_manual" NUMBER="number" USERNAME="text" PASSWORD="encrypyed text" REDIAL="number" REDIALTIME="number" WAITTYPE="text (options)"/>

See Also

Exchange, Execute Web Service, Get Email, HTTP Get, HTTP Post/Put, Map Drive, MSMQ, Open Web Page, Send E-mail, Send IM, Twitter

Description

Establishes a connection to another network using a VPN (Virtual Private Network) or dial-up connection. This action can also be used to disconnect a specific VPN or dial-up connection or all presently 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 Properties

Property

Type

Required

Default

Markup

Description

Connections

Text

Yes

(Empty)

ENTRY="theConnection"

Allows the selection of an existing phone book entry created during Dial-Up Networking (DUN) configuration. To select an existing entry, click the Down arrow or manually enter the name in the provided text box.

Action

Text (options)

Yes

(Empty)

ACTION="disconnect_all"

Specifies the action that should take place. The available options are:

  • Establish a connection - Establish a dial-up or VPN connection.

  • Disconnect a specific connection - Disconnects the phone book connection specified in the Connections parameter if it is active.

  • Disconnect all connections: Disconnects all active connections.

Use manual settings

Yes/No

No

No

ACTION="connect_manual"

If set to YES, allows manual entry of a dial-up number, user name and password in which to establish a connection with, bypassing the Windows phone book. The connection will be established based on the information entered in the Phone Number, User name and Password parameters. This parameter is valid only if the Action parameter is set to Establish a connection.

Phone number

Number

No

(Empty)

a)NUMBER="555-867-5309"

b)NUMBER="7145551212"

The phone number that should be used to establish a DUN connection. This option is valid only if the Usparameter is selected in conjunction with the Establish a connection parameter.e manual settings

User name

Text

No

(Empty)

USERNAME="joe"

The user name to use when establishing a remote connection. This option is valid only if the Use manual settings parameter is selected in conjunction with the Establish a connection parameter.

Password

Text

No

(Empty)

PASSWORD="encrypted"

The password to use when establishing a remote connection. This option is valid only if the Use manual settings parameter is selected in conjunction with the Establish a connection parameter.

Redial Settings

 

 

 

 

If enabled, allows redial settings to take place as specified via the Redial Attempts and Time Between Attempts parameters.

Redial Attempts

Number

No

(Empty)

REDIAL="3"

Specifies the amount of times that the connection should be re-dialed before an error is generated. This option is valid only if the Action parameter is set to Establish a connection.

Time Between Attempts

Text

No

0

REDIALTIME="30"

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

Wait Type

Text (options)

No

Seconds

WAITTYPE="minutes"

Specifies whether the number entered in Time Between Attempts parameter is in seconds or minutes.  This option is valid only if the Action parameter is set to Establish a connection. The available options are:

  • Second (default) - The wait time specified is in seconds.

  • Minutes - The wait time specified is in minutes.

↑ Top of Page

 

Description Properties

The Description tab allows you to customize the text description of any step as it appears in the Task Builder's Steps Pane.

More on setting custom step description

Error Causes Properties

The Error Causes tab properties allows you to instruct a task step to react only to specific errors or ignore certain errors that should cause it to fail.

More on Error Causes properties

On Error Properties

The On Error tab properties lets you determine what the task should do if a particular step encounters an error as defined in the Error Causes properties.

More about On Error properties

Additional Notes

Expressions, Variables and Functions

All text fields allow the use of expressions such as variables, functions or AutoMate extended functions, which can be entered by surrounding the expression in percentage signs (example: %FileDateTime(myVar)% or %myVar%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by clicking the Insert Expression (%) button or by pressing F2.

More on expressions

More on variables

More on function

More on extended functions
More on the expression builder

Example

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

 

Sample 1 - Establish a dialup connection using manual settings. Attempt to redial a total of 5 times. Pause 1 minute in between attempts.  

 

<AMDIALUP ACTION="connect_manual" NUMBER="555-867-5309" USERNAME="theUserName" PASSWORD="AM1TLax4GRtZO1qWN7qDphOEw==aME" REDIAL="5" REDIALTIME="1" WAITTYPE="minutes" />

 

 

Sample 2 - Disconnect a previously established dialup connection named "myDialupConnection."

 

<AMDIALUP ACTION="disconnect_phone_book" ENTRY="myDialupConnection" REDIAL="5" REDIALTIME="1" />

 

↑ Top of Page