MTOM Service (com.ibi.agents.XDMTOMAgent)

Syntax:

com.ibi.agents.XDMTOMAgent

iIT Service Object:

Description:

The Message Transmission Optimization Mechanism (MTOM) service can be used to format a document for MTOM transmission or to reconstruct a document received in MTOM format. Reconstruction converts the received MTOM message into a message format that can be handled by the attachment capabilities of the server.

Parameters:

Parameter

Description

Operation

Select one of the following specific operations to perform from the drop-down list:

  • Reconstruct the original message {reconstruct}

    Reconstructs the original XML message document by replacing the MTOM references with the actual binary content found in the attachments.

  • Create an MTOM package {create}

    Creates an MTOM message by replacing the contents of some binary elements with references to body parts in a new multipart attachment.

  • Add an Include {include}

    Assumes the document is already an MTOM message and replaces one more binary element with a reference to a new body part.

Delete Attachments

If the Reconstruct the original message option is selected for the Operation parameter, the Delete Attachments parameter specifies whether to delete the attachments that have replaced xop:Include elements.

Element Path

If the Create an MTOM package option is selected for the Operation parameter, you must specify an XPath expression for the Element Path parameter that returns the set of base64binary nodes to extract.

If the Add an Include option is selected for the Operation parameter, you must specify an XPath expression that returns the element where the xop:Include element will be added.

XML Namespace Provider

A provider for the mapping between XML namespace prefix and namespace URI in the Element Path.

XPath Syntax

Determines the syntax level of XPath that should be used. The default option selects the syntax level as set in the General Settings section of the iSM console. Select one of the following syntax levels from the drop-down list:

  • Default {default}
  • iWay abbreviated syntax {iway}
  • XPath 1.0 full syntax {xpath1}

Attachment Content-Type

If the Create an MTOM package option is selected for the Operation parameter, this is the Content-Type set on a new attachment when the xmlmime:contentType attribute is absent on the extracted element.

Attachment Content-ID

If the Add an Include option is selected for the Operation parameter, this value is the Content-ID of the existing attachment being referred to.

If the Create an MTOM package option is selected for the Operation parameter, the Content-ID of the new attachments will be the prefix specified here followed by a numeric suffix.

The edges returned are listed in the following table:

Edge

Description

success

The operation completed successfully.

fail_parse

Parameters to the service were invalid.

fail_operation

The MTOM operation cannot be completed. This can be caused by attempting to reconstruct a non-MTOM message.