OutboundFile
The OutboundFile handler can send a file to a remote server using the HTTP protocol.
When the SEND command of this content handler is executed the following steps occur:
1. The handler uses the value of the CONTENT keyword to determine the content type, if no CONTENT keyword is present, then the file extension is used to determine the content type using the MIME file type map.
2. If an ENCODING keyword is present, then a charset attribute is determined and appended to the content type.
3. If the value of the METHOD keyword is GET, then no FILE keyword is required as the HTTP GET protocol is used to receive content from the remote HTTP server.
Syntax:
|
Command
|
Keyword
|
Value
|
Developer notes
|
|
SEND
|
HANDLER
|
OutboundFile
|
|
|
FILE
|
value
|
Conditional. File path.
|
|
URI
|
value
|
Required. Remote URI.
|
|
HOST
|
value
|
Required. Remote server.
|
|
SNISERVER
|
value
|
Optional. SNI host name used by TLS handshake. Use specified value or *HOST for the value of the HOST keyword value.
LANSA Integrator can only support SNI when the Java Virtual Machine (JVM) is at Java version 1.8 or higher.
|
|
USER
|
value
|
Optional. Basic authentication user.
|
|
PASSWORD
|
value
|
Optional. Basic authentication password.
|
|
PROXY
|
value
|
Optional. Proxy server.
|
|
PROXYUSER
|
value
|
Optional. Basic authentication user.
|
|
PROXYPASSWORD
|
value
|
Optional. Basic authentication password.
|
|
METHOD
|
|
Optional. See METHOD.
|
|
VERSION
|
|
Optional. See VERSION.
|
|
SECURE
|
*YES
|
Optional. Use HTTPS protocol.
|
|
*NO
|
Default. Use HTTP protocol.
|
|
WAIT
|
*NO
|
Optional. Do not wait for HTTP response.
|
|
*YES
|
Default is 0. Infinite wait for HTTP response.
|
|
value
|
Wait read time in milliseconds.
|
|
TIMEOUT
|
value
|
Optional. Default is 0 which means disabled.
Host connection timeout in milliseconds.
|
|
LOCALE
|
|
Optional. See LOCALE.
|
|
CONTENT
|
|
Optional. See CONTENT.
|
|
ENCODING
|
|
Optional. See ENCODING.
Used to determine charset attribute.
|
|
Example
SEND HANDLER(OutboundFile) HOST(…) FILE(/folder/file.csv) URI(/cgi-bin/program)
