OutboundNameValue
The OutboundNameValue handler can post name value pairs to a remote server using the HTTP protocol.
Refer to 5.1.6 Web Browser Content.
When the SEND command of this content handler is executed the following steps occur:
If an optional working list is available name value pair data is created. This working list must have at least two fields, which can be of any name and size. Importantly, the first field supplies the name and the second field supplies the value. The name and values are URL encoded.
If no working list is available then zero length content is created.
If the METHOD keyword is GET, then the HTTP GET protocol is used to access the remote host, if name value pair content exists then this is appended to the end of the URL with a '?' separating the URL and the data.
If the METHOD keyword is POST, then the HTTP POST protocol is used to access the remote host, if name value pair content exists then this is included as content.
Syntax:
|
Command |
Keyword |
Value |
Developer notes for Command/Keyword/Value |
|
SEND |
HANDLER |
|
OutboundNameValue |
|
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. |
||
|
ENCODING |
|
Optional. See ENCODING. |
|
|
WAIT |
*YES |
Optional. Default. |
|
|
*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. |
|
|
SPACE |
*PLUS |
Default. Encode spaces to + sign. |
|
|
*BLANK |
Encode spaces to blank. |
||
|
*PERCENT20 |
Encode spaces to %20. |
Example
SEND HANDLER(OutboundNameValue) URI(/cgi-bin/program) HOST(…) SERVICE_LIST(…)