Table of Contents

Search

  1. Preface
  2. Introduction
  3. Dashboard
  4. Resources
  5. Workflows
  6. Task Reference
  7. Services Overview
  8. Users
  9. Logs and Reports
  10. Encryption
  11. System
  12. Appendix
  13. Glossary Terms

Get Method

Get Method

The Get Method element allows you to download files from an HTTP server.
Field
Definition
Basic Tab
Label
Specify a label for this action.
URI
Specify the URI (Uniform Resource Identifier), also known as URL (Uniform Resource Locator), e.g., '/data/orders.xls' or '/cgi-bin/upload.cgi'. If left blank, the default URI of the server is requested. e.g., www.domainname.com.
Advanced Tab
Follow Redirects
Specify whether or not to follow redirects. The default value is true. Default Value: Inherited from the task
Read Timeout
Specify the maximum amount of time, in seconds, to wait when waiting for a response from the server. A value of 0 (zero) is interpreted as infinite timeout. This defaults to the value specified on the HTTP task.
Validate Status Code
If true (default), the HTTP status code will be validated and any code not in the 200-299 range will cause the project to fail. If false, the HTTP status code will not be validated and will not cause the project to fail. This allows the response to be accessed later in the project.
NOTE: By definition the status codes 204 and 304 do not contain a message body and are therefore do not apply to this setting.
If Modified Since
Specify the value to send in the 'If-Modified-Since' header when making the request. The HTTP server will look at this header and sends the response body if and only if the requesting URI was modified after the specified date. The value must be a date and may include a time also. The value must be entered in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format.
Response Body Tab
Destination
Specify if and where the response body, if any, should be saved. By default, the response body will be saved to the job log.
File
Specify the location of the file to which the response body, if any, should be saved. This is required if the 'Response Body Destination' is set to 'file'.
When File Exists
Specify the action to take when the response file already exists. The default value is 'rename'.
Response Headers Tab
Destination
Specify if and where the response headers should be saved. By default, the response headers will be discarded.
File
Specify the location of the file to which the response headers should be saved. This is required if the 'Response Headers Destination' attribute is set to 'file'.
When File Exists
Specify the action to take when the response file already exists. The default value is 'rename'.
Output Variables Tab
Status Code Variable
If desired, specify the name of a variable which will contain the HTTP status code returned by the server. The variable may be used in subsequent tasks. The variable will be created if it does not exist.
Status Message Variable
If desired, specify the name of a variable which will contain the status message returned by HTTP server. The variable may be used in subsequent tasks. The variable will be created if it does not exist.
Response Body File Variable
If desired, specify the name of a variable which will contain the response body output file. The variable will be of type File and may be used in subsequent tasks that accept File or File List input variables. The variable will be created if it does not exist.
Response Headers File Variable
If desired, specify the name of a variable which will contain the headers file. The variable will be of type File and may be used in subsequent tasks that accept File or File List input variables. The variable will be created if it does not exist.

0 COMMENTS

We’d like to hear from you!