OutboundNameValue

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. Used to encode field values.
	WAIT	*YES	Optional. Default. Infinite wait for HTTP response.
		*NO	Do not 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.
	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(…)