Versions Compared

Key

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

...

  • With an inbound HTTP session – that is one that was initiated using the HTTP_BEGIN_INBOUND activity – to receive the multipart content posted with the inbound HTTP request.  For more information on inbound HTTP processing in LANSA Composer, refer to:

HTTP Inbound (Server) Processing in LANSA Composer

  • With an outbound HTTP session – that is one that was initiated using the HTTP_BEGIN_OUTBOUND activity – it is used AFTER sending an HTTP request, to receive the multipart content posted with the HTTP response.  For more information on outbound HTTP processing in LANSA Composer, refer to:

HTTP Outbound (Client) Processing in LANSA Composer

Upon successful completion, the multipart data is made available via the HTTP_RECEIVED_TYPES , HTTP_RECEIVED_NAMES and HTTP_RECEIVED_VALUES output parameters:

  • For those parts of the received multipart data that are name-value pairs, the entry in the HTTP_RECEIVED_TYPES variable list will contain the value 'FIELD'.  In this case the name-value pair data may be accessed directly by addressing the corresponding indexed entries in the HTTP_RECEIVED_NAMES and HTTP_RECEIVED_VALUES output parameters.
  • For those parts of the received multipart data that are files, the entry in the HTTP_RECEIVED_TYPES variable list will contain the value 'FILE'.  In this case you must use the HTTP_MULTIPART_GET activity if you wish to receive the file content.

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.

OUTPUT Parameters:

HTTP_RECEIVED_COUNT:

Upon successful completion, this parameter will contain the count of the name-value pair data and file data received.

HTTP_RECEIVED_TYPES:

Upon successful completion, this parameter will contain the "types" of the items received.  It is a variable list containing the number of entries identified by the HTTP_RECEIVED_COUNT parameter.  Each entry will contain:

...

- the value 'FILE' if it represents file data.  You must use the HTTP_MULTIPART_GET activity if you wish to receive the file content.

HTTP_RECEIVED_NAMES:

Upon successful completion, this parameter will contain the "names" for the name-value pairs or file items received.  It is a variable list containing the number of entries identified by the HTTP_RECEIVED_COUNT parameter.

HTTP_RECEIVED_VALUES:

Upon successful completion, this parameter will contain the "values" for the name-value pair items received.  It is a variable list containing the number of entries identified by the HTTP_RECEIVED_COUNT parameter.

...