OutboundXML

LANSA Integrator

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.
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.

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(…)