HTTP_MULTIPART_GET

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 you specified the path and file name on the HTTP_RECEIVE_INTO parameter, then it will be the same.

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 'FIELD' if the corresponding multipart item is a name-value pair

- 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.

(For those entries that represent multipart file data the value is undefined.)