Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space FUNCTDEV and version SVC2024.1

Info

The ability to send MIME and DIME attachments is deprecated and will be removed in a future version.

Many services use attachments to send and receive data that are not well represented with XML messages (for example, multimedia binary data). SOAtest can be used to send and receive attachments along with messages. Received attachments can then be processed and validated for correctness.The SOAP Client tools can be configured to send MIME, DIME, and MTOM attachments along with the message. Attachment encapsulation format optimize the sending of SOAP messages using MTOM, where any binary element content is sent as MIME attachments instead of being base64 encoded directly within the SOAP envelope. SOAtest can also receive and validate binary MIME attachments from MTOM payloads. Attachment encapsulation format for SOAP Client tools can be configured under the tool’s Misc tab.

With MIME/DIME, the tool’s Attachment tab allows you to send either Binary or XML attachments without scripting as described in the Attachment Options. With MTOM, you do NOT need to add anything to the Attachment tab (see below for details).

The Attachment Handler tool can be used in conjunction with a SOAP Client to Client to extract and validate attachments from a response message.

...

For more information on configuring the Attachment Handler tool, see Attachment Handler

...

MTOM/XOP Messages

Excerpt

SOAtest can work with services leveraging the MTOM (Message Transmission Optimization Mechanism) and XOP (XML-binary Optimized Packaging) technologies. You can elect the binary content to include—as well as validate, send, and receive—optimized messages.

MTOM optimized messages can be sent using the SOAP Client or Message Responder in Form Input view. 

The XOP optimization is performed by replacing the xsd:base64Binary element contents with a reference that looks similar to the following:

< xop:Include href="cid:1.urn:uuid:[email protected]" xmlns:xop="http://www.w3.org/2004/08/xop/include" />

The same href cid value is used in a --MIME_boundary section, which would include the corresponding non-encoded content.

To enable the sending of optimized messages, complete the following:

  1. Click on the tool's Misc. tab and choose Custom from the Attachment Encapsulation Format menu.

  2. Enable either MTOM Alwaysalways or MTOM Optionaloptional.
    • MTOM Alwaysalways: This tool will always send the request in a XOP Package (that is, with MIME boundaries), even when there is not optimized content in the request (that is, even when xsd:base64Binary XML types are not present in the message).
    • MTOM Optionaloptional: This tool will send the request in a XOP Package (that is, with MIME boundaries) only when there is optimized content in the request. In the absence of optimized content, it will send a normal request.Note that MTOM Alwaysalways or MTOM Optionaloptional can be selected at the test suite level in the SOAP Client Options tab or in the SOAP Client page of the Preferences panel.

  3. Select the Request tab and make sure Form Input is selected from the Views menu. The Form Input view is a schema-aware view. In this view, the xsd:base64Binary schema datatype will be recognized so that you can reference the content that you want to optimize. When you click on a base64Binary type, the following options are available:

    • Reference to file: This is the recommended option. This option allows you to select a file to send as optimized content. SOAtest reads the contents from the file as the contents are being sent on the wire. This way, the file contents are not stored in the suite.

    • Persist As Relative Path: It is always recommended that the path to the file be kept as a relative path to the suite to allow for easier sharing and collaboration with the rest of the organization.
    • Import from file: This option (not recommended) allows you to read the contents in from the file. This option is not recommended for big files because the contents of the file will be loaded into memory.
    • Additionally, the file to be sent can be driven by data sources by choosing Parameterized from the menu and selecting a File Data Source. For more information about File Data Sources, see Configuring a File Data Source

...