The Task type HTTP enables execution a remote script/load webpage with standard HTTP POST or HTTP GET. You can combine this function with logging the output of the script/page on a file or send the output by mail.

 

HTTP > Main settings tab

 

Endpoint/URL

This is the remote script or page to be called. Use the following format: http://www.yourwebpage.com/yourscript.php. If you use a GET you can either add parameters like ?mykey1=myvalue1&mykey2=myvalue2 or use the Parameters/Body tab to input parameters. If you use POST you should only use the Parameters/Body tab.

 

Proxy..

Select if you want to use a proxy.

 

Method

There are two kinds of methods which are most common when calling a remote script or page. Some web frameworks (such as PHP) provide separate mechanisms for accessing POST and GET data. POST is generally recommended because URL:s don't appear in web logs.

 

Version

Select which HTTP version to use. Default 1.1.

 

UserAgent

Optional. If your script requires a certain UserAgent you can use this field to let VisualCron pretend to be a certain UserAgent.

 

Timeout in seconds

This is the timeout of the web request. Default is 600 seconds.

 

KeepAlive

Set this property to true to send a Connection HTTP header with the value Keep-alive. An application uses KeepAlive to indicate a preference for persistent connections. When the KeepAlive property is true, the application makes persistent connections to the servers that support them.

 

When using HTTP/1.1, Keep-Alive is on by default. Setting KeepAlive to false may result in sending a Connection: Close header to the server.

 

AllowAutoRedirect

Set AllowAutoRedirect to true if you want the request to automatically follow HTTP redirection headers to the new location of the resource.

 

Expect 100 Continue

Enable this if you get HTTP error 417.

 

HTTP > Headers tab

 

Content-type header

This header controls the content type of the HTTP request. In the drop down most common headers can be found. This setting is also related to the Parameters/Body tab as it affects the way the body is posted.

 

Other headers

Custom headers can also be added by pressing Add button.

 

HTTP > Parameters/Body tab

 

Parameters/body

Depending on content-type header you can POST various content in the body. By selecting a tab you choose how the body is sent - please note that you need to set a matching content-header as well. Different body options;

 

x-www-form-urlencoded - use this for simple key/value pairs

form-data - use this if form-data content-type header required and if you want to POST multi-part data like files (and maybe text).

raw - use this for sending body text raw - for example when sending a Json request

binary - use this for sending a stream of binary data like one file

 

HTTP > Security tab

 

Supported security protocols

Set the supported security protocols (by your web server) to use the maximum security.

 

Credentials

Optional. If your script requires authentication you can select a credential from the combo box. By clicking on Manage credentials you can add or edit current credentials.

 

Auth type

What kind of authentication method that is used. No authentication method is used if no Credential is selected. By default NTLM auth type is used.

 

HTTP > Save content/response tab

 

Save content

Normally, the content from the request is stored in the HTTP output. For example, if you script returns a text it can be found the Result of the HTTP Task. It is stored in text mode. If you want to use the binary output, for example if you want to download a file, you should check Save content.

 

Credentials

Optional. If you want to save the content in a folder which requires network credentials then select a valid credential for that folder. By clicking on Manage credentials you can add or edit current credentials.

 

Folder path

Specify a path where you want to save the content/file.

 

Auto name file

Optional. If this box is checked your file will be named after the the last part of the url.

 

File name

The name of the file to be saved.

 

Exist options

Select how VisualCron should handle existing files. Append, overwrite, overwrite if newer or skip the saving.

 

Notes about Troubleshooting:

Error "The requested security protocol is not supported."

Try unchecking protocols in Supported security protocols. Start with disabling TLS1.1 and TLS1.2.