Internet
Basic Internet
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]" |
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.
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]" |
Purpose: |
Disconnect from the Internet. (This may not work for always-on broadband type connections.) |
Category: |
Internet |
Syntax: |
DisconnectFromInternet |
Example: |
DisconnectFromInternet |
Internet Explorer
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" |
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 Win.||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
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:
|
||||
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.
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 Win 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]" "" |
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 Win 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]" "" |
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 Win 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:
|
||||
Example: |
InternetGet "www.yoursite.com/index.html" "[Result]" "HideProgress+Async" |
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 Win 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" |