Web Services › HTTP Post Form Operator › Input Parameters

Input Parameters

HTTP URL Information

See HTTP URL Information for descriptions of input parameters.

HTTP Post Form Information

Form Fields Encoding

Specifies the character encoding to use when encoding the form fields parameters. The data in the HTTP Post Form operator goes in the body of the request.

Values

This field accepts the following values:

• A value from the drop-down list.
• A value entered by the user.
• Blank - ISO-8859-1

Default

ISO-8859-1

Use Indexed Value Map for Form Fields?

Specifies whether to specify form fields in the Form Fields Indexed Value Map field or in the Form Fields field. The choice enables entry to the corresponding field.

Values

• Selected - Indicates that the form fields are specified as an indexed Value Map in the Form Fields Indexed Value Map field.
• Cleared - Indicates that the form fields are specified in the Form Fields field.

Form Fields

Specifies the combination of key and value for each form field. The Key column contains the names of the form fields and the Value column contains the values of the form fields.

Use the buttons to add, remove, or reorder parameters.

Note: The HTTP Post Form operator ignores any form field with a blank Key.

Form Fields Indexed Value Map

Specifies the name of an indexed ValueMap.

This Value Map consists of Key and Value. A Key entry is the name of a form field; the corresponding Value entry is the value of that form field. The indexed ValueMap is in the same format as the one listed in the Form Fields field.

Note: The HTTP Post Form operator ignores any form field with a blank Key.

File Fields in Form?

Indicates whether the form contains fields that allow for files to be uploaded to the form. Selecting this check box lets you enter related data in the following fields: Use Indexed Value Map for Form Files?, Form Files, and Form Files Indexed Value Map.

Note: The HTTP request header content-type depends on how the File Fields in Form? field is set.

Values

This field is set in one of the following ways:

• Selected - The content type of the HTTP request follows, where XXXXXXX is the boundary string that separates the different parts of the HTTP request. Each part in the HTTP request body can have its own content-type.

  content-type=multipart/form-data;boundary=XXXXXXX
  

  • The form fields are encoded using the encoding specified in Form Fields Encoding. Each form field is placed as a separate part in the request body.
  • Each form field part has a content-type=text/plain; charset=’encoding’ where ‘encoding’ is the value (or default value) of Form Fields Encoding.
  • The form files are encoded using the encoding specified in the ContentType and ContentCharacterEncoding (if applicable) columns associated with each form file. Each form file is placed as a separate part in the request body.
  • The content-type of each form file part is specified in the ContentType column of the Form Files or Form Files Value Map. If applicable, this specification is combined with ContentCharacterEncoding.
• Cleared - The content type of the HTTP request follows, where ‘encoding’ is the type of encoding specified in Form Fields Encoding.

   content-type=application/x-www-form-urlencoded;charset='encoding' 
  

  • The form fields are URL encoded (using the ‘encoding’).
  • The form fields are placed in the body of the request.

Use Indexed Value Map for Form Files?

Indicates whether to specify the form file fields in the Form Files field or in the Form Files Indexed Value Map field.

• Selected - Indicates that the form file fields are specified as an indexed Value Map in the Form Files Indexed Value Map field.
• Cleared - Indicates that the form file fields are specified in the Form Files field.

Form Files

Specifies each form file with four fields: Key, File Path, Content Type, and Content Character Encoding. Descriptions of each field of a form file follow:

Key

Specifies the names of the form file fields.

FilePath

Specifies the path to the file to upload. (This field is required.) The operator ignores any form file field with a blank FilePath.

ContentType

Specifies the content type of the file to upload. Valid content-types are listed on the IANA website under assignments/media-types. If left blank, the content-type of the corresponding file’s part in the HTTP request body is set to application/octet-stream. It is then the responsibility of the HTTP server to interpret this generic content-type.

ContentCharacterEncoding

Specifies the character set of the content of the files to upload, if the corresponding content type is all characters such as ‘text/XXX’. Leave blank for other kinds of content types.

Note: For a list of different character sets (encodings), see the IANA website pages under assignments/character-sets.

Form Files Indexed Value Map

Specifies the name of an indexed ValueMap that contains the form file fields names and corresponding values. The indexed ValueMap must be of the same format as the one listed in the Form Files field. That is, it must consist of Key, FilePath, ContentType, and ContentCharacterEncoding.

HTTP Proxy Information

See HTTP Proxy Information for descriptions of input parameters.

HTTP Headers Information

See HTTP Headers Information for descriptions of input parameters.

HTTP Cookies Information

See HTTP Cookies Information for descriptions of input parameters.

HTTP Response Content Information

See HTTP Response Content Information for descriptions of input parameters.

HTTP Configuration Information

See HTTP Configuration Information for descriptions of input parameters.