Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

After receiving multipart content using the HTTP_RECEIVE_MULTI activity, you may execute this activity, for EACH multipart file item, to receive the multipart file content into a specified file.  Refer to the description of the HTTP_RECEIVE_MULTI activity for more information.

INPUT Parameters:

HTTP_HANDLE: Required

This parameter must specify the session handle value that identifies the HTTP session upon which this activity should operate.  The session handle value is returned by the HTTP_BEGIN_INBOUND  or HTTP_BEGIN_OUTBOUND activity.

HTTP_MULTIPART_INDEX: Required

This parameter must specify the index of the multipart item to receive.

The value must specify the index of the item in the HTTP_RECEIVED_TYPES , HTTP_RECEIVED_NAMES and HTTP_RECEIVED_VALUES output parameters of the HTTP_RECEIVE_MULTI activity.

HTTP_RECEIVE_INTO: Optional

This optional parameter specifies the path and file name of the file that is to receive the HTTP content.

If not specified, or if the special value *AUTO is specified, the activity will generate a path and file name to receive the content.  The directory will be taken from the system setting HTTP inbound payload directory.  The file name will be derived from a prefix plus a unique number plus .dat extension. The prefix is taken from the system setting HTTP inbound filename prefix.

OUTPUT Parameters:

HTTP_RECEIVED_INTO:

Upon successful completion, this parameter will contain the actual path and file name of the file that received the HTTP content.

...

If *AUTO was specified or assumed for the HTTP_RECEIVE_INTO parameter, then this parameter contains the actual (generated) path and file name used.

HTTP_MULTIPART_TYPE:

Upon successful completion, this parameter will contain the "type" of the item received.  It is will contain:

...

- the value 'FILE' if it represents file data.

HTTP_MULTIPART_NAME:

Upon successful completion, this parameter will contain the "name" for the name-value pair or file item received.

HTTP_MULTIPART_VALUE:

Upon successful completion, this parameter will contain the "value" for the name-value pair item received.

...