Send email with attachment in WSO2 ESB

WSO2 ESB comes with a comprehensive set of transports supported. Mail transport is one of the mostly used transports with the WSO2 ESB. This post will guide you to send an email with an attachment by using the WSO2 ESB.

1. First you need to download the WSO2 ESB from the official WSO2 web site.

http://wso2.com/products/enterprise-service-bus/

Extract the downloaded archive file in to a folder inside your computer. This extracted folder will be referred as ESB_HOME in the next part of the post.

2. Enable the mail transport from the axis2 configuration file which is located in the ESB_HOME\repository\conf\axis2\axis2.xml

Uncomment the lines which are related to mail transport

<transportSender name=”mailto”>

<parameter name=”mail.smtp.host”>smtp.gmail.com</parameter>

<parameter name=”mail.smtp.port”>587</parameter>

<parameter name=”mail.smtp.starttls.enable”>true</parameter>

<parameter name=”mail.smtp.auth”>true</parameter>

<parameter name=”mail.smtp.user”>synapse.demo.0</parameter>

<parameter name=”mail.smtp.password”>mailpassword</parameter>

<parameter name=”mail.smtp.from”>synapse.demo.0@gmail.com</parameter>

</transportSender>

<transportReceiver name=”mailto”>

<!– configure any optional POP3/IMAP properties

check com.sun.mail.pop3 and com.sun.mail.imap package documentation for more details–>

</transportReceiver>

Add the required messageFormatter type if it not included in the config file.

<messageFormatter contentType=”text/plain”/>

3.  Now let’s start the WSO2 ESB by executing the following command

ESB_HOME\bin\wso2server.sh (Linux)

ESB_HOME/bin/wso2server.bat (Windows)

4. Then access the management console of the ESB with the following URL

https://localhost:9443/carbon/

5. In the Main section, click proxy services and add new proxy service with the type as custom proxy type.

Click the source view button and copy the following configuration to the proxy source view.

<proxy xmlns=”http://ws.apache.org/ns/synapse&#8221; name=”MailProxy” transports=”https,http” statistics=”disable” trace=”disable” startOnLoad=”true”>
<target>
<inSequence>
<payloadFactory>
<format>
<ns:sendMailResponse xmlns:ns=”http://services.samples”>$1</ns:sendMailResponse&gt;
</format>
<args>
<arg value=”Message Sent from the WSO2 ESB”/>
</args>
</payloadFactory>
<property name=”transport.mail.Format” value=”Attachment” scope=”axis2″/>
<property name=”AttachmentFile” value=”attachment.csv” scope=”axis2″/>
<property name=”Subject” value=”File Received” scope=”transport”/>
<property name=”OUT_ONLY” value=”true” scope=”default” type=”STRING”/>
<log level=”full”/>
<send>
<endpoint>
<address uri=”mailto:yourname@gmail.com”/>
</endpoint>
</send>
</inSequence>
</target>
<description></description>
</proxy>

Just edit the email address above to your email address and save the proxy by clicking the save button.

Now you have configured the ESB to send an email.

6. Let’s try the written proxy with soapUI client. Now you can check on you email and confirm that email message is received with an attachment of the message content.