Lets a consumer Web Service program retrieve attachments from the SOAP response.
This function should be used to access SOAP attachments that are received in the SOAP response by the Invoke Web Service call.
This function is intended to be used for SOAP attachments that are not declared in the WSDL.
|
Syntax:
|
WsConsumerAttachmentGet (Identifier)
|
Parameters:
|
Identifier – Select an identifier type from the options below:
1. Universal Unique Identifier (UUID) – An alphanumeric value that uniquely identifies the attachment. UUID can be used only for DIME attachments.
2. Index – Numeric value. When Magic xpa receives several attachments, the function retrieves each attachment by its index number in the message, starting from 1.
|
Returns:
|
A BLOB containing the attachment content
A Null value is returned when the attachment is not found by the UUID or Index.
|
Examples:
|
WsConsumerAttachmentGet (1), returns the first attachment from the message.
WsConsumerAttachmentGet ('F2DA3C9C-74D3-4A46-B925-B150D62D9483'), returns the identified attachment.
|
Note:
|
-
In runtime, incoming attachments are available during the Web Service consumer program by using the following syntax: WsConsumerAttachmentGet (uuid) or WsConsumerAttachmentGet (index). For indexes, the incoming attachments are accessed in their order of appearance in the SOAP response.
-
Incoming attachments are automatically discarded before the Invoke Web Service is executed.
|
Exceptions:
|
This function is not supported as a parameter in the Invoke Web Service Lite operation.
|
See also:
|
WsConsumerAttachmentAdd
How Do I Work with Web Service Attachments?
|