|
|
Using attachments with SOAP, dotNet, and HTTP connectors and servicesAs of V6.2, all SOAP, dotNet, and HTTP connectors and services use a common approach for handling attachments.
Sending attachments from your application
Connectors
When building the outbound message content for a SOAP, dotNet, or HTTP connector, PRPC looks for a top-level clipboard page named pyRequestAttachmentPage of type Data-ServiceMessage. If it finds the page in the clipboard, it adds attachments to the outgoing message for every string value found in the pyAttachValues Value List property on the page. Each string is assumed to be a Base64-encoded representation of a binary data value. This page must be created and populated prior to invoking the connector.
Services
The same general model applies for SOAP, dotNet, and HTTP services, but in that case, the top-level page is named pyResponseAttachmentPage, since the attachments will be added to the outgoing service response message.
Receiving and processing attachments
Connectors
To process attachments that have been received as part of a SOAP, dotNet, or HTTP connector response message, configure your connector activity to look for a top-level clipboard page named pyResponseAttachmentPage of type Data-ServiceMessage after the connector has been invoked. If the page exists, any attachments that were received will appear as Base64-encoded values in the pyAttachValues value list property on the page. The typical use case is to iterate over the list of attachments and associate them with a work object.
Services
The same general model applies for SOAP, dotNet, and HTTP services, but in that case, the top-level page is named pyRequestAttachmentPage, since the attachments will be received as part of the inbound service request message.