Basic Internet

CheckInternetConnection

Purpose:

Determine if this computer is connected to the Internet.

Category:

Internet

Syntax:

CheckInternetConnection "variable"

variable

The name of a variable to store connection status. If connected, the variable will be set to “True”, otherwise, it will be set to “False”.

Example:

CheckInternetConnection "[Connected]"
If "[Connected]" "=" "True"
  AlertBox "Result" "Connection found!"
Else
  AlertBox "Result" "Not connected."
EndIf


Note: You cannot rely solely on CheckInternetConnection to determine if you have a valid active Internet connection. It is impossible for CheckInternetConnection to determine if the entire connection to the Internet is functioning without sending a request to a server. This is why you may also need to send some type of simple request (see InternetGet) to determine if you are really connected or not.


ConnectToInternet

Purpose:

Open an Internet connection. (Requires proper hardware and a valid Internet account.)

Category:

Internet

Syntax:

ConnectToInternet "variable"

variable

The name of a variable to store connection status. If successful, the variable will be set to “True”, otherwise, it will be set to “False”.

Example:

ConnectToInternet "[Result]"


DisconnectFromInternet

Purpose:

Disconnect from the Internet. (This may not work for always-on broadband type connections.)

Category:

Internet

Syntax:

DisconnectFromInternet

Example:

DisconnectFromInternet



Internet Explorer

InternetLink

Purpose:

Launch the computer’s default Internet browser, and navigate to the specified web site URL. Requires a valid Internet account and browser software.

Category:

Internet

Syntax:

InternetLink "url address"

url address

The address of a web site or local file to pass to the browser.

Example:

InternetLink "http://www.visualneo.com"


This Action can also be used to launch the computer’s default email application. For example:


InternetLink "mailto:info@visualneo.com"



eMail

SendMail

Purpose:

Send an email message with an optional file attachments over the Internet. A valid Internet account and connection are required.

Category:

Internet

Syntax:

SendMail "to" "from" "subject" "message" "attachments"

to

The email address of the person who will receive the message. Multiple addresses can be separated with the pipe character “|”.

from

The address of the person sending the message. Some Internet services will not allow messages to be sent if the sender’s address does not match the account.

subject

The subject of the message.

message

The message text. Can be either plain text or HTML. Line breaks can be entered into the message body using the pipe character “|”.

attachments (optional)

The name of an external file to be attached to the message. Multiple files can be separated with the pipe character “|”.

options

Enter “HideProgress” if you do not want to give the user any feedback while sending email. Leave options blank to display a graph showing the email’s progress.

Example:

SendMail "info@visualneo.com" "xyz@hotmail.com" "Request for product information" "Dear SinLios,||Please send me some information about VisualNEO for Windows.||Thank you.||Sincerely,||John Q. Smith" "" ""


Note: The behavior of the SendMail Action can be modified by using the global [MailServer], [MailUserID] and [MailUserPassword] variables. See Understanding Actions and Variables for details.



HTTP

DownloadFile

Purpose:

Download a file from the Internet.

Category:

Internet

Syntax:

DownloadFile "source url" "destination" "options"

source url

The name and location of the file to download.

destination

The path and name where the downloaded file is to be saved.

options

One or both of the following:


HideProgress

By default a graph showing the download progress is displayed. Include "HideProgress" here if you do not want the graph to be visible.

Async

Allow VisualNEO for Windows to respond to other input during the download. Without this option, VisualNEO for Windows will not be able to accept user input until the download is complete.

Example:

DownloadFile "http://www.yoursite.com/sample.txt" "[PubDir]sample.txt" ""


Note: You can download files from a secure/password protected server by using the global [HTTPUserID] and [HTTPUserPassword] variables. See Understanding Actions and Variables for details.


InternetFileExists

Purpose:

Determine if a remote file exists on an Internet server.

Category:

Internet

Syntax:

InternetFileExists "source url" "variable" "options"

source url

The name and location of the remote file to download.

variable

The name of the variable to store the result of the search. If the file exists, the variable will be set to “True”, otherwise, it will be set to “False”.

options

Enter "Async" here to allow VisualNEO for Windows to respond to other input while waiting for the server to reply. Leave this parameter blank to suspend user input until the action is complete.

Example:

The example below displays an alert box if the file sample.txt exists:


InternetFileExists "www.yoursite.com/sample.txt" "[Result]" ""
If "[Result]" "=" "True"
  AlertBox "Status" "The file was found!"
EndIf


InternetFileSize

Purpose:

Obtain the size (in bytes) of a remote file located on an Internet server.

Category:

Internet

Syntax:

InternetFileSize "source url" "variable" "options"

source url

The name and location of the remote file to examine.

variable

The name of the variable to store the file’s size.

options

Enter "Async" here to allow VisualNEO for Windows to respond to other input while waiting for the server to reply. Leave this parameter blank to suspend user input until the action is complete.

Example:

InternetFileSize "www.yoursite.com/sample.txt" "[Size]" ""


InternetGet

Purpose:

Request information from an Internet server. Similar to DownloadFile except that the returned content will be stored in a variable. This should only be used for content that is compatible with VisualNEO for Windows variables.

Category:

Internet

Syntax:

InternetGet "source url" "variable" "options"

source url

The name and location of the file, content, etc. to download.

variable

The name of the variable to store the data returned from the server.

options

One or both of the following:


HideProgress

By default a graph showing the download progress is displayed. Include "HideProgress" here if you do not want the graph to be visible.

Async

Allow VisualNEO for Windows to respond to other input during the download. Without this option, VisualNEO for Windows will not be able to accept user input until the download is complete.

Example:

InternetGet "www.yoursite.com/index.html" "[Result]" "HideProgress+Async"


InternetPost

Purpose:

Send an HTTP command and data to an Internet server. The response from the server will be stored in the supplied variable.

Category:

Internet

Syntax:

InternetPost "url" "data" "variable" "options"

url

The url that will receive the post command.

data

Additional data (if any) to send to the server. The formatting requirements for this data is highly server and application specific.

variable

The name of the variable to store the server’s response.

options

Enter "Async" here to allow VisualNEO for Windows to respond to other input while waiting for the server to reply. Leave this parameter blank to suspend user input until the action is complete.

Example:

SetVar "[Host]" "http://www.yoursite.com/test.php"
SetVar "[Data]" "fname=Larry&lname=Morton"
InternetPost "[Host]" "[Data]" "[Result]" "Async"