CA API Gateway 9.1

9.4 9.1

Translate HTTP Form to MIME Assertion

The Translate HTTP Form to MIME assertion allows you to parse the content submitted in HTTP form format by a browser-like client and turn it into a more standards-compliant multi-part MIME message. The Gateway converts incoming content to MIME in accordance with an ordered list of configured field names and Content-Types. If an incoming message does not contain a field configured for conversion in the Translate HTTP Form to MIME assertion, then the assertion will fail.
gateway90
The
Translate HTTP Form to MIME
assertion allows you to parse the content submitted in HTTP form format by a browser-like client and turn it into a more standards-compliant multi-part MIME message. The Gateway converts incoming content to MIME in accordance with an ordered list of configured field names and Content-Types. If an incoming message does not contain a field configured for conversion in the Translate HTTP Form to MIME assertion, then the assertion will fail.
For information on parsing and converting a standard multi-part MIME message into HTTP form submission format, see the Translate MIME to HTTP Form Assertion.
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. When adding the assertion, the
    HTTP Form to MIME Translation Properties
     automatically appear; when modifying the assertion, right-click
    Translate HTTP Form to MIME
    in the policy window and select
    HTTP Form to MIME Translation Properties
     or double-click the assertion in the policy window. The assertion properties are displayed. 
  3.  Select an action to perform.
    Action
    Description
    Add
    Click [
    Add
    ] to configure a new HTTP form field.
    Modify
    Select an existing form field and then click [
    Modify
    ] to edit the field information.
    Remove
    Select a form field to remove and then click [
    Remove
    ] to delete it. The field is removed without further confirmation.
    Move Up
    Move Down
    The order of the form fields in the table must reflect the order of the MIME parts in the resulting MIME message. To change the order of the entries in the table, select an entry to be moved and then click [
    Move Up
    ] or [
    Move Down
    ].
  4. When adding or modifying a field, the Configure Field Information dialog appears. Configure the dialog as follows:
    Setting
    Description
    Field Name
    Enter the name of the HTTP form field. The field name must exactly match the name and case of the element in the incoming message; for example,
    xml
    MIME Content-Type
    Enter the MIME type for the form field, including a character set if the field contains textual data; for example,
    text/xml; charset='utf-8'
    In accordance with the SOAP with Attachments standard, the first MIME part should always be the SOAP message.
  5. Click [
    OK
    ]
     
    to close each form when done.

Content feedback and comments