OutboundSeparatedValue
The OutboundSeparatedValue handler can send separated values to a remote server using the HTTP protocol.
When the SEND command of this content handler is executed the following steps occur:
If the handler is being used with keyword METHOD(GET) then no working list argument is needed. It is also possible to POST without a working list argument.
The handler uses the value of the CONTENT keyword to determine the type of separated values to create:
- If no content value is available, the handler defaults to application/comma-separated-values
- If the content value is *CSV, then content type will be application/comma-separated-values
- If the content value is *TEXTCSV, then content type will be text/tab-comma-values
- If the content value is *TSV, then content type will be application/tab-separated-values
- If the content value is *TEXTTSV, then content type will be text/tab-separated-values
- If the content value is not a valid separated value content type then CSV data is created, but the specified content type is sent.
The optional SVHEAD keyword allows a header record to be inserted at the beginning of the data.
The handler creates Unicode data using all entries in the list, if there is no list argument then zero length content is created.
The handler determines if this Unicode data needs to be archived.
Syntax:
|
Command |
Keyword |
Value |
Developer notes for Command/Keyword/Value |
|
SEND |
HANDLER |
|
OutboundSeparatedValue |
|
URI |
value |
Mandatory. Remote URI. |
|
|
HOST |
value |
Mandatory. Remote server. |
|
|
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 |
*YES |
Optional. Default is 0. |
|
|
*NO |
Do not wait for HTTP response. |
||
|
value |
Wait read time in milliseconds. |
||
|
TIMEOUT |
value |
Optional. Default is 0 which means disabled. |
|
|
LOCALE |
|
Optional. See LOCALE. |
|
|
NUMBERFORMAT |
|
Optional. See NUMBERFORMAT. |
|
|
CONTENT |
|
Optional. See CONTENT. |
|
|
ENCODING |
|
Optional. See ENCODING. |
|
|
SVQUOTE |
|
Optional. See SVQUOTE. |
|
|
SVHEAD |
|
Optional. See SVHEAD. |
|
|
ARCHIVE |
|
Optional. See ARCHIVE. |
Example
SEND HANDLER(OutboundSeparatedValue) URI(/cgi-bin/program) HOST(…) SERVICE_LIST(…)
SEND HANDLER(OutboundSeparatedValue) URI(/cgi-bin/program) HOST(…)CONTENT(*TSV) SERVICE_LIST(…)
SEND HANDLER(OutboundSeparatedValue) URI(/cgi-bin/program) HOST(…)CONTENT(text/csv) SERVICE_LIST(…)