Skip to content

Form URL Writer

The Form URL Writer provides the ability to integrate with three types of service:

  • Form URL Encoded - This will post a sequence of key value pairs (e.g. key1=value1&key2=value2&key3=value3) as an application/x-www-form-urlencoded type request.
  • Parameter URL - Will post a sequence of key value pairs (e.g. key1=value1&key2=value2&key3=value3) as key/value pairs as URL parameters.
  • Multipart Form URL Encoded - An extension of Form URL Encoded where a 'multipart' type request will encompass a set of form url encoded values and a binary type of data (such as images, Pdf's or any other non-textual file).
  • The Multipart Form Url Writer permits the return of binary data to a Web API invocation (via the WebAPI controller).

Due to the nature of the output the following limitations apply:

  • The writer only works with the HTTP IO Controller OR Web API.
  • Only the values from the top Transaction Type will be included in the request.
  • A single request per record will be made.

Transform > OPTIONS

The options tab specifies key options on how the writer functions.

Transform Id

The unique user-defined name for the transform.

Target

Either HTTP Controller or WebAPI.

Post Type

Controls how the values will be sent to the webservice. The Post Type has three options:

  • Form URL Encoded
    • The data is sent with the 'application/x-www-form-urlencoded' content type.
  • Paramterised URL
    • Parameterised URLs
  • Multipart Form URL Encoded
    • Post a mix of form url encoded and binary type data in a single request as a multipart/form-data type request.

Rewrite Response Transaction

Allows you write the response back to the IMan dataset.

See Rewrite (HTTP) Write Response

Multipart Form URL Encoded does not support handling of responses.

Make File As Attachment

When selected will make any binary/file output as a downloadable file.

Only available when Target is Web API and Post Type is Multipart.

Transform > Field Mapping

Current Transaction Id

The transaction type being edited.

Field Name

The field name within IMan.

Export

When set to True, field will be included in resultant request.

Parameter

The name of the parameter either on the form URL request or url.

Up/Down Arrows

Used to control the ordering of the fields sent of the request.

Top record will become first on the left of grid in Preview screen.