CA API Gateway 9.1

9.4 9.1

Validate MTOM Message Assertion

The Validate MTOM Message assertion is used to validate MTOM-optimized messages. MTOM-optimized messages are based on the Message Transmission Optimization Mechanism (MTOM) specification.
gateway90
The
Validate MTOM Message
assertion is used to validate MTOM-optimized messages. MTOM-optimized messages are based on the Message Transmission Optimization Mechanism (MTOM) specification.
To learn about selecting the target message for this assertion, see Selecting a Target Message.
MIME Multipart Messages
A SOAP service normally does not permit MIME multipart messages unless it is explicitly specified in the service's WSDL document or the policy contains an that processes MIME multipart. Adding a Validate MTOM Message assertion that targets a request message in a policy will mean that the service(s) for that policy will permit MIME multipart messages.
Using the Assertion
  1. Do one of the following:
    • To add the assertion to the Policy Development window, see Adding an Assertion.
    • To change the configuration of an existing assertion, proceed to step 2 below.
  2. Right-click
    <target>:
     Validate MTOM Message
     in the policy window and select
    MTOM Validate Properties
     or double-click the assertion in the policy window. The assertion properties are displayed.
  3. Configure the properties as follows: 
    Setting
    Description
    Require encoded
    Select this check box to require that the source message be MTOM-encoded, otherwise the assertion will fail.
    Clear this check box to not fail the assertion if the source message is not MTOM-encoded.
    Validation Rules
    The Validation Rules table is used to control which element's content will be validated. For each
    XPath
    , you can specify a maximum
    Item Count
     and maximum
    Item Size
    .
    • To add a validation rule, click [
      Add
      ].
    • To modify a validation rule on the list, select it and then click [
      Edit
      ].
    • To remove a validation rule from the list, select it and then click [
      Remove
      ].
  4. When adding or modifying a validation rule, the MTOM Validate Properties - Rule dialog appears. 
    Complete the fields as follows:
    • XPath:
       Click [
      Edit
      ] to select the XPath containing the elements to validate. For more information, see Selecting an XPath.
    • Item Count:
       Enter the maximum number of items permitted at the XPath. A count of '
      0
      ' (zero) means an unlimited number of items.
    • Item Size:
       Enter the maximum size permitted for an item, in kilobytes.
  5. Click [
    OK
    ] when done.

Content feedback and comments