Oracle SOA Suite- Implementing Email Notification

In this post, I am going to show how to implement email notifications in Oracle SOA Suite using BPEL process. So let's get started-

Implementing email notification in Oracle SOA Suite consists of below steps:

Environment-

1. IDE- Oracle jDeveloper 11g
2. Weblogic Server 12c
3. Oracle SOA Suite 12c

High Level Steps

1. Keep ready email server settings.
2. Configure & enable usermessagingdriver-email for target SOA servers via console.
3. Setting up Email driver (usermessagingdriver-email )with email server settings via enterprise manager.
4. Enable notifications for SOA workflows(make sure either All or EMail option is selected)..
5. Create SOA composite application
6. Deploy it on SOA server.
7. Testing & done.

1. Keep ready email server settings.

Keep ready your below email server settings:

1. Outgoing Mail Server          : smtp.domain.com
2. Outgoing Mail Server Port   : xxx
3. Default From Address         : username@doamin.com
4. Outgoing Username            : actualemailid@domain.com
5. Outgoing Password             : *******
6. Incoming Mail Server          pop.domain.com
7. Incoming Mail Server Port   xxxx
8. Incoming Mail IDs(use Outgoing Username/Password) 

2. Configure & enable usermessagingdriver-email for target SOA servers via console

1. Login to weblogic console(http://host:port/console)
2. Select domain in left panel
3. Click on deployments
4. Search for usermessagingdriver-email & click it
5. Go to 'Settings for usermessagingdriver-email'
   
   
   
6. Select targets
   
7. Check all & click on 'Change Targets'
8. Now select the servers where you want, I selected Admin Server L& SOA Server
9. Click on 'Yes' button.
10. Now your usermessagingdriver-email is enabled.

3. Setting up Email driver (usermessagingdriver-email )

1. Login to weblogic em console(http://host:port/em).
2. Now I want to configer email driver for soa_server1.
3. Go to User Messaging left navigation panel and select usermessagingdriver-email (soa_server1).
   
4. Now click on usermessagingdriver-email and select email driver properties
5. Click on plus sign '+' to create a new configuration(this option comes in 12c version, 11g opens directly a email driver configuration page)
6. Now fill the details under 'Create Driver Properties' with the help of email driver settings availabe in Step 1
7. Test it and Ok.

4. Enable notifications for SOA workflows.

Now driver has been configured and need to enable notifications. This ca be done via below navigation:

SOA --> soa-infra(soa server) -->Right Click --> SOA Administration --> Workflow Properties --> Workflow Notification Properties --> Notification Mode : All/Email/SMS

Now our back end system is ready for sending SMS notifications for SOA workflows.

5. Create SOA composite application via jDeveloper

1. Start jDeveloper and create a new application 'EmailDemoApplication' of SOA type.
2. Create a new project 'EmailDemoProject' & finish.
3. Now we need a schema i.e. xsd. You can create your own schema or just add a bpel process 'EmailBPELProcess' 
4. Process- Synchronous
5. Keep option checked - expose as a web service
6. Accept all defaults, 1 input & 1 output variable.
7. Ok.
8. Double click on bpel process and there are two activities availabe in composite swimlane.
9. Add an assign activity
10. Double click and do assignment for output variable using expression builder "concat('Hello user email is: ,',bpws:getVariableData('inputVariable','payload','/client:process/client:input'))"
11. Ok.
12. Now add an email activity from component palet below the assign activity.
13. Configure email activity
14. To: use expression builder to select input variable " <%bpws:getVariableData('inputVariable','payload','/client:process/client:input')%>"
15. CC: leave it blank
16. BCC: leave it blank
17. Reply To: leave it blank
18. Subject: Test email via bpel process
19. Message: Hello, this is a test message via SOA-BPEL workflow
20. Save it.

6. Deploy it on SOA server

Now create a connection via jDeveloper to your target soa server & deploy the application.

7. Testing the web service

1. Login to em console
2. Go to your soa server
3. Select deployed composites and select your project.
4. Below web service testing screen will open.
5. Enter an email id and click on Test Web service button & check it in flow trace and the email(provided in textbox).

Note:  Notification status can be verified inside usermessagingserver -> Message Status

Also check my this blog How to send SMS notifications via Oracle SOA Suite- https://k10technical.blogspot.com/2017/04/oracle-soa-suite-implementing-sms_28.html