OutboundXML
The OutboundXML handler can post XML to a remote server using the HTTP protocol.
The handler using the XSL keyword transforms the program fields and list into the resultant XML. If a FRAGMENT keyword is present this transformation is stored, as this is only a fragment of the final XML to be sent. When no FRAGMENT keyword is present this transformation is treated as the last and the final output XML is constructed and ready to be sent.
No XSL keyword is needed if the METHOD(GET) keyword is used.
When the SEND command of this content handler is executed the following steps occur:
If content is being posted, then the handler determines if this Unicode data needs to be archived.
The handler uses the value of the CONTENT keyword to determine the value of the HTTP protocol content-type.
- If no content value is available, the handler defaults to application/xml
- If the content value is *XML, then content type will be application/xml
- If the content value is *TEXTXML, then content type will be text/xml
The service property outbound.xml.default.contenttype can be used to set the default content type.
Syntax:
|
Command |
Keyword |
Value |
Developer notes for Command/Keyword/Value |
|
SEND |
HANDLER |
|
OutboundXML |
|
XSL |
|
Conditional. See XSL. |
|
|
FRAGMENT |
|
Optional. See FRAGMENT. |
|
|
OUTPUT |
|
Optional. See OUTPUT. |
|
|
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. |
|
|
CONTENT |
|
Optional. See CONTENT. |
|
|
ENCODING |
|
Optional. See ENCODING. |
|
|
ARCHIVE |
|
Optional. See ARCHIVE. |
|
|
ACTION |
value |
Optional. Include HTTP SOAPAction property |
Example
SEND HANDLER(OutboundXML) XSL(..) URI(/cgi-bin/program) HOST(…) SERVICE_LIST(…)
SEND HANDLER(OutboundXML) METHOD(GET) URI(/cgi-bin/program) HOST(…)